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

# 描述 Amazon DocumentDB 執行個體
<a name="db-instance-view-details"></a>

您可以使用 Amazon DocumentDB 管理主控台或 查看 AWS CLI 連線端點、安全群組 VPCs、憑證授權單位和與 Amazon DocumentDB 執行個體相關的參數群組等詳細資訊。

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

若要使用 AWS 管理主控台檢視執行個體的詳細資訊，請依照下列步驟操作。

1. 登入 AWS 管理主控台，並在 https：//[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. 在執行個體清單中，選擇您要查看其詳細資訊的執行個體名稱。執行個體的相關資訊分為下列群組：
   + **摘要** - 執行個體的一般資訊，包括引擎版本、類別、狀態和任何待定維護。
   + **連線與安全性** — **Connect** 區段列出使用 mongo shell 或 應用程式連線至此執行個體的連線端點。**Seucirty Groups (安全群組)** 區段會列出與此執行個體相關聯的安全群組，以及其 VPC ID 和描述。
   + **組態** - **詳細資訊**區段列出執行個體的組態和狀態，包括執行個體的 Amazon Resource Name (ARN)、端點、角色、類別和憑證授權單位。它也會列出執行個體的安全性和網路設定，以及備份資訊。**Cluster details (叢集詳細資訊)** 區段會列出此執行個體所屬叢集的詳細資訊。**Cluster instances (叢集執行個體)** 區段會列出屬於您叢集的所有執行個體，當中每個執行個體的角色和叢集參數群組狀態。
**注意**  
您可以透過選取叢集詳細資訊標頭旁的**修改**，來修改與執行個體相關聯的叢集。 ****如需詳細資訊，請參閱[修改 Amazon DocumentDB 叢集](db-cluster-modify.md)。
   + **監控** - 此執行個體的 CloudWatch Logs 指標。如需詳細資訊，請參閱[使用 CloudWatch 監控 Amazon DocumentDB](cloud_watch.md)。
   + **事件和標籤** — **最近事件**區段列出此執行個體的最近事件。Amazon DocumentDB 會保留與叢集、執行個體、快照、安全群組和叢集參數群組相關的事件記錄。此資訊包括與每個事件相關聯的日期、時間和訊息。**Tags (標籤)** 區段會列出連接至此叢集的標籤。如需詳細資訊，請參閱[標記 Amazon DocumentDB 資源](tagging.md)。

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

若要使用 檢視 Amazon DocumentDB 執行個體的詳細資訊 AWS CLI，請使用 `describe-db-clusters`命令，如以下範例所示。如需詳細資訊，請參閱《*Amazon DocumentDB Resource Management API 參考*[https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.html)》中的 。

**注意**  
對於特定管理功能，例如叢集和執行個體生命週期管理，Amazon DocumentDB 會利用與 Amazon RDS 共用的操作技術。`filterName=engine,Values=docdb` 篩選條件參數只會傳回 Amazon DocumentDB 叢集。

1. **列出所有 Amazon DocumentDB 執行個體。**

   下列 AWS CLI 程式碼列出區域中所有 Amazon DocumentDB 執行個體的詳細資訊。

   針對 Linux、macOS 或 Unix：

   ```
   aws docdb describe-db-instances \
       --filter Name=engine,Values=docdb
   ```

   針對 Windows：

   ```
   aws docdb describe-db-instances \
       --filter Name=engine,Values=docdb
   ```

1. **列出指定 Amazon DocumentDB 執行個體的所有詳細資訊**

   以下程式碼會列出 `sample-cluster-instance` 的詳細資訊。將 `--db-instance-identifier` 參數加入執行個體名稱會將輸出限制為該特定執行個體的資訊。

   針對 Linux、macOS 或 Unix：

   ```
   aws docdb describe-db-instances \
       --db-instance-identifier sample-cluster-instance
   ```

   針對 Windows：

   ```
   aws docdb describe-db-instances \
       --db-instance-identifier sample-cluster-instance
   ```

   此操作的輸出如下所示：

   ```
   {
       "DBInstances": [
           {
               "DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
               "DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
               "VpcSecurityGroups": [
                   {
                       "VpcSecurityGroupId": "sg-77186e0d",
                       "Status": "active"
                   }
               ],
               "DBInstanceClass": "db.r5.large",
               "DBInstanceStatus": "creating",
               "AutoMinorVersionUpgrade": true,
               "PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
               "BackupRetentionPeriod": 1,
               "StorageEncrypted": true,
               "DBClusterIdentifier": "sample-cluster",
               "EngineVersion": "3.6.0",
               "AvailabilityZone": "us-east-1a",
               "Engine": "docdb",
               "PromotionTier": 2,
               "DBInstanceIdentifier": "sample-cluster-instance",
               "PreferredBackupWindow": "00:00-00:30",
               "PubliclyAccessible": false,
               "DBSubnetGroup": {
                   "DBSubnetGroupName": "default",
                   "Subnets": [
                       {
                           "SubnetIdentifier": "subnet-4e26d263",
                           "SubnetAvailabilityZone": {
                               "Name": "us-east-1a"
                           },
                           "SubnetStatus": "Active"
                       },
                       {
                           "SubnetIdentifier": "subnet-afc329f4",
                           "SubnetAvailabilityZone": {
                               "Name": "us-east-1c"
                           },
                           "SubnetStatus": "Active"
                       },
                       {
                           "SubnetIdentifier": "subnet-b3806e8f",
                           "SubnetAvailabilityZone": {
                               "Name": "us-east-1e"
                           },
                           "SubnetStatus": "Active"
                       },
                       {
                           "SubnetIdentifier": "subnet-53ab3636",
                           "SubnetAvailabilityZone": {
                               "Name": "us-east-1d"
                           },
                           "SubnetStatus": "Active"
                       },
                       {
                           "SubnetIdentifier": "subnet-991cb8d0",
                           "SubnetAvailabilityZone": {
                               "Name": "us-east-1b"
                           },
                           "SubnetStatus": "Active"
                       },
                       {
                           "SubnetIdentifier": "subnet-29ab1025",
                           "SubnetAvailabilityZone": {
                               "Name": "us-east-1f"
                           },
                           "SubnetStatus": "Active"
                       }
                   ],
                   "VpcId": "vpc-91280df6",
                   "DBSubnetGroupDescription": "default",
                   "SubnetGroupStatus": "Complete"
               },
               "PendingModifiedValues": {},
               "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
           }
       ]
   }
   ```

------