DescribeTask - AWS DataSync

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: