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à.
DescribeTask
Fornisce informazioni su un'attività, che definisce dove e come vengono AWS DataSync trasferiti i dati.
Sintassi della richiesta
{
"TaskArn": "string
"
}
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- TaskArn
-
Speciifica l'Amazon Resource Name (ARN) dell'attività di trasferimento su cui desideri informazioni.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}$
Campo obbligatorio: sì
Sintassi della risposta
{
"CloudWatchLogGroupArn": "string",
"CreationTime": number,
"CurrentTaskExecutionArn": "string",
"DestinationLocationArn": "string",
"DestinationNetworkInterfaceArns": [ "string" ],
"ErrorCode": "string",
"ErrorDetail": "string",
"Excludes": [
{
"FilterType": "string",
"Value": "string"
}
],
"Includes": [
{
"FilterType": "string",
"Value": "string"
}
],
"ManifestConfig": {
"Action": "string",
"Format": "string",
"Source": {
"S3": {
"BucketAccessRoleArn": "string",
"ManifestObjectPath": "string",
"ManifestObjectVersionId": "string",
"S3BucketArn": "string"
}
}
},
"Name": "string",
"Options": {
"Atime": "string",
"BytesPerSecond": number,
"Gid": "string",
"LogLevel": "string",
"Mtime": "string",
"ObjectTags": "string",
"OverwriteMode": "string",
"PosixPermissions": "string",
"PreserveDeletedFiles": "string",
"PreserveDevices": "string",
"SecurityDescriptorCopyFlags": "string",
"TaskQueueing": "string",
"TransferMode": "string",
"Uid": "string",
"VerifyMode": "string"
},
"Schedule": {
"ScheduleExpression": "string",
"Status": "string"
},
"ScheduleDetails": {
"DisabledBy": "string",
"DisabledReason": "string",
"StatusUpdateTime": number
},
"SourceLocationArn": "string",
"SourceNetworkInterfaceArns": [ "string" ],
"Status": "string",
"TaskArn": "string",
"TaskMode": "string",
"TaskReportConfig": {
"Destination": {
"S3": {
"BucketAccessRoleArn": "string",
"S3BucketArn": "string",
"Subdirectory": "string"
}
},
"ObjectVersionIds": "string",
"OutputType": "string",
"Overrides": {
"Deleted": {
"ReportLevel": "string"
},
"Skipped": {
"ReportLevel": "string"
},
"Transferred": {
"ReportLevel": "string"
},
"Verified": {
"ReportLevel": "string"
}
},
"ReportLevel": "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.
- CloudWatchLogGroupArn
-
L'Amazon Resource Name (ARN) di un gruppo di CloudWatch log Amazon per il monitoraggio delle tue attività.
Per ulteriori informazioni, consulta Monitoraggio dei trasferimenti di dati con CloudWatch Logs.
Tipo: stringa
Vincoli di lunghezza: lunghezza massima di 562.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$
- CreationTime
-
L'ora in cui è stata creata l'attività.
Tipo: Timestamp
- CurrentTaskExecutionArn
-
L'ARN dell'esecuzione dell'attività più recente.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$
- DestinationLocationArn
-
L'ARN della località di destinazione del trasferimento.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
- DestinationNetworkInterfaceArns
-
Le interfacce ARNs di rete DataSync create per la località di destinazione.
Tipo: matrice di stringhe
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$
- ErrorCode
-
Se c'è un problema con la tua attività, puoi utilizzare il codice di errore per aiutarti a risolverlo. Per ulteriori informazioni, consulta Risoluzione dei problemi relativi ai DataSync trasferimenti.
Tipo: stringa
- ErrorDetail
-
Se c'è un problema con la tua attività, puoi utilizzare i dettagli dell'errore per aiutarti a risolverlo. Per ulteriori informazioni, consulta Risoluzione dei problemi relativi ai DataSync trasferimenti.
Tipo: stringa
- Excludes
-
I filtri di esclusione che definiscono i file, gli oggetti e le cartelle nella posizione di origine che non desideri DataSync trasferire. Per ulteriori informazioni ed esempi, consulta Specificare i DataSync trasferimenti utilizzando i filtri.
Tipo: matrice di oggetti FilterRule
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.
- Includes
-
Includono filtri che definiscono i file, gli oggetti e le cartelle che si desidera DataSync trasferire nella posizione di origine. Per ulteriori informazioni ed esempi, consulta Specificare i DataSync trasferimenti utilizzando i filtri.
Tipo: matrice di oggetti FilterRule
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.
- ManifestConfig
-
La configurazione del manifesto che elenca i file o gli oggetti che si desidera DataSync trasferire. Per ulteriori informazioni, vedere Specificazione dei DataSync trasferimenti utilizzando un manifesto.
Tipo: oggetto ManifestConfig
- Name
-
Il nome dell'attività.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello:
^[a-zA-Z0-9\s+=._:@/-]+$
- Options
-
Le impostazioni dell'attività. Ad esempio, quali metadati dei file vengono conservati, come viene verificata l'integrità dei dati al termine del trasferimento, limiti di larghezza di banda, tra le altre opzioni.
Tipo: oggetto Options
- Schedule
-
La pianificazione del momento in cui desideri che l'attività venga eseguita. Per ulteriori informazioni, vedere Pianificazione delle attività.
Tipo: oggetto TaskSchedule
- ScheduleDetails
-
I dettagli sulla pianificazione delle attività.
Tipo: oggetto TaskScheduleDetails
- SourceLocationArn
-
L'ARN della posizione di origine del trasferimento.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$
- SourceNetworkInterfaceArns
-
Le interfacce ARNs di rete DataSync create per la posizione di origine.
Tipo: matrice di stringhe
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$
- Status
-
Lo stato dell'attività. Per informazioni sul significato di ogni stato, consulta Stati delle attività.
Tipo: stringa
Valori validi:
AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE
- TaskArn
-
L'ARN della tua attività.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 128.
Modello:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}$
- TaskMode
-
La modalità di attività che stai utilizzando. Per ulteriori informazioni, vedere Scelta di una modalità di operazione per il trasferimento dei dati.
Tipo: stringa
Valori validi:
BASIC | ENHANCED
- TaskReportConfig
-
La configurazione del rapporto sulle attività, che fornisce informazioni dettagliate sul DataSync trasferimento. Per ulteriori informazioni, consulta Monitoraggio dei DataSync trasferimenti con i report sulle attività.
Tipo: oggetto TaskReportConfig
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalException
-
Questa eccezione viene generata quando si verifica un errore nel AWS DataSync servizio.
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
Esempi
Richiesta di esempio
L'esempio seguente specifica l'ARN di DataSync un'attività su cui ottenere informazioni.
{ "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" }
Risposta di esempio
L'esempio seguente mostra una DescribeTask
risposta.
{ "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026", "Name": "MyTask", "TaskMode": "BASIC", "Status": "RUNNING", "SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-1111aaaa2222bbbb3", "DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-0000zzzz1111yyyy2", "CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f", "CreationTime": 1532660733.39, "Options": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group:/log-group-name:*" }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: