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

ListCopyJobs

Gibt Metadaten zu Ihren Kopieraufträgen zurück.

Anforderungssyntax

GET /copy-jobs/?accountId=ByAccountId&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&destinationVaultArn=ByDestinationVaultArn&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&state=ByState HTTP/1.1

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

ByAccountId

Die Konto-ID, von der die Aufträge aufgelistet werden sollen. Gibt nur Kopieraufträge zurück, die der angegebenen Konto-ID zugeordnet sind.

Pattern: ^[0-9]{12}$

ByCompleteAfter

Gibt nur Kopieraufträge zurück, die nach einem Datum im Unix-Format und in der koordinierten Weltzeit (UTC) abgeschlossen wurden.

ByCompleteBefore

Gibt nur Kopieraufträge zurück, die vor einem Datum im Unix-Format und in der koordinierten Weltzeit (UTC) abgeschlossen wurden.

ByCreatedAfter

Gibt nur Kopieraufträge zurück, die nach dem angegebenen Datum erstellt wurden.

ByCreatedBefore

Gibt nur Kopieraufträge zurück, die vor dem angegebenen Datum erstellt wurden.

ByDestinationVaultArn

Ein Amazon-Ressourcenname (ARN), der einen Quell-Backup-Tresor eindeutig identifiziert, von dem kopiert werden soll, z. B. arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.

ByMessageCategory

Dies ist ein optionaler Parameter, mit dem Jobs herausgefiltert werden können MessageCategory , deren Wert dem von Ihnen eingegebenen Wert entspricht.

Beispielzeichenfolgen können AccessDenied, SUCCESS, AGGREGATE_ALL oder INVALIDPARAMETERS sein.

Unter Überwachung finden Sie eine Liste der akzeptierten Zeichenfolgen.

Der Wert ANY gibt die Anzahl aller Nachrichtenkategorien zurück.

AGGREGATE_ALL aggregiert die Anzahl der Aufträge für alle Nachrichtenkategorien und gibt die Summe zurück.

ByParentJobId

Dies ist ein Filter, um untergeordnete (verschachtelte) Aufträge auf Grundlage der übergeordneten Auftrags-ID aufzulisten.

ByResourceArn

Gibt nur Kopieraufträge zurück, die mit dem Amazon-Ressourcennamen (ARN) der angegebenen Ressource übereinstimmen.

ByResourceType

Gibt nur Backup-Aufträge für die angegebenen Ressourcen zurück:

  • Aurora für Amazon Aurora

  • CloudFormationfür AWS CloudFormation

  • DocumentDB für Amazon DocumentDB (mit MongoDB-Kompatibilität)

  • DynamoDB für Amazon DynamoDB

  • EBS für Amazon Elastic Block Store

  • EC2 für Amazon Elastic Compute Cloud

  • EFS für Amazon Elastic File System

  • FSxfür Amazon FSx

  • Neptune für Amazon Neptune

  • RDS für Amazon Relational Database Service

  • Redshift für Amazon Redshift

  • S3für Amazon Simple Storage Service (Amazon S3)

  • SAP HANA on Amazon EC2für SAP HANA-Datenbanken auf Amazon Elastic Compute Cloud-Instances

  • Storage Gatewayfür AWS Storage Gateway

  • Timestream für Amazon Timestream

  • VirtualMachinefür VMware virtuelle Maschinen

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

ByState

Gibt nur Kopieraufträge zurück, die sich im angegebenen Status befinden.

Zulässige Werte: CREATED | RUNNING | COMPLETED | FAILED | PARTIAL

MaxResults

Die maximale Anzahl der zurückzugebenden Elemente.

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anfrage zur Rückgabe der MaxResults Anzahl von Elementen gestellt wird, NextToken können Sie mehr Elemente in Ihrer Liste zurückgeben, beginnend an der Position, auf die das nächste Token zeigt.

Anforderungstext

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "CopyJobs": [ 
      { 
         "AccountId": "string",
         "BackupSizeInBytes": number,
         "ChildJobsInState": { 
            "string" : number 
         },
         "CompletionDate": number,
         "CompositeMemberIdentifier": "string",
         "CopyJobId": "string",
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreationDate": number,
         "DestinationBackupVaultArn": "string",
         "DestinationEncryptionKeyArn": "string",
         "DestinationRecoveryPointArn": "string",
         "DestinationRecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "DestinationVaultLockState": "string",
         "DestinationVaultType": "string",
         "IamRoleArn": "string",
         "IsParent": boolean,
         "MessageCategory": "string",
         "NumberOfChildJobs": number,
         "ParentJobId": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "SourceBackupVaultArn": "string",
         "SourceRecoveryPointArn": "string",
         "State": "string",
         "StatusMessage": "string"
      }
   ],
   "NextToken": "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.

CopyJobs

Eine Reihe von Strukturen, die Metadaten zu Ihren Kopieraufträgen enthalten, die im JSON-Format zurückgegeben wurden.

Typ: Array von CopyJob-Objekten

NextToken

Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anfrage zur Rückgabe der MaxResults Anzahl von Elementen gestellt wird, NextToken können Sie mehr Elemente in Ihrer Liste zurückgeben, beginnend an der Position, auf die das nächste Token zeigt.

Typ: Zeichenfolge

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.

Context

Type

HTTP Status Code: 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: