StartCopyJob - 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.

StartCopyJob

Memulai pekerjaan untuk membuat salinan satu kali dari sumber daya yang ditentukan.

Tidak mendukung pencadangan berkelanjutan.

Sintaks Permintaan

PUT /copy-jobs HTTP/1.1
Content-type: application/json

{
   "DestinationBackupVaultArn": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string",
   "SourceBackupVaultName": "string"
}

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

DestinationBackupVaultArn

Amazon Resource Name (ARN) yang secara unik mengidentifikasi brankas cadangan tujuan untuk disalin; misalnya,. arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault

Tipe: String

Diperlukan: Ya

IamRoleArn

Menentukan IAM peran yang ARN digunakan untuk menyalin titik pemulihan target; misalnya,arn:aws:iam::123456789012:role/S3Access.

Tipe: String

Diperlukan: Ya

IdempotencyToken

String yang dipilih pelanggan yang dapat Anda gunakan untuk membedakan antara panggilan yang identik. StartCopyJob Mencoba kembali permintaan yang berhasil dengan token idempotensi yang sama menghasilkan pesan sukses tanpa tindakan yang diambil.

Tipe: String

Wajib: Tidak

Lifecycle

Menentukan periode waktu, dalam beberapa hari, sebelum transisi titik pemulihan ke cold storage atau dihapus.

Backup yang dialihkan ke penyimpanan dingin harus disimpan dalam penyimpanan dingin minimal 90 hari. Oleh karena itu, pada konsol, pengaturan retensi harus 90 hari lebih besar dari transisi ke pengaturan dingin setelah hari. Transisi ke pengaturan dingin setelah hari tidak dapat diubah setelah cadangan dialihkan ke dingin.

Jenis sumber daya yang dapat bertransisi ke penyimpanan dingin tercantum dalam tabel Ketersediaan fitur menurut sumber daya. AWS Backup mengabaikan ekspresi ini untuk jenis sumber daya lainnya.

Untuk menghapus siklus hidup dan periode retensi yang ada dan menjaga titik pemulihan Anda tanpa batas waktu, tentukan -1 untuk dan. MoveToColdStorageAfterDays DeleteAfterDays

Tipe: Objek Lifecycle

Wajib: Tidak

RecoveryPointArn

Sebuah yang secara unik mengidentifikasi titik pemulihan ARN yang akan digunakan untuk pekerjaan penyalinan; misalnya, arn:aws:backup:us-east- 1:123456789012: recovery-point:1 -9EB0-435A-A80B-108B488B0D45. EB3B5E7

Tipe: String

Diperlukan: Ya

SourceBackupVaultName

Nama wadah sumber logis tempat cadangan disimpan. Brankas cadangan diidentifikasi dengan nama yang unik untuk akun yang digunakan untuk membuatnya dan AWS Wilayah tempat pembuatannya.

Tipe: String

Pola: ^[a-zA-Z0-9\-\_]{2,50}$

Diperlukan: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "CopyJobId": "string",
   "CreationDate": number,
   "IsParent": boolean
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

CopyJobId

Mengidentifikasi pekerjaan salinan secara unik.

Tipe: String

CreationDate

Tanggal dan waktu pekerjaan salinan dibuat, dalam format Unix dan Waktu Universal Terkoordinasi ()UTC. Nilai akurat CreationDate untuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.

Tipe: Timestamp

IsParent

Ini adalah nilai boolean yang dikembalikan yang menunjukkan ini adalah pekerjaan salinan induk (komposit).

Jenis: Boolean

Kesalahan

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

InvalidParameterValueException

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

HTTPKode Status: 400

InvalidRequestException

Menunjukkan bahwa ada sesuatu yang salah dengan input ke permintaan. Misalnya, parameter adalah tipe yang salah.

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

ResourceNotFoundException

Sumber daya yang diperlukan untuk tindakan 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: