ModifyDBClusterSnapshotAttribute
属性および値を、手動クラスタースナップショットに追加するか、削除します。
手動クラスタースナップショットを他の AWS アカウント と共有するには、restore を AttributeName として指定し、ValuesToAdd パラメータを使用して手動クラスタスナップショットの復元を許可された AWS アカウント の ID リストを追加します。値 all を使用して、手動クラスタースナップショットを公開します。これは、すべての AWS アカウント によってコピーまたは復元できることを意味します。すべての all に利用させたくないプライベート情報を含む手動クラスタースナップショットの AWS アカウント 値は追加しません。手動クラスタースナップショットが暗号化されている場合、 AWS アカウント パラメータに認可された ValuesToAdd の ID リストを指定することによってのみ共有できます。この場合、そのパラメータの値として all を使用することはできません。
リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
- AttributeName
-
変更するクラスタースナップショット属性名。
手動クラスタースナップショットをコピーまたは復元するための他の AWS アカウント の権限を管理するには、この値を
restoreに設定します。タイプ: 文字列
必須: はい
- DBClusterSnapshotIdentifier
-
属性を変更するクラスタースナップショットの識別子。
タイプ: 文字列
必須: はい
- ValuesToAdd.AttributeValue.N
-
AttributeNameで指定された属性に追加するクラスタースナップショット属性のリスト。他の AWS アカウント に手動クラスタースナップショットのコピーまたは復元を許可するには、このリストに 1 つ以上の AWS アカウント の ID を含めて設定します。手動クラスタースナップショットを任意の AWS アカウント で復元するには、それを
allに設定します。すべてのallに利用させたくないプライベート情報を含む手動クラスタースナップショットの AWS アカウント 値は追加しません。型: 文字列の配列
必須: いいえ
- ValuesToRemove.AttributeValue.N
-
AttributeNameで指定された属性から削除するクラスタースナップショット属性のリスト。他の AWS アカウント が手動クラスタースナップショットをコピーまたは復元する権限を削除するには、このリストに 1 つ以上の AWS アカウント 識別子を含めて設定します。クラスタースナップショットをコピーまたは復元するための任意の AWS アカウント の権限を削除するには、それを
allに設定します。allを指定しても、アカウント ID が明示的に AWS アカウント 属性に追加されたrestoreは、手動クラスタースナップショットをコピーまたは復元できます。型: 文字列の配列
必須: いいえ
レスポンス要素
以下の要素がサービスによって返されます。
- DBClusterSnapshotAttributesResult
-
クラスタースナップショットに関連付けられている属性の詳細情報。
型: DBClusterSnapshotAttributesResult オブジェクト
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- DBClusterSnapshotNotFoundFault
-
DBClusterSnapshotIdentifierは既存のクラスタースナップショットを参照していません。HTTP ステータスコード: 404
- InvalidDBClusterSnapshotStateFault
-
指定された値は有効なクラスタースナップショット状態ではありません。
HTTP ステータスコード: 400
- SharedSnapshotQuotaExceeded
-
手動 DB スナップショットを共有できるアカウントの最大数を超えました。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
