

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
<a name="API_ListCopyJobs"></a>

Gibt Metadaten zu Ihren Kopieraufträgen zurück.

## Anforderungssyntax
<a name="API_ListCopyJobs_RequestSyntax"></a>

```
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&sourceRecoveryPointArn=BySourceRecoveryPointArn&state=ByState HTTP/1.1
```

## URI-Anfrageparameter
<a name="API_ListCopyJobs_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [ByAccountId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByAccountId"></a>
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](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteAfter"></a>
Gibt nur Kopieraufträge zurück, die nach einem Datum im Unix-Format und in der koordinierten Weltzeit (UTC) abgeschlossen wurden.

 ** [ByCompleteBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteBefore"></a>
Gibt nur Kopieraufträge zurück, die vor einem Datum im Unix-Format und in der koordinierten Weltzeit (UTC) abgeschlossen wurden.

 ** [ByCreatedAfter](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedAfter"></a>
Gibt nur Kopieraufträge zurück, die nach dem angegebenen Datum erstellt wurden.

 ** [ByCreatedBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedBefore"></a>
Gibt nur Kopieraufträge zurück, die vor dem angegebenen Datum erstellt wurden.

 ** [ByDestinationVaultArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByDestinationVaultArn"></a>
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](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByMessageCategory"></a>
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](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) 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](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByParentJobId"></a>
Dies ist ein Filter, um untergeordnete (verschachtelte) Aufträge auf Grundlage der übergeordneten Auftrags-ID aufzulisten.

 ** [ByResourceArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceArn"></a>
Gibt nur Kopieraufträge zurück, die mit dem Amazon-Ressourcennamen (ARN) der angegebenen Ressource übereinstimmen. 

 ** [ByResourceType](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceType"></a>
Gibt nur Backup-Aufträge für die angegebenen Ressourcen zurück:  
+  `Aurora` für Amazon Aurora
+  `CloudFormation`fü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
+  `EKS`für Amazon Elastic Kubernetes Service
+  `FSx`für Amazon FSx
+  `Neptune` für Amazon Neptune
+  `RDS` für Amazon Relational Database Service
+  `Redshift` für Amazon Redshift
+  `S3`für Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2`für SAP HANA-Datenbanken auf Amazon Elastic Compute Cloud-Instances
+  `Storage Gateway`für AWS Storage Gateway 
+  `Timestream` für Amazon Timestream
+  `VirtualMachine`für VMware virtuelle Maschinen
Pattern: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [BySourceRecoveryPointArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-BySourceRecoveryPointArn"></a>
Filter kopieren Jobs nach dem angegebenen Quellwiederherstellungspunkt-ARN.

 ** [ByState](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByState"></a>
Gibt nur Kopieraufträge zurück, die sich im angegebenen Status befinden.  
Zulässige Werte: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL` 

 ** [MaxResults](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-MaxResults"></a>
Die maximale Anzahl der zurückzugebenden Elemente.  
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.

 ** [NextToken](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-NextToken"></a>
Das nächste Element folgt auf eine unvollständige Liste der zurückgegebenen Elemente. Wenn beispielsweise eine Anforderung zur Rückgabe der MaxResults Anzahl von Elementen gestellt wird, NextToken können Sie mehr Elemente in Ihrer Liste zurückgeben, beginnend mit der Position, auf die das nächste Token verweist. 

## Anforderungstext
<a name="API_ListCopyJobs_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_ListCopyJobs_ResponseSyntax"></a>

```
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"
         },
         "CreatedByBackupJobId": "string",
         "CreationDate": number,
         "DestinationBackupVaultArn": "string",
         "DestinationEncryptionKeyArn": "string",
         "DestinationRecoveryPointArn": "string",
         "DestinationRecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "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
<a name="API_ListCopyJobs_ResponseElements"></a>

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](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-CopyJobs"></a>
Eine Reihe von Strukturen, die Metadaten zu Ihren Kopieraufträgen enthalten, die im JSON-Format zurückgegeben wurden.   
Typ: Array von [CopyJob](API_CopyJob.md)-Objekten

 ** [NextToken](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-NextToken"></a>
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
<a name="API_ListCopyJobs_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** 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

 ** ServiceUnavailableException **   
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.    
 ** Context **   
  
 ** Type **   

HTTP Status Code: 500

## Weitere Informationen finden Sie unter:
<a name="API_ListCopyJobs_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobs) 