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

StartScanJob

Mulai memindai pekerjaan untuk sumber daya tertentu.

Minta Sintaks

PUT /scan/job HTTP/1.1
Content-type: application/json

{
   "BackupVaultName": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

BackupVaultName

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

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

Tipe: String

Diperlukan: Ya

IamRoleArn

Menentukan peran IAM ARN digunakan untuk membuat 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. StartScanJob Mencoba kembali permintaan yang berhasil dengan token idempotensi yang sama menghasilkan pesan sukses tanpa tindakan yang diambil.

Tipe: String

Wajib: Tidak

MalwareScanner

Menentukan pemindai malware yang digunakan selama pekerjaan pemindaian. Saat ini hanya mendukungGUARDDUTY.

Tipe: String

Nilai yang Valid: GUARDDUTY

Wajib: Ya

RecoveryPointArn

Nama Sumber Daya Amazon (ARN) yang secara unik mengidentifikasi titik pemulihan. Ini adalah titik pemulihan target Anda untuk pemindaian penuh. Jika Anda menjalankan pemindaian tambahan, ini akan menjadi titik pemulihan Anda yang telah dibuat setelah pemilihan titik pemulihan dasar Anda.

Tipe: String

Diperlukan: Ya

ScanBaseRecoveryPointArn

ARN yang secara unik mengidentifikasi titik pemulihan dasar yang akan digunakan untuk pemindaian inkremental.

Tipe: String

Wajib: Tidak

ScanMode

Menentukan jenis scan digunakan untuk pekerjaan scan.

Termasuk:

  • FULL_SCANakan memindai seluruh garis keturunan data dalam cadangan.

  • INCREMENTAL_SCANakan memindai perbedaan data antara titik pemulihan target dan titik pemulihan dasar ARN.

Tipe: String

Nilai yang Valid: FULL_SCAN | INCREMENTAL_SCAN

Wajib: Ya

ScannerRoleArn

Ditentukan peran pemindai IAM ARN.

Tipe: String

Diperlukan: Ya

Sintaksis Respons

HTTP/1.1 201
Content-type: application/json

{
   "CreationDate": number,
   "ScanJobId": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

CreationDate

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

ScanJobId

Secara unik mengidentifikasi permintaan AWS Backup untuk membuat cadangan sumber daya.

Tipe: String

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.

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

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