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.

# GetSearchJob
<a name="API_BKS_GetSearchJob"></a>

Dieser Vorgang ruft Metadaten eines Suchauftrags ab, einschließlich seines Fortschritts.

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

```
GET /search-jobs/SearchJobIdentifier HTTP/1.1
```

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

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_RequestSyntax) **   <a name="Backup-BKS_GetSearchJob-request-uri-SearchJobIdentifier"></a>
Erforderliche eindeutige Zeichenfolge, die den Suchauftrag spezifiziert.  
Erforderlich: Ja

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

Der Anforderung besitzt keinen Anforderungstext.

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

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

{
   "CompletionTime": number,
   "CreationTime": number,
   "CurrentSearchProgress": { 
      "ItemsMatchedCount": number,
      "ItemsScannedCount": number,
      "RecoveryPointsScannedCount": number
   },
   "EncryptionKeyArn": "string",
   "ItemFilters": { 
      "EBSItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "FilePaths": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "LastModificationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ]
         }
      ],
      "S3ItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "ETags": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "ObjectKeys": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "VersionIds": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ]
         }
      ]
   },
   "Name": "string",
   "SearchJobArn": "string",
   "SearchJobIdentifier": "string",
   "SearchScope": { 
      "BackupResourceArns": [ "string" ],
      "BackupResourceCreationTime": { 
         "CreatedAfter": number,
         "CreatedBefore": number
      },
      "BackupResourceTags": { 
         "string" : "string" 
      },
      "BackupResourceTypes": [ "string" ],
      "SourceResourceArns": [ "string" ]
   },
   "SearchScopeSummary": { 
      "TotalItemsToScanCount": number,
      "TotalRecoveryPointsToScanCount": number
   },
   "Status": "string",
   "StatusMessage": "string"
}
```

## Antwortelemente
<a name="API_BKS_GetSearchJob_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.

 ** [CompletionTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CompletionTime"></a>
Das Datum und die Uhrzeit, zu der ein Suchauftrag abgeschlossen wurde, im Unix-Format und in koordinierter Weltzeit (UTC). Der Wert von `CompletionTime` ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.  
Typ: Zeitstempel

 ** [CreationTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CreationTime"></a>
Datum und Uhrzeit der Erstellung eines Suchauftrags im Unix-Format und in koordinierter Weltzeit (UTC). Der Wert von `CompletionTime` ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.  
Typ: Zeitstempel

 ** [CurrentSearchProgress](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CurrentSearchProgress"></a>
Gibt Zahlen zurück, die für BackupsScannedCount ItemsScanned, und stehen ItemsMatched.  
Typ: [CurrentSearchProgress](API_BKS_CurrentSearchProgress.md) Objekt

 ** [EncryptionKeyArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-EncryptionKeyArn"></a>
Der Verschlüsselungsschlüssel für den angegebenen Suchauftrag.  
Beispiel: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Typ: Zeichenfolge

 ** [ItemFilters](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-ItemFilters"></a>
Elementfilter stellen alle Eigenschaften des Eingabeelements dar, die bei der Erstellung der Suche angegeben wurden.  
Typ: [ItemFilters](API_BKS_ItemFilters.md) Objekt

 ** [Name](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Name"></a>
Der Name des angegebenen Suchauftrags wurde zurückgegeben.  
Typ: Zeichenfolge

 ** [SearchJobArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobArn"></a>
Die eindeutige Zeichenfolge, die den Amazon-Ressourcennamen (ARN) des angegebenen Suchauftrags identifiziert.  
Typ: Zeichenfolge

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobIdentifier"></a>
Die eindeutige Zeichenfolge, die den angegebenen Suchauftrag identifiziert.  
Typ: Zeichenfolge

 ** [SearchScope](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScope"></a>
Der Suchbereich umfasst alle Backup-Eigenschaften, die in eine Suche eingegeben werden.  
Typ: [SearchScope](API_BKS_SearchScope.md) Objekt

 ** [SearchScopeSummary](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScopeSummary"></a>
Es wurde eine Zusammenfassung des angegebenen Suchauftragsbereichs zurückgegeben, einschließlich:   
+ TotalBackupsToScanCount, die Anzahl der bei der Suche zurückgegebenen Wiederherstellungspunkte.
+ TotalItemsToScanCount, die Anzahl der bei der Suche zurückgegebenen Elemente.
Typ: [SearchScopeSummary](API_BKS_SearchScopeSummary.md) Objekt

 ** [Status](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Status"></a>
Der aktuelle Status des angegebenen Suchauftrags.  
Ein Suchauftrag kann einen der folgenden Status haben:`RUNNING`;;`COMPLETED`;`STOPPED`; `FAILED``TIMED_OUT`; oder`EXPIRED`.  
Typ: Zeichenfolge  
Zulässige Werte: `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [StatusMessage](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-StatusMessage"></a>
Für einen Suchauftrag mit dem Status `ERRORED` oder dem Status von `COMPLETED` Aufträgen mit Problemen wird eine Statusmeldung zurückgegeben.  
Beispielsweise kann in einer Meldung angegeben werden, dass eine Suche Wiederherstellungspunkte enthielt, die aufgrund eines Berechtigungsproblems nicht gescannt werden konnten.  
Typ: Zeichenfolge

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

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

 ** AccessDeniedException **   
Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion.    
 ** message **   
Der Benutzer verfügt nicht über ausreichende Zugriffsrechte, um diese Aktion auszuführen.
HTTP-Statuscode: 403

 ** InternalServerException **   
Es ist ein interner Serverfehler aufgetreten. Wiederholen Sie Ihre Anforderung.    
 ** message **   
Unerwarteter Fehler bei der Bearbeitung der Anfrage.  
 ** retryAfterSeconds **   
Versuchen Sie den Anruf nach einigen Sekunden erneut.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Die Ressource wurde für diese Anfrage nicht gefunden.  
Vergewissern Sie sich, dass die Ressourceninformationen, wie z. B. der ARN oder der Typ, korrekt und vorhanden sind, und wiederholen Sie dann die Anfrage.    
 ** message **   
Die Anfrage verweist auf eine Ressource, die nicht existiert.  
 ** resourceId **   
Hypothetischer Identifier der betroffenen Ressource.  
 ** resourceType **   
Hypothetischer Typ der betroffenen Ressource.
HTTP-Statuscode: 404

 ** ThrottlingException **   
Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.    
 ** message **   
Die Anfrage war aufgrund der Drosselung der Anfrage nicht erfolgreich.  
 ** quotaCode **   
Dies ist der eindeutige Code für den ursprünglichen Dienst mit dem Kontingent.  
 ** retryAfterSeconds **   
Versuchen Sie den Anruf nach einigen Sekunden erneut.  
 ** serviceCode **   
Dies ist der eindeutige Code für den ursprünglichen Dienst.
HTTP-Statuscode: 429

 ** ValidationException **   
Die Eingabe erfüllt nicht die von einem Dienst angegebenen Einschränkungen.    
 ** message **   
Die Eingabe erfüllt nicht die von einem Amazon-Service angegebenen Einschränkungen.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_BKS_GetSearchJob_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/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchJob)