ModifyDBClusterSnapshotAttribute - Amazon DocumentDB

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ModifyDBClusterSnapshotAttribute

Añade un atributo y valores a una instantánea manual del clúster de base de datos o los elimina.

Para compartir una instantánea manual del clúster con otras Cuentas de AWS personas, especifique restore como parámetro y utilice el ValuesToAdd parámetro para añadir una lista de los identificadores Cuentas de AWS que están autorizados a restaurar la instantánea manual del clúster. AttributeName Utilice el valor all para convertir la instantánea manual del clúster en pública, lo que significa que todas las Cuentas de AWS la pueden copiar o restaurar. No añada el valor all a ninguna instantánea manual del clúster que contenga información privada que no quiera que esté disponible para todas las Cuentas de AWS. Si una instantánea de clúster manual está cifrada, se puede compartir, pero solo especificando una lista de Cuenta de AWS identificadores autorizados para el ValuesToAdd parámetro. No se puede utilizar all como valor para ese parámetro en este caso.

Parámetros de la solicitud

Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.

AttributeName

El nombre del atributo de la instantánea del clúster que se va a modificar.

Para gestionar la autorización para Cuentas de AWS que otros copien o restauren una instantánea de clúster manual, defina este valor enrestore.

Tipo: cadena

Obligatorio: sí

DBClusterSnapshotIdentifier

El identificador para la instantánea del clúster para el que se modifican los atributos.

Tipo: cadena

Obligatorio: sí

ValuesToAdd. AttributeValueN.

Una lista de atributos de la instantánea del clúster que desea añadir al atributo especificado por AttributeName.

Para autorizar a otras Cuentas de AWS personas a copiar o restaurar una instantánea de clúster manual, configure esta lista para que incluya uno o más Cuenta de AWS identificadores. Para que cualquier persona pueda restaurar la instantánea manual del clúster Cuenta de AWS, configúrela en. all No añada el valor all a ninguna instantánea manual del clúster que contenga información privada que no quiera que esté disponible para todas las Cuentas de AWS.

Tipo: matriz de cadenas

Obligatorio: no

ValuesToRemove. AttributeValueN.

Una lista de atributos de la instantánea del clúster que desea eliminar del atributo especificado por AttributeName.

Para eliminar la autorización para Cuentas de AWS que otros copien o restauren una instantánea de clúster manual, configure esta lista para que incluya uno o más Cuenta de AWS identificadores. Para eliminar la autorización para Cuenta de AWS que alguien copie o restaure la instantánea del clúster, configúrela all en. Si lo especificasall, una Cuenta de AWS persona cuyo ID de cuenta se añada explícitamente al restore atributo aún puede copiar o restaurar una instantánea del clúster manual.

Tipo: matriz de cadenas

Obligatorio: no

Elementos de respuesta

El servicio devuelve el siguiente elemento.

DBClusterSnapshotAttributesResult

Información detallada sobre los atributos asociados a una instantánea de clúster.

Tipo: objeto DBClusterSnapshotAttributesResult

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

DBClusterSnapshotNotFoundFault

DBClusterSnapshotIdentifier no hace referencia a una instantánea de un clúster existente.

Código de estado HTTP: 404

InvalidDBClusterSnapshotStateFault

El valor proporcionado no es un estado de instantánea de clúster válido.

Código de estado HTTP: 400

SharedSnapshotQuotaExceeded

Ha superado el número máximo de cuentas con las que puede compartir una instantánea manual de base de datos.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: