Neptune 快照 API - Amazon Neptune

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

Neptune 快照 API

操作:

结构:

CreateDBClusterSnapshot(操作)

        此 API 的 AWS CLI 名称为:create-db-cluster-snapshot

创建数据库集群的快照。

Request

  • DBClusterIdentifier(在 CLI 中:--db-cluster-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要为其创建快照的数据库集群的标识符。此参数不区分大小写。

    约束:

    • 必须匹配现有 DBCluster 的标识符。

    例如:my-cluster1

  • DBClusterSnapshotIdentifier(在 CLI 中:--db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    数据库集群快照的标识符。该参数作为一个小写字符串存储。

    约束:

    • 必须包含 1 到 63 个字母、数字或连字符。

    • 第一个字符必须是字母。

    • 不能以连字符结束或包含两个连续连字符。

    例如:my-cluster1-snapshot1

  • Tags:(在 CLI 中:--tags标签 对象的数组。

    要分配给数据库集群快照的标签。

响应

包含 Amazon Neptune 数据库集群快照的详细信息

此数据类型用作 DescribeDBClusterSnapshots(操作) 操作中的响应元素。

  • AllocatedStorage – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定分配的存储大小(以 GiB 为单位)。

  • AvailabilityZones – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照中的实例可以还原到的 EC2 可用区列表。

  • ClusterCreateTime – TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

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

  • DBClusterIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定从中创建了此数据库集群快照的数据库集群的标识符。

  • DBClusterSnapshotArn – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    数据库集群快照的 Amazon 资源名称 (ARN)。

  • DBClusterSnapshotIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库集群快照的标识符。必须与现有快照的标识符匹配。

    在使用 DBClusterSnapshotIdentifier 还原数据库集群后,您必须为该数据库集群的任何将来更新指定相同的 DBClusterSnapshotIdentifier。当您为更新指定此属性时,不会再次从快照还原数据库群集,并且数据库中的数据也不会更改。

    不过,如果您不指定 DBClusterSnapshotIdentifier,则会创建空数据库集群,并删除原始数据库集群。如果指定的属性与以前的快照还原属性不同,则从 DBClusterSnapshotIdentifier 指定的快照中还原数据库集群,并删除原始数据库集群。

  • Engine – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库引擎的名称。

  • EngineVersion – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的数据库引擎的版本。

  • IAMDatabaseAuthenticationEnabled - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    如果启用了 Amazon Identity and Access Management(IAM)账户与数据库账户之间的映射,则为 true;否则为 false。

  • KmsKeyId – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果 StorageEncrypted 为 true,则为加密数据库集群快照的 Amazon KMS 密钥标识符。

  • LicenseModel – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的许可模式信息。

  • PercentProgress – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定估计的已传输数据百分比。

  • Port – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定获取快照时数据库集群侦听的端口。

  • SnapshotCreateTime – TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

    提供获取快照的时间,以通用协调时 (UTC) 表示。

  • SnapshotType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照的类型。

  • SourceDBClusterSnapshotArn – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果数据库集群快照复制自源数据库集群快照,则为源数据库集群快照的 Amazon 资源名称 (ARN),否则为 null 值。

  • Status – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定此数据库集群快照的状态。

  • StorageEncrypted - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    指定是否加密数据库集群快照。

  • StorageType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    与数据库集群快照关联的存储类型。

  • VpcId – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供与数据库集群快照关联的 VPC ID。

DeleteDBClusterSnapshot(操作)

        此 API 的 AWS CLI 名称为:delete-db-cluster-snapshot

删除数据库集群快照。如果正在复制快照,则复制操作将会终止。

注意

只有处于 available 状态的数据库集群快照才能删除。

Request

  • DBClusterSnapshotIdentifier(在 CLI 中:--db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要删除的数据库集群快照的标识符。

    约束:必须为处于 available 状态的现有数据库集群快照的名称。

响应

包含 Amazon Neptune 数据库集群快照的详细信息

此数据类型用作 DescribeDBClusterSnapshots(操作) 操作中的响应元素。

  • AllocatedStorage – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定分配的存储大小(以 GiB 为单位)。

  • AvailabilityZones – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照中的实例可以还原到的 EC2 可用区列表。

  • ClusterCreateTime – TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

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

  • DBClusterIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定从中创建了此数据库集群快照的数据库集群的标识符。

  • DBClusterSnapshotArn – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    数据库集群快照的 Amazon 资源名称 (ARN)。

  • DBClusterSnapshotIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库集群快照的标识符。必须与现有快照的标识符匹配。

    在使用 DBClusterSnapshotIdentifier 还原数据库集群后,您必须为该数据库集群的任何将来更新指定相同的 DBClusterSnapshotIdentifier。当您为更新指定此属性时,不会再次从快照还原数据库群集,并且数据库中的数据也不会更改。

    不过,如果您不指定 DBClusterSnapshotIdentifier,则会创建空数据库集群,并删除原始数据库集群。如果指定的属性与以前的快照还原属性不同,则从 DBClusterSnapshotIdentifier 指定的快照中还原数据库集群,并删除原始数据库集群。

  • Engine – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库引擎的名称。

  • EngineVersion – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的数据库引擎的版本。

  • IAMDatabaseAuthenticationEnabled - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    如果启用了 Amazon Identity and Access Management(IAM)账户与数据库账户之间的映射,则为 true;否则为 false。

  • KmsKeyId – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果 StorageEncrypted 为 true,则为加密数据库集群快照的 Amazon KMS 密钥标识符。

  • LicenseModel – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的许可模式信息。

  • PercentProgress – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定估计的已传输数据百分比。

  • Port – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定获取快照时数据库集群侦听的端口。

  • SnapshotCreateTime – TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

    提供获取快照的时间,以通用协调时 (UTC) 表示。

  • SnapshotType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照的类型。

  • SourceDBClusterSnapshotArn – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果数据库集群快照复制自源数据库集群快照,则为源数据库集群快照的 Amazon 资源名称 (ARN),否则为 null 值。

  • Status – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定此数据库集群快照的状态。

  • StorageEncrypted - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    指定是否加密数据库集群快照。

  • StorageType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    与数据库集群快照关联的存储类型。

  • VpcId – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供与数据库集群快照关联的 VPC ID。

CopyDBClusterSnapshot(操作)

        此 API 的 AWS CLI 名称为:copy-db-cluster-snapshot

复制数据库集群的快照。

要从共享的手动数据库集群快照复制数据库集群快照,SourceDBClusterSnapshotIdentifier 必须为共享数据库集群快照的 Amazon 资源名称 (ARN)。

Request

  • CopyTags(在 CLI 中:--copy-tags)– BooleanOptional,类型为:boolean [布尔值(true 或 false)]。

    如果为 true,则将源数据库集群快照的所有标签复制到目标数据库集群快照;否则为 false。默认值为 false。

  • KmsKeyId(在 CLI 中:--kms-key-id)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    加密数据库集群快照的 Amazon KMS 密钥 ID。KMS 密钥 ID 是 Amazon 资源名称 (ARN)、KMS 密钥标识符或 KMS 加密密钥的 KMS 密钥别名。

    如果您从 Amazon 账户复制加密的数据库集群快照,则可以为 KmsKeyId 指定值来使用新的 KMS 加密密钥加密副本。如果您不为 KmsKeyId 指定值,则使用与源数据库集群快照相同的 KMS 密钥来加密数据库集群快照的副本。

    如果您复制从其它 Amazon 账户共享的加密数据库集群快照,则必须为 KmsKeyId 指定值。

    KMS 加密密钥是特定于创建它们的 Amazon 区域的,您无法将一个 Amazon 区域的加密密钥用于另一个 Amazon 区域。

    您无法在复制时加密未加密的数据库集群快照。如果您尝试复制未加密的数据库集群快照并为 KmsKeyId 参数指定值,则会返回错误。

  • PreSignedUrl(在 CLI 中:--pre-signed-url)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    当前不支持。

  • SourceDBClusterSnapshotIdentifier(在 CLI 中:--source-db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要复制的数据库集群快照的标识符。此参数不区分大小写。

    约束:

    • 必须指定处于“available”状态的有效系统快照。

    • 指定有效的数据库快照标识符。

    例如:my-cluster-snapshot1

  • Tags:(在 CLI 中:--tags标签 对象的数组。

    分配到新数据库集群快照副本的标签。

  • TargetDBClusterSnapshotIdentifier(在 CLI 中:--target-db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要从源数据库集群快照创建的新数据库集群快照标识符。此参数不区分大小写。

    约束:

    • 必须包含 1 到 63 个字母、数字或连字符。

    • 第一个字符必须是字母。

    • 不能以连字符结束或包含两个连续连字符。

    例如:my-cluster-snapshot2

响应

包含 Amazon Neptune 数据库集群快照的详细信息

此数据类型用作 DescribeDBClusterSnapshots(操作) 操作中的响应元素。

  • AllocatedStorage – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定分配的存储大小(以 GiB 为单位)。

  • AvailabilityZones – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照中的实例可以还原到的 EC2 可用区列表。

  • ClusterCreateTime – TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

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

  • DBClusterIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定从中创建了此数据库集群快照的数据库集群的标识符。

  • DBClusterSnapshotArn – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    数据库集群快照的 Amazon 资源名称 (ARN)。

  • DBClusterSnapshotIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库集群快照的标识符。必须与现有快照的标识符匹配。

    在使用 DBClusterSnapshotIdentifier 还原数据库集群后,您必须为该数据库集群的任何将来更新指定相同的 DBClusterSnapshotIdentifier。当您为更新指定此属性时,不会再次从快照还原数据库群集,并且数据库中的数据也不会更改。

    不过,如果您不指定 DBClusterSnapshotIdentifier,则会创建空数据库集群,并删除原始数据库集群。如果指定的属性与以前的快照还原属性不同,则从 DBClusterSnapshotIdentifier 指定的快照中还原数据库集群,并删除原始数据库集群。

  • Engine – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库引擎的名称。

  • EngineVersion – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的数据库引擎的版本。

  • IAMDatabaseAuthenticationEnabled - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    如果启用了 Amazon Identity and Access Management(IAM)账户与数据库账户之间的映射,则为 true;否则为 false。

  • KmsKeyId – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果 StorageEncrypted 为 true,则为加密数据库集群快照的 Amazon KMS 密钥标识符。

  • LicenseModel – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的许可模式信息。

  • PercentProgress – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定估计的已传输数据百分比。

  • Port – 一个整数,类型为:integer(带符号的 32 位整数)。

    指定获取快照时数据库集群侦听的端口。

  • SnapshotCreateTime – TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

    提供获取快照的时间,以通用协调时 (UTC) 表示。

  • SnapshotType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照的类型。

  • SourceDBClusterSnapshotArn – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果数据库集群快照复制自源数据库集群快照,则为源数据库集群快照的 Amazon 资源名称 (ARN),否则为 null 值。

  • Status – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定此数据库集群快照的状态。

  • StorageEncrypted - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    指定是否加密数据库集群快照。

  • StorageType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    与数据库集群快照关联的存储类型。

  • VpcId – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供与数据库集群快照关联的 VPC ID。

ModifyDBClusterSnapshotAttribute(操作)

        此 API 的 AWS CLI 名称为:modify-db-cluster-snapshot-attribute

向手动数据库集群快照添加属性和值,或者从中删除属性和值。

要与其它 Amazon 账户共享手动数据库集群快照,请指定 restore 作为 AttributeName,并使用 ValuesToAdd 参数添加已获得授权可还原手动数据库集群快照的 Amazon 账户的 ID 列表。使用值 all 以公开手动数据库集群快照,这意味着所有 Amazon 账户都可以复制或还原它。若任何手动数据库集群快照包含您不想向所有 Amazon 账户公开的私有信息,则不要添加 all 值。如果手动数据库集群快照已加密,则可以共享它,但只能通过为 ValuesToAdd 参数指定已授权 Amazon 账户 ID 列表来共享。在这种情况下,您不能使用 all 作为该参数的值。

要查看哪些 Amazon 账户有权复制或还原手动数据库集群快照,或者手动数据库集群快照为公有还是私有,请使用DescribeDBClusterSnapshotAttributes(操作) API 操作。

Request

  • AttributeName(在 CLI 中:--attribute-name)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要修改的数据库集群快照属性的名称。

    要管理其它 Amazon 账户复制或还原数据库集群快照的授权,请将此值设置为 restore

  • DBClusterSnapshotIdentifier(在 CLI 中:--db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要修改其属性的数据库集群快照的标识符。

  • ValuesToAdd(在 CLI 中:--values-to-add)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    要添加到 AttributeName 所指定属性中的数据库集群快照属性的列表。

    要授权其它 Amazon 账户复制或还原手动数据库集群快照,请设置此列表,在其中包含一个或多个 Amazon 账户 ID,或者设置为 all 以使手动数据库集群快照可由所有 Amazon 账户还原。若任何手动数据库集群快照包含您不想向所有 Amazon 账户公开的私有信息,则不要添加 all 值。

  • ValuesToRemove(在 CLI 中:--values-to-remove)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    要从 AttributeName 所指定属性中删除的数据库集群快照属性的列表。

    要删除其它 Amazon 账户复制或还原手动数据库集群快照的授权,请设置此列表,在其中包含一个或多个 Amazon 账户标识符,或者设置为 all 以删除所有 Amazon 账户复制或还原数据库集群快照的授权。如果您指定 all,则其账户 ID 显式添加到 restore 属性的 Amazon 账户仍可以复制或还原手动数据库集群快照。

响应

包含成功调用DescribeDBClusterSnapshotAttributes(操作) API 操作的结果。

手动数据库集群快照属性用于授权其它 Amazon 账户复制或还原手动数据库集群快照。有关更多信息,请参阅 ModifyDBClusterSnapshotAttribute(操作) API 操作。

  • DBClusterSnapshotAttributesDBClusterSnapshotAttribute 对象的数组。

    手动数据库集群快照的属性和值的列表。

  • DBClusterSnapshotIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    属性应用到的手动数据库集群快照的标识符。

RestoreDBClusterFromSnapshot(操作)

        此 API 的 AWS CLI 名称为:restore-db-cluster-from-snapshot

从数据库快照或数据库集群快照创建新的数据库集群。

如果指定数据库快照,则使用默认配置和默认安全组,从源数据库快照创建目标数据库集群。

如果指定数据库集群快照,则使用具有与原始源数据库集群相同配置的源数据库集群恢复点,创建目标数据库集群,不同之处在于新数据库集群在默认安全组中创建。

Request

  • AvailabilityZones(在 CLI 中:--availability-zones)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供可在其中创建所还原数据库集群的实例的 EC2 可用区列表。

  • CopyTagsToSnapshot(在 CLI 中:--copy-tags-to-snapshot)– BooleanOptional,类型为:boolean [布尔值(true 或 false)]。

    如果设置为 true,则标签将复制到所创建的已还原数据库集群的任何快照中。

  • DatabaseName(在 CLI 中:--database-name)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    不支持。

  • DBClusterIdentifier(在 CLI 中:--db-cluster-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    从数据库快照或数据库集群快照创建的数据库集群的名称。该参数不区分大小写。

    约束:

    • 必须包含 1 到 63 个字母、数字或连字符

    • 第一个字符必须是字母

    • 不能以连字符结束或包含两个连续连字符

    例如:my-snapshot-id

  • 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 编码的字符串)。

    要导出到 Amazon CloudWatch Logs 的已还原数据库集群的日志列表。

  • EnableIAMDatabaseAuthentication(在 CLI 中:--enable-iam-database-authentication)– BooleanOptional,类型为:boolean [布尔值(true 或 false)]。

    如果启用 Amazon Identity and Access Management (IAM) 账户与数据库账户之间的映射,则为 true;否则为 false。

    默认值:false

  • Engine(在 CLI 中:--engine)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要用于新数据库集群的数据库引擎。

    默认值:与源相同

    约束:必须与源的引擎兼容

  • EngineVersion(在 CLI 中:--engine-version)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    要用于新数据库集群的数据库引擎的版本。

  • KmsKeyId(在 CLI 中:--kms-key-id)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    从数据库快照或数据库集群快照还原加密数据库集群时使用的 Amazon KMS 密钥标识符。

    KMS 密钥标识符是 KMS 加密密钥的 Amazon 资源名称 (ARN)。如果您还原数据库集群所用的 Amazon 的账户,与拥有用于加密新数据库集群所用 KMS 密钥的账户相同,则您可以使用 KMS 密钥别名而不是 KMS 加密密钥的 ARN。

    如果您未指定 KmsKeyId 参数的值,则会出现以下情况:

    • 如果 SnapshotIdentifier 中的数据库快照或数据库集群快照已加密,将使用用于加密数据库快照或数据库集群快照的同一 KMS 密钥加密还原的数据库集群。

    • 如果 SnapshotIdentifier 中的数据库快照或数据库集群快照未加密,还原的数据库集群也不会加密。

  • Port(在 CLI 中:--port)– IntegerOptional,类型为:integer(带符号的 32 位整数)。

    新数据库集群用于接受连接的端口号。

    约束:值必须为 1150-65535

    默认值:与原始数据库集群相同的端口。

  • ServerlessV2ScalingConfiguration(在 CLI 中:--serverless-v2-scaling-configuration)– ServerlessV2ScalingConfiguration 对象。

    包含 Neptune 无服务器数据库集群的扩展配置。

    有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器

  • SnapshotIdentifier(在 CLI 中:--snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要从中进行还原的数据库快照或数据库集群快照的标识符。

    您可以使用名称或 Amazon 资源名称(ARN) 指定数据库集群快照。但是,您只能使用 ARN 指定数据库快照。

    约束:

    • 必须与现有快照的标识符匹配。

  • StorageType(在 CLI 中:--storage-type)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定要与数据库集群关联的存储类型。

    有效值:standardiopt1

    默认值:standard

  • Tags:(在 CLI 中:--tags标签 对象的数组。

    要分配给所还原数据库集群的标签。

  • VpcSecurityGroupIds(在 CLI 中:--vpc-security-group-ids)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    新数据库集群所属的 VPC 安全组的列表。

响应

包含 Amazon Neptune 数据库集群的详细信息。

此数据类型用作 DescribeDBClusters(操作) 中的响应元素。

  • AllocatedStorage – IntegerOptional,类型为:integer(带符号的 32 位整数)。

    AllocatedStorage 始终返回 1,因为 Neptune 数据库集群存储大小不固定,而是会根据需要自动调整。

  • AssociatedRolesDBClusterRole 对象的数组。

    提供与数据库集群关联的 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 编码的字符串)。

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

  • DBClusterMembersDBClusterMember 对象的数组。

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

  • 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

  • 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 对象。

    此数据类型用作 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 对象。

    显示 Neptune 无服务器数据库集群的扩展配置。

    有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器

  • Status – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定此数据库集群的当前状态。

  • StorageEncrypted - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    指定数据库集群是否已加密。

  • StorageType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    数据库集群所使用的存储类型。

    有效值:

    • standard -(默认)为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。

    • iopt1 - 启用 I/O 优化型存储,其符合 I/O 密集型图形工作负载的需求,且价格可预测,I/O 延迟低,I/O 吞吐量稳定。

      Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。

  • VpcSecurityGroupsVpcSecurityGroupMembership 对象的数组。

    提供数据库集群所属的 VPC 安全组的列表。

RestoreDBClusterToPointInTime(操作)

        此 API 的 AWS CLI 名称为:restore-db-cluster-to-point-in-time

将数据库集群还原到任意时间点。用户可以还原到 LatestRestorableTime 之前最多 BackupRetentionPeriod 天的任意时间点。使用具有与原始数据库集群相同配置的源数据库集群创建目标数据库集群,不同之处在于新数据库集群在默认数据库安全组中创建。

注意

此操作仅还原数据库集群,而不还原该数据库集群的数据库实例。您必须调用CreateDBInstance(操作)操作为还原的数据库集群创建数据库实例,并在 DBClusterIdentifier 中指定还原的数据库集群的标识符。只有在完成 RestoreDBClusterToPointInTime 操作并且数据库集群可用后,您才能创建数据库实例。

Request

  • DBClusterIdentifier(在 CLI 中:--db-cluster-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要创建的新数据库集群的名称。

    约束:

    • 必须包含 1 到 63 个字母、数字或连字符

    • 第一个字符必须是字母

    • 不能以连字符结束或包含两个连续连字符

  • 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 的已还原数据库集群的日志列表。

  • EnableIAMDatabaseAuthentication(在 CLI 中:--enable-iam-database-authentication)– BooleanOptional,类型为:boolean [布尔值(true 或 false)]。

    如果启用 Amazon Identity and Access Management (IAM) 账户与数据库账户之间的映射,则为 true;否则为 false。

    默认值:false

  • KmsKeyId(在 CLI 中:--kms-key-id)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    从加密数据库集群快照还原加密数据库集群时使用的 Amazon KMS 密钥标识符。

    KMS 密钥标识符是 KMS 加密密钥的 Amazon 资源名称 (ARN)。如果您还原数据库集群所用的 Amazon 的账户,与拥有用于加密新数据库集群所用 KMS 密钥的账户相同,则您可以使用 KMS 密钥别名而不是 KMS 加密密钥的 ARN。

    您可以还原到新数据库集群,并使用与加密源数据库集群所用密钥不同的 KMS 密钥,加密新数据库集群。新数据库集群使用由 KmsKeyId 参数确定的 KMS 密钥加密。

    如果您未指定 KmsKeyId 参数的值,则会出现以下情况:

    • 如果数据库集群已加密,将使用用于加密源数据库集群的同一 KMS 密钥加密还原的数据库集群。

    • 如果数据库集群未加密,还原的数据库集群也不会加密。

    如果 DBClusterIdentifier 引用未加密的数据库集群,则将拒绝恢复请求。

  • Port(在 CLI 中:--port)– IntegerOptional,类型为:integer(带符号的 32 位整数)。

    新数据库集群用于接受连接的端口号。

    约束:值必须为 1150-65535

    默认值:与原始数据库集群相同的端口。

  • RestoreToTime(在 CLI 中:--restore-to-time) – TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

    要将数据库集群还原到的日期和时间。

    有效值:值必须为通用协调时间 (UTC) 格式的时间

    约束:

    • 必须在数据库实例的最新可还原时间之前

    • 如果未提供 UseLatestRestorableTime 参数,则必须指定

    • 如果 UseLatestRestorableTime 参数为 true,则无法指定

    • 如果 RestoreType 参数为 copy-on-write,则无法指定

    例如:2015-03-07T23:45:00Z

  • RestoreType(在 CLI 中:--restore-type)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    要执行的还原类型。可以指定以下值之一:

    • full-copy – 新数据库集群作为源数据库集群的完整副本还原。

    • copy-on-write – 新数据库集群作为源数据库集群的克隆还原。

    如果您没有指定 RestoreType 值,则新数据库集群作为源数据库集群的完整副本还原。

  • ServerlessV2ScalingConfiguration(在 CLI 中:--serverless-v2-scaling-configuration) – ServerlessV2ScalingConfiguration 对象。

    包含 Neptune 无服务器数据库集群的扩展配置。

    有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器

  • SourceDBClusterIdentifier(在 CLI 中:--source-db-cluster-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要从中还原的源数据库集群的标识符。

    约束:

    • 必须匹配现有 DBCluster 的标识符。

  • StorageType(在 CLI 中:--storage-type)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定要与数据库集群关联的存储类型。

    有效值:standardiopt1

    默认值:standard

  • Tags:(在 CLI 中:--tags标签 对象的数组。

    要应用到所还原数据库集群的标签。

  • UseLatestRestorableTime(在 CLI 中:--use-latest-restorable-time)– 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    值设置为 true 时,将数据库集群还原到最新可还原的备份时间,否则为 false

    默认值:false

    约束:如果未提供 RestoreToTime 参数,则无法指定。

  • VpcSecurityGroupIds(在 CLI 中:--vpc-security-group-ids)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    新数据库集群所属的 VPC 安全组的列表。

响应

包含 Amazon Neptune 数据库集群的详细信息。

此数据类型用作 DescribeDBClusters(操作) 中的响应元素。

  • AllocatedStorage – IntegerOptional,类型为:integer(带符号的 32 位整数)。

    AllocatedStorage 始终返回 1,因为 Neptune 数据库集群存储大小不固定,而是会根据需要自动调整。

  • AssociatedRolesDBClusterRole 对象的数组。

    提供与数据库集群关联的 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 编码的字符串)。

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

  • DBClusterMembersDBClusterMember 对象的数组。

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

  • 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

  • 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 对象。

    此数据类型用作 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 对象。

    显示 Neptune 无服务器数据库集群的扩展配置。

    有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器

  • Status – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定此数据库集群的当前状态。

  • StorageEncrypted - 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    指定数据库集群是否已加密。

  • StorageType – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    数据库集群所使用的存储类型。

    有效值:

    • standard -(默认)为 I/O 使用量适中到较小的应用程序提供经济实惠的数据库存储。

    • iopt1 - 启用 I/O 优化型存储,其符合 I/O 密集型图形工作负载的需求,且价格可预测,I/O 延迟低,I/O 吞吐量稳定。

      Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。

  • VpcSecurityGroupsVpcSecurityGroupMembership 对象的数组。

    提供数据库集群所属的 VPC 安全组的列表。

DescribeDBClusterSnapshots(操作)

        此 API 的 AWS CLI 名称为:describe-db-cluster-snapshots

返回有关数据库集群快照的信息。此 API 操作支持分页。

Request

  • DBClusterIdentifier(在 CLI 中:--db-cluster-identifier)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    要为其检索数据库集群快照列表的数据库集群的 ID。此参数不能与 DBClusterSnapshotIdentifier 参数结合使用。此参数不区分大小写。

    约束:

    • 如果提供,则必须与现有 DBCluster 的标识符匹配。

  • DBClusterSnapshotIdentifier(在 CLI 中:--db-cluster-snapshot-identifier)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    要描述的特定数据库集群快照标识符。此参数不能与 DBClusterIdentifier 参数结合使用。此值以一个小写字符串存储。

    约束:

    • 如果提供,则必须与现有 DBClusterSnapshot 的标识符匹配。

    • 如果此标识符用于自动快照,则还必须指定 SnapshotType 参数。

  • Filters:(在 CLI 中:--filters筛选条件 对象的数组。

    当前不支持此参数。

  • IncludePublic(在 CLI 中:--include-public)– 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    如果为 true,则包括可由所有 Amazon 账户复制或还原的公有手动数据库集群快照,否则为 false。默认为 false。默认值为 false。

    您可使用 ModifyDBClusterSnapshotAttribute(操作) API 操作,将手动数据库集群快照作为公有来共享。

  • IncludeShared(在 CLI 中:--include-shared)– 一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    如果为 true,则包括来自其它 Amazon 账户且此 Amazon 账户已获得授权可复制或还原的共享手动数据库集群快照,否则为 false。默认为 false

    您可以通过 ModifyDBClusterSnapshotAttribute(操作) API 操作,授予 Amazon 账户权限来还原其它 Amazon 账户的手动数据库集群快照。

  • Marker(在 CLI 中:--marker)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    由之前的 DescribeDBClusterSnapshots 请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为 MaxRecords 指定的值。

  • MaxRecords(在 CLI 中:--max-records)– IntegerOptional,类型为:integer(带符号的 32 位整数)。

    包括在响应中的最大记录数。如果存在的记录数超过了指定的MaxRecords 值,则在响应中包含称为标记的分页记号,以便检索剩余的结果。

    默认值:100

    约束:最低为 20,最高为 100。

  • SnapshotType(在 CLI 中:--snapshot-type)– 一个字符串,类型为:string(UTF-8 编码的字符串)。

    要返回的数据库集群快照的类型。可以指定以下值之一:

    • automated - 返回由 Amazon Neptune 为您的 Amazon 账户自动获取的所有数据库集群快照。

    • manual - 返回您的 Amazon 账户获取的所有数据库集群快照。

    • shared - 返回与您 Amazon 账户共享的所有手动数据库集群快照。

    • public – 返回已标记为公有的所有数据库集群快照。

    如果您未指定 SnapshotType 值,则返回自动和手动数据库集群快照。您可以通过将 IncludeShared 参数设置为 true,在这些结果中包括共享数据库集群快照。您可以通过将 IncludePublic 参数设置为 true,在这些结果中包括公有数据库集群快照。

    IncludeSharedIncludePublic 参数不适用于 SnapshotType 的值 manualautomatedSnapshotType 设置为 shared 时,IncludePublic 参数不适用。SnapshotType 设置为 public 时,IncludeShared 参数不适用。

响应

  • DBClusterSnapshotsDBClusterSnapshot 对象的数组。

    提供用户的数据库集群快照的列表。

  • Marker – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    由之前的 DescribeDBClusterSnapshots(操作) 请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为 MaxRecords 指定的值。

DescribeDBClusterSnapshotAttributes(操作)

        此 API 的 AWS CLI 名称为:describe-db-cluster-snapshot-attributes

返回手动数据库集群快照的数据库集群快照属性名称和值的列表。

与其它 Amazon 账户共享快照时,DescribeDBClusterSnapshotAttributes 返回 restore 属性以及已获授权可复制或还原手动数据库集群快照的 Amazon 账户的 ID 列表。如果 restore 属性的值列表中包含了 all,则手动数据库集群快照为公有,可以由所有 Amazon 账户复制或还原。

要为 Amazon 账户添加或删除用于复制或还原手动数据库集群快照的权限,或者使手动数据库集群快照为公有或私有,请使用 ModifyDBClusterSnapshotAttribute(操作) API 操作。

Request

  • DBClusterSnapshotIdentifier(在 CLI 中:--db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。

    要描述其属性的数据库集群快照的标识符。

响应

包含成功调用DescribeDBClusterSnapshotAttributes(操作) API 操作的结果。

手动数据库集群快照属性用于授权其它 Amazon 账户复制或还原手动数据库集群快照。有关更多信息,请参阅 ModifyDBClusterSnapshotAttribute(操作) API 操作。

  • DBClusterSnapshotAttributesDBClusterSnapshotAttribute 对象的数组。

    手动数据库集群快照的属性和值的列表。

  • DBClusterSnapshotIdentifier – 一个字符串,类型为:string(UTF-8 编码的字符串)。

    属性应用到的手动数据库集群快照的标识符。

结构:

DBClusterSnapshot(结构)

包含 Amazon Neptune 数据库集群快照的详细信息

此数据类型用作 DescribeDBClusterSnapshots(操作) 操作中的响应元素。

字段
  • AllocatedStorage – 这是一个整数,类型为:integer(带符号的 32 位整数)。

    指定分配的存储大小(以 GiB 为单位)。

  • AvailabilityZones – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照中的实例可以还原到的 EC2 可用区列表。

  • ClusterCreateTime – 这是 TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

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

  • DBClusterIdentifier – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定从中创建了此数据库集群快照的数据库集群的标识符。

  • DBClusterSnapshotArn – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    数据库集群快照的 Amazon 资源名称 (ARN)。

  • DBClusterSnapshotIdentifier – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库集群快照的标识符。必须与现有快照的标识符匹配。

    在使用 DBClusterSnapshotIdentifier 还原数据库集群后,您必须为该数据库集群的任何将来更新指定相同的 DBClusterSnapshotIdentifier。当您为更新指定此属性时,不会再次从快照还原数据库群集,并且数据库中的数据也不会更改。

    不过,如果您不指定 DBClusterSnapshotIdentifier,则会创建空数据库集群,并删除原始数据库集群。如果指定的属性与以前的快照还原属性不同,则从 DBClusterSnapshotIdentifier 指定的快照中还原数据库集群,并删除原始数据库集群。

  • Engine – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定数据库引擎的名称。

  • EngineVersion – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的数据库引擎的版本。

  • IAMDatabaseAuthenticationEnabled - 这是一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    如果启用了 Amazon Identity and Access Management(IAM)账户与数据库账户之间的映射,则为 true;否则为 false。

  • KmsKeyId – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果 StorageEncrypted 为 true,则为加密数据库集群快照的 Amazon KMS 密钥标识符。

  • LicenseModel – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供此数据库集群快照的许可模式信息。

  • PercentProgress – 这是一个整数,类型为:integer(带符号的 32 位整数)。

    指定估计的已传输数据百分比。

  • Port – 这是一个整数,类型为:integer(带符号的 32 位整数)。

    指定获取快照时数据库集群侦听的端口。

  • SnapshotCreateTime – 这是 TStamp,类型为:timestamp(一个时间点,通常定义为与 1970 年 1 月 1 日午夜的偏移量)。

    提供获取快照的时间,以通用协调时 (UTC) 表示。

  • SnapshotType – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供数据库集群快照的类型。

  • SourceDBClusterSnapshotArn – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    如果数据库集群快照复制自源数据库集群快照,则为源数据库集群快照的 Amazon 资源名称 (ARN),否则为 null 值。

  • Status – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    指定此数据库集群快照的状态。

  • StorageEncrypted - 这是一个布尔值,类型为:boolean [布尔值(true 或 false)]。

    指定是否加密数据库集群快照。

  • StorageType – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    与数据库集群快照关联的存储类型。

  • VpcId – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    提供与数据库集群快照关联的 VPC ID。

DBClusterSnapshot 用作下列对象的响应元素:

DBClusterSnapshotAttribute(结构)

包含手动数据库集群快照属性的名称和值。

手动数据库集群快照属性用于授权其它 Amazon 账户还原手动数据库集群快照。有关更多信息,请参阅 ModifyDBClusterSnapshotAttribute(操作) API 操作。

字段
  • AttributeName – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    手动数据库集群快照属性的名称。

    名为 restore 的属性引用有权复制或还原手动数据库集群快照的 Amazon 账户列表。有关更多信息,请参阅 ModifyDBClusterSnapshotAttribute(操作) API 操作。

  • AttributeValues – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    手动数据库集群快照属性的值。

    如果 AttributeName 字段设置为 restore,则此元素返回已获授权可复制或还原手动数据库集群快照的 Amazon 账户列表。如果列表中有值 all,则手动数据库集群快照为公有,可供任意 Amazon 账户复制或还原。

DBClusterSnapshotAttributesResult(结构)

包含成功调用DescribeDBClusterSnapshotAttributes(操作) API 操作的结果。

手动数据库集群快照属性用于授权其它 Amazon 账户复制或还原手动数据库集群快照。有关更多信息,请参阅 ModifyDBClusterSnapshotAttribute(操作) API 操作。

字段
  • DBClusterSnapshotAttributes – 这是 DBClusterSnapshotAttribute 对象数组。

    手动数据库集群快照的属性和值的列表。

  • DBClusterSnapshotIdentifier – 这是一个字符串,类型为:string(UTF-8 编码的字符串)。

    属性应用到的手动数据库集群快照的标识符。

DBClusterSnapshotAttributesResult 用作下列对象的响应元素: