As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # StartSearchJob Essa operação cria um trabalho de pesquisa que retorna pontos de recuperação filtrados por SearchScope e itens filtrados por. ItemFilters Opcionalmente, você pode incluir ClientToken EncryptionKeyArn, Nome, and/or Tags. ## Sintaxe da Solicitação ``` 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 da solicitação de URI A solicitação não usa nenhum parâmetro de URI. ## Corpo da Solicitação A solicitação aceita os dados a seguir no formato JSON. ** [ClientToken](#API_BKS_StartSearchJob_RequestSyntax) ** Inclua esse parâmetro para permitir várias chamadas idênticas de idempotência. Um token de cliente é válido por oito horas depois que a primeira solicitação que o utiliza é concluída. Após esse prazo, qualquer solicitação com o mesmo token será tratada como uma nova solicitação. Tipo: string Obrigatório: não ** [EncryptionKeyArn](#API_BKS_StartSearchJob_RequestSyntax) ** A chave de criptografia para o trabalho de pesquisa especificado. Tipo: string Obrigatório: não ** [ItemFilters](#API_BKS_StartSearchJob_RequestSyntax) ** Os filtros de itens representam todas as propriedades do item de entrada especificadas quando a pesquisa foi criada. Contém EBSItem filtros ou S3 ItemFilters Tipo: objeto [ItemFilters](API_BKS_ItemFilters.md) Obrigatório: não ** [Name](#API_BKS_StartSearchJob_RequestSyntax) ** Inclua caracteres alfanuméricos para criar um nome para esse trabalho de pesquisa. Tipo: string Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 500. Obrigatório: não ** [SearchScope](#API_BKS_StartSearchJob_RequestSyntax) ** Esse objeto pode conter BackupResourceTypes,, BackupResourceArns BackupResourceCreationTime BackupResourceTags, e SourceResourceArns filtrar os pontos de recuperação retornados pelo trabalho de pesquisa. Tipo: objeto [SearchScope](API_BKS_SearchScope.md) Obrigatório: Sim ** [Tags](#API_BKS_StartSearchJob_RequestSyntax) ** Lista de tags retornadas pela operação. Tipo: mapa de string para string Obrigatório: Não ## Sintaxe da resposta ``` HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "SearchJobArn": "string", "SearchJobIdentifier": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [CreationTime](#API_BKS_StartSearchJob_ResponseSyntax) ** A data e a hora em que um trabalho foi criado, em formato Unix e Tempo Universal Coordenado (UTC). O valor de `CompletionTime` tem precisão de milissegundos. Por exemplo, o valor 1516925490,087 representa sexta-feira, 26 de janeiro de 2018, 0:11:30,087. Tipo: Timestamp ** [SearchJobArn](#API_BKS_StartSearchJob_ResponseSyntax) ** A string exclusiva que identifica o nome do recurso da Amazon (ARN) do trabalho de pesquisa especificado. Tipo: string ** [SearchJobIdentifier](#API_BKS_StartSearchJob_ResponseSyntax) ** A string exclusiva que especifica o trabalho de pesquisa. Tipo: string ## Erros Para obter informações sobre os erros que são comuns a todas as ações, consulte [Tipos de erro comuns](CommonErrors.md). ** AccessDeniedException ** Você não tem acesso suficiente para executar esta ação. ** message ** O usuário não tem acesso suficiente para executar esta ação. Código de status HTTP: 403 ** ConflictException ** Essa exceção ocorre quando um conflito com uma operação anterior bem-sucedida é detectado. Isso geralmente ocorre quando a operação anterior não teve tempo de se propagar para o host que atende à solicitação atual. Uma nova tentativa (com a lógica de recuo apropriada) é a resposta recomendada para essa exceção. ** message ** Atualizar ou excluir um recurso pode causar um estado inconsistente. ** resourceId ** Identificador do recurso afetado. ** resourceType ** Tipo do recurso afetado. Código de Status HTTP: 409 ** InternalServerException ** Ocorreu um erro interno do servidor. Tente sua solicitação novamente. ** message ** Erro inesperado durante o processamento da solicitação. ** retryAfterSeconds ** Tente fazer a chamada novamente após alguns segundos. Código de status HTTP: 500 ** ResourceNotFoundException ** O recurso não foi encontrado para essa solicitação. Confirme se as informações do recurso, como o ARN ou o tipo, estão corretas e existem e, então, repita a solicitação. ** message ** A solicitação faz referência a um recurso que não existe. ** resourceId ** Identificador hipotético do recurso afetado. ** resourceType ** Tipo hipotético do recurso afetado. Código de status HTTP: 404 ** ServiceQuotaExceededException ** A solicitação foi negada por exceder os limites de cota permitidos. ** message ** Essa solicitação não foi bem-sucedida devido a uma cota de serviço que excedeu os limites. ** quotaCode ** Esse é o código específico para o tipo de cota. ** resourceId ** Identificador do recurso. ** resourceType ** Tipo de recurso. ** serviceCode ** Esse é o código exclusivo do serviço de origem com a cota. Código de status HTTP: 402 ** ThrottlingException ** A solicitação foi negada devido à limitação da solicitação. ** message ** A solicitação não foi bem-sucedida devido ao controle de utilização da solicitação. ** quotaCode ** Esse é o código exclusivo do serviço de origem com a cota. ** retryAfterSeconds ** Tente fazer a chamada novamente após alguns segundos. ** serviceCode ** Esse é o código exclusivo do serviço de origem. Código de status HTTP: 429 ** ValidationException ** A entrada não atende às restrições especificadas por um serviço. ** message ** A entrada não atende às restrições especificadas por um serviço da Amazon. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchJob) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchJob)