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
URIParametri di richiesta
La richiesta utilizza i seguenti URI parametri.
- 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 lavori di copia completati dopo una data espressa in formato Unix e Coordinated Universal Time (UTC).
- ByCompleteBefore
-
Restituisce solo i lavori di copia completati prima di una data espressa in formato Unix e Coordinated Universal Time ()UTC.
- 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 Amazon Resource Name (ARN) che identifica in modo univoco un archivio 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 inserito.
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 lavori di copia che corrispondono alla risorsa specificata Amazon Resource Name (ARN).
- 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 SAP HANA database 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",
"BackupPlanVersion": "string",
"BackupRuleId": "string"
},
"CreationDate": number,
"DestinationBackupVaultArn": "string",
"DestinationRecoveryPointArn": "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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- CopyJobs
-
Una serie di strutture contenenti metadati sui lavori di copia restituiti in JSON formato.
Tipo: matrice di oggetti CopyJob
- NextToken
-
L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire un MaxResults numero di elementi, 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.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
HTTPCodice di stato: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
