GetSearchJob - AWS Backup
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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

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

Anforderungssyntax

GET /search-jobs/SearchJobIdentifier HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

SearchJobIdentifier

Erforderliche eindeutige Zeichenfolge, die den Suchauftrag spezifiziert.

Erforderlich: Ja

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

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

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

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

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

Gibt Zahlen zurück, die für BackupsScannedCount ItemsScanned, und stehen ItemsMatched.

Typ: CurrentSearchProgress Objekt

EncryptionKeyArn

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

Elementfilter stellen alle Eigenschaften des Eingabeelements dar, die bei der Erstellung der Suche angegeben wurden.

Typ: ItemFilters Objekt

Name

Der Name des angegebenen Suchauftrags wurde zurückgegeben.

Typ: Zeichenfolge

SearchJobArn

Die eindeutige Zeichenfolge, die den Amazon-Ressourcennamen (ARN) des angegebenen Suchauftrags identifiziert.

Typ: Zeichenfolge

SearchJobIdentifier

Die eindeutige Zeichenfolge, die den angegebenen Suchauftrag identifiziert.

Typ: Zeichenfolge

SearchScope

Der Suchbereich umfasst alle Backup-Eigenschaften, die in eine Suche eingegeben werden.

Typ: SearchScope Objekt

SearchScopeSummary

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 Objekt

Status

Der aktuelle Status des angegebenen Suchauftrags.

Ein Suchauftrag kann einen der folgenden Status haben:RUNNING;;COMPLETED;STOPPED; FAILEDTIMED_OUT; oderEXPIRED.

Typ: Zeichenfolge

Zulässige Werte: RUNNING | COMPLETED | STOPPING | STOPPED | FAILED

StatusMessage

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

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 Status Code: 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 Status Code: 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 Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: