As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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 manual do cluster com outro Contas da AWS, especifique restore como o. AttributeName e use o ValuesToAdd parâmetro para adicionar uma lista de IDs dos Contas da AWS que estão autorizados a restaurar o snapshot manual do cluster. 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 snapshot manual do cluster for criptografado, ele poderá ser compartilhado, mas somente especificando uma lista de Conta da AWS IDs autorizados para o ValuesToAdd parâmetro. Você não pode usar all como um valor para esse parâmetro nesse caso.
Parâmetros da 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 Contas da AWS que outra pessoa copie ou restaure um snapshot manual do cluster, defina
restoreesse valor como.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. AttributeValueN.
-
Uma lista de atributos de snapshot do cluster de banco de dados a serem adicionados ao atributo especificado por
AttributeName.Para autorizar outra pessoa Contas da AWS a copiar ou restaurar um snapshot manual do cluster, defina essa lista para incluir uma ou mais Conta da AWS IDs. Para tornar o snapshot manual do cluster restaurável por qualquer um Conta da AWS, defina-o como.
allNã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. AttributeValueN.
-
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 Contas da AWS que outra pessoa copie ou restaure um snapshot manual do cluster, defina essa lista para incluir um ou mais Conta da AWS identificadores. Para remover a autorização de qualquer Conta da AWS pessoa para copiar ou restaurar o snapshot do cluster, defina-o como.
allSe você especificarall, um Conta da AWS cujo ID de conta seja explicitamente adicionado aorestoreatributo ainda poderá copiar ou restaurar um snapshot manual do cluster.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 AWS SDKs específicos da linguagem, consulte o seguinte:
