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. # StartBackupJob Inicia un trabajo de copia de seguridad bajo demanda para el recurso especificado. ## Sintaxis de la solicitud ``` PUT /backup-jobs HTTP/1.1 Content-type: application/json { "BackupOptions": { "string" : "string" }, "BackupVaultName": "string", "CompleteWindowMinutes": number, "IamRoleArn": "string", "IdempotencyToken": "string", "Index": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "LogicallyAirGappedBackupVaultArn": "string", "RecoveryPointTags": { "string" : "string" }, "ResourceArn": "string", "StartWindowMinutes": number } ``` ## 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. ** [BackupOptions](#API_StartBackupJob_RequestSyntax) ** La opción de copia de seguridad para un recurso seleccionado. Esta opción solo está disponible para los trabajos de copia de seguridad de Windows Volume Shadow Copy Service (VSS). Valores válidos: configure `"WindowsVSS":"enabled"` para habilitar la opción de copia de seguridad de `WindowsVSS` y crear una copia de seguridad de Windows VSS. Configure `"WindowsVSS""disabled"` para crear una copia de seguridad normal. La opción `WindowsVSS` no está habilitada de forma predeterminada. Tipo: mapa de cadena a cadena Patrón de clave: `^[a-zA-Z0-9\-\_\.]{1,50}$` Patrón de valores: `^[a-zA-Z0-9\-\_\.]{1,50}$` Obligatorio: no ** [BackupVaultName](#API_StartBackupJob_RequestSyntax) ** El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de AWS donde se crearon. Tipo: cadena Patrón: `^[a-zA-Z0-9\-\_]{2,50}$` Obligatorio: sí ** [CompleteWindowMinutes](#API_StartBackupJob_RequestSyntax) ** Un valor en minutos durante el cual debe completarse una copia de seguridad que se haya iniciado correctamente o, de lo contrario, AWS Backup cancelará el trabajo. Este valor es opcional. Este valor comienza la cuenta regresiva a partir del momento en que se programó la copia de seguridad. No agrega tiempo adicional para `StartWindowMinutes` o si la copia de seguridad se inició más tarde de lo programado. Como `StartWindowMinutes`, este parámetro tiene un valor máximo de 100 años (52 560 000 minutos). Tipo: largo Obligatorio: no ** [IamRoleArn](#API_StartBackupJob_RequestSyntax) ** Especifica el ARN del rol de IAM utilizado para crear el punto de recuperación de destino; por ejemplo, `arn:aws:iam::123456789012:role/S3Access`. Tipo: cadena Obligatorio: sí ** [IdempotencyToken](#API_StartBackupJob_RequestSyntax) ** Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `StartBackupJob` 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 ** [Index](#API_StartBackupJob_RequestSyntax) ** Incluya este parámetro para activar la creación de índices si su trabajo de copia de seguridad tiene un tipo de recurso que admite índices de copia de seguridad. Los tipos de recurso que admiten índices de copia de seguridad son: + `EBS` para Amazon Elastic Block Store (EBS) + `S3` para Amazon Simple Storage Service (Amazon S3) El índice puede tener uno o dos valores posibles, `ENABLED` o `DISABLED`. Para crear un índice de copias de seguridad para un punto de recuperación `ACTIVE` elegible que aún no tiene un índice de copia de seguridad, establezca el valor en `ENABLED`. Para eliminar un índice de copias de seguridad, defina el valor en `DISABLED`. Tipo: cadena Valores válidos: `ENABLED | DISABLED` Obligatorio: no ** [Lifecycle](#API_StartBackupJob_RequestSyntax) ** El ciclo de vida define cuándo un recurso protegido pasa a almacenamiento en frío y cuándo caduca. AWS Backup realizará la transición y caducará las copias de seguridad automáticamente según el ciclo de vida que usted defina. 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, 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 “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. Este parámetro tiene un valor máximo de 100 años (36 500 días). Tipo: objeto [Lifecycle](API_Lifecycle.md) Obligatorio: no ** [LogicallyAirGappedBackupVaultArn](#API_StartBackupJob_RequestSyntax) ** El ARN de una bóveda con huecos de aire lógicos. El ARN debe estar en la misma cuenta y región. Si se proporcionan, los recursos compatibles totalmente gestionados realizan copias de seguridad directamente en un almacén aislado de forma lógica, mientras que otros recursos compatibles crean una instantánea temporal (facturable) en el almacén de respaldo y, a continuación, la copian en un almacén aislado de forma lógica. Los recursos no compatibles solo se respaldan en el almacén de respaldo especificado. Tipo: cadena Requerido: no ** [RecoveryPointTags](#API_StartBackupJob_RequestSyntax) ** Las etiquetas para asignar a los recursos. Tipo: mapa de cadena a cadena Obligatorio: no ** [ResourceArn](#API_StartBackupJob_RequestSyntax) ** Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso. Tipo: cadena Obligatorio: sí ** [StartWindowMinutes](#API_StartBackupJob_RequestSyntax) ** Un valor en minutos después del que una copia de seguridad está programada antes de que se cancele el trabajo si no se ha iniciado correctamente. El valor es opcional y el valor predeterminado es 8 horas. Si se incluye este valor, debe ser de al menos 60 minutos para evitar errores. Este parámetro tiene un valor máximo de 100 años (52 560 000 minutos). Durante el intervalo de inicio, el estado del trabajo de copia de seguridad permanece en ese estado `CREATED` hasta que comience correctamente o hasta que se agote el tiempo del intervalo de inicio. Si dentro de la ventana de inicio, Time AWS Backup recibe un error que permite volver a intentar el trabajo, AWS Backup volverá a intentarlo automáticamente al menos cada 10 minutos hasta que la copia de seguridad comience correctamente (el estado del trabajo cambia a`RUNNING`) o hasta que el estado del trabajo cambie a `EXPIRED` (lo que se espera que ocurra cuando finalice el tiempo de la ventana de inicio). Tipo: largo Obligatorio: no ## Sintaxis de la respuesta ``` HTTP/1.1 200 Content-type: application/json { "BackupJobId": "string", "CreationDate": number, "IsParent": boolean, "RecoveryPointArn": "string" } ``` ## 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. ** [BackupJobId](#API_StartBackupJob_ResponseSyntax) ** Identifica de forma exclusiva una solicitud para AWS Backup hacer una copia de seguridad de un recurso. Tipo: cadena ** [CreationDate](#API_StartBackupJob_ResponseSyntax) ** La fecha y la hora en que se creó el trabajo de copia de seguridad, 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_StartBackupJob_ResponseSyntax) ** Se trata de un valor booleano devuelto que indica que es un trabajo de copia de seguridad principal (compuesto). Tipo: Booleano ** [RecoveryPointArn](#API_StartBackupJob_ResponseSyntax) ** *Nota: Este campo solo se devuelve para los recursos avanzados de DynamoDB y Amazon EFS.* Un ARN que identifica de forma exclusiva un punto de recuperación; por ejemplo, `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`. Tipo: cadena ## 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, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/StartBackupJob) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartBackupJob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartBackupJob) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartBackupJob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartBackupJob) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartBackupJob) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartBackupJob) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartBackupJob) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartBackupJob) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartBackupJob)