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.

# ListSearchJobs
<a name="API_BKS_ListSearchJobs"></a>

Esta operación devuelve una lista de los trabajos de búsqueda que pertenecen a una cuenta.

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

```
GET /search-jobs?MaxResults=MaxResults&NextToken=NextToken&Status=ByStatus HTTP/1.1
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [ByStatus](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-ByStatus"></a>
Incluya este parámetro para filtrar la lista por estado del trabajo de búsqueda.  
Valores válidos: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [MaxResults](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-MaxResults"></a>
Número máximo de elementos de la lista de recursos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-NextToken"></a>
Es el elemento que sigue a una lista parcial de los resultados del trabajo de búsqueda devueltos.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.

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

La solicitud no tiene un cuerpo de la solicitud.

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

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

{
   "NextToken": "string",
   "SearchJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "Name": "string",
         "SearchJobArn": "string",
         "SearchJobIdentifier": "string",
         "SearchScopeSummary": { 
            "TotalItemsToScanCount": number,
            "TotalRecoveryPointsToScanCount": number
         },
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

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

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-NextToken"></a>
Es el siguiente elemento tras una lista parcial de copias de seguridad devueltas que se incluyen en un trabajo de búsqueda.  
Por ejemplo, si se solicita que se devuelva el número de copias de seguridad `MaxResults`, `NextToken` permite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.  
Tipo: cadena

 ** [SearchJobs](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-SearchJobs"></a>
Son los trabajos de búsqueda de la lista que incluyen detalles de los trabajos de búsqueda devueltos.  
Tipo: matriz de objetos [SearchJobSummary](API_BKS_SearchJobSummary.md)

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene acceso suficiente para realizar esta acción.    
 ** message **   
El usuario no tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403

 ** InternalServerException **   
Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.    
 ** message **   
Error inesperado durante el procesamiento de la solicitud.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.
Código de estado HTTP: 500

 ** ThrottlingException **   
La solicitud fue denegada debido a una limitación de la solicitud.    
 ** message **   
La solicitud ha dado error debido a la limitación de la solicitud.  
 ** quotaCode **   
Este es el código unívoco del servicio de origen con la cuota.  
 ** retryAfterSeconds **   
Vuelva a intentar la llamada pasados varios segundos.  
 ** serviceCode **   
Este es el código unívoco del servicio de origen.
Código de estado HTTP: 429

 ** ValidationException **   
La entrada no satisface las limitaciones que especifica un servicio.    
 ** message **   
La entrada no satisface las limitaciones que especifica un servicio de Amazon.
Código de estado HTTP: 400

## Véase también
<a name="API_BKS_ListSearchJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobs)