本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 尋找執行個體的端點
<a name="db-instance-endpoint-find"></a>

您可以使用 Amazon DocumentDB 主控台或 尋找執行個體的端點 AWS CLI。

------
#### [ Using the AWS 管理主控台 ]

**使用主控台尋找執行個體的端點**

1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)：// 開啟 Amazon DocumentDB 主控台。

1. 在導覽窗格中，選擇**叢集**。
**提示**  
如果畫面左側沒有出現導覽窗格，請選擇頁面左上角的功能表圖示 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 在叢集導覽方塊中，您會看到 欄**叢集識別符**。您的執行個體會列在叢集下，類似於下方的螢幕擷取畫面。  
![\[叢集資料表顯示叢集識別符欄下的叢集清單，其中執行個體巢狀在叢集內。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/choose-clusters.png)

1. 勾選您感興趣的執行個體左側的方塊。

1. 向下捲動到 **Details (詳細資訊)** 區段，然後找到執行個體端點。  
![\[主控台螢幕擷取畫面顯示詳細資訊頁面，並反白顯示執行個體端點。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/db-instance-endpoint.png)

1. 若要連接至這個執行個體，捲動到 **Connect (連接)** 區段。找出 `mongo` 殼層的連線字串及可用在應用程式碼的連線字串，以連接至您的執行個體。  
![\[主控台螢幕擷取畫面，顯示已反白顯示 mongo shell 和應用程式連線字串的連線區段。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/instance-connection-strings.png)

------
#### [ Using the AWS CLI ]

若要使用 尋找執行個體端點 AWS CLI，請使用這些引數執行下列命令。

**引數**
+ **--db-instance-identifier**- 選用。指定要傳回其端點的執行個體。如果省略，則最多會傳回您的 100 個執行個體的端點。
+ **--query**- 選用。指定顯示的欄位。有助於減少您尋找端點時需要檢視的資料量。如果省略，將會傳回執行個體的所有資訊。`Endpoint` 欄位有三個成員，若如以下範例將其列入查詢中，則會傳回全部三個成員。如果您只對某些 `Endpoint` 成員有興趣，請將查詢中的 `Endpoint` 取代為您有興趣的成員，如第二個範例所示。
+ **--region**- 選用。使用 `--region` 參數來指定您要套用命令的區域。若省略，則使用您的預設區域。

**Example**  
若為 Linux、macOS 或 Unix：  

```
aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
針對 Windows：  

```
aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
此操作的輸出將會如下所示 (JSON 格式)。  

```
[
    [
        "sample-cluster-instance",
        {
            "Port": 27017,
            "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
            "HostedZoneId": "Z2R2ITUGPM61AM"
        }
    ]
]
```
您可以藉由指定 `Endpoint.Port` 和 `Endpoint.Address` 來修改您的查詢，降低輸出以消除端點的 `HostedZoneId`。  
若為 Linux、macOS 或 Unix：  

```
aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
針對 Windows：  

```
aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
此操作的輸出將會如下所示 (JSON 格式)。  

```
[
    [
        "sample-cluster-instance",
        27017,
        "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
    ]
]
```

現在，有了執行個體端點，您可以使用 `mongo` 或 `mongodb` 連接至該執行個體。如需詳細資訊，請參閱[連線至端點](endpoints-connecting.md)。

------