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

StartCopyJob

Startet einen Auftrag zum Erstellen einer einmaligen Kopie der angegebenen Ressource.

Unterstützt keine kontinuierlichen Backups.

Anforderungssyntax

PUT /copy-jobs HTTP/1.1
Content-type: application/json

{
   "DestinationBackupVaultArn": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "RecoveryPointArn": "string",
   "SourceBackupVaultName": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

DestinationBackupVaultArn

Ein Amazon-Ressourcenname (ARN), der einen Ziel-Backup-Tresor eindeutig identifiziert, z. B. arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.

Typ: Zeichenfolge

Erforderlich: Ja

IamRoleArn

Gibt den ARN der IAM-Rolle an, der zum Kopieren des Ziel-Wiederherstellungspunkts verwendet wurde; zum Beispiel arn:aws:iam::123456789012:role/S3Access.

Typ: Zeichenfolge

Erforderlich: Ja

IdempotencyToken

Eine vom Kunden gewählte Zeichenfolge, mit der Sie zwischen ansonsten identischen Aufrufen an StartCopyJob unterscheiden können. Der erneute Versuch einer erfolgreichen Anforderung mit demselben Idempotenz-Token führt zu einer Erfolgsmeldung, ohne dass Maßnahmen ergriffen werden.

Typ: Zeichenfolge

Erforderlich: Nein

Lifecycle

Gibt den Zeitraum in Tagen an, bevor ein Recovery Point in den Cold Storage übergeht oder gelöscht wird.

In den Cold Storage übertragene Sicherungen müssen mindestens 90 Tage lang im Cold Storage gespeichert werden. Daher muss die Aufbewahrungseinstellung auf der Konsole um 90 Tage höher sein als die Einstellung für den Übergang zur Einstellung „Kalt nach Tagen“. Die Einstellung für den Übergang zu „kalt nach Tagen“ kann nicht geändert werden, nachdem ein Backup auf „kalt“ umgestellt wurde.

Ressourcentypen, die auf Cold Storage umgestellt werden können, sind in der Tabelle Verfügbarkeit von Funktionen nach Ressourcen aufgeführt. AWS Backup ignoriert diesen Ausdruck für andere Ressourcentypen.

Um den bestehenden Lebenszyklus und die Aufbewahrungsfristen zu entfernen und Ihre Wiederherstellungspunkte unbegrenzt beizubehalten, geben Sie -1 für MoveToColdStorageAfterDays und an. DeleteAfterDays

Typ: Lifecycle Objekt

Erforderlich: Nein

RecoveryPointArn

Ein ARN, der einen für den Kopierauftrag zu verwendenden Wiederherstellungspunkt eindeutig identifiziert, z. B. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Typ: Zeichenfolge

Erforderlich: Ja

SourceBackupVaultName

Der Name eines logischen Quellcontainers, in dem die Backups gespeichert werden. Backup-Tresore werden anhand von Namen identifiziert, die für das Konto, mit dem sie erstellt wurden, und für die AWS Region, in der sie erstellt wurden, eindeutig sind.

Typ: Zeichenfolge

Pattern: ^[a-zA-Z0-9\-\_]{2,50}$

Erforderlich: Ja

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "CopyJobId": "string",
   "CreationDate": number,
   "IsParent": boolean
}

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.

CopyJobId

Identifiziert einen Kopierauftrag eindeutig.

Typ: Zeichenfolge

CreationDate

Das Datum und die Uhrzeit der Erstellung eines Kopierauftrags im Unix-Zeitformat und in der koordinierten Weltzeit (UTC). Der Wert von CreationDate ist auf Millisekunden genau. Der Wert 1516925490.087 steht beispielsweise für Freitag, 26. Januar 2018, 12:11:30.087 Uhr.

Typ: Zeitstempel

IsParent

Dies ist ein zurückgegebener boolescher Wert, der angibt, dass es sich um einen übergeordneten (zusammengesetzten) Kopierauftrag handelt.

Typ: Boolesch

Fehler

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

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

ResourceNotFoundException

Eine Ressource, die für die Aktion erforderlich ist, ist nicht vorhanden.

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: