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

# StartScanJob
<a name="API_StartScanJob"></a>

Mulai memindai pekerjaan untuk sumber daya tertentu.

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

```
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
<a name="API_StartScanJob_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

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

Permintaan menerima data berikut dalam format JSON.

 ** [BackupVaultName](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-BackupVaultName"></a>
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](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-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_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IdempotencyToken"></a>
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](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-MalwareScanner"></a>
Menentukan pemindai malware yang digunakan selama pekerjaan pemindaian. Saat ini hanya mendukung`GUARDDUTY`.  
Tipe: String  
Nilai yang Valid: `GUARDDUTY`   
Wajib: Ya

 ** [RecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-RecoveryPointArn"></a>
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](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanBaseRecoveryPointArn"></a>
ARN yang secara unik mengidentifikasi titik pemulihan dasar yang akan digunakan untuk pemindaian inkremental.  
Tipe: String  
Wajib: Tidak

 ** [ScanMode](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanMode"></a>
Menentukan jenis scan digunakan untuk pekerjaan scan.  
Termasuk:  
+  `FULL_SCAN`akan memindai seluruh garis keturunan data dalam cadangan.
+  `INCREMENTAL_SCAN`akan memindai perbedaan data antara titik pemulihan target dan titik pemulihan dasar ARN.
Tipe: String  
Nilai yang Valid: `FULL_SCAN | INCREMENTAL_SCAN`   
Wajib: Ya

 ** [ScannerRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScannerRoleArn"></a>
Ditentukan peran pemindai IAM ARN.  
Tipe: String  
Diperlukan: Ya

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

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

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

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

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CreationDate](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-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

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

## Kesalahan
<a name="API_StartScanJob_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_StartScanJob_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/StartScanJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartScanJob)