

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.

# DescribeScanJob
<a name="API_DescribeScanJob"></a>

Gibt die Details des Scanauftrags für die angegebene ScanJob ID zurück.

## Anforderungssyntax
<a name="API_DescribeScanJob_RequestSyntax"></a>

```
GET /scan/jobs/ScanJobId HTTP/1.1
```

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

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [ScanJobId](#API_DescribeScanJob_RequestSyntax) **   <a name="Backup-DescribeScanJob-request-uri-ScanJobId"></a>
Identifiziert eindeutig eine Anfrage AWS Backup zum Scannen einer Ressource.  
Erforderlich: Ja

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

Der Anforderung besitzt keinen Anforderungstext.

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

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

{
   "AccountId": "string",
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanVersion": "string",
      "BackupRuleId": "string"
   },
   "CreationDate": number,
   "IamRoleArn": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanId": "string",
   "ScanJobId": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string",
   "ScanResult": { 
      "ScanResultStatus": "string"
   },
   "State": "string",
   "StatusMessage": "string"
}
```

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

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

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

 ** [AccountId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-AccountId"></a>
Gibt die Konto-ID zurück, der der Scanauftrag gehört.  
Pattern: `^[0-9]{12}$`   
Typ: Zeichenfolge

 ** [BackupVaultArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-BackupVaultArn"></a>
Ein Amazon-Ressourcenname (ARN), der einen Backup-Tresor eindeutig identifiziert; zum Beispiel `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`   
Typ: Zeichenfolge

 ** [BackupVaultName](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-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

 ** [CompletionDate](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CompletionDate"></a>
Datum und Uhrzeit, an dem die Erstellung eines Backup-Index abgeschlossen wurde, im Unix-Format und in koordinierter Weltzeit (UTC). Der Wert von `CompletionDate` ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.  
Typ: Zeitstempel

 ** [CreatedBy](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CreatedBy"></a>
Enthält identifizierende Informationen über die Erstellung eines Scanauftrags, einschließlich des Sicherungsplans und der Regel, die den Scan initiiert haben.  
Typ: [ScanJobCreator](API_ScanJobCreator.md) Objekt

 ** [CreationDate](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CreationDate"></a>
Datum und Uhrzeit, zu der die Erstellung eines Backup-Index abgeschlossen wurde, im Unix-Format und in koordinierter 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

 ** [IamRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-IamRoleArn"></a>
Ein Amazon-Ressourcenname (ARN), der einen Backup-Tresor eindeutig identifiziert, z. B. `arn:aws:iam::123456789012:role/S3Access`.  
Typ: Zeichenfolge

 ** [MalwareScanner](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-MalwareScanner"></a>
Die Scan-Engine, die für den entsprechenden Scanauftrag verwendet wurde. Derzeit wird nur `GUARDUTY` unterstützt.  
Typ: Zeichenfolge  
Zulässige Werte: `GUARDDUTY` 

 ** [RecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-RecoveryPointArn"></a>
Ein ARN, der den Zielwiederherstellungspunkt für das Scannen eindeutig identifiziert.; zum Beispiel`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Typ: Zeichenfolge

 ** [ResourceArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceArn"></a>
Ein ARN, der die Quellressource des entsprechenden Wiederherstellungspunkt-ARN eindeutig identifiziert.  
Typ: Zeichenfolge

 ** [ResourceName](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceName"></a>
Der nicht eindeutige Name der Ressource, die zu der angegebenen Sicherung gehört.  
Typ: Zeichenfolge

 ** [ResourceType](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceType"></a>
Der Typ der AWS Ressource, die gesichert werden soll, z. B. ein Amazon Elastic Block Store (Amazon EBS) -Volume.  
Pattern: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Typ: Zeichenfolge  
Zulässige Werte: `EBS | EC2 | S3` 

 ** [ScanBaseRecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanBaseRecoveryPointArn"></a>
Ein ARN, der den Basiswiederherstellungspunkt für das Scannen eindeutig identifiziert. Dieses Feld wird nur ausgefüllt, wenn ein inkrementeller Scanauftrag stattgefunden hat.  
Typ: Zeichenfolge

 ** [ScanId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanId"></a>
Die von Amazon GuardDuty für die entsprechende Scan-Job-ID-Anfrage von generierte Scan-ID AWS Backup.  
Typ: Zeichenfolge

 ** [ScanJobId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanJobId"></a>
Die Scanauftrags-ID, mit der die Anfrage eindeutig identifiziert wurde AWS Backup.  
Typ: Zeichenfolge

 ** [ScanMode](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanMode"></a>
Gibt den für den Scanauftrag verwendeten Scantyp an.  
Typ: Zeichenfolge  
Zulässige Werte: `FULL_SCAN | INCREMENTAL_SCAN` 

 ** [ScannerRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScannerRoleArn"></a>
Gibt die Scanner-IAM-Rolle an, für die ARN für den Scanauftrag verwendet wurde.  
Typ: Zeichenfolge

 ** [ScanResult](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanResult"></a>
 Enthält den Wert `ScanResultsStatus` für den Scanauftrag und gibt den Wert `NO_THREATS_FOUND` für `THREATS_FOUND` abgeschlossene Aufträge zurück.  
Typ: [ScanResultInfo](API_ScanResultInfo.md) Objekt

 ** [State](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-State"></a>
Der aktuelle Status eines Scanauftrags.  
Typ: Zeichenfolge  
Zulässige Werte: `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` 

 ** [StatusMessage](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-StatusMessage"></a>
Eine ausführliche Meldung, in der der Status des Backup-Auftrags für eine Ressource erläutert wird.  
Typ: Zeichenfolge

## Fehler
<a name="API_DescribeScanJob_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

 ** 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_DescribeScanJob_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/DescribeScanJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeScanJob) 