翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ListSearchJobs
<a name="API_BKS_ListSearchJobs"></a>

このオペレーションは、アカウントに属する検索ジョブのリストを返します。

## リクエストの構文
<a name="API_BKS_ListSearchJobs_RequestSyntax"></a>

```
GET /search-jobs?MaxResults=MaxResults&NextToken=NextToken&Status=ByStatus HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_BKS_ListSearchJobs_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [ByStatus](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-ByStatus"></a>
検索ジョブのステータスでリストを絞り込むには、このパラメータを含めます。  
有効な値：`RUNNING | COMPLETED | STOPPING | STOPPED | FAILED`

 ** [MaxResults](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-MaxResults"></a>
返されるリソースリストアイテムの最大数。  
有効な範囲: 最小値 は 1 です。最大値は 1000 です。

 ** [NextToken](#API_BKS_ListSearchJobs_RequestSyntax) **   <a name="Backup-BKS_ListSearchJobs-request-uri-NextToken"></a>
返される検索ジョブの部分的リストに続く次の項目です。  
例えば、`MaxResults` で指定した数のバックアップを返すリクエストが行われた場合、`NextToken` を使用すると、次のトークンが指す場所から開始してさらにリストの項目を返すことができます。

## リクエスト本文
<a name="API_BKS_ListSearchJobs_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_BKS_ListSearchJobs_ResponseSyntax"></a>

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

{
   "NextToken": "string",
   "SearchJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "Name": "string",
         "SearchJobArn": "string",
         "SearchJobIdentifier": "string",
         "SearchScopeSummary": { 
            "TotalItemsToScanCount": number,
            "TotalRecoveryPointsToScanCount": number
         },
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

## レスポンス要素
<a name="API_BKS_ListSearchJobs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [NextToken](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-NextToken"></a>
検索ジョブに含まれる返されたバックアップの部分的なリストに続く次のアイテム。  
例えば、`MaxResults` で指定した数のバックアップを返すリクエストが行われた場合、`NextToken` を使用すると、次のトークンが指す場所から開始してさらにリストの項目を返すことができます。  
タイプ: 文字列

 ** [SearchJobs](#API_BKS_ListSearchJobs_ResponseSyntax) **   <a name="Backup-BKS_ListSearchJobs-response-SearchJobs"></a>
リスト内の検索ジョブと、返された検索ジョブの詳細。  
型: [SearchJobSummary](API_BKS_SearchJobSummary.md) オブジェクトの配列

## エラー
<a name="API_BKS_ListSearchJobs_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** AccessDeniedException **   
このアクションを実行する十分なアクセス権限がありません。    
 ** message **   
このアクションを実行する十分なアクセス権限がありません。
HTTP ステータスコード: 403

 ** InternalServerException **   
内部サーバーエラーが発生しました。リクエストを再実行します。    
 ** message **   
リクエストの処理中に予期しないエラーが発生しました。  
 ** retryAfterSeconds **   
秒数後に呼び出しを再試行します。
HTTP ステータスコード: 500

 ** ThrottlingException **   
リクエストのスロットリングにより、リクエストが拒否されました。    
 ** message **   
リクエストのスロットリングにより、リクエストは失敗しました。  
 ** quotaCode **   
これは、クォータを持つ元のサービスに固有のコードです。  
 ** retryAfterSeconds **   
秒数後に呼び出しを再試行します。  
 ** serviceCode **   
これは、元のサービスに固有のコードです。
HTTP ステータスコード: 429

 ** ValidationException **   
入力が、サービスで指定された制約を満たしていません。    
 ** message **   
入力が、Amazon サービスで指定された制約を満たしていません。
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_BKS_ListSearchJobs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/ListSearchJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/ListSearchJobs)