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á.
UpdateIAMPolicyAssignment
Atualiza uma atribuição de política do IAM existente. Essa operação atualiza somente o parâmetro ou parâmetros opcionais especificados na solicitação. Isso substitui todos os usuários incluídos noIdentities
.
Sintaxe da solicitação
PUT /accounts/AwsAccountId
/namespaces/Namespace
/iam-policy-assignments/AssignmentName
HTTP/1.1
Content-type: application/json
{
"AssignmentStatus": "string
",
"Identities": {
"string
" : [ "string
" ]
},
"PolicyArn": "string
"
}
Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AssignmentName
-
O nome da tarefa, também chamado de regra. Esse nome deve ser exclusivo em umaAWSconta.
Restrições de comprimento: Tamanho mínimo de 1.
Padrão:
(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$
Obrigatório: Sim
- AwsAccountId
-
O ID daAWSconta que contém a atribuição de política do IAM.
Restrições de comprimento: Comprimento fixo de 12.
Padrão:
^[0-9]{12}$
Obrigatório: Sim
- Namespace
-
O namespace da atribuição.
Restrições de comprimento: Tamanho máximo de 64.
Padrão:
^[a-zA-Z0-9._-]*$
Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- AssignmentStatus
-
O status da atribuição. Os valores possíveis são:
-
ENABLED
- Qualquer coisa especificada nesta atribuição é usada ao criar a fonte de dados. -
DISABLED
- Essa atribuição não é usada ao criar a fonte de dados. -
DRAFT
- Essa atribuição é um rascunho inacabado e não é usada ao criar a fonte de dados.
Type: String
Valores válidos:
ENABLED | DRAFT | DISABLED
Obrigatório: Não
-
- Identities
-
A Amazon QuickSight usuários, grupos ou ambos aos quais você deseja atribuir a política.
Type: String para a matriz do mapa de strings
Restrições de comprimento: Tamanho mínimo de 1.
Padrão:
[\u0020-\u00FF]+
Obrigatório: Não
- PolicyArn
-
O ARN da política do IAM a ser aplicada à Amazon QuickSight usuários e grupos especificados nesta atribuição.
Type: String
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"AssignmentId": "string",
"AssignmentName": "string",
"AssignmentStatus": "string",
"Identities": {
"string" : [ "string" ]
},
"PolicyArn": "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.
- AssignmentId
-
O ID da tarefa.
Type: String
- AssignmentName
-
O nome da atribuição ou regra.
Type: String
Restrições de comprimento: Tamanho mínimo de 1.
Padrão:
(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$
- AssignmentStatus
-
O status da atribuição. Os valores possíveis são:
-
ENABLED
- Qualquer coisa especificada nesta atribuição é usada ao criar a fonte de dados. -
DISABLED
- Essa atribuição não é usada ao criar a fonte de dados. -
DRAFT
- Essa atribuição é um rascunho inacabado e não é usada ao criar a fonte de dados.
Type: String
Valores válidos:
ENABLED | DRAFT | DISABLED
-
- Identities
-
A Amazon QuickSight usuários, grupos ou ambos aos quais a política do IAM está atribuída.
Type: String para a matriz do mapa de strings
Restrições de comprimento: Tamanho mínimo de 1.
Padrão:
[\u0020-\u00FF]+
- PolicyArn
-
O ARN para a política do IAM aplicada à Amazon QuickSight usuários e grupos especificados nesta atribuição.
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 as 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
- ConcurrentUpdatingException
-
Um recurso já está em um estado que indica que está acontecendo uma operação que deve ser concluída antes que uma nova atualização possa ser aplicada.
Código de status HTTP: 500
- 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
- ResourceExistsException
-
O recurso especificado já existe.
Código de status HTTP: 409
- 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
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: