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.
CreateLogicallyAirGappedBackupVault
Diese Anforderung erstellt einen logischen Container, in den Backups kopiert werden können.
Diese Anforderung umfasst einen Namen, die Region, die maximale Anzahl von Aufbewahrungstagen und die Mindestanzahl von Aufbewahrungstagen. Sie kann optional Tags und eine Anforderungs-ID des Erstellers enthalten.
Anmerkung
Fügen Sie keine sensiblen Daten wie Passnummern in den Namen eines Backup-Tresors ein.
Anforderungssyntax
PUT /logically-air-gapped-backup-vaults/backupVaultName
HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string
" : "string
"
},
"CreatorRequestId": "string
",
"MaxRetentionDays": number
,
"MinRetentionDays": number
}
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- backupVaultName
-
Dies ist der Name des Tresors, der erstellt wird.
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$
Erforderlich: Ja
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- BackupVaultTags
-
Dies sind die Tags, die in den neu erstellten Tresor aufgenommen werden.
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge
Erforderlich: Nein
- CreatorRequestId
-
Dies ist die ID der Erstellungsanforderung.
Dieser Parameter ist optional. Wenn dieser Parameter verwendet wird, muss er 1 bis 50 alphanumerische Zeichen oder „-_“ enthalten. Zeichen.
Typ: Zeichenfolge
Erforderlich: Nein
- MaxRetentionDays
-
Dies ist die Einstellung, die die maximale Aufbewahrungsdauer angibt, in welcher der Tresor seine Wiederherstellungspunkte beibehält. Wenn dieser Parameter nicht angegeben wird, erzwingt AWS Backup keine maximale Aufbewahrungsdauer für die Wiederherstellungspunkte im Tresor (und erlaubt somit eine unbegrenzte Speicherung).
Wenn angegeben, muss jeder Backup- oder Kopierauftrag in den Tresor über eine Lebenszyklusrichtlinie mit einer Aufbewahrungsdauer verfügen, die der maximalen Aufbewahrungsdauer entspricht oder kürzer ist. Wenn die Aufbewahrungsdauer des Auftrags länger als die maximale Aufbewahrungsdauer ist, schlägt der Tresor den Backup- oder Kopierauftrag fehl, und Sie sollten entweder Ihre Lebenszyklus-Einstellungen ändern oder einen anderen Tresor verwenden.
Type: Long
Erforderlich: Ja
- MinRetentionDays
-
Diese Einstellung gibt den Mindestaufbewahrungszeitraum an, in dem der Tresor seine Wiederherstellungspunkte beibehält. Wenn dieser Parameter nicht angegeben wird, wird keine Mindestaufbewahrungsdauer erzwungen.
Wenn angegeben, muss jeder Backup- oder Kopierauftrag in den Tresor über eine Lebenszyklusrichtlinie mit einer Aufbewahrungsdauer verfügen, die der minimalen Aufbewahrungsdauer entspricht oder länger ist. Wenn die Aufbewahrungsfrist des Auftrags länger als die maximale Aufbewahrungsdauer ist, kann der Tresor den Backup- oder Kopierauftrag nicht ausführen und Sie sollten entweder Ihre Lebenszyklus-Einstellungen ändern oder einen anderen Tresor verwenden.
Type: Long
Erforderlich: Ja
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "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.
- BackupVaultArn
-
Dies ist der ARN (Amazon Resource Name) des Tresors, der erstellt wird.
Typ: Zeichenfolge
- BackupVaultName
-
Der Name eines logischen Containers, in dem die Sicherungen gespeichert werden. Logische Air-Gapped Backup-Vaults werden durch Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und die -Region, in der sie erstellt wurden, eindeutig sind. Sie bestehen aus Kleinbuchstaben, Zahlen und Bindestrichen.
Typ: Zeichenfolge
Pattern:
^[a-zA-Z0-9\-\_]{2,50}$
- CreationDate
-
Das Datum und die Uhrzeit, zu der der Tresor erstellt wurde.
Dieser Wert ist im Unix-Format in Coordinated Universal Time (UTC) und ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.
Typ: Zeitstempel
- VaultState
-
Dies ist der aktuelle Status des Tresors.
Typ: Zeichenfolge
Zulässige Werte:
CREATING | AVAILABLE | FAILED
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.
HTTP Status Code: 400
- InvalidParameterValueException
-
Zeigt an, dass etwas mit dem Wert eines Parameters nicht stimmt. Beispielsweise liegt der Wert außerhalb des zulässigen Bereichs.
HTTP Status Code: 400
- InvalidRequestException
-
Zeigt an, dass etwas mit der Eingabe für die Anforderung nicht stimmt. Beispielsweise ist ein Parameter vom falschen Typ.
HTTP Status Code: 400
- LimitExceededException
-
Ein Limit in der Anforderung wurde überschritten, z. B. die maximale Anzahl von Elementen, die in einer Anforderung zulässig sind.
HTTP Status Code: 400
- MissingParameterValueException
-
Zeigt an, dass ein erforderlicher Parameter fehlt.
HTTP Status Code: 400
- ServiceUnavailableException
-
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.
HTTP Status Code: 500
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: