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.

Sintaks Permintaan

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

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

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.

Data berikut dikembalikan dalam JSON format oleh layanan.

AdvancedBackupSettings

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

Tipe: Array objek AdvancedBackupSetting

BackupPlanArn

Amazon Resource Name (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

Unik, dihasilkan secara acak, Unicode, UTF -8 string yang dikodekan dengan panjang paling banyak 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.

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:

• AWS Antarmuka Baris Perintah

• AWS SDKuntuk. NET

• AWS SDKuntuk C ++

• AWS SDKuntuk Go v2

• AWS SDKuntuk Java V2

• AWS SDKuntuk JavaScript V3

• AWS SDKuntuk PHP V3

• AWS SDKuntuk Python

• AWS SDKuntuk Ruby V3