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

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

ModifyDBClusterSnapshotAttribute

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

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

请求参数

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

AttributeName

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

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

类型:字符串

必需:是

DBClusterSnapshotIdentifier

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

类型:字符串

必需:是

ValuesToAdd。 AttributeValue.N

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

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

类型:字符串数组

必需:否

ValuesToRemove。 AttributeValue.N

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

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

类型:字符串数组

必需:否

响应元素

服务返回以下元素。

DBClusterSnapshotAttributesResult

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

类型:DBClusterSnapshotAttributesResult 对象

错误

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

DBClusterSnapshotNotFoundFault

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

HTTP 状态代码:404

InvalidDBClusterSnapshotStateFault

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

HTTP 状态代码:400

SharedSnapshotQuotaExceeded

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

HTTP 状态代码:400

另请参阅

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