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 los 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
-
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,NextTokenpermite 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
-
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,NextTokenpermite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.Tipo: cadena
- SearchJobs
-
Son los trabajos de búsqueda de la lista que incluyen 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 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
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
