CreateBackupPlan - AWS Backup
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateBackupPlan

Membuat rencana cadangan menggunakan nama rencana cadangan dan aturan cadangan. Rencana cadangan adalah dokumen yang berisi informasi yang AWS Backup digunakan untuk menjadwalkan tugas yang membuat titik pemulihan untuk sumber daya.

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

Minta Sintaks

PUT /backup/plans/ HTTP/1.1
Content-type: application/json

{
   "BackupPlan": { 
      "AdvancedBackupSettings": [ 
         { 
            "BackupOptions": { 
               "string" : "string" 
            },
            "ResourceType": "string"
         }
      ],
      "BackupPlanName": "string",
      "Rules": [ 
         { 
            "CompletionWindowMinutes": number,
            "CopyActions": [ 
               { 
                  "DestinationBackupVaultArn": "string",
                  "Lifecycle": { 
                     "DeleteAfterDays": number,
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleName": "string",
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string"
         }
      ]
   },
   "BackupPlanTags": { 
      "string" : "string" 
   },
   "CreatorRequestId": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

BackupPlan

Tubuh rencana cadangan. Termasuk satu BackupPlanName dan satu atau lebih setRules.

Tipe: Objek BackupPlanInput

Wajib: Ya

BackupPlanTags

Tag untuk ditetapkan ke rencana cadangan.

Tipe: Peta antar string

Wajib: Tidak

CreatorRequestId

Mengidentifikasi permintaan dan memungkinkan permintaan yang gagal untuk dicoba ulang tanpa risiko menjalankan operasi dua kali. Jika permintaan menyertakan CreatorRequestId yang cocok dengan rencana cadangan yang ada, paket tersebut dikembalikan. Parameter ini bersifat opsional.

Jika digunakan, parameter ini harus berisi 1 sampai 50 alfanumerik atau '-_.' karakter.

Tipe: String

Wajib: Tidak

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "VersionId": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

AdvancedBackupSettings

Pengaturan untuk jenis sumber daya. Opsi ini hanya tersedia untuk pekerjaan cadangan Windows Volume Shadow Copy Service (VSS).

Tipe: Array objek AdvancedBackupSetting

BackupPlanArn

Nama Sumber Daya Amazon (ARN) yang secara unik mengidentifikasi rencana cadangan; misalnya,. arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50

Tipe: String

BackupPlanId

ID dari rencana cadangan.

Tipe: String

CreationDate

Tanggal dan waktu rencana cadangan dibuat, dalam format Unix dan Coordinated Universal Time (UTC). Nilai akurat CreationDate untuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.

Tipe: Timestamp

VersionId

String berkode UTF-8, Unicode, yang dihasilkan secara acak dan unik, dengan panjang maksimal 1.024 byte. Mereka tidak dapat diedit.

Tipe: String

Kesalahan

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

AlreadyExistsException

Sumber daya yang dibutuhkan sudah ada.

Kode Status HTTP: 400

InvalidParameterValueException

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

Kode Status HTTP: 400

LimitExceededException

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

Kode Status HTTP: 400

MissingParameterValueException

Menunjukkan bahwa parameter yang diperlukan tidak ada.

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan gagal karena kegagalan sementara server.

Kode Status HTTP: 500

Lihat Juga

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