ModifyDBClusterSnapshotAttribute - Amazon DocumentDB

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

ModifyDBClusterSnapshotAttribute

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

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

请求参数

有关所有操作的通用参数的信息,请参阅通用参数

AttributeName

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

要管理其他 AWS 账户 人复制或恢复手动集群快照的授权,请将此值设置为restore

类型:字符串

必需:是

DBClusterSnapshotIdentifier

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

类型:字符串

必需:是

ValuesToAdd。 AttributeValue.N

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

要授权其他 AWS 账户 人复制或恢复手动集群快照,请将此列表设置为包括一个或多个快照 AWS 账户 IDs。要使手动集群快照可由任何人恢复 AWS 账户,请all将其设置为。若任何手动集群快照包含您不想向所有 AWS 账户公开的私有信息,请不要添加 all 值。

类型:字符串数组

必需:否

ValuesToRemove。 AttributeValue.N

要从 AttributeName 所指定属性中移除的集群快照属性的列表。

要取消其他 AWS 账户 人复制或恢复手动集群快照的授权,请将此列表设置为包含一个或多个 AWS 账户 标识符。要取消任何 AWS 账户 人复制或恢复集群快照的授权,请将其设置为all。如果您指定all,则 AWS 账户 其账户 ID 已明确添加到restore属性中的用户仍可以复制或恢复手动集群快照。

类型:字符串数组

必需:否

响应元素

服务返回以下元素。

DBClusterSnapshotAttributesResult

有关集群快照关联属性的详细信息。

类型:DBClusterSnapshotAttributesResult 对象

错误

有关所有操作的常见错误的信息,请参阅常见错误

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier 并不引用现有集群快照。

HTTP 状态代码:404

InvalidDBClusterSnapshotStateFault

提供的值不是有效的集群快照状态。

HTTP 状态代码:400

SharedSnapshotQuotaExceeded

您已超过您可与其共享手动数据库快照的最大账户数。

HTTP 状态代码:400

另请参阅

有关以特定语言之一使用此 API 的更多信息 AWS SDKs,请参阅以下内容: