本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Neptune 快照 API
操作:
结构:
创建DBCluster快照(操作)
此 AP AWS I 的 CLI 名称是:create-db-cluster-snapshot。
创建数据库集群的快照。
请求
-
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)Tag 对象的数组。要分配给数据库集群快照的标签。
响应
包含 Amazon Neptune 数据库集群快照的详细信息
此数据类型用作 描述DBCluster快照(操作) 操作中的响应元素。
-
AllocatedStorage – 一个整数,类型为:
integer(带符号的 32 位整数)。指定分配的存储大小(以 GiB 为单位)。
-
AvailabilityZones – 一个字符串,类型为:
string(UTF-8 编码的字符串)。提供可在其中还原数据库集群快照中的实例的 EC2 可用区列表。
-
ClusterCreateTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定创建数据库集群的时间,采用通用协调时间 (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— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。提供获取快照的时间,以通用协调时 (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。
错误
删除DBCluster快照(操作)
此 AP AWS I 的 CLI 名称是:delete-db-cluster-snapshot。
删除数据库集群快照。如果正在复制快照,则复制操作将会终止。
注意
只有处于 available 状态的数据库集群快照才能删除。
请求
-
DBClusterSnapshotIdentifier(在 CLI 中:
--db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。要删除的数据库集群快照的标识符。
约束:必须为处于
available状态的现有数据库集群快照的名称。
响应
包含 Amazon Neptune 数据库集群快照的详细信息
此数据类型用作 描述DBCluster快照(操作) 操作中的响应元素。
-
AllocatedStorage – 一个整数,类型为:
integer(带符号的 32 位整数)。指定分配的存储大小(以 GiB 为单位)。
-
AvailabilityZones – 一个字符串,类型为:
string(UTF-8 编码的字符串)。提供可在其中还原数据库集群快照中的实例的 EC2 可用区列表。
-
ClusterCreateTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定创建数据库集群的时间,采用通用协调时间 (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— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。提供获取快照的时间,以通用协调时 (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。
复制DBCluster快照(操作)
此 AP AWS I 的 CLI 名称是:copy-db-cluster-snapshot。
复制数据库集群的快照。
要从共享的手动数据库集群快照复制数据库集群快照,SourceDBClusterSnapshotIdentifier 必须为共享数据库集群快照的 Amazon 资源名称 (ARN)。
请求
-
CopyTags(在 CLI 中:
--copy-tags)— a BooleanOptional,类型为:boolean(布尔值(真或假))。如果为 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)Tag 对象的数组。分配到新数据库集群快照副本的标签。
-
TargetDBClusterSnapshotIdentifier(在 CLI 中:
--target-db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。要从源数据库集群快照创建的新数据库集群快照标识符。此参数不区分大小写。
约束:
-
必须包含 1 到 63 个字母、数字或连字符。
-
第一个字符必须是字母。
-
不能以连字符结束或包含两个连续连字符。
示例:
my-cluster-snapshot2 -
响应
包含 Amazon Neptune 数据库集群快照的详细信息
此数据类型用作 描述DBCluster快照(操作) 操作中的响应元素。
-
AllocatedStorage – 一个整数,类型为:
integer(带符号的 32 位整数)。指定分配的存储大小(以 GiB 为单位)。
-
AvailabilityZones – 一个字符串,类型为:
string(UTF-8 编码的字符串)。提供可在其中还原数据库集群快照中的实例的 EC2 可用区列表。
-
ClusterCreateTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定创建数据库集群的时间,采用通用协调时间 (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— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。提供获取快照的时间,以通用协调时 (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。
错误
修改 DBClusterSnapshotAttribute (操作)
此 AP AWS I 的 CLI 名称是:modify-db-cluster-snapshot-attribute。
向手动数据库集群快照添加属性和值,或者从中删除属性和值。
要与其他 Amazon 账户共享手动数据库集群快照,请指定restore为,AttributeName并使用ValuesToAdd参数添加有权恢复手动数据库集群快照的 Amazon 账户列表。 IDs 使用值 all 以公开手动数据库集群快照,这意味着所有 Amazon 账户都可以复制或还原它。若任何手动数据库集群快照包含您不想向所有 Amazon 账户公开的私有信息,则不要添加 all 值。如果手动数据库集群快照已加密,则可以共享该快照,但只能通过 IDs 为ValuesToAdd参数指定授权的 Amazon 账户列表来共享。在这种情况下,您不能使用 all 作为该参数的值。
要查看哪些 Amazon 账户有权复制或还原手动数据库集群快照,或者手动数据库集群快照为公有还是私有,请使用描述 DBClusterSnapshotAttributes (操作) API 操作。
请求
-
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 账户 IDs,或者
all将手动数据库集群快照设置为可由任何 Amazon 账户恢复。若任何手动数据库集群快照包含您不想向所有 Amazon 账户公开的私有信息,则不要添加all值。 -
ValuesToRemove(在 CLI 中:
--values-to-remove)– 一个字符串,类型为:string(UTF-8 编码的字符串)。要从
AttributeName所指定属性中删除的数据库集群快照属性的列表。要删除其它 Amazon 账户复制或还原手动数据库集群快照的授权,请设置此列表,在其中包含一个或多个 Amazon 账户标识符,或者设置为
all以删除所有 Amazon 账户复制或还原数据库集群快照的授权。如果您指定all,则其账户 ID 显式添加到restore属性的 Amazon 账户仍可以复制或还原手动数据库集群快照。
响应
包含成功调用描述 DBClusterSnapshotAttributes (操作) API 操作的结果。
手动数据库集群快照属性用于授权其它 Amazon 账户复制或还原手动数据库集群快照。有关更多信息,请参阅 修改 DBClusterSnapshotAttribute (操作) API 操作。
-
DBClusterSnapshotAttributes – DBClusterSnapshotAttribute 对象的数组。
手动数据库集群快照的属性和值的列表。
-
DBClusterSnapshotIdentifier – 一个字符串,类型为:
string(UTF-8 编码的字符串)。属性应用到的手动数据库集群快照的标识符。
恢复 DBClusterFromSnapshot (操作)
此 AP AWS I 的 CLI 名称是:restore-db-cluster-from-snapshot。
从数据库快照或数据库集群快照创建新的数据库集群。
如果指定数据库快照,则使用默认配置和默认安全组,从源数据库快照创建目标数据库集群。
如果指定数据库集群快照,则使用具有与原始源数据库集群相同配置的源数据库集群恢复点,创建目标数据库集群,不同之处在于新数据库集群在默认安全组中创建。
请求
-
AvailabilityZones(在 CLI 中:
--availability-zones)– 一个字符串,类型为:string(UTF-8 编码的字符串)。提供 EC2 可用区列表,还原后的数据库集群中可以在这些可用区中创建实例。
-
CopyTagsToSnapshot(在 CLI 中:
--copy-tags-to-snapshot)— a BooleanOptional,类型为:boolean(布尔值(真或假))。如果设置为
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 编码的字符串)。用于新数据库集群的数据库子网组的名称。
限制:如果提供,则必须与现有 DBSubnet组的名称匹配。
示例:
mySubnetgroup -
DeletionProtection(在 CLI 中:
--deletion-protection)— a BooleanOptional,类型为:boolean(布尔值(真或假))。一个值,指示数据库集群是否已启用删除保护。在启用删除保护时,无法删除数据库。默认情况下,将禁用删除保护。
-
EnableCloudwatchLogsExports(在 CLI 中:
--enable-cloudwatch-logs-exports)– 一个字符串,类型为:string(UTF-8 编码的字符串)。恢复后的数据库集群要导出到 Amazon Logs 的 CloudWatch日志列表。
-
EnableIAMDatabaseAuthentication(在 CLI 中:
--enable-iam-database-authentication)— a BooleanOptional,类型为:boolean(布尔值(真或假))。如果启用 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)— a IntegerOptional,类型为:integer(带符号的 32 位整数)。新数据库集群用于接受连接的端口号。
约束:值必须为
1150-65535默认值:与原始数据库集群相同的端口。
-
ServerlessV2ScalingConfiguration(在 CLI 中:
--serverless-v2-scaling-configuration)– 无服务器 v2 ScalingConfiguration 对象。包含 Neptune 无服务器数据库集群的扩展配置。
有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器。
-
SnapshotIdentifier(在 CLI 中:
--snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。要从中进行还原的数据库快照或数据库集群快照的标识符。
您可以使用名称或 Amazon 资源名称(ARN) 指定数据库集群快照。但是,您只能使用 ARN 指定数据库快照。
约束:
-
必须与现有快照的标识符匹配。
-
-
StorageType(在 CLI 中:
--storage-type)– 一个字符串,类型为:string(UTF-8 编码的字符串)。指定要与数据库集群关联的存储类型。
有效值:
standard、iopt1默认值:
standard -
Tags:(在 CLI 中:
--tags)Tag 对象的数组。要分配给所还原数据库集群的标签。
-
VpcSecurityGroupIds(在 CLI 中:
--vpc-security-group-ids)– 一个字符串,类型为:string(UTF-8 编码的字符串)。新数据库集群所属的 VPC 安全组的列表。
响应
包含 Amazon Neptune 数据库集群的详细信息。
此数据类型用作 描述DBClusters (操作) 中的响应元素。
-
AllocatedStorage— a IntegerOptional,类型为:
integer(带符号的 32 位整数)。AllocatedStorage始终返回 1,因为 Neptune 数据库集群存储大小不固定,而是会根据需要自动调整。 -
AssociatedRoles – DBCluster角色 对象的数组。
提供与数据库集群关联的 Amazon Identity and Access Management(IAM)角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。
-
AutomaticRestartTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。数据库集群将自动重启的时间。
-
AvailabilityZones – 一个字符串,类型为:
string(UTF-8 编码的字符串)。提供可在数据库集群中创建实例的 EC2 可用区列表。
-
BacktrackConsumedChangeRecords— a LongOptional,类型为:
long(有符号的 64 位整数)。不受 Neptune 支持。
-
BacktrackWindow— a LongOptional,类型为:
long(有符号的 64 位整数)。不受 Neptune 支持。
-
BackupRetentionPeriod— a IntegerOptional,类型为:
integer(带符号的 32 位整数)。指定自动数据库快照的保留天数。
-
Capacity— a IntegerOptional,类型为:
integer(带符号的 32 位整数)。不受 Neptune 支持。
-
CloneGroupId – 一个字符串,类型为:
string(UTF-8 编码的字符串)。标识数据库集群与之关联的克隆组。
-
ClusterCreateTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定创建数据库集群的时间,采用通用协调时间 (UTC)。
-
CopyTagsToSnapshot— a BooleanOptional,类型为:
boolean(布尔值(真或假))。如果设置为
true,则标签将复制到所创建的数据库集群的任何快照中。 -
CrossAccountClone— a BooleanOptional,类型为:
boolean(布尔值(真或假))。如果设置为
true,则可以跨账户克隆数据库集群。 -
DatabaseName – 一个字符串,类型为:
string(UTF-8 编码的字符串)。包含此数据库集群在创建时提供的初始数据库的名称(如果在创建数据库集群时指定了初始数据库)。在数据库集群的使用期间会始终返回同一名称。
-
DBClusterArn – 一个字符串,类型为:
string(UTF-8 编码的字符串)。数据库集群的 Amazon 资源名称 (ARN)。
-
DBClusterIdentifier – 一个字符串,类型为:
string(UTF-8 编码的字符串)。包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。
-
DBClusterMembers – DBCluster会员 对象的数组。
提供组成数据库集群的实例的列表。
-
DBClusterParameterGroup – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定数据库集群的数据库集群参数组名称。
-
DbClusterResourceId – 一个字符串,类型为:
string(UTF-8 编码的字符串)。数据库集群在 Amazon 区域中唯一的不可变标识符。每当访问数据库集群的 Amazon KMS 密钥时,都会在亚马逊 CloudTrail 日志条目中找到此标识符。
-
DBSubnetGroup – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定与数据库集群关联的子网组的信息,包括名称、描述和子网组中的子网。
-
DeletionProtection— a BooleanOptional,类型为:
boolean(布尔值(真或假))。指示数据库集群是否已启用删除保护。在启用删除保护时,无法删除数据库。
-
EarliestBacktrackTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。不受 Neptune 支持。
-
EarliestRestorableTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定通过还原可以将数据库 point-in-time还原到的最早时间。
-
EnabledCloudwatchLogsExports – 一个字符串,类型为:
string(UTF-8 编码的字符串)。此数据库集群配置为导出到 CloudWatch日志的日志类型列表。有效的日志类型有:
audit(将审核日志发布到 CloudWatch)和慢查询(将慢查询日志发布到)。 CloudWatch请参阅将 Nep tune 日志发布到亚马逊 CloudWatch 日志。 -
Endpoint – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定数据库集群的主实例的连接终端节点。
-
Engine – 一个字符串,类型为:
string(UTF-8 编码的字符串)。提供要用于此数据库集群的数据库引擎的名称。
-
EngineVersion – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指示数据库引擎版本。
-
GlobalClusterIdentifier— a GlobalClusterIdentifier,类型为:
string(UTF-8 编码的字符串),不小于 1 或大于 255? st? s,匹配这个正则表达式:[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— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。下次您可以修改数据库集群以使用
iopt1存储类型。 -
KmsKeyId – 一个字符串,类型为:
string(UTF-8 编码的字符串)。如果
StorageEncrypted为 true,则为加密数据库集群的 Amazon KMS 密钥标识符。 -
LatestRestorableTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定通过还原可以将数据库 point-in-time还原到的最晚时间。
-
MultiAZ - 一个布尔值,类型为:
boolean[布尔值(true 或 false)]。指定数据库集群是否在多个可用区中有实例。
-
PendingModifiedValues – 一个 ClusterPendingModifiedValues 对象。
此数据类型用作
ModifyDBCluster操作中的响应元素,包含将在下一个维护时段期间应用的更改。 -
PercentProgress – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定操作的进度百分比。
-
Port— a 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 – 一个 无服务器 v2 ScalingConfigurationInfo 对象。
显示 Neptune 无服务器数据库集群的扩展配置。
有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器。
-
Status – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定此数据库集群的当前状态。
-
StorageEncrypted - 一个布尔值,类型为:
boolean[布尔值(true 或 false)]。指定数据库集群是否已加密。
-
StorageType – 一个字符串,类型为:
string(UTF-8 编码的字符串)。数据库集群所使用的存储类型。
有效值:
-
standard—(默认)为中等到小 I/O 使用量的应用程序提供经济实惠的数据库存储。 -
iopt1— 支持专为满足吞吐量I/O-intensive graph workloads that require predictable pricing with low I/O latency and consistent I/O需求而设计的 I/O 优化存储。Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。
-
-
VpcSecurityGroups – VpcSecurityGroupMembership 对象的数组。
提供数据库集群所属的 VPC 安全组的列表。
错误
恢复 DBClusterToPointInTime (操作)
此 AP AWS I 的 CLI 名称是:restore-db-cluster-to-point-in-time。
将数据库集群还原到任意时间点。用户可以还原到 LatestRestorableTime 之前最多 BackupRetentionPeriod 天的任意时间点。使用具有与原始数据库集群相同配置的源数据库集群创建目标数据库集群,不同之处在于新数据库集群在默认数据库安全组中创建。
注意
此操作仅还原数据库集群,而不还原该数据库集群的数据库实例。您必须调用创建DBInstance (操作)操作为还原的数据库集群创建数据库实例,并在 DBClusterIdentifier 中指定还原的数据库集群的标识符。只有在完成 RestoreDBClusterToPointInTime 操作并且数据库集群可用后,您才能创建数据库实例。
请求
-
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 编码的字符串)。要用于新数据库集群的数据库子网组名称。
限制:如果提供,则必须与现有 DBSubnet组的名称匹配。
示例:
mySubnetgroup -
DeletionProtection(在 CLI 中:
--deletion-protection)— a BooleanOptional,类型为:boolean(布尔值(真或假))。一个值,指示数据库集群是否已启用删除保护。在启用删除保护时,无法删除数据库。默认情况下,将禁用删除保护。
-
EnableCloudwatchLogsExports(在 CLI 中:
--enable-cloudwatch-logs-exports)– 一个字符串,类型为:string(UTF-8 编码的字符串)。恢复后的数据库集群要导出到 CloudWatch日志的日志列表。
-
EnableIAMDatabaseAuthentication(在 CLI 中:
--enable-iam-database-authentication)— a BooleanOptional,类型为:boolean(布尔值(真或假))。如果启用 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)— a IntegerOptional,类型为:integer(带符号的 32 位整数)。新数据库集群用于接受连接的端口号。
约束:值必须为
1150-65535默认值:与原始数据库集群相同的端口。
-
RestoreToTime(在 CLI 中:
--restore-to-time)— a TStamp,类型为:timestamp(一个时间点,通常定义为从 1970-01-01 午夜开始的偏移量)。要将数据库集群还原到的日期和时间。
有效值:值必须为通用协调时间 (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) – 无服务器 v2 ScalingConfiguration 对象。包含 Neptune 无服务器数据库集群的扩展配置。
有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器。
-
SourceDBClusterIdentifier(在 CLI 中:
--source-db-cluster-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。要从中还原的源数据库集群的标识符。
约束:
-
必须与现有标识符匹配 DBCluster。
-
-
StorageType(在 CLI 中:
--storage-type)– 一个字符串,类型为:string(UTF-8 编码的字符串)。指定要与数据库集群关联的存储类型。
有效值:
standard、iopt1默认值:
standard -
Tags:(在 CLI 中:
--tags)Tag 对象的数组。要应用到所还原数据库集群的标签。
-
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 数据库集群的详细信息。
此数据类型用作 描述DBClusters (操作) 中的响应元素。
-
AllocatedStorage— a IntegerOptional,类型为:
integer(带符号的 32 位整数)。AllocatedStorage始终返回 1,因为 Neptune 数据库集群存储大小不固定,而是会根据需要自动调整。 -
AssociatedRoles – DBCluster角色 对象的数组。
提供与数据库集群关联的 Amazon Identity and Access Management(IAM)角色的列表。与数据库集群关联的 IAM 角色授予数据库集群代表您访问其他 Amazon 服务的权限。
-
AutomaticRestartTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。数据库集群将自动重启的时间。
-
AvailabilityZones – 一个字符串,类型为:
string(UTF-8 编码的字符串)。提供可在数据库集群中创建实例的 EC2 可用区列表。
-
BacktrackConsumedChangeRecords— a LongOptional,类型为:
long(有符号的 64 位整数)。不受 Neptune 支持。
-
BacktrackWindow— a LongOptional,类型为:
long(有符号的 64 位整数)。不受 Neptune 支持。
-
BackupRetentionPeriod— a IntegerOptional,类型为:
integer(带符号的 32 位整数)。指定自动数据库快照的保留天数。
-
Capacity— a IntegerOptional,类型为:
integer(带符号的 32 位整数)。不受 Neptune 支持。
-
CloneGroupId – 一个字符串,类型为:
string(UTF-8 编码的字符串)。标识数据库集群与之关联的克隆组。
-
ClusterCreateTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定创建数据库集群的时间,采用通用协调时间 (UTC)。
-
CopyTagsToSnapshot— a BooleanOptional,类型为:
boolean(布尔值(真或假))。如果设置为
true,则标签将复制到所创建的数据库集群的任何快照中。 -
CrossAccountClone— a BooleanOptional,类型为:
boolean(布尔值(真或假))。如果设置为
true,则可以跨账户克隆数据库集群。 -
DatabaseName – 一个字符串,类型为:
string(UTF-8 编码的字符串)。包含此数据库集群在创建时提供的初始数据库的名称(如果在创建数据库集群时指定了初始数据库)。在数据库集群的使用期间会始终返回同一名称。
-
DBClusterArn – 一个字符串,类型为:
string(UTF-8 编码的字符串)。数据库集群的 Amazon 资源名称 (ARN)。
-
DBClusterIdentifier – 一个字符串,类型为:
string(UTF-8 编码的字符串)。包含用户提供的数据库集群标识符。此标识符是识别数据库集群的唯一键。
-
DBClusterMembers – DBCluster会员 对象的数组。
提供组成数据库集群的实例的列表。
-
DBClusterParameterGroup – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定数据库集群的数据库集群参数组名称。
-
DbClusterResourceId – 一个字符串,类型为:
string(UTF-8 编码的字符串)。数据库集群在 Amazon 区域中唯一的不可变标识符。每当访问数据库集群的 Amazon KMS 密钥时,都会在亚马逊 CloudTrail 日志条目中找到此标识符。
-
DBSubnetGroup – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定与数据库集群关联的子网组的信息,包括名称、描述和子网组中的子网。
-
DeletionProtection— a BooleanOptional,类型为:
boolean(布尔值(真或假))。指示数据库集群是否已启用删除保护。在启用删除保护时,无法删除数据库。
-
EarliestBacktrackTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。不受 Neptune 支持。
-
EarliestRestorableTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定通过还原可以将数据库 point-in-time还原到的最早时间。
-
EnabledCloudwatchLogsExports – 一个字符串,类型为:
string(UTF-8 编码的字符串)。此数据库集群配置为导出到 CloudWatch日志的日志类型列表。有效的日志类型有:
audit(将审核日志发布到 CloudWatch)和慢查询(将慢查询日志发布到)。 CloudWatch请参阅将 Nep tune 日志发布到亚马逊 CloudWatch 日志。 -
Endpoint – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定数据库集群的主实例的连接终端节点。
-
Engine – 一个字符串,类型为:
string(UTF-8 编码的字符串)。提供要用于此数据库集群的数据库引擎的名称。
-
EngineVersion – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指示数据库引擎版本。
-
GlobalClusterIdentifier— a GlobalClusterIdentifier,类型为:
string(UTF-8 编码的字符串),不小于 1 或大于 255? st? s,匹配这个正则表达式:[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— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。下次您可以修改数据库集群以使用
iopt1存储类型。 -
KmsKeyId – 一个字符串,类型为:
string(UTF-8 编码的字符串)。如果
StorageEncrypted为 true,则为加密数据库集群的 Amazon KMS 密钥标识符。 -
LatestRestorableTime— a TStamp,类型为:
timestamp(时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定通过还原可以将数据库 point-in-time还原到的最晚时间。
-
MultiAZ - 一个布尔值,类型为:
boolean[布尔值(true 或 false)]。指定数据库集群是否在多个可用区中有实例。
-
PendingModifiedValues – 一个 ClusterPendingModifiedValues 对象。
此数据类型用作
ModifyDBCluster操作中的响应元素,包含将在下一个维护时段期间应用的更改。 -
PercentProgress – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定操作的进度百分比。
-
Port— a 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 – 一个 无服务器 v2 ScalingConfigurationInfo 对象。
显示 Neptune 无服务器数据库集群的扩展配置。
有关更多信息,请参阅《Amazon Neptune 用户指南》中的使用 Amazon Neptune 无服务器。
-
Status – 一个字符串,类型为:
string(UTF-8 编码的字符串)。指定此数据库集群的当前状态。
-
StorageEncrypted - 一个布尔值,类型为:
boolean[布尔值(true 或 false)]。指定数据库集群是否已加密。
-
StorageType – 一个字符串,类型为:
string(UTF-8 编码的字符串)。数据库集群所使用的存储类型。
有效值:
-
standard—(默认)为中等到小 I/O 使用量的应用程序提供经济实惠的数据库存储。 -
iopt1— 支持专为满足吞吐量I/O-intensive graph workloads that require predictable pricing with low I/O latency and consistent I/O需求而设计的 I/O 优化存储。Neptune I/O 优化型存储仅从引擎版本 1.3.0.0 开始可用。
-
-
VpcSecurityGroups – VpcSecurityGroupMembership 对象的数组。
提供数据库集群所属的 VPC 安全组的列表。
错误
描述DBCluster快照(操作)
此 AP AWS I 的 CLI 名称是:describe-db-cluster-snapshots。
返回有关数据库集群快照的信息。此 API 操作支持分页。
请求
-
DBClusterIdentifier(在 CLI 中:
--db-cluster-identifier)– 一个字符串,类型为:string(UTF-8 编码的字符串)。要为其检索数据库集群快照列表的数据库集群的 ID。此参数不能与
DBClusterSnapshotIdentifier参数结合使用。此参数不区分大小写。约束:
-
如果提供,则必须与现有标识符匹配 DBCluster。
-
-
DBClusterSnapshotIdentifier(在 CLI 中:
--db-cluster-snapshot-identifier)– 一个字符串,类型为:string(UTF-8 编码的字符串)。要描述的特定数据库集群快照标识符。此参数不能与
DBClusterIdentifier参数结合使用。此值以一个小写字符串存储。约束:
-
如果提供,则必须与现有 DBCluster快照的标识符匹配。
-
如果此标识符用于自动快照,则还必须指定
SnapshotType参数。
-
-
Filters:(在 CLI 中:
--filters)筛选条件 对象的数组。当前不支持此参数。
-
IncludePublic(在 CLI 中:
--include-public)– 一个布尔值,类型为:boolean[布尔值(true 或 false)]。如果为 true,则包括可由所有 Amazon 账户复制或还原的公有手动数据库集群快照,否则为 false。默认值为
false。默认值为 false。您可使用 修改 DBClusterSnapshotAttribute (操作) API 操作,将手动数据库集群快照作为公有来共享。
-
IncludeShared(在 CLI 中:
--include-shared)– 一个布尔值,类型为:boolean[布尔值(true 或 false)]。如果为 true,则包括来自其它 Amazon 账户且此 Amazon 账户已获得授权可复制或还原的共享手动数据库集群快照,否则为 false。默认值为
false。您可以通过 修改 DBClusterSnapshotAttribute (操作) API 操作,授予 Amazon 账户权限来还原其它 Amazon 账户的手动数据库集群快照。
-
Marker(在 CLI 中:
--marker)– 一个字符串,类型为:string(UTF-8 编码的字符串)。由之前的
DescribeDBClusterSnapshots请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为MaxRecords指定的值。 -
MaxRecords(在 CLI 中:
--max-records)— a 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,在这些结果中包括公有数据库集群快照。IncludeShared和IncludePublic参数不适用于SnapshotType的值manual或automated。SnapshotType设置为shared时,IncludePublic参数不适用。SnapshotType设置为public时,IncludeShared参数不适用。 -
响应
-
DBClusterSnapshots – DBCluster快照 对象的数组。
提供用户的数据库集群快照的列表。
-
Marker – 一个字符串,类型为:
string(UTF-8 编码的字符串)。由之前的 描述DBCluster快照(操作) 请求提供的可选分页标记。如果指定此参数,则响应仅包含标记之外的记录,最大数量为
MaxRecords指定的值。
描述 DBClusterSnapshotAttributes (操作)
此 AP AWS I 的 CLI 名称是:describe-db-cluster-snapshot-attributes。
返回手动数据库集群快照的数据库集群快照属性名称和值的列表。
与其他亚马逊账户共享快照时,DescribeDBClusterSnapshotAttributes返回有权复制或恢复手动数据库集群快照的亚马逊账户的restore属性和列表。 IDs 如果 restore 属性的值列表中包含了 all,则手动数据库集群快照为公有,可以由所有 Amazon 账户复制或还原。
要为 Amazon 账户添加或删除用于复制或还原手动数据库集群快照的权限,或者使手动数据库集群快照为公有或私有,请使用 修改 DBClusterSnapshotAttribute (操作) API 操作。
请求
-
DBClusterSnapshotIdentifier(在 CLI 中:
--db-cluster-snapshot-identifier)– 必需:一个字符串,类型为:string(UTF-8 编码的字符串)。要描述其属性的数据库集群快照的标识符。
响应
包含成功调用描述 DBClusterSnapshotAttributes (操作) API 操作的结果。
手动数据库集群快照属性用于授权其它 Amazon 账户复制或还原手动数据库集群快照。有关更多信息,请参阅 修改 DBClusterSnapshotAttribute (操作) API 操作。
-
DBClusterSnapshotAttributes – DBClusterSnapshotAttribute 对象的数组。
手动数据库集群快照的属性和值的列表。
-
DBClusterSnapshotIdentifier – 一个字符串,类型为:
string(UTF-8 编码的字符串)。属性应用到的手动数据库集群快照的标识符。
结构:
DBCluster快照(结构)
包含 Amazon Neptune 数据库集群快照的详细信息
此数据类型用作 描述DBCluster快照(操作) 操作中的响应元素。
字段
-
AllocatedStorage – 这是一个整数,类型为:
integer(带符号的 32 位整数)。指定分配的存储大小(以 GiB 为单位)。
-
AvailabilityZones – 这是一个字符串,类型为:
string(UTF-8 编码的字符串)。提供可在其中还原数据库集群快照中的实例的 EC2 可用区列表。
-
ClusterCreateTime— 这是一个 TStamp,类型为:
timestamp(一个时间点,通常定义为从 1970-01-01 年午夜开始的偏移量)。指定创建数据库集群的时间,采用通用协调时间 (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-01-01 年午夜开始的偏移量)。提供获取快照的时间,以通用协调时 (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 账户还原手动数据库集群快照。有关更多信息,请参阅 修改 DBClusterSnapshotAttribute (操作) API 操作。
字段
-
AttributeName – 这是一个字符串,类型为:
string(UTF-8 编码的字符串)。手动数据库集群快照属性的名称。
名为
restore的属性引用有权复制或还原手动数据库集群快照的 Amazon 账户列表。有关更多信息,请参阅 修改 DBClusterSnapshotAttribute (操作) API 操作。 -
AttributeValues – 这是一个字符串,类型为:
string(UTF-8 编码的字符串)。手动数据库集群快照属性的值。
如果该
AttributeName字段设置为restore,则此元素将返回有权复制或恢复手动数据库集群快照的 Amazon 账户的列表。 IDs 如果列表中有值all,则手动数据库集群快照为公有,可供任意 Amazon 账户复制或还原。
DBClusterSnapshotAttributesResult (结构)
包含成功调用描述 DBClusterSnapshotAttributes (操作) API 操作的结果。
手动数据库集群快照属性用于授权其它 Amazon 账户复制或还原手动数据库集群快照。有关更多信息,请参阅 修改 DBClusterSnapshotAttribute (操作) API 操作。
字段
-
DBClusterSnapshotAttributes – 这是 DBClusterSnapshotAttribute 对象数组。
手动数据库集群快照的属性和值的列表。
-
DBClusterSnapshotIdentifier – 这是一个字符串,类型为:
string(UTF-8 编码的字符串)。属性应用到的手动数据库集群快照的标识符。
DBClusterSnapshotAttributesResult 用作下列对象的响应元素: