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.

# SearchFolders
<a name="API_SearchFolders"></a>

Busca en las subcarpetas de una carpeta.

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

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

{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_SearchFolders_RequestSyntax) **   <a name="QS-SearchFolders-request-AwsAccountId"></a>
El ID de para elAWScuenta que contiene la carpeta.  
Restricciones de longitud Longitud fija de 12.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [Filters](#API_SearchFolders_RequestSyntax) **   <a name="QS-SearchFolders-request-Filters"></a>
Los filtros que se van a aplicar a la búsqueda. En la actualidad, puede buscar únicamente por el ARN de la carpeta padre. Por ejemplo, `"Filters": [ { "Name": "PARENT_FOLDER_ARN", "Operator": "StringEquals", "Value": "arn:aws:quicksight:us-east-1:1:folder/folderId" } ]`.  
Type: Matriz de[FolderSearchFilter](API_FolderSearchFilter.md)objects  
Miembros de matrices: Número máximo de 100 elementos.  
Obligatorio: Sí

 ** [MaxResults](#API_SearchFolders_RequestSyntax) **   <a name="QS-SearchFolders-request-MaxResults"></a>
El número máximo de resultados que se van a devolver por solicitud.  
Type: Entero  
Rango válido: Valor mínimo de 1. Valor máximo de 100.  
Obligatorio: No

 ** [NextToken](#API_SearchFolders_RequestSyntax) **   <a name="QS-SearchFolders-request-NextToken"></a>
El token para el conjunto de resultados o nulo si no hay resultados.  
Type: Cadena  
Obligatorio: No

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

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

{
   "FolderSummaryList": [ 
      { 
         "Arn": "string",
         "CreatedTime": number,
         "FolderId": "string",
         "FolderType": "string",
         "LastUpdatedTime": number,
         "Name": "string"
      }
   ],
   "NextToken": "string",
   "RequestId": "string"
}
```

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

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [FolderSummaryList](#API_SearchFolders_ResponseSyntax) **   <a name="QS-SearchFolders-response-FolderSummaryList"></a>
Una estructura que contiene todas las carpetas delAWSaccount. Esta estructura proporciona información básica sobre las carpetas.  
Type: Matriz de[FolderSummary](API_FolderSummary.md)objects  
Miembros de matrices: Número máximo de 100 elementos.

 ** [NextToken](#API_SearchFolders_ResponseSyntax) **   <a name="QS-SearchFolders-response-NextToken"></a>
El token para el conjunto de resultados o nulo si no hay resultados.  
Type: Cadena

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

## Errores
<a name="API_SearchFolders_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

 ** InternalFailureException **   
Se produjo un error interno.  
Código de estado HTTP: 500

 ** InvalidNextTokenException **   
El valor de `NextToken` no es válido.  
Código de estado HTTP: 400

 ** InvalidParameterValueException **   
Uno o más parámetros tienen un valor que no es válido.  
Código de estado HTTP: 400

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

 ** UnsupportedUserEditionException **   
Este error indica que está llamando a una operación en Amazon QuickSighten la que la edición no incluye soporte para esa operación. Amazon Amazon QuickSight tiene Standard Edition y Enterprise. 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_SearchFolders_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/SearchFolders) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/SearchFolders) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/SearchFolders) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/SearchFolders) 
+  [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/SearchFolders) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/SearchFolders) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/SearchFolders) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/SearchFolders) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/SearchFolders)