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.
StartSearchResultExportJob
Dieser Vorgang startet einen Job, um die Ergebnisse des Suchauftrags in einen bestimmten S3-Bucket zu exportieren.
Anforderungssyntax
PUT /export-search-jobs HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"ExportSpecification": { ... },
"RoleArn": "string",
"SearchJobIdentifier": "string",
"Tags": {
"string" : "string"
}
}URI-Anfrageparameter
Die Anforderung verwendet keine URI-Parameter.
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- ClientToken
-
Fügen Sie diesen Parameter hinzu, um mehrere identische Aufrufe zur Feststellung von Idempotenz zu ermöglichen.
Ein Client-Token ist 8 Stunden lang gültig, nachdem die erste Anfrage, die es verwendet, abgeschlossen wurde. Nach Ablauf dieser Zeit wird jede Anfrage mit demselben Token als neue Anfrage behandelt.
Typ: Zeichenfolge
Erforderlich: Nein
- ExportSpecification
-
Diese Spezifikation enthält eine erforderliche Zeichenfolge für den Ziel-Bucket. Optional können Sie das Zielpräfix angeben.
Typ: ExportSpecification Objekt
Hinweis: Dieses Objekt ist eine Union. Nur ein Mitglied dieses Objekts kann angegeben oder zurückgegeben werden.
Erforderlich: Ja
- RoleArn
-
Dieser Parameter gibt den Rollen-ARN an, der zum Starten der Exportaufträge für Suchergebnisse verwendet wird.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 20. Maximale Länge beträgt 2048 Zeichen.
Pattern:
arn:(?:aws|aws-cn|aws-us-gov):iam::[a-z0-9-]+:role/(.+)Erforderlich: Nein
- SearchJobIdentifier
-
Die eindeutige Zeichenfolge, die den Suchauftrag spezifiziert.
Typ: Zeichenfolge
Erforderlich: Ja
- Tags
-
Optionale Tags, die hinzugefügt werden sollen. Ein Tag ist ein Schlüssel-Wert-Paar, mit dem Sie Ihre Ressourcen verwalten, filtern und suchen können. Erlaubte Zeichen sind: UTF-8-Buchstaben, Zahlen, Leerzeichen und die folgenden Zeichen: + - = . _ : /.
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge
Erforderlich: Nein
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"ExportJobArn": "string",
"ExportJobIdentifier": "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.
- ExportJobArn
-
Dies ist der eindeutige ARN (Amazon Resource Name), der zu dem neuen Exportauftrag gehört.
Typ: Zeichenfolge
- ExportJobIdentifier
-
Dies ist die eindeutige Kennung, die den neuen Exportauftrag spezifiziert.
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
- ConflictException
-
Diese Ausnahme tritt auf, wenn ein Konflikt mit einem vorherigen erfolgreichen Vorgang erkannt wird. Dies tritt im Allgemeinen auf, wenn der vorherige Vorgang keine Zeit hatte, sich an den Host zu übertragen, der die aktuelle Anforderung bedient.
Ein erneuter Versuch (mit entsprechender Backoff-Logik) ist die empfohlene Reaktion auf diese Ausnahme.
- message
-
Das Aktualisieren oder Löschen einer Ressource kann zu einem inkonsistenten Zustand führen.
- resourceId
-
Kennung der betroffenen Ressource.
- resourceType
-
Typ der betroffenen Ressource.
HTTP-Statuscode: 409
- 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
- ServiceQuotaExceededException
-
Die Anfrage wurde aufgrund der Überschreitung der zulässigen Kontingentgrenzen abgelehnt.
- message
-
Diese Anfrage war nicht erfolgreich, da ein Dienstkontingent die Grenzwerte überschritten hat.
- quotaCode
-
Dies ist der Code, der für den Kontingenttyp spezifisch ist.
- resourceId
-
Bezeichner der Ressource.
- resourceType
-
Typ der Ressource.
- serviceCode
-
Dies ist der eindeutige Code für den ursprünglichen Dienst mit dem Kontingent.
HTTP-Statuscode: 402
- 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:
