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á.
UpdateDataSetPermissions
Atualiza as permissões em um conjunto de dados.
O recurso de permissões éarn:aws:quicksight:region:aws-account-id:dataset/data-set-id.
Sintaxe da solicitação
POST /accounts/AwsAccountId/data-sets/DataSetId/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.
- AwsAccountId
-
O ID da conta da AWS.
Restrições de tamanho: Comprimento fixo de 12.
Padrão:
^[0-9]{12}$Obrigatório: Sim
- DataSetId
-
O ID do conjunto de dados cujas permissões você deseja atualizar. Esse ID é único porRegião da AWSpara cadaAWSconta.
Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- GrantPermissions
-
As permissões de recurso que você deseja conceder ao conjunto de dados.
Type: Matriz deResourcePermissionobjetos
Membros da matriz: Número mínimo de 1 item. Número máximo de 64 itens.
Obrigatório: Não
- RevokePermissions
-
As permissões de recurso que você deseja revogar do conjunto de dados.
Type: Matriz deResourcePermissionobjetos
Membros da matriz: Número mínimo de 1 item. Número máximo de 64 itens.
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"DataSetArn": "string",
"DataSetId": "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.
- DataSetArn
-
O nome de recurso da Amazon (ARN) do conjunto de dados.
Type: String
- DataSetId
-
O ID do conjunto de dados cujas permissões você deseja atualizar. Esse ID é único porRegião da AWSpara cadaAWSconta.
Type: String
- 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.
- AccessDeniedException
-
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight se suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.
Código de status HTTP: 401
- 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
Exemplos
Exemplo
Este exemplo ilustra um uso de UpdateDataSetPermissions.
Exemplo de solicitação
POST /accounts/{AwsAccountId}/data-sets/{DataSetId}/permissions HTTP/1.1
Content-type: application/jsonConsulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
