StartSearchJob - AWS Backup

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.

StartSearchJob

Esta operación crea un trabajo de búsqueda que devuelve los puntos de recuperación filtrados por SearchScope y los elementos filtrados por ItemFilters.

Si lo desea ClientToken EncryptionKeyArn, puede incluir un nombre o etiquetas.

Sintaxis de la solicitud

PUT /search-jobs HTTP/1.1 Content-type: application/json { "ClientToken": "string", "EncryptionKeyArn": "string", "ItemFilters": { "EBSItemFilters": [ { "CreationTimes": [ { "Operator": "string", "Value": number } ], "FilePaths": [ { "Operator": "string", "Value": "string" } ], "LastModificationTimes": [ { "Operator": "string", "Value": number } ], "Sizes": [ { "Operator": "string", "Value": number } ] } ], "S3ItemFilters": [ { "CreationTimes": [ { "Operator": "string", "Value": number } ], "ETags": [ { "Operator": "string", "Value": "string" } ], "ObjectKeys": [ { "Operator": "string", "Value": "string" } ], "Sizes": [ { "Operator": "string", "Value": number } ], "VersionIds": [ { "Operator": "string", "Value": "string" } ] } ] }, "Name": "string", "SearchScope": { "BackupResourceArns": [ "string" ], "BackupResourceCreationTime": { "CreatedAfter": number, "CreatedBefore": number }, "BackupResourceTags": { "string" : "string" }, "BackupResourceTypes": [ "string" ], "SourceResourceArns": [ "string" ] }, "Tags": { "string" : "string" } }

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

ClientToken

Incluya este parámetro para permitir múltiples llamadas idénticas de idempotencia.

Un token de cliente es válido durante 8 horas después de que se complete la primera solicitud que lo utilice. Transcurrido este tiempo, cualquier solicitud con el mismo token se considera una solicitud nueva.

Tipo: cadena

Requerido: no

EncryptionKeyArn

La clave de cifrado del trabajo de búsqueda especificado.

Tipo: cadena

Requerido: no

ItemFilters

Los filtros de elementos representan todas las propiedades de los elementos de entrada especificadas al crear la búsqueda.

Contiene EBSItem filtros o S3 ItemFilters

Tipo: objeto ItemFilters

Obligatorio: no

Name

Incluye caracteres alfanuméricos para crear un nombre para este trabajo de búsqueda.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 500 caracteres.

Obligatorio: no

SearchScope

Este objeto puede contener BackupResourceTypes, BackupResourceArns BackupResourceCreationTime BackupResourceTags, y filtrar SourceResourceArns los puntos de recuperación devueltos por el trabajo de búsqueda.

Tipo: objeto SearchScope

Obligatorio: sí

Tags

Lista de etiquetas devueltas por la operación.

Tipo: mapa de cadena a cadena

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "SearchJobArn": "string", "SearchJobIdentifier": "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.

CreationTime

La fecha y la hora en que se creó un trabajo, en formato Unix y en hora universal coordinada (UTC). El valor de CompletionTime tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.

Tipo: marca temporal

SearchJobArn

La cadena única que identifica el nombre de recurso de Amazon (ARN) del trabajo de búsqueda especificado.

Tipo: cadena

SearchJobIdentifier

La cadena única que especifica el trabajo de búsqueda.

Tipo: cadena

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.

Código de estado HTTP: 403

ConflictException

Esta excepción se produce cuando se detecta un conflicto con una operación anterior correcta. Esto suele ocurrir cuando la operación anterior no tuvo tiempo de propagarse al host que atiende la solicitud actual.

La respuesta recomendada a esta excepción es volver a intentarlo (con la lógica de espera adecuada).

Código de estado HTTP: 409

InternalServerException

Se ha producido un error interno del servidor. Vuelva a enviar la solicitud.

Código de estado HTTP: 500

ServiceQuotaExceededException

La solicitud se denegó por superar los límites de cuota permitidos.

Código de estado HTTP: 402

ThrottlingException

La solicitud fue denegada debido a una limitación de la solicitud.

Código de estado HTTP: 429

ValidationException

La entrada no cumple las restricciones especificadas por un servicio.

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, consulte lo siguiente: