

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Startet das Scannen von Aufträgen für bestimmte Ressourcen.

## Anforderungssyntax
<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"
}
```

## URI-Anfrageparameter
<a name="API_StartScanJob_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_StartScanJob_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [BackupVaultName](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-BackupVaultName"></a>
Der Name eines logischen Containers, in dem die Sicherungen gespeichert werden. Backup-Tresore werden anhand von Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und für die AWS Region, in der sie erstellt wurden, eindeutig sind.  
Pattern: `^[a-zA-Z0-9\-\_]{2,50}$`   
Typ: Zeichenfolge  
Erforderlich: Ja

 ** [IamRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IamRoleArn"></a>
Gibt den ARN der IAM-Rolle an, der zum Erstellen des Ziel-Wiederherstellungspunkts verwendet wurde; zum Beispiel `arn:aws:iam::123456789012:role/S3Access`.  
Typ: Zeichenfolge  
Erforderlich: Ja

 ** [IdempotencyToken](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IdempotencyToken"></a>
Eine vom Kunden gewählte Zeichenfolge, mit der Sie zwischen ansonsten identischen Aufrufen an `StartScanJob` unterscheiden können. Der erneute Versuch einer erfolgreichen Anforderung mit demselben Idempotenz-Token führt zu einer Erfolgsmeldung, ohne dass Maßnahmen ergriffen werden.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [MalwareScanner](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-MalwareScanner"></a>
Gibt den Malware-Scanner an, der während des Scanauftrags verwendet wurde. Unterstützt derzeit nur`GUARDDUTY`.  
Typ: Zeichenfolge  
Zulässige Werte: `GUARDDUTY`   
Erforderlich: Ja

 ** [RecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-RecoveryPointArn"></a>
Ein Amazon-Ressourcenname (ARN), der einen Wiederherstellungspunkt eindeutig identifiziert. Dies ist Ihr Ziel-Erholungspunkt für einen vollständigen Scan. Wenn Sie einen inkrementellen Scan ausführen, ist dies Ihr Erholungspunkt, der nach der Auswahl Ihres Basiswiederherstellungspunkts erstellt wurde.  
Typ: Zeichenfolge  
Erforderlich: Ja

 ** [ScanBaseRecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanBaseRecoveryPointArn"></a>
Ein ARN, der den Basiswiederherstellungspunkt, der für das inkrementelle Scannen verwendet werden soll, eindeutig identifiziert.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [ScanMode](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanMode"></a>
Gibt den für den Scanauftrag verwendeten Scantyp an.  
Beinhaltet:  
+  `FULL_SCAN`scannt die gesamte Datenlinie innerhalb des Backups.
+  `INCREMENTAL_SCAN`scannt den Datenunterschied zwischen dem Zielwiederherstellungspunkt und dem Basiswiederherstellungspunkt-ARN.
Typ: Zeichenfolge  
Zulässige Werte: `FULL_SCAN | INCREMENTAL_SCAN`   
Erforderlich: Ja

 ** [ScannerRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScannerRoleArn"></a>
Der ARN für die IAM-Scannerrolle wurde angegeben.  
Typ: Zeichenfolge  
Erforderlich: Ja

## Antwortsyntax
<a name="API_StartScanJob_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_StartScanJob_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP-201-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [CreationDate](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-CreationDate"></a>
Das Datum und die Uhrzeit der Erstellung eines Backup-Auftrags im Unix-Zeitformat und in der koordinierten Weltzeit (UTC). Der Wert von `CreationDate` ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.  
Typ: Zeitstempel

 ** [ScanJobId](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-ScanJobId"></a>
Identifiziert eindeutig eine Anfrage AWS Backup zur Sicherung einer Ressource.  
Typ: Zeichenfolge

## Fehler
<a name="API_StartScanJob_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** InvalidParameterValueException **   
Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.    
 ** Context **   
  
 ** Type **   

HTTP-Statuscode: 400

 ** InvalidRequestException **   
Zeigt an, dass etwas mit der Eingabe für die Anforderung nicht stimmt. Beispielsweise ist ein Parameter vom falschen Typ.    
 ** Context **   
  
 ** Type **   

HTTP-Statuscode: 400

 ** LimitExceededException **   
Ein Limit in der Anforderung wurde überschritten, z. B. die maximale Anzahl von Elementen, die in einer Anforderung zulässig sind.    
 ** Context **   
  
 ** Type **   

HTTP-Statuscode: 400

 ** MissingParameterValueException **   
Zeigt an, dass ein erforderlicher Parameter fehlt.    
 ** Context **   
  
 ** Type **   

HTTP-Statuscode: 400

 ** ResourceNotFoundException **   
Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.    
 ** Context **   
  
 ** Type **   

HTTP-Statuscode: 400

 ** ServiceUnavailableException **   
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.    
 ** Context **   
  
 ** Type **   

HTTP Status Code: 500

## Weitere Informationen finden Sie unter:
<a name="API_StartScanJob_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle 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 für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK für 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 für 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) 