DBCluster - Amazon DocumentDB
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DBCluster

有关集群的详细信息。

内容

注意

下表中,首先描述的是必需参数。

AssociatedRoles.DBClusterRole.N

提供与集群关联的 Amazon Identity and Access Management (IAM) 角色列表。与集群关联的 (IAM) 角色授予集群代表您访问其他 Amazon 服务的权限。

类型:DBClusterRole 对象数组

必需:否

AvailabilityZones.AvailabilityZone.N

提供可在其上创建集群中实例的 Amazon EC2 可用区的列表。

类型:字符串数组

必需:否

BackupRetentionPeriod

指定自动快照的保留天数。

类型:整数

必需:否

CloneGroupId

标识数据库集群与之关联的克隆组。

类型:字符串

必需:否

ClusterCreateTime

指定创建集群的时间,采用通用协调时间 (UTC)。

类型:时间戳

必需:否

DBClusterArn

集群的 Amazon 资源名称 (ARN)。

类型:字符串

必需:否

DBClusterIdentifier

包含用户提供的集群标识符。此标识符是识别集群的唯一键。

类型:字符串

必需:否

DBClusterMembers.DBClusterMember.N

提供组成集群的实例的列表。

类型:DBClusterMember 对象数组

必需:否

DBClusterParameterGroup

指定集群的集群参数组名称。

类型:字符串

必需:否

DbClusterResourceId

集群 Amazon Web Services 区域的唯一且不可变的标识符。每当访问集群的 Amazon KMS 密钥时,都会在 Amazon CloudTrail 日志条目中找到此标识符。

类型:字符串

必需:否

DBSubnetGroup

指定与集群关联的子网组的信息,包括名称、描述和子网组中的子网。

类型:字符串

必需:否

DeletionProtection

指定是否可以删除此集群。如果 DeletionProtection 启用,则无法删除集群,除非集群经修改并 DeletionProtection 禁用。DeletionProtection 防止意外删除集群。

类型:布尔值

必需:否

EarliestRestorableTime

通过还原可以将数据库 point-in-time还原到的最早时间。

类型:时间戳

必需:否

EnabledCloudwatchLogsExports.member.N

此集群配置为导出到 Amazon CloudWatch 日志的日志类型列表。

类型:字符串数组

必需:否

Endpoint

指定集群的主实例的连接端点。

类型:字符串

必需:否

Engine

提供要用于此集群的数据库引擎的名称。

类型:字符串

必需:否

EngineVersion

指示数据库引擎版本。

类型:字符串

必需:否

HostedZoneId

指定在您创建托管区域时 Amazon Route 53 分配的 ID。

类型:字符串

必需:否

KmsKeyId

如果StorageEncryptedtrue,则为加密群集的 Amazon KMS 密钥标识符。

类型:字符串

必需:否

LatestRestorableTime

指定通过还原可以将数据库 point-in-time还原到的最晚时间。

类型:时间戳

必需:否

MasterUsername

包含集群的主用户名。

类型:字符串

必需:否

MultiAZ

指定集群是否在多个可用区中有实例。

类型:布尔值

必需:否

PercentProgress

指定操作的进度百分比。

类型:字符串

必需:否

Port

指定数据库引擎侦听的端口。

类型:整数

必需:否

PreferredBackupWindow

指定在启用自动备份时,自动执行备份的日常时间范围,如 BackupRetentionPeriod 所规定。

类型:字符串

必需:否

PreferredMaintenanceWindow

指定可进行系统维护的每周时间范围(采用通用协调时间 (UTC))。

类型:字符串

必需:否

ReaderEndpoint

集群的读取器端点。集群的读取器端点负载均衡集群中可用的 Amazon DocumentDB 副本间的连接。当客户端请求与读取器端点的新连接时,Amazon DocumentDB 将在集群中的 Amazon DocumentDB 副本之间分配连接请求。该功能可帮助平衡集群中跨多个 Amazon DocumentDB 副本的读取工作负载。

如果发生了失效转移并且连接到的 Amazon DocumentDB 副本被提升为主实例,则将删除您的连接。要继续向集群中的其他 Amazon DocumentDB 副本发送读取工作负载,您可以随后重新连接到读取器端点。

类型:字符串

必需:否

ReadReplicaIdentifiers.ReadReplicaIdentifier.N

包含与此集群关联的辅助集群的一个或多个标识符。

类型:字符串数组

必需:否

ReplicationSourceIdentifier

包含源集群的标识符,如该集群是辅助集群。

类型:字符串

必需:否

Status

指定此集群的当前状态。

类型:字符串

必需:否

StorageEncrypted

指定集群是否已加密。

类型:布尔值

必需:否

StorageType

与您的集群关联的存储类型

与您的集群关联的存储类型

有关亚马逊 DocumentDB 集群存储类型的信息,请参阅亚马逊 Document DB 开发者指南中的集群存储配置。

存储类型的有效值-standard | iopt1

默认值为 standard

类型:字符串

必需:否

VpcSecurityGroups.VpcSecurityGroupMembership.N

提供集群从属的虚拟私有云(VPC)安全组的列表。

类型:VpcSecurityGroupMembership 对象数组

必需:否

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: