本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
向集群添加 Amazon DocumentDB 实例
- Using the AWS Management Console
-
使用以下过程通过 Amazon DocumentDB 控制台为集群创建实例。
-
在导航窗格中，选择集群。
提示
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (
)。 -
要选择希望将实例添加到的集群，请选择该集群名称左侧的按钮。
-
选择 Actions (操作)，然后选择 Add instance (添加实例)。
-
在 Add instance to: (将实例添加到:)<cluster-name> 页面中，对要添加到集群的每个实例重复以下步骤。您最多可以有 15。
-
Instance identifier (实例标识符) - 您可以输入此实例的唯一标识符，或允许 Amazon DocumentDB 基于集群标识符提供实例标识符。
实例命名约束：
-
长度为 [1-63] 个字母、数字或连字符。
-
第一个字符必须是字母。
-
不能以连字符结束或包含两个连续连字符。
-
每个区域的亚马逊RDS、Neptune 和 Amazon DocumentDB 上的所有实例都必须是唯一 AWS 账户的。
-
-
Instance class (实例类) - 从下拉列表中，为该实例选择所需的实例类型。
-
Promotion tier (提升层) - 从下拉列表中，选择该实例的提升层，或者选择 No preference (无首选项) 以允许 Amazon DocumentDB 为您的实例设置提升层。数字越小，意味着优先级越高。有关更多信息，请参阅 控制失效转移目标。
-
要添加更多实例，请选择 Add additional instances (添加额外实例)，并重复步骤 a、b 和 c。
-
-
完成此操作。
-
要将实例添加到集群，请选择 Create (创建)。
-
要取消操作，请选择取消。
-
创建实例需要几分钟时间。您可以使用控制台或 AWS CLI 查看实例的状态。有关更多信息，请参阅 监控实例的状态。
- Using the AWS CLI
-
使用带有以下参数的
create-db-instanceAWS CLI 操作为您的集群创建主实例。-
--db-instance-class– 必需。实例的计算和内存容量，例如，db.m4.large。并非所有实例类在所有 AWS 区域中都可用。 -
--db-instance-identifier– 必需。标识实例的一个 字符串。实例命名约束：
-
长度为 [1-63] 个字母、数字或连字符。
-
第一个字符必须是字母。
-
不能以连字符结束或包含两个连续连字符。
-
每个区域的亚马逊RDS、Neptune 和 Amazon DocumentDB 上的所有实例都必须是唯一 AWS 账户的。
-
-
--engine– 必需。必须是docdb。 -
--availability-zone– 可选。要在其中创建此实例的可用区。使用此参数在不同可用区中找到您的实例，以增强容错能力。有关更多信息，请参阅 Amazon DocumentDB 高可用性和复制。 -
--promotion-tier– 可选。此实例的失效转移优先级层。必须介于 0 与 15 之间，数字越小，优先级越高。有关更多信息，请参阅 控制失效转移目标。
-
首先，确定您可以在哪些可用区中创建您的实例。
如果要在创建实例前指定可用区，请运行以下命令以确定哪些可用区可用于您的 Amazon DocumentDB 集群。
对于 Linux、macOS 或 Unix：
aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'对于 Windows：
aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'此操作的输出将类似于下文。
[ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] -
其次，确定您可以在您的区域中创建哪些实例类。
要确定您所在区域中可用的实例类，请运行以下命令。从输出中，为要添加到 Amazon DocumentDB 集群的实例选择实例类。
对于 Linux、macOS 或 Unix：
aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'对于 Windows：
aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'此操作的输出将类似于下文。
[ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] -
最后，将实例添加到您的 Amazon DocumentDB 集群。
要将实例添加到您的 Amazon DocumentDB 集群，请运行以下命令。
对于 Linux、macOS 或 Unix：
aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdb对于 Windows：
aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdb此操作的输出将类似于下文。
{ "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2" } }
创建实例需要几分钟时间。您可以使用控制台或 AWS CLI 查看实例的状态。有关更多信息，请参阅 监控 Amazon DocumentDB 实例的状态。
-
