CreateTieringConfiguration - 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.

CreateTieringConfiguration

Erstellt eine Tiering-Konfiguration.

Eine Tiering-Konfiguration ermöglicht die automatische Verschiebung von Backup-Daten auf eine kostengünstigere Speicherebene, die auf dem Alter der gesicherten Objekte im Backup-Tresor basiert.

Jeder Tresor kann nur eine tresorspezifische Tiering-Konfiguration haben, zusätzlich zu jeder globalen Konfiguration, die für alle Tresore gilt.

Anforderungssyntax

PUT /tiering-configurations HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ],
      "TieringConfigurationName": "string"
   },
   "TieringConfigurationTags": { 
      "string" : "string" 
   }
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

CreatorRequestId

Dies ist eine eindeutige Zeichenfolge, die die Anfrage identifiziert und die Wiederholung fehlgeschlagener Anfragen ermöglicht, ohne dass das Risiko besteht, dass der Vorgang zweimal ausgeführt wird. Dieser Parameter ist optional. Wenn dieser Parameter verwendet wird, muss er 1 bis 50 alphanumerische Zeichen oder „-_“ enthalten. Zeichen.

Typ: Zeichenfolge

Erforderlich: Nein

TieringConfiguration

Eine Tiering-Konfiguration muss eine von Ihnen erstellte eindeutige TieringConfigurationName Zeichenfolge sowie ein BackupVaultName UND enthalten. ResourceSelection Sie können optional eine CreatorRequestId Zeichenfolge einschließen.

Das TieringConfigurationName ist eine eindeutige Zeichenfolge, die dem Namen der Tiering-Konfiguration entspricht. Dieser Wert kann nach der Erstellung nicht geändert werden und darf nur aus alphanumerischen Zeichen und Unterstrichen bestehen.

Typ: TieringConfigurationInputForCreate Objekt

Erforderlich: Ja

TieringConfigurationTags

Die Tags, die der Tiering-Konfiguration zugewiesen werden sollen.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "TieringConfigurationArn": "string",
   "TieringConfigurationName": "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.

CreationTime

Datum und Uhrzeit der Erstellung einer Tiering-Konfiguration im Unix-Format und in koordinierter Weltzeit (UTC). Der Wert von CreationTime ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30,087 Uhr.

Typ: Zeitstempel

TieringConfigurationArn

Ein Amazon-Ressourcenname (ARN), der die erstellte Tiering-Konfiguration eindeutig identifiziert.

Typ: Zeichenfolge

TieringConfigurationName

Diese eindeutige Zeichenfolge ist der Name der Tiering-Konfiguration.

Der Name kann nach der Erstellung nicht mehr geändert werden. Der Name enthält nur alphanumerische Zeichen und Unterstriche. Die maximale Länge beträgt 200.

Typ: Zeichenfolge

Fehler

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

AlreadyExistsException

Die erforderliche Ressource ist bereits vorhanden.

Arn

Context

CreatorRequestId

Type

HTTP-Statuscode: 400

ConflictException

AWS Backup kann die von Ihnen angeforderte Aktion erst ausführen, wenn die Ausführung einer vorherigen Aktion abgeschlossen ist. Bitte versuchen Sie es später erneut.

Context

Type

HTTP-Statuscode: 400

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

LimitExceededException

Ein Limit in der Anforderung wurde überschritten, z. B. die maximale Anzahl von Elementen, die in einer Anforderung zulässig sind.

Context

Type

HTTP-Statuscode: 400

MissingParameterValueException

Zeigt an, dass ein erforderlicher Parameter fehlt.

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:

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