Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# ListCopyJobs
<a name="API_ListCopyJobs"></a>

Devuelve los metadatos de los trabajos de copia.

## Sintaxis de la solicitud
<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
```

## Parámetros de solicitud del URI
<a name="API_ListCopyJobs_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [ByAccountId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByAccountId"></a>
El ID de la cuenta desde la que se van a enumerar los trabajos. Devuelve solo los trabajos de copia asociados al ID de cuenta especificado.  
Patrón: `^[0-9]{12}$` 

 ** [ByCompleteAfter](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteAfter"></a>
Devuelve solo los trabajos de copia completados después de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCompleteBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCompleteBefore"></a>
Devuelve solo los trabajos de copia completados antes de una fecha expresada en formato Unix y horario universal coordinado (UTC).

 ** [ByCreatedAfter](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedAfter"></a>
Devuelve solo los trabajos de copia que se crearon después de la fecha especificada.

 ** [ByCreatedBefore](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByCreatedBefore"></a>
Devuelve solo los trabajos de copia que se crearon antes de la fecha especificada.

 ** [ByDestinationVaultArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByDestinationVaultArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de seguridad de origen desde el que realizar copias; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. 

 ** [ByMessageCategory](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByMessageCategory"></a>
Se trata de un parámetro opcional que se puede utilizar para filtrar los trabajos con un valor MessageCategory que coincida con el valor introducido.  
Las cadenas de ejemplo pueden ser `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` y `INVALIDPARAMETERS`.  
Consulte en [Monitorización](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) una lista de cadenas aceptadas.  
El valor ANY devuelve el recuento de todas las categorías de mensajes.  
 `AGGREGATE_ALL` suma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma.

 ** [ByParentJobId](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByParentJobId"></a>
Se trata de un filtro para enumerar los trabajos secundarios (anidados) en función del ID del trabajo principal.

 ** [ByResourceArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceArn"></a>
Devuelve solo los trabajos de copia que coinciden con el nombre de recurso de Amazon (ARN) del recurso especificado. 

 ** [ByResourceType](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByResourceType"></a>
Devuelve únicamente los trabajos de copia de seguridad de los recursos especificados:  
+  `Aurora` para Amazon Aurora
+  `CloudFormation`para AWS CloudFormation 
+  `DocumentDB` para Amazon DocumentDB (compatible con MongoDB)
+  `DynamoDB` para Amazon DynamoDB
+  `EBS` para Amazon Elastic Block Store (EBS)
+  `EC2` para Amazon Elastic Compute Cloud
+  `EFS` para Amazon Elastic File System
+  `EKS` para Amazon Elastic Kubernetes Service
+  `FSx`para Amazon FSx
+  `Neptune` para Amazon Neptune
+  `RDS` para Amazon Relational Database Service
+  `Redshift` para Amazon Redshift
+  `S3` para Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2` para bases de datos de SAP HANA en instancias de Amazon Elastic Compute Cloud
+  `Storage Gateway`para AWS Storage Gateway 
+  `Timestream` para Amazon Timestream
+  `VirtualMachine`para máquinas VMware virtuales
Patrón: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [BySourceRecoveryPointArn](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-BySourceRecoveryPointArn"></a>
Filtra los trabajos de copia por el punto de recuperación de origen especificado (ARN).

 ** [ByState](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-ByState"></a>
Devuelve solo los trabajos de copia que se encuentran en el estado especificado.  
Valores válidos: `CREATED | RUNNING | COMPLETED | FAILED | PARTIAL` 

 ** [MaxResults](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-MaxResults"></a>
Número máximo de elementos que se van a devolver.  
Rango válido: valor mínimo de 1. Valor máximo de 1000.

 ** [NextToken](#API_ListCopyJobs_RequestSyntax) **   <a name="Backup-ListCopyJobs-request-uri-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el MaxResults número de artículos NextToken , podrá devolver más artículos de la lista empezando por la ubicación indicada por el siguiente token. 

## Cuerpo de la solicitud
<a name="API_ListCopyJobs_RequestBody"></a>

La solicitud no tiene un cuerpo de la solicitud.

## Sintaxis de la respuesta
<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"
}
```

## Elementos de respuesta
<a name="API_ListCopyJobs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CopyJobs](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-CopyJobs"></a>
Una matriz de estructuras que contiene metadatos sobre trabajos de copia devueltos en formato JSON.   
Tipo: matriz de objetos [CopyJob](API_CopyJob.md)

 ** [NextToken](#API_ListCopyJobs_ResponseSyntax) **   <a name="Backup-ListCopyJobs-response-NextToken"></a>
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el MaxResults número de NextToken artículos, podrás devolver más artículos de la lista empezando por la ubicación que indique el siguiente token.   
Tipo: cadena

## Errores
<a name="API_ListCopyJobs_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InvalidParameterValueException **   
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_ListCopyJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListCopyJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListCopyJobs)