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.

# CreateIAMPolicyAssignment
<a name="API_CreateIAMPolicyAssignment"></a>

Crea una asignación con una política de IAM especificada, identificada por su nombre de recurso de Amazon (ARN). Esta asignación de política se adjunta a los grupos o usuarios especificados de Amazon QuickSight. Los nombres de las asignaciones son únicos porAWSaccount. Para evitar sobrescribir reglas en otros espacios de nombres, utilice nombres de asignación que sean únicos.

## Sintaxis de la solicitud
<a name="API_CreateIAMPolicyAssignment_RequestSyntax"></a>

```
POST /accounts/AwsAccountId/namespaces/Namespace/iam-policy-assignments/ HTTP/1.1
Content-type: application/json

{
   "AssignmentName": "string",
   "AssignmentStatus": "string",
   "Identities": { 
      "string" : [ "string" ]
   },
   "PolicyArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_CreateIAMPolicyAssignment_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_CreateIAMPolicyAssignment_RequestSyntax) **   <a name="QS-CreateIAMPolicyAssignment-request-AwsAccountId"></a>
El ID de laAWScuenta en la que desea asignar una política de IAM a Amazon QuickSight usuarios o grupos.  
Limitaciones de longitud Longitud fija de 12.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

 ** [Namespace](#API_CreateIAMPolicyAssignment_RequestSyntax) **   <a name="QS-CreateIAMPolicyAssignment-request-Namespace"></a>
El espacio de nombres que contiene la asignación.  
Limitaciones de longitud La longitud máxima es 64.  
Patrón: `^[a-zA-Z0-9._-]*$`   
Obligatorio: Sí

## Cuerpo de la solicitud
<a name="API_CreateIAMPolicyAssignment_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [AssignmentName](#API_CreateIAMPolicyAssignment_RequestSyntax) **   <a name="QS-CreateIAMPolicyAssignment-request-AssignmentName"></a>
El nombre de la asignación, también denominado regla. Debe ser único dentro de unaAWSaccount.  
Type: Cadena  
Limitaciones de longitud Longitud mínima de 1.  
Patrón: `(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$`   
Obligatorio: Sí

 ** [AssignmentStatus](#API_CreateIAMPolicyAssignment_RequestSyntax) **   <a name="QS-CreateIAMPolicyAssignment-request-AssignmentStatus"></a>
El estado de la asignación. Los valores posibles son los siguientes:  
+  `ENABLED`- Todo lo especificado en esta asignación se utiliza al crear la fuente de datos.
+  `DISABLED`- Esta asignación no se usa al crear la fuente de datos.
+  `DRAFT`- Esta tarea es un borrador sin terminar y no se utiliza al crear la fuente de datos.
Type: Cadena  
Valores válidos:` ENABLED | DRAFT | DISABLED`   
Obligatorio: Sí

 ** [Identities](#API_CreateIAMPolicyAssignment_RequestSyntax) **   <a name="QS-CreateIAMPolicyAssignment-request-Identities"></a>
El Amazon QuickSight usuarios, grupos o ambos a los que desee asignar la política.  
Type: mapa de cadena a matriz de cadenas  
Limitaciones de longitud Longitud mínima de 1.  
Patrón: `[\u0020-\u00FF]+`   
Obligatorio: No

 ** [PolicyArn](#API_CreateIAMPolicyAssignment_RequestSyntax) **   <a name="QS-CreateIAMPolicyAssignment-request-PolicyArn"></a>
El ARN para que la política de IAM se aplique a Amazon QuickSight usuarios y grupos especificados en esta asignación.  
Type: Cadena  
Obligatorio: No

## Sintaxis de la respuesta
<a name="API_CreateIAMPolicyAssignment_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "AssignmentId": "string",
   "AssignmentName": "string",
   "AssignmentStatus": "string",
   "Identities": { 
      "string" : [ "string" ]
   },
   "PolicyArn": "string",
   "RequestId": "string"
}
```

## Elementos de respuesta
<a name="API_CreateIAMPolicyAssignment_ResponseElements"></a>

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

 ** [Status](#API_CreateIAMPolicyAssignment_ResponseSyntax) **   <a name="QS-CreateIAMPolicyAssignment-response-Status"></a>
El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AssignmentId](#API_CreateIAMPolicyAssignment_ResponseSyntax) **   <a name="QS-CreateIAMPolicyAssignment-response-AssignmentId"></a>
El ID de la tarea.  
Type: Cadena

 ** [AssignmentName](#API_CreateIAMPolicyAssignment_ResponseSyntax) **   <a name="QS-CreateIAMPolicyAssignment-response-AssignmentName"></a>
El nombre de la tarea. El nombre debe ser único en laAWSaccount.  
Type: Cadena  
Limitaciones de longitud Longitud mínima de 1.  
Patrón: `(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$` 

 ** [AssignmentStatus](#API_CreateIAMPolicyAssignment_ResponseSyntax) **   <a name="QS-CreateIAMPolicyAssignment-response-AssignmentStatus"></a>
El estado de la asignación. Los valores posibles son los siguientes:  
+  `ENABLED`- Todo lo especificado en esta asignación se utiliza al crear la fuente de datos.
+  `DISABLED`- Esta asignación no se usa al crear la fuente de datos.
+  `DRAFT`- Esta tarea es un borrador sin terminar y no se utiliza al crear la fuente de datos.
Type: Cadena  
Valores válidos:` ENABLED | DRAFT | DISABLED` 

 ** [Identities](#API_CreateIAMPolicyAssignment_ResponseSyntax) **   <a name="QS-CreateIAMPolicyAssignment-response-Identities"></a>
El Amazon QuickSight usuarios, grupos o ambos a los que está asignada la política de IAM.  
Type: mapa de cadena a matriz de cadenas  
Limitaciones de longitud Longitud mínima de 1.  
Patrón: `[\u0020-\u00FF]+` 

 ** [PolicyArn](#API_CreateIAMPolicyAssignment_ResponseSyntax) **   <a name="QS-CreateIAMPolicyAssignment-response-PolicyArn"></a>
El ARN de la política de IAM que se aplica a Amazon QuickSight usuarios y grupos especificados en esta asignación.  
Type: Cadena

 ** [RequestId](#API_CreateIAMPolicyAssignment_ResponseSyntax) **   <a name="QS-CreateIAMPolicyAssignment-response-RequestId"></a>
LaAWSID de solicitud de esta operación.  
Type: Cadena

## Errores
<a name="API_CreateIAMPolicyAssignment_Errors"></a>

Para obtener información sobre los errores que son comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md).

 ** 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 esté autorizada para usar 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á llevando a cabo 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 encontraron 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
<a name="API_CreateIAMPolicyAssignment_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateIAMPolicyAssignment) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateIAMPolicyAssignment)