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à.
ListCopyJobs
Restituisce i metadati relativi ai processi di copia.
Sintassi della richiesta
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&state=ByState HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- ByAccountId
-
L'ID account da cui elencare i processi. Restituisce solo i processi di copia associati all'ID account specificato.
Modello:
^[0-9]{12}$ - ByCompleteAfter
-
Restituisce solo i processi di copia completati dopo una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
- ByCompleteBefore
-
Restituisce solo i processi di copia completati prima di una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).
- ByCreatedAfter
-
Restituisce solo i processi di copia creati dopo la data specificata.
- ByCreatedBefore
-
Restituisce solo i processi di copia creati prima della data specificata.
- ByDestinationVaultArn
-
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup di origine da cui copiare, ad esempio
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault. - ByMessageCategory
-
Questo è un parametro opzionale che può essere utilizzato per filtrare i lavori con un valore MessageCategory che corrisponde al valore immesso.
Stringhe di esempio possono essere
AccessDenied,SUCCESS,AGGREGATE_ALLeINVALIDPARAMETERS.Visualizza Monitoraggio per un elenco di stringhe accettate.
Il valore ANY restituisce il conteggio di tutte le categorie di messaggi.
AGGREGATE_ALLaggrega i numeri dei processi per tutte le categorie di messaggi e restituisce la somma. - ByParentJobId
-
Si tratta di un filtro per elencare i processi (nidificati) figlio in base all'ID del processo padre.
- ByResourceArn
-
Restituisce solo i processi di copia che corrispondono al nome della risorsa Amazon (ARN) specificata.
- ByResourceType
-
Restituisce solo i processi di backup per le risorse specificate:
-
Auroraper Amazon Aurora -
CloudFormationper AWS CloudFormation -
DocumentDBper Amazon DocumentDB (compatibile con MongoDB) -
DynamoDBper Amazon DynamoDB -
EBSper Amazon Elastic Block Store -
EC2per Amazon Elastic Compute Cloud -
EFSper Amazon Elastic File System -
FSxper Amazon FSx -
Neptuneper Amazon Neptune -
RDSper Amazon Relational Database Service -
Redshiftper Amazon Redshift -
S3per Amazon Simple Storage Service (Amazon S3) -
SAP HANA on Amazon EC2per database SAP HANA su istanze Amazon Elastic Compute Cloud -
Storage Gatewayper AWS Storage Gateway -
Timestreamper Amazon Timestream -
VirtualMachineper macchine VMware virtuali
Modello:
^[a-zA-Z0-9\-\_\.]{1,50}$ -
- ByState
-
Restituisce solo i processi di copia che si trovano nello stato specificato.
Valori validi:
CREATED | RUNNING | COMPLETED | FAILED | PARTIAL - MaxResults
-
Il numero massimo di elementi da restituire.
Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.
- NextToken
-
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta di restituzione di un MaxResults numero di articoli, NextToken consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.
Corpo della richiesta
La richiesta non ha un corpo della richiesta.
Sintassi della risposta
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"
},
"CreationDate": number,
"DestinationBackupVaultArn": "string",
"DestinationEncryptionKeyArn": "string",
"DestinationRecoveryPointArn": "string",
"DestinationRecoveryPointLifecycle": {
"DeleteAfterDays": number,
"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"
}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.
- CopyJobs
-
Un array di strutture contenenti metadati sui processi di copia restituiti in formato JSON.
Tipo: matrice di oggetti CopyJob
- NextToken
-
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta di restituzione di un MaxResults numero di articoli, NextToken consente di restituire più elementi nell'elenco a partire dalla posizione indicata dal token successivo.
▬Tipo: stringa
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.
- Context
- Type
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
- Context
- Type
Codice di stato HTTP: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
