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

# StartSearchJob
<a name="API_BKS_StartSearchJob"></a>

此操作會建立搜尋任務，以傳回 SearchScope 篩選的復原點和 ItemFilters 篩選的項目。

您可以選擇包含 ClientToken、EncryptionKeyArn、Name 和/或 Tags。

## 請求語法
<a name="API_BKS_StartSearchJob_RequestSyntax"></a>

```
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" 
   }
}
```

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

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

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

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

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

 ** [EncryptionKeyArn](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-EncryptionKeyArn"></a>
指定搜尋任務的加密金鑰。  
類型：字串  
必要：否

 ** [ItemFilters](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-ItemFilters"></a>
項目篩選條件代表建立搜尋時指定的所有輸入項目屬性。  
包含 EBSItemFilters 或 S3ItemFilters  
類型：[ItemFilters](API_BKS_ItemFilters.md) 物件  
必要：否

 ** [Name](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-Name"></a>
包含英數字元以建立此搜尋任務的名稱。  
類型：字串  
長度限制：長度下限為 0。長度上限為 500。  
必要：否

 ** [SearchScope](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-SearchScope"></a>
此物件可包含 BackupResourceTypes、 BackupResourceArns、 BackupResourceCreationTime、 BackupResourceTags 和 SourceResourceArns，以篩選搜尋任務傳回的復原點。  
類型：[SearchScope](API_BKS_SearchScope.md) 物件  
必要：是

 ** [Tags](#API_BKS_StartSearchJob_RequestSyntax) **   <a name="Backup-BKS_StartSearchJob-request-Tags"></a>
操作傳回的標籤清單。  
類型：字串到字串映射  
必要：否

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

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

{
   "CreationTime": number,
   "SearchJobArn": "string",
   "SearchJobIdentifier": "string"
}
```

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

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

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

 ** [CreationTime](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-CreationTime"></a>
建立任務的日期和時間，採用 Unix 格式和國際標準時間 (UTC)。`CompletionTime` 的值精確到毫秒。例如，值 1516925490.087 代表 2018 年 1 月 26 日星期五上午 12 點 11 分 30.087 秒。  
類型：Timestamp

 ** [SearchJobArn](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-SearchJobArn"></a>
識別指定搜尋任務之 Amazon Resource Name (ARN) 的唯一字串。  
類型：字串

 ** [SearchJobIdentifier](#API_BKS_StartSearchJob_ResponseSyntax) **   <a name="Backup-BKS_StartSearchJob-response-SearchJobIdentifier"></a>
指定搜尋任務的唯一字串。  
類型：字串

## 錯誤
<a name="API_BKS_StartSearchJob_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_StartSearchJob_SeeAlso"></a>

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