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
Esta operación devuelve una lista de trabajos de búsqueda que pertenecen a una cuenta.
Sintaxis de la solicitud
GET /search-jobs?MaxResults=MaxResults&NextToken=NextToken&Status=ByStatus HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- ByStatus
-
Incluya este parámetro para filtrar la lista por estado del trabajo de búsqueda.
Valores válidos:
RUNNING | COMPLETED | STOPPING | STOPPED | FAILED - MaxResults
-
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
-
El siguiente elemento que sigue a una lista parcial de los trabajos de búsqueda devueltos.
Por ejemplo, si se solicita que se devuelva el
MaxResultsnúmero de copias de seguridad,NextTokenpodrá devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
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
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- NextToken
-
El siguiente elemento que aparece después de una lista parcial de copias de seguridad devueltas incluidas en un trabajo de búsqueda.
Por ejemplo, si se solicita que se devuelva el
MaxResultsnúmero de copias de seguridad,NextTokenpuede devolver más elementos de la lista empezando por la ubicación que indique el siguiente token.Tipo: cadena
- SearchJobs
-
Los trabajos de búsqueda de la lista, con detalles de los trabajos de búsqueda devueltos.
Tipo: matriz de objetos SearchJobSummary
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- 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 después de varios segundos.
Código de estado HTTP: 500
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
- message
-
La solicitud no se ha realizado correctamente debido a una limitación de la solicitud.
- quotaCode
-
Este es el código exclusivo del servicio de origen con la cuota.
- retryAfterSeconds
-
Vuelva a intentar la llamada después de varios segundos.
- serviceCode
-
Este es el código exclusivo del servicio de origen.
Código de estado HTTP: 429
- ValidationException
-
La entrada no cumple las restricciones especificadas por un servicio.
- message
-
La entrada no cumple las restricciones especificadas por un servicio de Amazon.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
