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

# ListReportJobs
<a name="API_ListReportJobs"></a>

レポートジョブの詳細を返します。

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

```
GET /audit/report-jobs?CreationAfter=ByCreationAfter&CreationBefore=ByCreationBefore&MaxResults=MaxResults&NextToken=NextToken&ReportPlanName=ByReportPlanName&Status=ByStatus HTTP/1.1
```

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

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

 ** [ByCreationAfter](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByCreationAfter"></a>
Unix 形式および協定世界時 (UTC) で指定された日付と時刻の後に作成されたレポートジョブのみを返します。たとえば、1516925490 の値は、2018年 1月 26日 (金) 午前 12:11:30 を表します。

 ** [ByCreationBefore](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByCreationBefore"></a>
Unix 形式および協定世界時 (UTC) で指定された日付と時刻より前に作成されたレポートジョブのみを返します。たとえば、1516925490 の値は、2018年 1月 26日 (金) 午前 12:11:30 を表します。

 ** [ByReportPlanName](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByReportPlanName"></a>
指定したレポートプラン名を持つレポートジョブのみを返します。  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `[a-zA-Z][_a-zA-Z0-9]*` 

 ** [ByStatus](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-ByStatus"></a>
指定されたステータスのレポートジョブのみを返します。ステータスは次のとおりです。  
 `CREATED | RUNNING | COMPLETED | FAILED | COMPLETED_WITH_ISSUES`   
 スキャンジョブのみが問題のある状態で終了することに注意してください。バックアップジョブの場合、これは完了状態で終了し、ステータスメッセージがあるジョブのコンソール解釈です。

 ** [MaxResults](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-MaxResults"></a>
1 から 1000 の範囲の望ましい結果の数。（オプション）。指定しない場合、クエリは 1 MB のデータを返します。  
有効な範囲: 最小値 は 1 です。最大値は 1000 です。

 ** [NextToken](#API_ListReportJobs_RequestSyntax) **   <a name="Backup-ListReportJobs-request-uri-NextToken"></a>
リスト内の次の項目のセットを返すために使用できる、この操作に対する前回の呼び出しから返された識別子。

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

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

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

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

{
   "NextToken": "string",
   "ReportJobs": [ 
      { 
         "CompletionTime": number,
         "CreationTime": number,
         "ReportDestination": { 
            "S3BucketName": "string",
            "S3Keys": [ "string" ]
         },
         "ReportJobId": "string",
         "ReportPlanArn": "string",
         "ReportTemplate": "string",
         "Status": "string",
         "StatusMessage": "string"
      }
   ]
}
```

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

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

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

 ** [NextToken](#API_ListReportJobs_ResponseSyntax) **   <a name="Backup-ListReportJobs-response-NextToken"></a>
リスト内の次の項目のセットを返すために使用できる、この操作に対する前回の呼び出しから返された識別子。  
タイプ: 文字列

 ** [ReportJobs](#API_ListReportJobs_ResponseSyntax) **   <a name="Backup-ListReportJobs-response-ReportJobs"></a>
JSON 形式のレポートジョブに関する詳細。  
型: [ReportJob](API_ReportJob.md) オブジェクトの配列

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

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

 ** InvalidParameterValueException **   
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** ResourceNotFoundException **   
アクションに必要なリソースは存在しません。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** ServiceUnavailableException **   
サーバーの一時的障害のため、リクエストは失敗しました。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 500

## その他の参照資料
<a name="API_ListReportJobs_SeeAlso"></a>

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