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.

# CreateFolder
<a name="API_CreateFolder"></a>

Crea una carpeta compartida vacía.

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

```
POST /accounts/AwsAccountId/folders/FolderId HTTP/1.1
Content-type: application/json

{
   "FolderType": "string",
   "Name": "string",
   "ParentFolderArn": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-AwsAccountId"></a>
El ID de:AWSen la que desea crear la carpeta.  
Restricciones: Longitud fija de 12.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

 ** [FolderId](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-FolderId"></a>
El ID de la carpeta.  
Restricciones: Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `[\w\-]+`   
Obligatorio: Sí

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [FolderType](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-FolderType"></a>
El tipo de carpeta. Por defecto, `folderType` es `SHARED`.  
Type: Cadena  
Valores válidos:` SHARED`   
Obligatorio: No

 ** [Name](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Name"></a>
El nombre de la carpeta.  
Type: Cadena  
Restricciones: Longitud mínima de 1. La longitud máxima es de 200 caracteres.  
Obligatorio: No

 ** [ParentFolderArn](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-ParentFolderArn"></a>
El nombre de recurso de Amazon (ARN) de la carpeta principal.  
 `ParentFolderArn`puede ser null. Un vacío`parentFolderArn`crea una carpeta de nivel raíz.  
Type: Cadena  
Obligatorio: No

 ** [Permissions](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Permissions"></a>
Estructura que describe los principales y los permisos de nivel de recursos de una carpeta.  
Para no especificar ningún permiso, omita`Permissions`.  
Type: Matriz de[ResourcePermission](API_ResourcePermission.md)objects  
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 64 elementos.  
Obligatorio: No

 ** [Tags](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Tags"></a>
Etiquetas de la carpeta.  
Type: Matriz de[Tag](API_Tag.md)objects  
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 200 elementos.  
Obligatorio: No

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

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

{
   "Arn": "string",
   "FolderId": "string",
   "RequestId": "string"
}
```

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

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Arn](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-Arn"></a>
El nombre de recurso de Amazon (ARN) de la carpeta recién creada.  
Type: Cadena

 ** [FolderId](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-FolderId"></a>
El ID de carpeta de la carpeta recién creada.  
Type: Cadena  
Restricciones: Longitud mínima de 1. La longitud máxima es de 2048 caracteres.  
Patrón: `[\w\-]+` 

 ** [RequestId](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-RequestId"></a>
El identificador de solicitud de la carpeta recién creada.  
Type: Cadena

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

Para obtener información sobre 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 las claves de acceso correctas.  
Código de estado HTTP: 401

 ** ConflictException **   
La actualización o eliminación de un recurso puede provocar un estado incoherente.  
Código de estado HTTP: 409

 ** 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

 ** LimitExceededException **   
Se superó un límite.  
Código de estado HTTP: 409

 ** 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

 ** UnsupportedUserEditionException **   
Este error indica que está llamando a una operación QuickSighten la que la edición no incluye soporte para esa operación. Amazon Amazon QuickSight tiene las ediciones actuales de Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones.  
Código de estado HTTP: 403

## Véase también
<a name="API_CreateFolder_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/CreateFolder) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateFolder) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateFolder) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateFolder) 
+  [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateFolder) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateFolder) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateFolder) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateFolder) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateFolder)