CreateReportPlan - AWS Backup
Sintaks PermintaanURIParameter PermintaanIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateReportPlan

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.

Sintaks Permintaan

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

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

IdempotencyToken

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

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

Wajib: Ya

ReportPlanDescription

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

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 (_).

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: [a-zA-Z][_a-zA-Z0-9]*

Wajib: Ya

ReportPlanTags

Tag untuk ditetapkan ke rencana laporan.

Tipe: Peta antar string

Wajib: Tidak

ReportSetting

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

Jika templat laporan adalah RESOURCE_COMPLIANCE_REPORT atauCONTROL_COMPLIANCE_REPORT, API sumber daya ini juga menjelaskan cakupan laporan oleh Wilayah AWS dan kerangka kerja.

Tipe: Objek ReportSetting

Wajib: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

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

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

CreationTime

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

Amazon Resource Name (ARN) yang secara unik mengidentifikasi sumber daya. Format ARN tergantung pada jenis sumber daya.

Tipe: String

ReportPlanName

Nama unik dari rencana laporan.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: [a-zA-Z][_a-zA-Z0-9]*

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

AlreadyExistsException

Sumber daya yang dibutuhkan sudah ada.

HTTPKode Status: 400

InvalidParameterValueException

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

HTTPKode Status: 400

LimitExceededException

Batas permintaan telah terlampaui; misalnya, jumlah maksimum item yang diizinkan dalam permintaan.

HTTPKode Status: 400

MissingParameterValueException

Menunjukkan bahwa parameter yang diperlukan tidak ada.

HTTPKode Status: 400

ServiceUnavailableException

Permintaan gagal karena kegagalan sementara server.

HTTPKode Status: 500

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: