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.
ListSearchJobBackups
Esta operación devuelve una lista de todas las copias de seguridad (puntos de recuperación) en formato paginado que se han incluido en el trabajo de búsqueda.
Si una búsqueda no muestra la copia de seguridad esperada en los resultados, puede llamar a esta operación para que se muestren todas las copias de seguridad incluidas en la búsqueda. Se mostrarán todas las copias de seguridad que no se hayan incluido porque tenían el estado FAILED de un problema de permisos, junto con un mensaje de estado.
En los resultados de búsqueda solo se incluyen puntos de recuperación con un índice de copias de seguridad con el estado ACTIVE. Si el índice tiene otro estado, este se mostrará junto con un mensaje de estado.
Sintaxis de la solicitud
GET /search-jobs/SearchJobIdentifier/backups?maxResults=MaxResults&nextToken=NextToken HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- 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 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. - SearchJobIdentifier
-
Cadena unívoca que especifica el trabajo de búsqueda.
Obligatorio: sí
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",
"Results": [
{
"BackupCreationTime": number,
"BackupResourceArn": "string",
"IndexCreationTime": number,
"ResourceType": "string",
"SourceResourceArn": "string",
"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
- Results
-
Los puntos de recuperación devuelven los resultados de un trabajo de búsqueda.
Tipo: matriz de objetos SearchJobBackupsResult
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
- ResourceNotFoundException
-
No se ha encontrado el recurso para esta solicitud.
Confirme que la información del recurso, como el ARN o el tipo, es correcta y existe y, a continuación, vuelva a intentar la solicitud.
- message
-
La solicitud hace referencia a un recurso que no existe.
- resourceId
-
Identificador hipotético del recurso afectado.
- resourceType
-
Tipo hipotético del recurso afectado.
Código de estado HTTP: 404
- 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:
