本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

此操作會啟動任務，將搜尋任務的結果匯出至指定的 S3 儲存貯體。

## 請求語法
<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" 
   }
}
```

## URI 請求參數
<a name="API_BKS_StartSearchResultExportJob_RequestParameters"></a>

請求不會使用任何 URI 參數。

## 請求主體
<a name="API_BKS_StartSearchResultExportJob_RequestBody"></a>

請求接受採用 JSON 格式的下列資料。

 ** [ClientToken](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ClientToken"></a>
包含此參數以允許對等冪進行多個相同呼叫。  
用戶端字符在第一個使用它的請求完成後 8 小時內有效。在此期間之後，任何具有相同字符的請求都會視為新的請求。  
類型：字串  
必要：否

 ** [ExportSpecification](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-ExportSpecification"></a>
此規格包含目的地儲存貯體的必要字串；您可以選擇包含目的地字首。  
類型：[ExportSpecification](API_BKS_ExportSpecification.md) 物件  
 **注意：**此物件是 Union。只能指定或傳回此物件的一個成員。  
必要：是

 ** [RoleArn](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-RoleArn"></a>
此參數指定用於啟動搜尋結果匯出任務的角色 ARN。  
類型：字串  
長度限制︰長度下限為 20。長度上限為 2048。  
模式：`arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)`  
必要：否

 ** [SearchJobIdentifier](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-SearchJobIdentifier"></a>
指定搜尋任務的唯一字串。  
類型：字串  
必要：是

 ** [Tags](#API_BKS_StartSearchResultExportJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-request-Tags"></a>
要包含的選用標籤。標籤是可用於管理、篩選和搜尋資源的鍵值對。允許使用的字元包括 UTF-8 字母、數字、空格，以及下列字元：\$1 - = . \$1 : /。  
類型：字串到字串映射  
必要：否

## 回應語法
<a name="API_BKS_StartSearchResultExportJob_ResponseSyntax"></a>

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

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

## 回應元素
<a name="API_BKS_StartSearchResultExportJob_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [ExportJobArn](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobArn"></a>
這是屬於新匯出任務的唯一 ARN (Amazon Resource Name)。  
類型：字串

 ** [ExportJobIdentifier](#API_BKS_StartSearchResultExportJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchResultExportJob-response-ExportJobIdentifier"></a>
這是指定新匯出任務的唯一識別符。  
類型：字串

## 錯誤
<a name="API_BKS_StartSearchResultExportJob_Errors"></a>

如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。

 ** AccessDeniedException **   
您沒有足夠存取權可執行此動作。    
 ** message **   
使用者沒有足夠的存取權來執行此動作。
HTTP 狀態碼：403

 ** ConflictException **   
當偵測到與先前成功的操作發生衝突時，就會發生此例外狀況。這通常發生在先前的操作沒有時間傳播到提供目前請求的主機時。  
重試 （具有適當的退避邏輯） 是建議對此例外狀況的回應。    
 ** message **   
更新或刪除資源可能會導致不一致的狀態。  
 ** resourceId **   
受影響資源的識別符。  
 ** resourceType **   
受影響的資源類型。
HTTP 狀態碼：409

 ** InternalServerException **   
發生內部伺服器錯誤。重試您的請求。    
 ** message **   
處理請求時發生非預期的錯誤。  
 ** retryAfterSeconds **   
在秒數後重試呼叫。
HTTP 狀態碼：500

 ** ResourceNotFoundException **   
找不到此請求的資源。  
確認資源資訊，例如 ARN 或類型正確且存在，然後重試請求。    
 ** message **   
請求會參考不存在的資源。  
 ** resourceId **   
受影響資源的假設識別符。  
 ** resourceType **   
受影響資源的假設類型。
HTTP 狀態碼：404

 ** ServiceQuotaExceededException **   
由於超過允許的配額限制，請求遭拒。    
 ** message **   
由於服務配額超過限制，此請求未成功。  
 ** quotaCode **   
這是配額類型的專屬程式碼。  
 ** resourceId **   
資源的識別符。  
 ** resourceType **   
資源類型。  
 ** serviceCode **   
這是具有配額之原始服務的唯一程式碼。
HTTP 狀態碼：402

 ** ThrottlingException **   
由於請求調節，因此請求遭到拒絕。    
 ** message **   
由於請求調節，請求失敗。  
 ** quotaCode **   
這是具有配額之原始服務的唯一程式碼。  
 ** retryAfterSeconds **   
在秒數後重試呼叫。  
 ** serviceCode **   
這是原始服務的唯一程式碼。
HTTP 狀態碼：429

 ** ValidationException **   
輸入無法滿足服務指定的限制條件。    
 ** message **   
輸入無法滿足 Amazon 服務指定的限制條件。
HTTP 狀態碼：400

## 另請參閱
<a name="API_BKS_StartSearchResultExportJob_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/StartSearchResultExportJob) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/StartSearchResultExportJob)