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á.
UpdateAnalysisPermissions
Atualiza as permissões de leitura e gravação para uma análise.
Sintaxe da solicitação
PUT /accounts/AwsAccountId/analyses/AnalysisId/permissions HTTP/1.1
Content-type: application/json
{
"GrantPermissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
],
"RevokePermissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
]
}Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AnalysisId
-
O ID da análise cujas permissões que você está atualizando. O ID faz parte da URL de análise.
Restrições de tamanho: Tamanho mínimo de 1. Tamanho máximo de 2048.
Padrão:
[\w\-]+Obrigatório: Sim
- AwsAccountId
-
O ID daAWSconta que contém a análise cujas permissões você está atualizando. Você deve estar usandoAWSconta em que a análise está.
Restrições de tamanho: Comprimento fixo de 12.
Padrão:
^[0-9]{12}$Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- GrantPermissions
-
Uma estrutura que descreve as permissões a serem adicionadas e o principal para adicioná-las.
Type: Matriz deResourcePermissionobjetos
Membros da matriz: Número máximo de 100 itens.
Obrigatório: Não
- RevokePermissions
-
Uma estrutura que descreve as permissões a serem removidas e as principais das quais removê-las.
Type: Matriz deResourcePermissionobjetos
Membros da matriz: Número máximo de 100 itens.
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"AnalysisArn": "string",
"AnalysisId": "string",
"Permissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
],
"RequestId": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
- Status
-
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
- AnalysisArn
-
O nome de recurso da Amazon (ARN) da análise que você atualizou.
Type: String
- AnalysisId
-
O ID da análise para a qual você atualizou permissões.
Type: String
Restrições de tamanho: Tamanho mínimo de 1. Tamanho máximo de 2048.
Padrão:
[\w\-]+ - Permissions
-
Uma estrutura que descreve os principais e as permissões em nível de recurso em uma análise.
Type: Matriz deResourcePermissionobjetos
Membros da matriz: Número mínimo de 1 item. Número máximo de 64 itens.
- RequestId
-
OAWSID da solicitação para essa operação.
Type: String
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulteErros comuns.
- ConflictException
-
Atualizar ou excluir um recurso pode causar um estado inconsistente.
Código de status HTTP: 409
- InternalFailureException
-
Ocorreu um erro interno.
Código de status HTTP: 500
- InvalidParameterValueException
-
Um ou mais parâmetros têm um valor que não é válido.
Código de status HTTP: 400
- ResourceNotFoundException
-
Não foi possível encontrar um ou mais recursos.
Código de status HTTP: 404
- ThrottlingException
-
O acesso é limitado.
Código de status HTTP: 429
- UnsupportedUserEditionException
-
Esse erro indica que você está chamando uma operação em uma Amazon QuickSightassinatura em que a edição não inclui suporte para essa operação. Amazon Amazon QuickSight No momento, está disponível na Standard Edition e Enterprise Edition. Nem todas operações e recursos estão disponível em todas as edições.
Código de status HTTP: 403
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
