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.
Sintaxis de la solicitud
PUT /copy-jobs HTTP/1.1
Content-type: application/json
{
"DestinationBackupVaultArn": "string
",
"IamRoleArn": "string
",
"IdempotencyToken": "string
",
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointArn": "string
",
"SourceBackupVaultName": "string
"
}
URIParámetros de solicitud
La solicitud no utiliza ningún URI parámetro.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- DestinationBackupVaultArn
-
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de respaldo de destino en el que realizar copias; por ejemplo,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault
.Tipo: cadena
Obligatorio: sí
- IamRoleArn
-
Especifica la IAM función ARN utilizada para copiar el punto de recuperación de destino; por ejemplo,
arn:aws:iam::123456789012:role/S3Access
.Tipo: cadena
Obligatorio: sí
- IdempotencyToken
-
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
-
Especifica el período de tiempo, en días, antes de que un punto de recuperación pase a almacenamiento en frío o se elimine.
Las copias de seguridad que se han migrado al almacenamiento en frío deben permanecer en él durante un mínimo de 90 días. Por lo tanto, en la consola, la configuración de retención debe ser 90 días superior a la de transición a la configuración «frío después de días». La configuración de transición a frío después de varios días no se puede cambiar después de que una copia de seguridad haya pasado a estar fría.
Los tipos de recursos que pueden pasar al almacenamiento en frío se muestran en la tabla Disponibilidad de funciones por recurso. 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
Obligatorio: no
- RecoveryPointArn
-
Y ARN que identifique de forma exclusiva un punto de recuperación que se utilizará en el trabajo de copia; por ejemplo, arn:aws:backup:us-east- 1:123456789012:recovery-point:1 -9EB0-435A-A80B-108B488B0D45. EB3B5E7
Tipo: cadena
Obligatorio: sí
- SourceBackupVaultName
-
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 de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- CopyJobId
-
Identifica de forma exclusiva un trabajo de copia.
Tipo: cadena
- CreationDate
-
La fecha y la hora en que se creó un trabajo de copia, en formato Unix y en hora universal coordinada (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
-
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 Errores comunes.
- InvalidParameterValueException
-
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.
HTTPCódigo de estado: 400
- InvalidRequestException
-
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.
HTTPCódigo de estado: 400
- LimitExceededException
-
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.
HTTPCódigo de estado: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
No existe un recurso necesario para la acción.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
HTTPCódigo de estado: 500
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: