Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# CreateReportPlan
<a name="API_CreateReportPlan"></a>

Membuat rencana laporan. Rencana laporan adalah dokumen yang berisi informasi tentang isi laporan dan di mana AWS Backup akan mengirimkannya.

Jika Anda menelepon `CreateReportPlan` dengan paket yang sudah ada, Anda menerima `AlreadyExistsException` pengecualian.

## Minta Sintaks
<a name="API_CreateReportPlan_RequestSyntax"></a>

```
POST /audit/report-plans HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string",
   "ReportDeliveryChannel": { 
      "Formats": [ "string" ],
      "S3BucketName": "string",
      "S3KeyPrefix": "string"
   },
   "ReportPlanDescription": "string",
   "ReportPlanName": "string",
   "ReportPlanTags": { 
      "string" : "string" 
   },
   "ReportSetting": { 
      "Accounts": [ "string" ],
      "FrameworkArns": [ "string" ],
      "NumberOfFrameworks": number,
      "OrganizationUnits": [ "string" ],
      "Regions": [ "string" ],
      "ReportTemplate": "string"
   }
}
```

## Parameter Permintaan URI
<a name="API_CreateReportPlan_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_CreateReportPlan_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [IdempotencyToken](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-IdempotencyToken"></a>
String yang dipilih pelanggan yang dapat Anda gunakan untuk membedakan antara panggilan yang identik. `CreateReportPlanInput` Mencoba kembali permintaan yang berhasil dengan token idempotensi yang sama menghasilkan pesan sukses tanpa tindakan yang diambil.  
Tipe: String  
Wajib: Tidak

 ** [ReportDeliveryChannel](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportDeliveryChannel"></a>
Struktur yang berisi informasi tentang tempat dan cara mengirimkan laporan, khususnya nama bucket Amazon S3, key prefix S3, dan format laporan Anda.  
Tipe: Objek [ReportDeliveryChannel](API_ReportDeliveryChannel.md)  
Wajib: Ya

 ** [ReportPlanDescription](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanDescription"></a>
Deskripsi opsional dari rencana laporan dengan maksimum 1.024 karakter.  
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 1024.  
Pola: `.*\S.*`   
Wajib: Tidak

 ** [ReportPlanName](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanName"></a>
Nama unik dari rencana laporan. Nama harus antara 1 dan 256 karakter, dimulai dengan huruf, dan terdiri dari huruf (a-z, A-Z), angka (0-9), dan garis bawah (\$1).  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `[a-zA-Z][_a-zA-Z0-9]*`   
Wajib: Ya

 ** [ReportPlanTags](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanTags"></a>
Tag untuk ditetapkan ke rencana laporan.  
Tipe: Peta antar string  
Wajib: Tidak

 ** [ReportSetting](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportSetting"></a>
Mengidentifikasi template laporan untuk laporan. Laporan dibuat menggunakan template laporan. Template laporan adalah:  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT | SCAN_JOB_REPORT `   
Jika template laporan adalah `RESOURCE_COMPLIANCE_REPORT` atau`CONTROL_COMPLIANCE_REPORT`, sumber daya API ini juga menjelaskan cakupan laporan oleh Wilayah AWS dan kerangka kerja.  
Tipe: Objek [ReportSetting](API_ReportSetting.md)  
Wajib: Ya

## Sintaksis Respons
<a name="API_CreateReportPlan_ResponseSyntax"></a>

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

{
   "CreationTime": number,
   "ReportPlanArn": "string",
   "ReportPlanName": "string"
}
```

## Elemen Respons
<a name="API_CreateReportPlan_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CreationTime](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-CreationTime"></a>
Tanggal dan waktu penyimpanan cadangan dibuat, dalam format Unix dan Coordinated Universal Time (UTC). Nilai akurat `CreationTime` untuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.  
Tipe: Timestamp

 ** [ReportPlanArn](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanArn"></a>
Nama Sumber Daya Amazon (ARN) yang secara unik mengidentifikasi sumber daya. Format ARN tergantung pada jenis sumber daya.  
Tipe: String

 ** [ReportPlanName](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanName"></a>
Nama unik dari rencana laporan.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.  
Pola: `[a-zA-Z][_a-zA-Z0-9]*` 

## Kesalahan
<a name="API_CreateReportPlan_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** AlreadyExistsException **   
Sumber daya yang dibutuhkan sudah ada.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Kode Status HTTP: 400

 ** InvalidParameterValueException **   
Menunjukkan bahwa ada sesuatu yang salah dengan nilai parameter. Misalnya, nilainya di luar jangkauan.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** LimitExceededException **   
Batas permintaan telah terlampaui; misalnya, jumlah maksimum item yang diizinkan dalam permintaan.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** MissingParameterValueException **   
Menunjukkan bahwa parameter yang diperlukan tidak ada.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 400

 ** ServiceUnavailableException **   
Permintaan gagal karena kegagalan sementara server.    
 ** Context **   
  
 ** Type **   

Kode Status HTTP: 500

## Lihat Juga
<a name="API_CreateReportPlan_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateReportPlan)