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, especifique restore como AttributeName y utilice el parámetro ValuesToAdd para añadir una lista de ID de las Cuentas de AWS autorizadas a restaurar la instantánea manual del clúster. 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 manual del clúster está cifrada, se podrá compartir, pero solo especificando una lista de ID de Cuenta de AWS autorizados para el parámetro ValuesToAdd. 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 administrar la autorización para otras Cuentas de AWS para copiar o restaurar una instantánea manual del clúster, establezca este valor en
restore.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.AttributeValue.N
-
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 a copiar o restaurar una instantánea de clúster manual, configure esta lista para que incluya uno o más ID de Cuenta de AWS. Para que cualquier Cuenta de AWS pueda restaurar la instantánea manual del clúster, configúrela en
all. No añada el valoralla 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
Requerido: no
- ValuesToRemove.AttributeValue.N
-
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 que otras Cuentas de AWS copien o restauren una instantánea de clúster manual, configure esta lista para que incluya uno o más identificadores de Cuenta de AWS. Para eliminar la autorización para que cualquier Cuenta de AWS copie o restaure la instantánea del clúster, configúrela en
all. Si especificaall, una Cuenta de AWS cuyo ID de cuenta se añade explícitamente al atributorestorepuede seguir copiando o restaurando una instantánea manual del clúster.Tipo: matriz de cadenas
Requerido: 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
-
DBClusterSnapshotIdentifierno 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 un SDK de AWS de un idioma específico, consulte:
