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. # StartCopyJob Inicia un trabajo para crear una copia única del recurso especificado. No admite copias de seguridad continuas. Consulte [Reintentar tareas de copia](https://docs.aws.amazon.com/aws-backup/latest/devguide/recov-point-create-a-copy.html#backup-copy-retry) para obtener información sobre cómo se AWS Backup reintentan las operaciones de copia de tareas. ## Sintaxis de la solicitud ``` PUT /copy-jobs HTTP/1.1 Content-type: application/json { "DestinationBackupVaultArn": "string", "IamRoleArn": "string", "IdempotencyToken": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointArn": "string", "SourceBackupVaultName": "string" } ``` ## Parámetros de solicitud del URI La solicitud no utiliza ningún parámetro de URI. ## Cuerpo de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [DestinationBackupVaultArn](#API_StartCopyJob_RequestSyntax) ** Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de seguridad de destino al que copiar; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Tipo: cadena Obligatorio: sí ** [IamRoleArn](#API_StartCopyJob_RequestSyntax) ** Especifica el ARN del rol de IAM utilizado para copiar el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`. Tipo: cadena Obligatorio: sí ** [IdempotencyToken](#API_StartCopyJob_RequestSyntax) ** Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `StartCopyJob` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción. Tipo: cadena Requerido: no ** [Lifecycle](#API_StartCopyJob_RequestSyntax) ** Especifica el período, en días, antes de que un punto de recuperación se transfiera al almacenamiento en frío o se elimine. Las copias de seguridad que se transfieran al almacenamiento en frío deben almacenarse en un almacenamiento en frío durante un mínimo de 90 días. Por lo tanto, en la consola, el valor de retención debe tener 90 días más que el valor del número de días tras los cuales se transferirá al almacenamiento en frío. El valor de "transition to cold after days" (número de días tras los cuales migrará a almacenamiento en frío) no puede cambiarse una vez que se ha migrado una copia de seguridad al almacenamiento en frío. Los tipos de recursos que pueden pasar al almacenamiento en frío se enumeran en la tabla [Disponibilidad de funciones por recurso](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup omite esta expresión para otros tipos de recursos. Para eliminar el ciclo de vida y los períodos de retención existentes y conservar los puntos de recuperación indefinidamente, especifique -1 para `MoveToColdStorageAfterDays` y `DeleteAfterDays`. Tipo: objeto [Lifecycle](API_Lifecycle.md) Obligatorio: no ** [RecoveryPointArn](#API_StartCopyJob_RequestSyntax) ** Un ARN que identifica de forma exclusiva un punto de recuperación para usarlo en el trabajo de copia; por ejemplo, arn:aws:backup:us-east- 1:123456789012:recovery-point:1 B5E7-9EB0-435A-A80B-108B488B0D45. EB3 Tipo: cadena Obligatorio: sí ** [SourceBackupVaultName](#API_StartCopyJob_RequestSyntax) ** El nombre de un contenedor de origen lógico donde se almacenan las copias de seguridad. Los almacenes de Backup se identifican con nombres que son exclusivos de la cuenta utilizada para crearlos y de la AWS región en la que se crearon. Tipo: cadena Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` Obligatorio: sí ## Sintaxis de la respuesta ``` HTTP/1.1 200 Content-type: application/json { "CopyJobId": "string", "CreationDate": number, "IsParent": boolean } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [CopyJobId](#API_StartCopyJob_ResponseSyntax) ** Identifica de forma exclusiva un trabajo de copia. Tipo: cadena ** [CreationDate](#API_StartCopyJob_ResponseSyntax) ** La fecha y la hora en que se creó el trabajo de copia, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h. Tipo: marca temporal ** [IsParent](#API_StartCopyJob_ResponseSyntax) ** Se trata de un valor booleano devuelto que indica que es un trabajo de copia principal (compuesto). Tipo: Booleano ## Errores 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 ** InvalidRequestException ** Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto. ** Context ** ** Type ** Código de estado HTTP: 400 ** LimitExceededException ** Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud. ** Context ** ** Type ** Código de estado HTTP: 400 ** MissingParameterValueException ** Indica que falta un parámetro obligatorio. ** Context ** ** Type ** Código de estado HTTP: 400 ** ResourceNotFoundException ** No existe un recurso necesario para la acción. ** 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 Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartCopyJob) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartCopyJob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartCopyJob) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartCopyJob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartCopyJob) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartCopyJob) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartCopyJob) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartCopyJob) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartCopyJob) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartCopyJob)