jobParameters - Amazon S3 Glacier

Diese Seite richtet sich nur an Bestandskunden des S3 Glacier-Dienstes, die Vaults und das Original REST API von 2012 verwenden.

Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der S3 Glacier-Speicherklassen in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive. Weitere Informationen zu diesen Speicheroptionen finden Sie unter S3 Glacier-Speicherklassen und Langfristige Datenspeicherung mit S3 Glacier-Speicherklassen im Amazon S3 S3-Benutzerhandbuch. Diese Speicherklassen verwenden Amazon S3API, sind in allen Regionen verfügbar und können in der Amazon S3 S3-Konsole verwaltet werden. Sie bieten Funktionen wie Speicherkostenanalyse, Storage Lens, erweiterte optionale Verschlüsselungsfunktionen und mehr.

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.

jobParameters

Bietet Optionen zum Definieren von Jobs

Inhalt

ArchiveId

Die ID des gewünschten Archivs. Dieses Feld ist erforderlich, wenn das Feld Type auf select oder archive-retrieval eingestellt ist. Wenn Sie dieses Feld bei einer Auftragsanforderung für eine Inventarabfrage festlegen, tritt ein Fehler auf.

Gültige Werte: Es muss sich um eine gültige Archiv-ID handeln, die Sie bei einer vorherigen Anforderung an Amazon S3 Glacier (S3 Glacier) abgerufen haben.

Typ: Zeichenfolge

Erforderlich: Ja, wenn Type auf select oder archive-retrieval eingestellt ist.

Beschreibung

Geben Sie die optionale Beschreibung für den Auftrag ein.

Gültige Werte: Die Beschreibung darf höchstens 1 024 Bytes umfassen. Zulässig sind 7-Bit-ASCII-Zeichen ohne Steuercodes, also die ASCII-Dezimalwerte 32 bis 126 bzw. die ASCII-Hexadezimalwerte 0x20 bis 0x7E.

Typ: Zeichenfolge

Erforderlich: Nein

Format

(Optional) Das Ausgabeformat, das beim Initiieren des Auftrags zum Abrufen einer Tresorinventarliste festgelegt wird. Wenn Sie einen Inventarauftrag initiieren und kein Format-Feld angeben, wird JSON als Standardformat verwendet.

Gültige Werte: CSV | JSON

Typ: Zeichenfolge

Erforderlich: Nein

InventoryRetrievalParameters

Die Eingabeparameter für die Inventarabfrage für einzelne Bereiche

Typ: InventoryRetrievalJobInput-Objekt

Erforderlich: Nein

OutputLocation

Ein Objekt, das Informationen zum Speicherort der Ergebnisse des ausgewählten Jobs enthält

Typ: OutputLocation-Objekt

Erforderlich: Ja, für select-Aufträge

RetrievalByteRange

Der für archive-retrieval abzurufende Bytebereich in der Form "StartByteValue-EndByteValue". Wenn kein Bereich angegeben ist, wird das gesamte Archiv abgerufen. Wenn ein Feldwert angegeben wird, muss der Bereich in Megabytewerten (1024*1024) angegeben werden. Das bedeutet, StartByteValue muss 1 MB oder ein Vielfaches davon sein und EndByteValue plus 1 muss durch 1 MB teilbar sein oder dem Ende des Archivs entsprechen, das als der Wert der Archivbytegröße minus 1 angegeben ist. Wenn die Angabe für RetrievalByteRange kein ganzer Megabytewert ist, wird bei diesem Vorgang die Antwort 400 zurückgegeben.

Wenn Sie dieses Feld bei einer inventory-retrieval- oder select-Auftragsanforderung festlegen, tritt ein Fehler auf.

Typ: Zeichenfolge

Erforderlich: Nein

SelectParameters

Ein Objekt mit Informationen zu den Parametern für eine Auswahl

Typ: SelectParameters-Objekt

Erforderlich: Nein

SNSTopic

Der Amazon-Ressourcenname (ARN) des Amazon-SNS-Themas, an das S3 Glacier eine Benachrichtigung sendet, wenn der Auftrag abgeschlossen ist und die Ausgabe zum Herunterladen bereitsteht. Das angegebene Thema veröffentlicht die Benachrichtigung an die Abonnenten.

Das SNS-Thema muss vorhanden sein. Wenn es nicht vorhanden ist, wird es von S3 Glacier auch nicht erstellt. Das SNS-Thema muss außerdem über eine Richtlinie verfügen, die dem Konto, über das der Auftrag erstellt wurde, erlaubt, Nachrichten im Thema zu veröffentlichen. Weitere Informationen über SNS-Themennamen finden Sie unter CreateTopic in der Amazon Simple Notification Service API-Referenz.

Typ: Zeichenfolge

Erforderlich: Nein

Stufe

Das Kontingent, das für eine Auswahl oder einen Archivabruf verwendet wird. Der Standardwert ist Standard.

Zulässige Werte: Expedited | Standard | Bulk

Typ: Zeichenfolge

Erforderlich: Nein

Typ

Der Auftragstyp. Sie können eine -Aufgabe initiieren, um eine Auswahlabfrage an ein Archiv zu senden, ein Archiv abzurufen oder ein Inventar des Tresors zu ermitteln.

Zulässige Werte: select | archive-retrieval | inventory-retrieval

Typ: Zeichenfolge

Erforderlich: Ja

Weitere Infos