DescribeTaskExecution - AWS DataSync
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriEsempiVedi anche

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à.

DescribeTaskExecution

Restituisce metadati dettagliati relativi a un'attività in corso di esecuzione.

Sintassi della richiesta

{
   "TaskExecutionArn": "string"
}

Parametri della richiesta

Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

TaskExecutionArn

L'Amazon Resource Name (ARN) dell'attività in corso di esecuzione.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 128.

Pattern: ^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}$

Campo obbligatorio: sì

Sintassi della risposta

{
   "BytesCompressed": number,
   "BytesTransferred": number,
   "BytesWritten": number,
   "EstimatedBytesToTransfer": number,
   "EstimatedFilesToTransfer": number,
   "Excludes": [ 
      { 
         "FilterType": "string",
         "Value": "string"
      }
   ],
   "FilesTransferred": number,
   "Includes": [ 
      { 
         "FilterType": "string",
         "Value": "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"
   },
   "Result": { 
      "ErrorCode": "string",
      "ErrorDetail": "string",
      "PrepareDuration": number,
      "PrepareStatus": "string",
      "TotalDuration": number,
      "TransferDuration": number,
      "TransferStatus": "string",
      "VerifyDuration": number,
      "VerifyStatus": "string"
   },
   "StartTime": number,
   "Status": "string",
   "TaskExecutionArn": "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.

BytesCompressed

Il numero fisico di byte trasferiti sulla rete dopo l'applicazione della compressione. Nella maggior parte dei casi, questo numero è inferiore a, BytesTransferred a meno che i dati non siano comprimibili.

Tipo: long

BytesTransferred

Il numero totale di byte coinvolti nel trasferimento. Per il numero di byte inviati sulla rete, consultaBytesCompressed.

Tipo: long

BytesWritten

Il numero di byte logici scritti nella risorsa di AWS storage di destinazione.

Tipo: long

EstimatedBytesToTransfer

Il numero fisico stimato di byte da trasferire sulla rete.

Tipo: long

EstimatedFilesToTransfer

Il numero previsto di file da trasferire in rete. Questo valore viene calcolato durante la PREPARING fase precedente alla TRANSFERRING fase di esecuzione dell'attività. Questo valore indica il numero previsto di file da trasferire. Viene calcolato in base al confronto del contenuto delle località di origine e di destinazione e alla ricerca del delta da trasferire.

Tipo: long

Excludes

Un elenco di regole di filtro che escludono dati specifici durante il trasferimento. Per ulteriori informazioni ed esempi, consulta Filtraggio dei dati trasferiti da DataSync.

Tipo: matrice di oggetti FilterRule

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

FilesTransferred

Il numero effettivo di file trasferiti in rete. Questo valore viene calcolato e aggiornato su base continuativa durante la TRANSFERRING fase di esecuzione dell'attività. Viene aggiornato periodicamente quando ogni file viene letto dalla fonte e inviato in rete.

Se durante il trasferimento si verificano dei guasti, il valore può essere inferiore a EstimatedFilesToTransfer. In alcuni casi, questo valore può anche essere maggiore diEstimatedFilesToTransfer. Per alcuni tipi di posizione, questo elemento è specifico dell'implementazione, perciò non va utilizzato come indicatore di un numero corretto di file o per monitorare l'esecuzione dell'attività.

Tipo: long

Includes

Un elenco di regole di filtro che includono dati specifici durante il trasferimento. Per ulteriori informazioni ed esempi, consulta Filtraggio dei dati trasferiti da DataSync.

Tipo: matrice di oggetti FilterRule

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

Options

Configura le impostazioni delle AWS DataSync attività. Queste opzioni includono il modo in cui DataSync gestisce file, oggetti e i metadati associati. Puoi anche specificare come DataSync verifica l'integrità dei dati, impostare limiti di larghezza di banda per la tua attività, tra le altre opzioni.

Ogni impostazione di attività. A meno che non sia necessario, non è necessario configurare nessuno di questi elementi Options prima di iniziare l'attività.

Tipo: Options oggetto

Result

Il risultato dell'esecuzione dell'attività.

Tipo: TaskExecutionResultDetail oggetto

StartTime

L'ora in cui è stata avviata l'esecuzione dell'attività.

Tipo: Timestamp

Status

Lo stato di esecuzione dell'attività.

Per informazioni dettagliate sugli stati di esecuzione delle attività, vedere Understanding Task Statuses.

Tipo: String

Valori validi: QUEUED | LAUNCHING | PREPARING | TRANSFERRING | VERIFYING | SUCCESS | ERROR

TaskExecutionArn

L'Amazon Resource Name (ARN) dell'esecuzione dell'attività descritta. TaskExecutionArnè gerarchico e include TaskArn l'attività che è stata eseguita.

Ad esempio, un TaskExecution valore con ARN ha arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2/execution/exec-08ef1e88ec491019b eseguito l'operazione con l'arn:aws:datasync:us-east-1:111222333444:task/task-0208075f79cedf4a2ARN.

Tipo: String

Limitazioni di lunghezza: lunghezza massima di 128.

Pattern: ^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}$

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

Questo esempio illustra una DescribeTaskExecution richiesta.

{
  "TaskExecutionArn": "arn:aws:datasync:us-east-1:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}

Risposta di esempio

Questo esempio illustra una DescribeTaskExecution risposta.

{
   "BytesCompressed": "3500",
   "BytesTransferred": "5000",
   "BytesWritten": "5000",
   "EstimatedBytesToTransfer": "5000",
   "EstimatedFilesToTransfer": "100",
   "FilesTransferred": "100",
   "Result": { 
      "ErrorCode": "??????",
      "ErrorDetail": "??????",
      "PrepareDuration": "100",
      "PrepareStatus": "SUCCESS",
      "TransferDuration": "60",
      "TransferStatus": "AVAILABLE",
      "VerifyDuration": "30",
      "VerifyStatus": "SUCCESS"
   },
   "StartTime": "1532660733.39",
   "Status": "SUCCESS",
   "OverrideOptions": { 
      "Atime": "BEST_EFFORT",
      "BytesPerSecond": "1000",
      "Gid": "NONE",
      "Mtime": "PRESERVE",
      "PosixPermissions": "PRESERVE",
      "PreserveDevices": "NONE",
      "PreserveDeletedFiles": "PRESERVE",
      "Uid": "NONE",
      "VerifyMode": "POINT_IN_TIME_CONSISTENT"
   },
   "TaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f"
}

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: