UpdateIAMPolicyAssignment -

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

UpdateIAMPolicyAssignment

Actualiza una asignación de directiva de IAM existente. Esta operación actualiza sólo el parámetro opcional o parámetros especificados en la solicitud. Esto sobrescribe todos los usuarios incluidos enIdentities.

Sintaxis de la solicitud

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 de solicitud URI

La solicitud utiliza los siguientes parámetros URI.

NombreDeAsignación

El nombre de la asignación, también denominado regla. Este nombre debe ser único en una cuenta de AWS.

Restricciones: Longitud mínima de 1.

Patrón: (?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$

: obligatorio Sí

AwsAccountId

El ID de la cuenta de AWS que contiene la asignación de política de IAM.

Restricciones: Longitud fija de 12.

Patrón: ^[0-9]{12}$

: obligatorio Sí

Espacio de nombres

El espacio de nombres de la asignación.

Restricciones: La longitud máxima es 64.

Patrón: ^[a-zA-Z0-9._-]*$

: obligatorio Sí

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

AssignmentStatus

Status (Estado): Los valores posibles son los siguientes:

  • ENABLED: cualquier cosa especificada en esta asignación se utiliza al crear el origen de datos.

  • DISABLED: esta asignación no se utiliza al crear el origen de datos.

  • DRAFT: esta asignación es un borrador sin terminar y no se utiliza al crear el origen de datos.

Tipo: Cadena

Valores válidos: ENABLED | DRAFT | DISABLED

: obligatorio No

Identidades

Los usuarios, grupos o ambos de QuickSight a los que desea asignar la directiva.

Tipo: mapa de cadena a matriz de cadenas

Restricciones: Longitud mínima de 1.

Patrón: [\u0020-\u00FF]+

: obligatorio No

PolicyArn

ARN para que la directiva de IAM se aplique a los usuarios y grupos de QuickSight especificados en esta asignación.

Tipo: Cadena

: obligatorio No

Sintaxis de la respuesta

HTTP/1.1 Status Content-type: application/json { "AssignmentId": "string", "AssignmentName": "string", "AssignmentStatus": "string", "Identities": { "string" : [ "string" ] }, "PolicyArn": "string", "RequestId": "string" }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve la respuesta HTTP siguiente.

Estado

El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

AssignmentId

El ID de la asignación.

Tipo: Cadena

NombreDeAsignación

El nombre de la asignación o regla.

Tipo: Cadena

Restricciones: Longitud mínima de 1.

Patrón: (?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$

AssignmentStatus

Status (Estado): Los valores posibles son los siguientes:

  • ENABLED: cualquier cosa especificada en esta asignación se utiliza al crear el origen de datos.

  • DISABLED: esta asignación no se utiliza al crear el origen de datos.

  • DRAFT: esta asignación es un borrador sin terminar y no se utiliza al crear el origen de datos.

Tipo: Cadena

Valores válidos: ENABLED | DRAFT | DISABLED

Identidades

Los usuarios, grupos o ambos de QuickSight a los que está asignada la directiva de IAM.

Tipo: mapa de cadena a matriz de cadenas

Restricciones: Longitud mínima de 1.

Patrón: [\u0020-\u00FF]+

PolicyArn

El ARN para la directiva de IAM aplicado a los usuarios y grupos de QuickSight especificados en esta asignación.

Tipo: Cadena

RequestId

ID de solicitud de AWS de esta operación.

Tipo: Cadena

Errors

Para obtener información sobre errores que son comunes a todas las acciones, consulteErrores comunes.

AccessDeniedException

No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta tiene permiso para utilizar el servicio de Amazon QuickSight, que las políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.

Código de estado HTTP: 401

ConcurrentUpdatingException

Un recurso ya está en un estado que indica que se está produciendo una operación que debe completarse antes de que se pueda aplicar una nueva actualización.

Código de estado HTTP: 500

InternalFailureException

Se produjo un error interno.

Código de estado HTTP: 500

InvalidParameterValueException

Uno o más parámetros tienen un valor que no es válido.

Código de estado HTTP: 400

ResourceExistsException

El recurso especificado ya existe.

Código de estado HTTP: 409

ResourceNotFoundException

No se encuentran uno o varios recursos.

Código de estado HTTP: 404

ThrottlingException

El acceso está limitado.

Código de estado HTTP: 429

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: