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á.

# StartSearchResultExportJob
<a name="API_BKS_StartSearchResultExportJob"></a>

Essa operação inicia um trabalho para exportar os resultados do trabalho de pesquisa para um bucket do S3 designado.

## Sintaxe da Solicitação
<a name="API_BKS_StartSearchResultExportJob_RequestSyntax"></a>

```
PUT /export-search-jobs HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "ExportSpecification": { ... },
   "RoleArn": "string",
   "SearchJobIdentifier": "string",
   "Tags": { 
      "string" : "string" 
   }
}
```

## Parâmetros da solicitação de URI
<a name="API_BKS_StartSearchResultExportJob_RequestParameters"></a>

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_BKS_StartSearchResultExportJob_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [ClientToken](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ClientToken"></a>
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

 ** [ExportSpecification](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ExportSpecification"></a>
Essa especificação contém uma string obrigatória do bucket de destino. Se preferir, inclua o prefixo de destino.  
Tipo: objeto [ExportSpecification](API_BKS_ExportSpecification.md)  
 **Observação:** este objeto é uma união. Somente um membro desse objeto pode ser especificado ou retornado.  
Obrigatório: Sim

 ** [RoleArn](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-RoleArn"></a>
Esse parâmetro especifica o ARN do perfil usado para iniciar os trabalhos de exportação dos resultados da pesquisa.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2.048.  
Padrão: `arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)`   
Obrigatório: não

 ** [SearchJobIdentifier](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-SearchJobIdentifier"></a>
A string exclusiva que especifica o trabalho de pesquisa.  
Tipo: String  
Obrigatório: Sim

 ** [Tags](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-Tags"></a>
Tags opcionais a serem incluídas. Uma tag é um par de chave/valor que ajuda você a gerenciar, filtrar e pesquisar seus recursos. Os caracteres permitidos incluem letras, números e espaços em UTF-8, além dos seguintes caracteres especiais: \$1 - = . \$1 : /.   
Tipo: mapa de string para string  
Obrigatório: Não

## Sintaxe da resposta
<a name="API_BKS_StartSearchResultExportJob_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ExportJobArn": "string",
   "ExportJobIdentifier": "string"
}
```

## Elementos de resposta
<a name="API_BKS_StartSearchResultExportJob_ResponseElements"></a>

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.

 ** [ExportJobArn](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobArn"></a>
Esse é o ARN (nome do recurso da Amazon) exclusivo que pertence ao novo trabalho de exportação.  
Tipo: string

 ** [ExportJobIdentifier](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobIdentifier"></a>
Esse é o identificador exclusivo que especifica o novo trabalho de exportação.  
Tipo: string

## Erros
<a name="API_BKS_StartSearchResultExportJob_Errors"></a>

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
<a name="API_BKS_StartSearchResultExportJob_SeeAlso"></a>

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/StartSearchResultExportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchResultExportJob)