ModifyDBClusterSnapshotAttribute - Amazon DocumentDB

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

ModifyDBClusterSnapshotAttribute

Ajoute un attribut et des valeurs ou supprime un attribut et des valeurs d'un instantané de cluster manuel.

Pour partager un instantané de cluster manuel avec d'autres personnes Comptes AWSAttributeName, spécifiez restore comme ValuesToAdd paramètre et utilisez le paramètre pour ajouter une liste des Comptes AWS identifiants autorisés à restaurer l'instantané de cluster manuel. Utilisez cette valeur all pour rendre public le cliché manuel du cluster, ce qui signifie qu'il peut être copié ou restauré par tous Comptes AWS. N'ajoutez aucune all valeur aux instantanés de cluster manuels contenant des informations privées que vous ne souhaitez pas voir accessibles à tous Comptes AWS. Si un instantané de cluster manuel est chiffré, il peut être partagé, mais uniquement en spécifiant une liste d' Compte AWS identifiants autorisés pour le ValuesToAdd paramètre. Dans ce cas, vous ne pouvez pas utiliser all comme une valeur pour ce paramètre.

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

AttributeName

Nom de l'attribut de capture d'écran du cluster à modifier.

Pour gérer l'autorisation permettant Comptes AWS à d'autres personnes de copier ou de restaurer un instantané de cluster manuel, définissez cette valeur surrestore.

Type : chaîne

Obligatoire : oui

DBClusterSnapshotIdentifier

Identifiant du cliché du cluster dont les attributs doivent être modifiés.

Type : chaîne

Obligatoire : oui

ValuesToAdd. AttributeValueN.

Liste des attributs de capture d'écran du cluster à ajouter à l'attribut spécifié parAttributeName.

Pour autoriser d'autres Comptes AWS utilisateurs à copier ou à restaurer un instantané de cluster manuel, configurez cette liste pour inclure un ou plusieurs Compte AWS identifiants. Pour que l'instantané manuel du cluster puisse être restauré par n'importe qui Compte AWS, définissez-le surall. N'ajoutez aucune all valeur aux instantanés de cluster manuels contenant des informations privées que vous ne souhaitez pas rendre accessibles à tous Comptes AWS.

Type : tableau de chaînes

Obligatoire : non

ValuesToRemove. AttributeValueN.

Liste des attributs de capture d'écran du cluster à supprimer de l'attribut spécifié parAttributeName.

Pour supprimer l'autorisation permettant Comptes AWS à d'autres utilisateurs de copier ou de restaurer un instantané de cluster manuel, configurez cette liste pour inclure un ou plusieurs Compte AWS identifiants. Pour supprimer l'autorisation permettant Compte AWS à quiconque de copier ou de restaurer l'instantané du cluster, définissez-le surall. Si vous le spécifiezall, un Compte AWS utilisateur dont l'ID de compte est explicitement ajouté à l'restoreattribut peut toujours copier ou restaurer un instantané de cluster manuel.

Type : tableau de chaînes

Obligatoire : non

Éléments de réponse

L'élément suivant est renvoyé par le service.

DBClusterSnapshotAttributesResult

Informations détaillées sur les attributs associés à un instantané de cluster.

Type : objet DBClusterSnapshotAttributesResult

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifierne fait pas référence à un instantané de cluster existant.

Code d’état HTTP : 404

InvalidDBClusterSnapshotStateFault

La valeur fournie n'est pas un état de capture d'écran de cluster valide.

Code d’état HTTP : 400

SharedSnapshotQuotaExceeded

Vous avez dépassé le nombre maximal de comptes avec lesquels vous pouvez partager un instantané de base de données manuel.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :