ModifyDBClusterSnapshotAttribute
Adiciona um atributo e os valores ou remove um atributo e os valores de um snapshot do cluster de banco de dados manual.
Para compartilhar um snapshot de cluster manual com outros Contas da AWS, especifique restore como o AttributeName, e use o parâmetro ValuesToAdd para adicionar uma lista de IDs do Contas da AWS que estão autorizados a restaurar o snapshot de cluster manual. Use o valor all para tornar público o instantâneo manual do cluster, o que significa que ele pode ser copiado ou restaurado por todos os Contas da AWS. Não adicione o valor all de nenhum snapshot de cluster manual que contenha informações privadas que você não deseja que estejam disponíveis para todos Contas da AWS. Se um instantâneo de cluster manual for criptografado, ele poderá ser compartilhado, mas somente especificando uma lista de IDs Conta da AWS autorizadas para o parâmetro ValuesToAdd. Você não pode usar all como um valor para esse parâmetro nesse caso.
Parâmetros de solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.
- AttributeName
-
O nome do atributo do snapshot do cluster de banco de dados a ser modificado.
Para gerenciar a autorização para que outros Contas da AWS copiem ou restaurem um snapshot manual do cluster, defina esse valor como
restore.Tipo: String
Obrigatório: Sim
- DBClusterSnapshotIdentifier
-
O identificador do snapshot do cluster de banco de dados cujos atributos serão modificados.
Tipo: String
Obrigatório: Sim
- ValuesToAdd.AttributeValue.N
-
Uma lista de atributos de snapshot do cluster de banco de dados a serem adicionados ao atributo especificado por
AttributeName.Para autorizar outro Contas da AWS a copiar ou restaurar um snapshot manual do cluster, defina essa lista para incluir uma ou mais IDs Conta da AWS. Para tornar o snapshot manual do cluster restaurável por qualquer Conta da AWS, defina-o como
all. Não adicione o valorallpara nenhum snapshot de cluster manual que contenha informações privadas que você não deseja que estejam disponíveis para todos os Contas da AWS.Tipo: Matriz de strings
Obrigatório: Não
- ValuesToRemove.AttributeValue.N
-
Uma lista de atributos de snapshot do cluster de banco de dados a serem removidos do atributo especificado por
AttributeName.Para remover a autorização para que Contas da AWS copie ou restaure um snapshot manual do cluster, defina essa lista para incluir um ou mais identificadores Conta da AWS. Para remover a autorização para que Conta da AWS copie ou restaure o snapshot do cluster, defina-o como
all. Se você especificarall, uma Conta da AWS cuja ID de conta seja explicitamente adicionada ao atributorestoreainda poderá copiar ou restaurar um instantâneo de cluster manual.Tipo: Matriz de strings
Obrigatório: Não
Elementos de Resposta
O elemento a seguir é retornado pelo serviço.
- DBClusterSnapshotAttributesResult
-
Informações detalhadas sobre os atributos associados a um snapshot de cluster.
Tipo: objeto DBClusterSnapshotAttributesResult
Erros
Para obter informações sobre erros comuns a todas as ações, consulte Erros comuns.
- DBClusterSnapshotNotFoundFault
-
DBClusterSnapshotIdentifiernão se refere a um snapshot de cluster existente.Código de Status HTTP: 404
- InvalidDBClusterSnapshotStateFault
-
O valor fornecido não é um estado de snapshot de cluster válido.
Código de Status HTTP: 400
- SharedSnapshotQuotaExceeded
-
Você excedeu o número máximo de contas com as quais você pode compartilhar um DB snapshot manual.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
