Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
StartCopyJob
Avvia un processo per creare una copia univoca della risorsa specificata.
Non supporta backup continui.
Sintassi della richiesta
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"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- DestinationBackupVaultArn
-
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup di destinazione in cui copiare; ad esempio
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.Tipo: stringa
Campo obbligatorio: sì
- IamRoleArn
-
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio
arn:aws:iam::123456789012:role/S3Access.Tipo: stringa
Campo obbligatorio: sì
- IdempotencyToken
-
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a
StartCopyJob. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.▬Tipo: stringa
Campo obbligatorio: no
- Lifecycle
-
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.
I backup trasferiti allo storage dei dati inattivi devono essere archiviati nello storage dei dati inattivi per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella Disponibilità delle funzionalità per risorsa. AWS Backup ignora questa espressione per altri tipi di risorse.
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e.
MoveToColdStorageAfterDaysDeleteAfterDaysTipo: oggetto Lifecycle
Campo obbligatorio: no
- RecoveryPointArn
-
Un ARN che identifica in modo univoco un punto di ripristino da utilizzare per il processo di copia; ad esempio arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.
Tipo: stringa
Campo obbligatorio: sì
- SourceBackupVaultName
-
Il nome di un container di origine logico in cui vengono archiviati i backup. Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati. Consistono di minuscole, numeri e trattini.
Tipo: stringa
Modello:
^[a-zA-Z0-9\-\_]{2,50}$Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"CopyJobId": "string",
"CreationDate": number,
"IsParent": boolean
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- CopyJobId
-
Identifica in modo univoco un processo di copia.
▬Tipo: stringa
- CreationDate
-
La data e l'ora di creazione di un processo di copia, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di
CreationDateè preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.Tipo: Timestamp
- IsParent
-
Questo è un valore booleano restituito che indica che si tratta di un processo di copia (composito) padre.
Tipo: Booleano
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InvalidParameterValueException
-
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
Codice di stato HTTP: 400
- InvalidRequestException
-
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
Codice di stato HTTP: 400
- LimitExceededException
-
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
Codice di stato HTTP: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
