本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Neptune 数据库集群 API **操作：** + [CreateDBCluster（操作）](#CreateDBCluster) + [DeleteDBCluster（操作）](#DeleteDBCluster) + [ModifyDBCluster（操作）](#ModifyDBCluster) + [StartDBCluster（操作）](#StartDBCluster) + [StopDBCluster（操作）](#StopDBCluster) + [AddRoleToDBCluster（操作）](#AddRoleToDBCluster) + [RemoveRoleFromDBCluster（操作）](#RemoveRoleFromDBCluster) + [FailoverDBCluster（操作）](#FailoverDBCluster) + [PromoteReadReplicaDBCluster（操作）](#PromoteReadReplicaDBCluster) + [DescribeDBClusters（操作）](#DescribeDBClusters) **结构：** + [DBCluster（结构）](#DBCluster) + [DBClusterMember（结构）](#DBClusterMember) + [DBClusterRole（结构）](#DBClusterRole) + [CloudwatchLogsExportConfiguration（结构）](#CloudwatchLogsExportConfiguration) + [PendingCloudwatchLogsExports（结构）](#PendingCloudwatchLogsExports) + [ClusterPendingModifiedValues（结构）](#ClusterPendingModifiedValues) ## CreateDBCluster（操作）         此 API 的 AWS CLI 名称为：`create-db-cluster`。 创建新的 Amazon Neptune 数据库集群。 您可以使用 `ReplicationSourceIdentifier` 参数创建数据库集群，作为其他数据库集群或 Amazon Neptune 数据库实例的只读副本。 请注意，当您直接使用 `CreateDBCluster` 创建新的集群时，默认情况下会禁用删除保护（在控制台中创建新的生产集群时，默认情况下会启用删除保护）。仅在数据库集群的 `DeletionProtection` 字段设置为 `false` 时，才能删除数据库集群。 **请求** + **AvailabilityZones**（在 CLI 中：`--availability-zones`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 可在其中创建数据库集群的实例的 EC2 可用区列表。 + **BackupRetentionPeriod**（在 CLI 中：`--backup-retention-period`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 自动备份的保留天数。您必须指定最小值 1。 默认值：1 约束： + 值必须介于 1 到 35 之间 + **CopyTagsToSnapshot**（在 CLI 中：`--copy-tags-to-snapshot`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **DatabaseName**（在 CLI 中：`--database-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库的名称，最多 64 个字母和数字字符。如果您不提供名称，Amazon Neptune 就不会在您正在创建的数据库集群中创建数据库。 + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群标识符。该参数作为一个小写字符串存储。 约束： + 必须包含 1 到 63 个字母、数字或连字符。 + 第一个字符必须是字母。 + 不能以连字符结束或包含两个连续连字符。 示例：`my-cluster1` + **DBClusterParameterGroupName**（在 CLI 中：`--db-cluster-parameter-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要与该数据库集群关联的数据库集群参数组的名称。如果省略此参数，则使用默认值。 约束： + 如果提供，必须与现有 DBClusterParameterGroup 的名称匹配。 + **DBSubnetGroupName**（在 CLI 中：`--db-subnet-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 与此数据库集群关联的数据库子网组。 约束：必须与现有 DBSubnetGroup 的名称匹配。不能是默认值。 示例：`mySubnetgroup` + **DeletionProtection**（在 CLI 中：`--deletion-protection`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 一个值，指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。默认情况下，将启用删除保护。 + **EnableCloudwatchLogsExports**（在 CLI 中：`--enable-cloudwatch-logs-exports`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群应导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型为：`audit`（用于发布审计日志）和 `slowquery`（用于发布慢速查询日志）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **EnableIAMDatabaseAuthentication**（在 CLI 中：`--enable-iam-database-authentication`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则为整个数据库集群启用 Amazon Identity and Access Management (IAM) 身份验证（无法在实例级进行设置）。 默认值：`false`。 + **Engine**（在 CLI 中：`--engine`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 用于此数据库集群的数据库引擎的名称。 有效值：`neptune` + **EngineVersion**（在 CLI 中：`--engine-version`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要用于新数据库集群的数据库引擎的版本号。 示例：`1.2.1.0` + **GlobalClusterIdentifier**（在 CLI 中：`--global-cluster-identifier`）– GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 应向其中添加此新数据库集群的 Neptune 全球数据库的 ID。 + **KmsKeyId**（在 CLI 中：`--kms-key-id`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 加密数据库集群的 Amazon KMS 密钥标识符。 KMS 密钥标识符是 KMS 加密密钥的 Amazon 资源名称 (ARN)。如果您创建数据库集群时使用的 Amazon 账户，是拥有加密新数据库集群所用 KMS 加密密钥的同一个账户，则您可以使用 KMS 密钥别名来取代 KMS 加密密钥的 ARN。 未在 `KmsKeyId` 中指定加密密钥时： + 如果 `ReplicationSourceIdentifier` 标识了加密的源，则 Amazon Neptune 将使用加密源所用的加密密钥。否则，Amazon Neptune 将使用您的默认加密密钥。 + 如果 `StorageEncrypted` 参数为 true，并且未指定 `ReplicationSourceIdentifier`，则 Amazon Neptune 将使用您的默认加密密钥。 Amazon KMS 将为您的 Amazon 账户创建默认加密密钥。您的 Amazon 账户在每个 Amazon 区域都有一个不同的默认加密密钥。 如果您在其它 Amazon 区域中创建加密数据库集群的只读副本，则必须将 `KmsKeyId` 设置为在目标 Amazon 区域中有效的 KMS 密钥 ID。此密钥用于在该 Amazon 区域中加密只读副本。 + **Port**（在 CLI 中：`--port`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 数据库集群中的实例接受连接的端口号。 默认值：`8182` + **PreferredBackupWindow**（在 CLI 中：`--preferred-backup-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 使用 `BackupRetentionPeriod` 参数启用了自动备份时，自动执行备份的日常时间范围。 默认值为从每个 Amazon 区域的 8 小时时段中随机选择的 30 分钟时间。要查看可用的时段，请参阅《Amazon Neptune 用户指南》**中的 [Neptune 维护时段](https://docs.aws.amazon.com/neptune/latest/userguide/manage-console-maintaining.html#manage-console-maintaining-window)。 约束： + 必须采用 `hh24:mi-hh24:mi` 格式。 + 必须采用通用协调时间（UTC）。 + 不得与首选维护时段冲突。 + 必须至少为 30 分钟。 + **PreferredMaintenanceWindow**（在 CLI 中：`--preferred-maintenance-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 可进行系统维护的每周时间范围（采用通用协调时间（UTC））。 格式：`ddd:hh24:mi-ddd:hh24:mi` 默认值为每个 Amazon 区域 8 小时的时段中随机选择的 30 分钟时段（随机选取周中的某天进行）。要查看可用的时段，请参阅《Amazon Neptune 用户指南》**中的 [Neptune 维护时段](https://docs.aws.amazon.com/neptune/latest/userguide/manage-console-maintaining.html#manage-console-maintaining-window)。 有效值：Mon、Tue、Wed、Thu、Fri、Sat、Sun。 约束：至少为 30 分钟的时段。 + **PreSignedUrl**（在 CLI 中：`--pre-signed-url`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 当前不支持此参数。 + **ReplicationSourceIdentifier**（在 CLI 中：`--replication-source-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 源数据库实例或数据库集群（如果该数据库集群是作为只读副本创建的）的 Amazon 资源名称 (ARN)。 + **ServerlessV2ScalingConfiguration**（在 CLI 中：`--serverless-v2-scaling-configuration`）– [ServerlessV2ScalingConfiguration](api-datatypes.md#ServerlessV2ScalingConfiguration) 对象。 包含 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **StorageEncrypted**（在 CLI 中：`--storage-encrypted`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType**（在 CLI 中：`--storage-type`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 新数据库集群的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序配置经济实惠的数据库存储。设置为 `standard` 时，响应中不返回存储类型。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **Tags**：（在 CLI 中：`--tags`）[标签](api-other-apis.md#Tag) 对象的数组。 分配到新数据库集群的标签。 + **VpcSecurityGroupIds**（在 CLI 中：`--vpc-security-group-ids`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要与此数据库集群关联的 EC2 VPC 安全组的列表。 **响应** 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 + **AllocatedStorage** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – [DBClusterRole](#DBClusterRole) 对象的数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – [DBClusterMember](#DBClusterMember) 对象的数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** – 一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** – 一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。 提供数据库集群所属的 VPC 安全组的列表。 **错误** + [DBClusterAlreadyExistsFault](api-faults.md#DBClusterAlreadyExistsFault) + [InsufficientStorageClusterCapacityFault](api-faults.md#InsufficientStorageClusterCapacityFault) + [DBClusterQuotaExceededFault](api-faults.md#DBClusterQuotaExceededFault) + [StorageQuotaExceededFault](api-faults.md#StorageQuotaExceededFault) + [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault) + [InvalidVPCNetworkStateFault](api-faults.md#InvalidVPCNetworkStateFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) + [InvalidDBSubnetGroupStateFault](api-faults.md#InvalidDBSubnetGroupStateFault) + [InvalidSubnet](api-faults.md#InvalidSubnet) + [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault) + [DBClusterParameterGroupNotFoundFault](api-faults.md#DBClusterParameterGroupNotFoundFault) + [KMSKeyNotAccessibleFault](api-faults.md#KMSKeyNotAccessibleFault) + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [DBInstanceNotFoundFault](api-faults.md#DBInstanceNotFoundFault) + [DBSubnetGroupDoesNotCoverEnoughAZs](api-faults.md#DBSubnetGroupDoesNotCoverEnoughAZs) + [GlobalClusterNotFoundFault](api-faults.md#GlobalClusterNotFoundFault) + [InvalidGlobalClusterStateFault](api-faults.md#InvalidGlobalClusterStateFault) ## DeleteDBCluster（操作）         此 API 的 AWS CLI 名称为：`delete-db-cluster`。 DeleteDBCluster 操作将删除先前预置的数据库集群。在您删除数据库集群时，会删除该数据库集群的所有自动备份，且无法恢复。系统不会删除指定数据库集群的手动数据库集群快照。 请注意，如果启用了删除保护，则无法删除数据库集群。要删除数据库集群，您必须先将其 `DeletionProtection` 字段设置为 `False`。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要删除的数据库集群的数据库集群标识符。该参数不区分大小写。 约束： + 必须匹配现有 DBClusterIdentifier。 + **FinalDBSnapshotIdentifier**（在 CLI 中：`--final-db-snapshot-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 `SkipFinalSnapshot` 设置为 `false` 时，新创建数据库集群快照的数据库集群快照标识符。 **注意** 指定此参数并且将 `SkipFinalShapshot` 参数设置为 true 会导致错误。 约束： + 必须为 1 到 255 个字母、数字或连字符。 + 第一个字符必须是字母 + 不能以连字符结束或包含两个连续连字符 + **SkipFinalSnapshot**（在 CLI 中：`--skip-final-snapshot`）– 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 确定删除数据库集群之前是否创建最终数据库集群快照。如果指定 `true`，则不创建数据库集群快照。如果指定 `false`，则删除数据库集群之前创建一个数据库集群快照。 **注意** 如果 `FinalDBSnapshotIdentifier` 为 `SkipFinalSnapshot`，则必须指定 `false`。 默认值：`false` **响应** 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 + **AllocatedStorage** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – [DBClusterRole](#DBClusterRole) 对象的数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – [DBClusterMember](#DBClusterMember) 对象的数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** – 一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** – 一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。 提供数据库集群所属的 VPC 安全组的列表。 **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) + [DBClusterSnapshotAlreadyExistsFault](api-faults.md#DBClusterSnapshotAlreadyExistsFault) + [SnapshotQuotaExceededFault](api-faults.md#SnapshotQuotaExceededFault) + [InvalidDBClusterSnapshotStateFault](api-faults.md#InvalidDBClusterSnapshotStateFault) ## ModifyDBCluster（操作）         此 API 的 AWS CLI 名称为：`modify-db-cluster`。 修改数据库集群的设置。您可通过在请求中指定这些参数以及新值，更改一个或多个数据库配置参数。 **请求** + **AllowMajorVersionUpgrade**（在 CLI 中：`--allow-major-version-upgrade`）– 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 一个指示是否允许在不同的主要版本之间进行升级的值。 约束：当提供使用与数据库集群当前版本不同的主要版本的 `EngineVersion` 参数时，必须设置 allow-major-version-upgrade 标志。 + **ApplyImmediately**（在 CLI 中：`--apply-immediately`）– 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定应尽快异步应用此请求中修改及任何待处理修改的值，无论数据库集群的 `PreferredMaintenanceWindow` 设置如何。如果此参数设置为 `false`，则在下一个维护时段中应用对数据库集群的更改。 `ApplyImmediately` 参数仅影响 `NewDBClusterIdentifier` 值。如果将 `ApplyImmediately` 参数值设置为 false，则对 `NewDBClusterIdentifier` 值的更改在下一维护时段中应用。所有其他更改会立即应用，而不管 `ApplyImmediately` 参数的值如何。 默认值：`false` + **BackupRetentionPeriod**（在 CLI 中：`--backup-retention-period`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 自动备份的保留天数。您必须指定最小值 1。 默认值：1 约束： + 值必须介于 1 到 35 之间 + **CloudwatchLogsExportConfiguration**（在 CLI 中：`--cloudwatch-logs-export-configuration`） – [CloudwatchLogsExportConfiguration](#CloudwatchLogsExportConfiguration) 对象。 要启用日志类型的配置设置，以便针对特定数据库集群导出到 CloudWatch Logs。请参阅[使用 CLI 将 Neptune 审计日志发布到 CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html#cloudwatch-logs-cli)。 + **CopyTagsToSnapshot**（在 CLI 中：`--copy-tags-to-snapshot`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要修改的集群的数据库集群标识符。此参数不区分大小写。 约束： + 必须匹配现有 DBCluster 的标识符。 + **DBClusterParameterGroupName**（在 CLI 中：`--db-cluster-parameter-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 用于数据库集群的数据库集群参数组名称。 + **DBInstanceParameterGroupName**（在 CLI 中：`--db-instance-parameter-group-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 应用于数据库集群所有实例的数据库参数组的名称。 **注意** 使用 `DBInstanceParameterGroupName` 应用参数组时，参数更改不会在下一个维护时段内应用，而是会立即应用。 默认：现有名称设置 约束： + 数据库参数组必须与目标数据库集群版本位于同一个数据库参数组系列中。 + `DBInstanceParameterGroupName` 参数仅在与 `AllowMajorVersionUpgrade` 参数组合使用时才有效。 + **DeletionProtection**（在 CLI 中：`--deletion-protection`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 一个值，指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。默认情况下，将禁用删除保护。 + **EnableIAMDatabaseAuthentication**（在 CLI 中：`--enable-iam-database-authentication`）– BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果启用 Amazon Identity and Access Management (IAM) 账户与数据库账户之间的映射，则为 true；否则为 false。 默认值：`false` + **EngineVersion**（在 CLI 中：`--engine-version`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要升级到的数据库引擎的版本号。更改此参数会导致中断。除非 `ApplyImmediately` 参数设置为 true，否则会在下个维护时段内应用更改。 有关有效引擎版本的列表，请参阅 [Amazon Neptune 的引擎版本](https://docs.aws.amazon.com/neptune/latest/userguide/engine-releases.html)，或调用 [DescribeDBEngineVersions（操作）](api-other-apis.md#DescribeDBEngineVersions)。 + **NewDBClusterIdentifier**（在 CLI 中：`--new-db-cluster-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 重命名数据库集群时数据库集群的新标识符。此值以一个小写字符串存储。 约束： + 必须包含 1 到 63 个字母、数字或连字符 + 第一个字符必须是字母 + 不能以连字符结束或包含两个连续连字符 示例：`my-cluster2` + **Port**（在 CLI 中：`--port`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 数据库集群用于接受连接的端口号。 约束：值必须为 `1150-65535` 默认值：与原始数据库集群相同的端口。 + **PreferredBackupWindow**（在 CLI 中：`--preferred-backup-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 使用 `BackupRetentionPeriod` 参数启用了自动备份时，自动执行备份的日常时间范围。 默认值为从每个 Amazon 区域的 8 小时时段中随机选择的 30 分钟时间。 约束： + 必须采用 `hh24:mi-hh24:mi` 格式。 + 必须采用通用协调时间（UTC）。 + 不得与首选维护时段冲突。 + 必须至少为 30 分钟。 + **PreferredMaintenanceWindow**（在 CLI 中：`--preferred-maintenance-window`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 可进行系统维护的每周时间范围（采用通用协调时间（UTC））。 格式：`ddd:hh24:mi-ddd:hh24:mi` 默认值为每个 Amazon 区域 8 小时的时段中随机选择的 30 分钟时段（随机选取周中的某天进行）。 有效值：Mon、Tue、Wed、Thu、Fri、Sat、Sun。 约束：至少为 30 分钟的时段。 + **ServerlessV2ScalingConfiguration**（在 CLI 中：`--serverless-v2-scaling-configuration`） – [ServerlessV2ScalingConfiguration](api-datatypes.md#ServerlessV2ScalingConfiguration) 对象。 包含 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **StorageType**（在 CLI 中：`--storage-type`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 与数据库集群关联的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序配置经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroupIds**（在 CLI 中：`--vpc-security-group-ids`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所属的 VPC 安全组的列表。 **响应** 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 + **AllocatedStorage** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – [DBClusterRole](#DBClusterRole) 对象的数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – [DBClusterMember](#DBClusterMember) 对象的数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** – 一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** – 一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。 提供数据库集群所属的 VPC 安全组的列表。 **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) + [StorageQuotaExceededFault](api-faults.md#StorageQuotaExceededFault) + [DBSubnetGroupNotFoundFault](api-faults.md#DBSubnetGroupNotFoundFault) + [InvalidVPCNetworkStateFault](api-faults.md#InvalidVPCNetworkStateFault) + [InvalidDBSubnetGroupStateFault](api-faults.md#InvalidDBSubnetGroupStateFault) + [InvalidSubnet](api-faults.md#InvalidSubnet) + [DBClusterParameterGroupNotFoundFault](api-faults.md#DBClusterParameterGroupNotFoundFault) + [InvalidDBSecurityGroupStateFault](api-faults.md#InvalidDBSecurityGroupStateFault) + [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault) + [DBClusterAlreadyExistsFault](api-faults.md#DBClusterAlreadyExistsFault) + [StorageTypeNotSupportedFault](api-faults.md#StorageTypeNotSupportedFault) ## StartDBCluster（操作）         此 API 的 AWS CLI 名称为：`start-db-cluster`。 启动已通过 Amazon 控制台、Amazon CLI stop-db-cluster 命令或 StopDBCluster API 停止的 Amazon Neptune 数据库集群。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要启动的 Neptune 数据库集群的数据库集群标识符。该参数作为一个小写字符串存储。 **响应** 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 + **AllocatedStorage** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – [DBClusterRole](#DBClusterRole) 对象的数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – [DBClusterMember](#DBClusterMember) 对象的数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** – 一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** – 一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。 提供数据库集群所属的 VPC 安全组的列表。 **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) + [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault) ## StopDBCluster（操作）         此 API 的 AWS CLI 名称为：`stop-db-cluster`。 停止 Amazon Neptune 数据库集群。在停止数据库集群时，Neptune 将保留数据库集群的元数据，包括其终端节点和数据库参数组。 此外，Neptune 将保留事务日志，以便您可以在必要时执行时间点还原。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要停止的 Neptune 数据库集群的数据库集群标识符。该参数作为一个小写字符串存储。 **响应** 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 + **AllocatedStorage** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – [DBClusterRole](#DBClusterRole) 对象的数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – [DBClusterMember](#DBClusterMember) 对象的数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** – 一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** – 一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。 提供数据库集群所属的 VPC 安全组的列表。 **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) + [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault) ## AddRoleToDBCluster（操作）         此 API 的 AWS CLI 名称为：`add-role-to-db-cluster`。 将 Identity and Access Management (IAM) 角色与 Neptune 数据库集群关联。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 IAM 角色与之关联的数据库集群的名称。 + **FeatureName**（在 CLI 中：`--feature-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 IAM 角色要关联的 Neptune 数据库集群的特征的名称。有关支持的特征名称的列表，请参阅[DBEngineVersion（结构）](api-other-apis.md#DBEngineVersion)。 + **RoleArn**（在 CLI 中：`--role-arn`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 与 Neptune 数据库集群关联的 IAM 角色的 Amazon 资源名称 (ARN)，例如 `arn:aws:iam::123456789012:role/NeptuneAccessRole`。 **响应** + *无响应参数。* **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [DBClusterRoleAlreadyExistsFault](api-faults.md#DBClusterRoleAlreadyExistsFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) + [DBClusterRoleQuotaExceededFault](api-faults.md#DBClusterRoleQuotaExceededFault) ## RemoveRoleFromDBCluster（操作）         此 API 的 AWS CLI 名称为：`remove-role-from-db-cluster`。 取消数据库集群与 Identity and Access Management (IAM) 角色的关联。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 从中取消与 IAM 角色关联的数据库集群的名称。 + **FeatureName**（在 CLI 中：`--feature-name`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要取消与 IAM 角色关联的数据库集群的特征的名称。有关支持的特征名称的列表，请参阅[DescribeDBEngineVersions（操作）](api-other-apis.md#DescribeDBEngineVersions)。 + **RoleArn**（在 CLI 中：`--role-arn`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要取消与数据库集群关联的 IAM 角色的 Amazon 资源名称 (ARN)，例如 `arn:aws:iam::123456789012:role/NeptuneAccessRole`。 **响应** + *无响应参数。* **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [DBClusterRoleNotFoundFault](api-faults.md#DBClusterRoleNotFoundFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) ## FailoverDBCluster（操作）         此 API 的 AWS CLI 名称为：`failover-db-cluster`。 强制数据库集群失效转移。 数据库集群的故障转移会将数据库集群中的只读副本之一（只读实例）提升为主实例（集群写入器）。 Amazon Neptune 在主实例发生故障时自动故障转移到只读副本（如果存在）。当您要模拟主实例的故障以进行测试时，可以强制进行故障转移。由于数据库集群中的每个实例都有自己的终端节点地址，您需要在故障转移完成后清理并重新建立使用这些终端节点地址的任何现有连接。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 用于强制进行故障转移的数据库集群标识符。此参数不区分大小写。 约束： + 必须匹配现有 DBCluster 的标识符。 + **TargetDBInstanceIdentifier**（在 CLI 中：`--target-db-instance-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提升为主实例的实例的名称。 您必须指定数据库集群中只读副本的实例标识符。例如 `mydbcluster-replica1`。 **响应** 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 + **AllocatedStorage** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – [DBClusterRole](#DBClusterRole) 对象的数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – [DBClusterMember](#DBClusterMember) 对象的数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** – 一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** – 一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。 提供数据库集群所属的 VPC 安全组的列表。 **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) + [InvalidDBInstanceStateFault](api-faults.md#InvalidDBInstanceStateFault) ## PromoteReadReplicaDBCluster（操作）         此 API 的 AWS CLI 名称为：`promote-read-replica-db-cluster`。 不支持。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– *必需：*一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不支持。 **响应** 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 + **AllocatedStorage** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – [DBClusterRole](#DBClusterRole) 对象的数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – longOptional，类型为：`long`（带符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – [DBClusterMember](#DBClusterMember) 对象的数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** – 一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** – 一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象的数组。 提供数据库集群所属的 VPC 安全组的列表。 **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) + [InvalidDBClusterStateFault](api-faults.md#InvalidDBClusterStateFault) ## DescribeDBClusters（操作）         此 API 的 AWS CLI 名称为：`describe-db-clusters`。 返回有关预配置的数据库集群的信息，并支持分页。 **注意** 此操作还可以返回 Amazon RDS 集群和 Amazon DocDB 集群的信息。 **请求** + **DBClusterIdentifier**（在 CLI 中：`--db-cluster-identifier`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 用户提供的数据库集群标识符。如果指定了此参数，则只返回特定数据库集群的信息。该参数不区分大小写。 约束： + 如果提供，则必须匹配现有 DBClusterIdentifier。 + **Filters**：（在 CLI 中：`--filters`）[筛选条件](api-datatypes.md#Filter) 对象的数组。 筛选条件指定要描述的一个或多个数据库集群。 支持的筛选条件： + `db-cluster-id` - 接受数据库集群标识符和数据库集群 Amazon 资源名称 (ARN)。结果列表中仅包含由这些 ARN 确定的数据库集群的相关信息。 + `engine` - 接受引擎名称（例如 `neptune`），并将结果列表限制为由该引擎创建的数据库集群。 例如，要从 Amazon CLI 调用此 API 并进行筛选，以便仅返回 Neptune 数据库集群，您可以使用以下命令： **Example** ``` aws neptune describe-db-clusters \ --filters Name=engine,Values=neptune ``` + **Marker**（在 CLI 中：`--marker`）– 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 由之前的 [DescribeDBClusters（操作）](#DescribeDBClusters) 请求提供的可选分页标记。如果指定此参数，则响应仅包含标记之外的记录，最大数量为 `MaxRecords` 指定的值。 + **MaxRecords**（在 CLI 中：`--max-records`）– IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 包括在响应中的最大记录数。如果存在的记录数超过了指定的`MaxRecords` 值，则在响应中包含称为标记的分页记号，以便检索剩余的结果。 默认值：100 约束：最低为 20，最高为 100。 **响应** + **DBClusters** – [DBCluster](#DBCluster) 对象的数组。 包含用户的数据库集群列表。 + **Marker** – 一个字符串，类型为：`string`（UTF-8 编码的字符串）。 分页标记，您可在后续的 DescribeDBClusters 请求中使用。 **错误** + [DBClusterNotFoundFault](api-faults.md#DBClusterNotFoundFault) ## *结构：* ## DBCluster（结构） 包含 Amazon Neptune 数据库集群的详细信息。 此数据类型用作 [DescribeDBClusters（操作）](#DescribeDBClusters) 中的响应元素。 **Fields** + **AllocatedStorage** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 `AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **AssociatedRoles** – 这是 [DBClusterRole](#DBClusterRole) 对象数组。 提供与数据库集群关联的 Amazon Identity and Access Management（IAM）角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。 + **AutomaticRestartTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 数据库集群将自动重启的时间。 + **AvailabilityZones** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供可在其上创建数据库集群中实例的 EC2 可用区的列表。 + **BacktrackConsumedChangeRecords** – 这是 longOptional，类型为：`long`（有符号的 64 位整数）。 不受 Neptune 支持。 + **BacktrackWindow** – 这是 longOptional，类型为：`long`（有符号的 64 位整数）。 不受 Neptune 支持。 + **BackupRetentionPeriod** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定自动数据库快照的保留天数。 + **Capacity** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 不受 Neptune 支持。 + **CloneGroupId** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 标识数据库集群与之关联的克隆组。 + **ClusterCreateTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定创建数据库集群的时间，采用通用协调时间 (UTC)。 + **CopyTagsToSnapshot** – 这是 BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 *如果设置为 `true`，则标签将复制到所创建的数据库集群的任何快照中。* + **CrossAccountClone** – 这是 BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 如果设置为 `true`，则可以跨账户克隆数据库集群。 + **DatabaseName** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含此数据库集群在创建时提供的初始数据库的名称（如果在创建数据库集群时指定了初始数据库）。在数据库集群的使用期间会始终返回同一名称。 + **DBClusterArn** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 Amazon 资源名称 (ARN)。 + **DBClusterIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。 + **DBClusterMembers** – 这是 [DBClusterMember](#DBClusterMember) 对象数组。 提供组成数据库集群的实例的列表。 + **DBClusterParameterGroup** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的数据库集群参数组名称。 + **DbClusterResourceId** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群在 Amazon 区域中唯一的不可变标识符。只要访问了数据库集群的 Amazon KMS 密钥，就可在 Amazon CloudTrail 日志条目中找到此标识符。 + **DBSubnetGroup** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定与数据库集群关联的子网组的信息，包括名称、描述和子网组中的子网。 + **DeletionProtection** – 这是 BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 指示数据库集群是否已启用删除保护。在启用删除保护时，无法删除数据库。 + **EarliestBacktrackTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 不受 Neptune 支持。 + **EarliestRestorableTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最早还原时间。 + **EnabledCloudwatchLogsExports** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 此数据库集群配置为导出到 CloudWatch Logs 的日志类型的列表。有效的日志类型有：`audit`（将审计日志发布到 CloudWatch）和慢速查询（将慢速查询日志发布到 CloudWatch）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 + **Endpoint** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的主实例的连接终端节点。 + **Engine** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 提供要用于此数据库集群的数据库引擎的名称。 + **EngineVersion** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指示数据库引擎版本。 + **GlobalClusterIdentifier** – 这是 GlobalClusterIdentifier，类型为：`string`（UTF-8 编码的字符串），不小于 1 或大于 255，与以下正则表达式匹配：`[A-Za-z][0-9A-Za-z-:._]*`。 包含用户提供的全球数据库集群标识符。此标识符是标识全球数据库的唯一键。 + **HostedZoneId** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在您创建托管区域时 Amazon Route 53 分配的 ID。 + **IAMDatabaseAuthenticationEnabled** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果启用了 Amazon Identity and Access Management（IAM）账户与数据库账户之间的映射，则为 true；否则为 false。 + **IOOptimizedNextAllowedModificationTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 下次您可以修改数据库集群以使用 `iopt1` 存储类型。 + **KmsKeyId** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 如果 `StorageEncrypted` 为 true，则为加密数据库集群的 Amazon KMS 密钥标识符。 + **LatestRestorableTime** – 这是 TStamp，类型为：`timestamp`（一个时间点，通常定义为与 1970 年 1 月 1 日午夜的偏移量）。 指定数据库可以使用时间点还原的最新还原时间。 + **MultiAZ** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否在多个可用区中有实例。 + **PendingModifiedValues** –这是一个 [ClusterPendingModifiedValues](#ClusterPendingModifiedValues) 对象。 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 + **PercentProgress** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定操作的进度百分比。 + **Port** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定数据库引擎侦听的端口。 + **PreferredBackupWindow** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定在启用自动备份时，自动执行备份的日常时间范围，如 `BackupRetentionPeriod` 所规定。 + **PreferredMaintenanceWindow** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定可进行系统维护的每周时间范围（采用通用协调时间 (UTC)）。 + **ReaderEndpoint** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的读取器端点。数据库集群的读取器终端节点跨数据库集群中可用的只读副本，实现连接的负载均衡。当客户端请求与读取器终端节点的新连接时，Neptune 将在数据库集群中的只读副本之间分配连接请求。该功能可帮助跨数据库集群中的多个只读副本平衡读取工作负载。 如果发生了故障转移并且连接到的只读副本将提升到主实例，则将删除您的连接。要继续向集群中的其他只读副本发送读取工作负载，您可以随后重新连接到读取器终端节点。 + **ReadReplicaIdentifiers** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 包含一个或多个与此数据库集群关联的只读副本的标识符。 + **ReplicationSourceIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ReplicationType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 不受 Neptune 支持。 + **ServerlessV2ScalingConfiguration** –这是一个 [ServerlessV2ScalingConfigurationInfo](api-datatypes.md#ServerlessV2ScalingConfigurationInfo) 对象。 显示 Neptune 无服务器数据库集群的扩展配置。 有关更多信息，请参阅《Amazon Neptune 用户指南》**中的[使用 Amazon Neptune 无服务器](https://docs.aws.amazon.com/neptune/latest/userguide/neptune-serverless-using.html)。 + **Status** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定此数据库集群的当前状态。 + **StorageEncrypted** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 指定数据库集群是否已加密。 + **StorageType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群所使用的存储类型。 有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。 + **VpcSecurityGroups** – 这是 [VpcSecurityGroupMembership](api-datatypes.md#VpcSecurityGroupMembership) 对象数组。 提供数据库集群所属的 VPC 安全组的列表。 `DBCluster` 用作下列对象的响应元素： + [CreateDBCluster](#CreateDBCluster) + [DeleteDBCluster](#DeleteDBCluster) + [FailoverDBCluster](#FailoverDBCluster) + [ModifyDBCluster](#ModifyDBCluster) + [PromoteReadReplicaDBCluster](#PromoteReadReplicaDBCluster) + [RestoreDBClusterFromSnapshot](api-snapshots.md#RestoreDBClusterFromSnapshot) + [RestoreDBClusterToPointInTime](api-snapshots.md#RestoreDBClusterToPointInTime) + [StartDBCluster](#StartDBCluster) + [StopDBCluster](#StopDBCluster) ## DBClusterMember（结构） 包含有关属于数据库集群的实例的信息。 **Fields** + **DBClusterParameterGroupStatus** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的此成员的数据库集群参数组状态。 + **DBInstanceIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 指定数据库集群的此成员的实例标识符。 + **IsClusterWriter** - 这是一个布尔值，类型为：`boolean` [布尔值（true 或 false）]。 如果集群成员是数据库集群的主实例，值为 `true`，否则为 `false`。 + **PromotionTier** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 该值指定在现有主实例发生故障后将只读副本提升为主实例的顺序。 ## DBClusterRole（结构） 描述与数据库集群关联的 Amazon Identity and Access Management（IAM）角色。 **Fields** + **FeatureName** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 与 Amazon Identity and Access Management（IAM）角色关联的功能的名称。有关支持的特征名称的列表，请参阅[DescribeDBEngineVersions（操作）](api-other-apis.md#DescribeDBEngineVersions)。 + **RoleArn** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 与数据库集群关联的 IAM 角色的 Amazon 资源名称（ARN）。 + **Status** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 描述 IAM 角色与数据库集群之间关联的状态。Status 属性返回以下值之一： + `ACTIVE` - 该 IAM 角色 ARN 已与数据库集群关联，可用于代表您访问其它 Amazon 服务。 + `PENDING` - 与数据库集群关联的 IAM 角色 ARN。 + `INVALID` - 与数据库集群关联的 IAM 角色 ARN，但数据库集群无法代入 IAM 角色以代表您访问其它 Amazon 服务。 ## CloudwatchLogsExportConfiguration（结构） 要启用日志类型的配置设置，以便针对特定数据库实例或数据库集群导出到 CloudWatch Logs。 `EnableLogTypes` 和 `DisableLogTypes` 数组确定要将哪些日志导出（或不导出）到 CloudWatch Logs。 有效的日志类型为：`audit`（用于发布审计日志）和 `slowquery`（用于发布慢速查询日志）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 **Fields** + **DisableLogTypes** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要禁用的日志类型列表。 + **EnableLogTypes** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 要启用的日志类型的列表。 ## PendingCloudwatchLogsExports（结构） 其配置仍处于待处理状态的日志类型的列表。换句话说，这些日志类型正处于激活或停用过程中。 有效的日志类型为：`audit`（用于发布审计日志）和 `slowquery`（用于发布慢速查询日志）。请参阅[将 Neptune 日志发布到 Amazon CloudWatch Logs](https://docs.aws.amazon.com/neptune/latest/userguide/cloudwatch-logs.html)。 **Fields** + **LogTypesToDisable** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 处于启用过程中的日志类型。启用之后，这些日志类型会导出到 CloudWatch Logs。 + **LogTypesToEnable** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 处于停用过程中的日志类型。停用之后，这些日志类型不会导出到 CloudWatch Logs。 ## ClusterPendingModifiedValues（结构） 此数据类型用作 `ModifyDBCluster` 操作中的响应元素，包含将在下一个维护时段期间应用的更改。 **Fields** + **AllocatedStorage** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 分配给数据库引擎的存储空间大小（以 GiB 为单位）。对于 Neptune，`AllocatedStorage` 始终返回 1，因为 Neptune 数据库集群存储大小不固定，而是会根据需要自动调整。 + **BackupRetentionPeriod** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 自动拍摄的数据库快照的保留天数。 + **DBClusterIdentifier** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群的 DBClusterIdentifier 值。 + **EngineVersion** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库引擎版本。 + **IAMDatabaseAuthenticationEnabled** – 这是 BooleanOptional，类型为：`boolean` [布尔值（true 或 false）]。 一个值，指示是否启用 AWS Identity and Access Management (IAM) 账户与数据库账户之间的映射。 + **Iops** – 这是 IntegerOptional，类型为：`integer`（带符号的 32 位整数）。 指定预调配 IOPS（每秒 I/O 操作数）值。此设置仅适用于多可用区数据库集群。 + **PendingCloudwatchLogsExports** –这是一个 [PendingCloudwatchLogsExports](#PendingCloudwatchLogsExports) 对象。 此 `PendingCloudwatchLogsExports` 结构指定了已启用和已禁用 CloudWatch Logs 的待处理更改。 + **StorageType** – 这是一个字符串，类型为：`string`（UTF-8 编码的字符串）。 数据库集群存储类型的待定更改。  有效值： + **`standard`** -（*默认*）为 I/O 使用量适中到较小的应用程序配置经济实惠的数据库存储。 + **`iopt1`** - 启用 [I/O 优化型存储](https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage)，其符合 I/O 密集型图形工作负载的需求，且价格可预测，I/O 延迟低，I/O 吞吐量稳定。 Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。