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

# StartBackupJob
<a name="API_StartBackupJob"></a>

Memulai pekerjaan cadangan sesuai permintaan untuk sumber daya yang ditentukan.

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

```
PUT /backup-jobs HTTP/1.1
Content-type: application/json

{
   "BackupOptions": { 
      "string" : "string" 
   },
   "BackupVaultName": "string",
   "CompleteWindowMinutes": number,
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Index": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "LogicallyAirGappedBackupVaultArn": "string",
   "RecoveryPointTags": { 
      "string" : "string" 
   },
   "ResourceArn": "string",
   "StartWindowMinutes": number
}
```

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

Permintaan tidak menggunakan parameter URI apa pun.

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

Permintaan menerima data berikut dalam format JSON.

 ** [BackupOptions](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-BackupOptions"></a>
Opsi cadangan untuk sumber daya yang dipilih. Opsi ini hanya tersedia untuk pekerjaan cadangan Windows Volume Shadow Copy Service (VSS).  
Nilai yang valid: Setel `"WindowsVSS":"enabled"` untuk mengaktifkan opsi `WindowsVSS` cadangan dan membuat cadangan Windows VSS. Setel `"WindowsVSS""disabled"` untuk membuat cadangan reguler. `WindowsVSS`Opsi ini tidak diaktifkan secara default.  
Tipe: Peta string ke string  
Pola Kunci: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Pola nilai: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Wajib: Tidak

 ** [BackupVaultName](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-BackupVaultName"></a>
Nama kontainer logis tempat cadangan disimpan. Vault cadangan diidentifikasi berdasarkan nama yang unik untuk akun yang digunakan untuk membuatnya dan Wilayah AWS tempatnya dibuat.  
Tipe: String  
Pola: `^[a-zA-Z0-9\-\_]{2,50}$`   
Wajib: Ya

 ** [CompleteWindowMinutes](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-CompleteWindowMinutes"></a>
Nilai dalam hitungan menit di mana pencadangan yang berhasil dimulai harus diselesaikan, atau AWS Backup akan membatalkan pekerjaan. Nilai ini bersifat opsional. Nilai ini mulai menghitung mundur dari saat cadangan dijadwalkan. Itu tidak menambah waktu tambahan untuk`StartWindowMinutes`, atau jika cadangan dimulai lebih lambat dari yang dijadwalkan.  
Seperti`StartWindowMinutes`, parameter ini memiliki nilai maksimum 100 tahun (52.560.000 menit).  
Tipe: Panjang  
Wajib: Tidak

 ** [IamRoleArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-IamRoleArn"></a>
Menentukan peran IAM ARN digunakan untuk membuat titik pemulihan target; misalnya,. `arn:aws:iam::123456789012:role/S3Access`  
Tipe: String  
Diperlukan: Ya

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

 ** [Index](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-Index"></a>
Sertakan parameter ini untuk mengaktifkan pembuatan indeks jika pekerjaan cadangan Anda memiliki jenis sumber daya yang mendukung indeks cadangan.  
Jenis sumber daya yang mendukung indeks cadangan meliputi:  
+  `EBS`untuk Amazon Elastic Block Store
+  `S3`untuk Amazon Simple Storage Service (Amazon S3)
Indeks dapat memiliki 1 dari 2 nilai yang mungkin, baik `ENABLED` atau`DISABLED`.  
Untuk membuat indeks cadangan untuk titik `ACTIVE` pemulihan yang memenuhi syarat yang belum memiliki indeks cadangan, tetapkan nilai ke`ENABLED`.  
Untuk menghapus indeks cadangan, tetapkan nilai ke`DISABLED`.  
Tipe: String  
Nilai yang Valid: `ENABLED | DISABLED`   
Wajib: Tidak

 ** [Lifecycle](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-Lifecycle"></a>
Siklus hidup menentukan kapan sumber daya yang dilindungi dialihkan ke penyimpanan dingin dan kapan sumber daya tersebut kedaluwarsa. AWS Backup akan transisi dan kedaluwarsa backup secara otomatis sesuai dengan siklus hidup yang Anda tentukan.   
Cadangan yang dialihkan ke penyimpanan dingin harus disimpan dalam penyimpanan dingin minimal 90 hari. Oleh karena itu, pengaturan "retensi" harus 90 hari lebih lama dari pengaturan "transisi ke penyimpanan dingin setelah beberapa hari". Pengaturan "transisi ke penyimpanan dingin setelah beberapa hari" tidak dapat diubah setelah pencadangan telah ditransisi ke penyimpanan dingin.   
Jenis sumber daya yang dapat bertransisi ke penyimpanan dingin tercantum dalam tabel [Ketersediaan fitur menurut sumber daya](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup mengabaikan ekspresi ini untuk jenis sumber daya lainnya.  
Parameter ini memiliki nilai maksimum 100 tahun (36.500 hari).  
Tipe: Objek [Lifecycle](API_Lifecycle.md)  
Wajib: Tidak

 ** [LogicallyAirGappedBackupVaultArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-LogicallyAirGappedBackupVaultArn"></a>
ARN dari lemari besi yang memiliki celah udara secara logis. ARN harus berada di akun dan Wilayah yang sama. Jika disediakan, sumber daya terkelola penuh yang didukung dicadangkan langsung ke brankas dengan celah udara secara logis, sementara sumber daya lain yang didukung membuat snapshot sementara (dapat ditagih) di brankas cadangan, lalu salin ke brankas yang memiliki celah udara secara logis. Sumber daya yang tidak didukung hanya dicadangkan ke brankas cadangan yang ditentukan.  
Tipe: String  
Wajib: Tidak

 ** [RecoveryPointTags](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-RecoveryPointTags"></a>
Tag untuk menetapkan sumber daya.  
Tipe: Peta antar string  
Wajib: Tidak

 ** [ResourceArn](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-ResourceArn"></a>
Nama Sumber Daya Amazon (ARN) yang secara unik mengidentifikasi sumber daya. Format ARN tergantung pada jenis sumber daya.  
Tipe: String  
Diperlukan: Ya

 ** [StartWindowMinutes](#API_StartBackupJob_RequestSyntax) **   <a name="Backup-StartBackupJob-request-StartWindowMinutes"></a>
Nilai dalam hitungan menit setelah pencadangan dijadwalkan sebelum pekerjaan akan dibatalkan jika tidak berhasil dimulai. Nilai ini opsional, dan defaultnya adalah 8 jam. Jika nilai ini disertakan, setidaknya harus 60 menit untuk menghindari kesalahan.  
Parameter ini memiliki nilai maksimum 100 tahun (52.560.000 menit).  
Selama jendela mulai, status pekerjaan cadangan tetap dalam `CREATED` status sampai berhasil dimulai atau sampai waktu jendela mulai habis. Jika dalam waktu jendela mulai AWS Backup menerima kesalahan yang memungkinkan pekerjaan untuk dicoba lagi, secara otomatis AWS Backup akan mencoba lagi untuk memulai pekerjaan setidaknya setiap 10 menit sampai pencadangan berhasil dimulai (status pekerjaan berubah menjadi`RUNNING`) atau sampai status pekerjaan berubah menjadi `EXPIRED` (yang diharapkan terjadi ketika waktu jendela mulai selesai).  
Tipe: Panjang  
Wajib: Tidak

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

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

{
   "BackupJobId": "string",
   "CreationDate": number,
   "IsParent": boolean,
   "RecoveryPointArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [BackupJobId](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-BackupJobId"></a>
Secara unik mengidentifikasi permintaan AWS Backup untuk membuat cadangan sumber daya.  
Tipe: String

 ** [CreationDate](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-CreationDate"></a>
Tanggal dan waktu pekerjaan 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

 ** [IsParent](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-IsParent"></a>
Ini adalah nilai boolean yang dikembalikan yang menunjukkan ini adalah pekerjaan cadangan induk (komposit).  
Jenis: Boolean

 ** [RecoveryPointArn](#API_StartBackupJob_ResponseSyntax) **   <a name="Backup-StartBackupJob-response-RecoveryPointArn"></a>
 *Catatan: Bidang ini hanya dikembalikan untuk sumber daya Amazon EFS dan Advanced DynamoDB.*   
ARN yang secara unik mengidentifikasi titik pemulihan; misalnya,. `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`  
Tipe: String

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

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

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

Kode Status HTTP: 400

 ** InvalidRequestException **   
Menunjukkan bahwa ada sesuatu yang salah dengan input ke permintaan. Misalnya, parameter adalah tipe yang salah.    
 ** 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

 ** ResourceNotFoundException **   
Sumber daya yang diperlukan untuk tindakan 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_StartBackupJob_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/StartBackupJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartBackupJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartBackupJob)