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
<a name="API_DescribeTask"></a>

Fornisce informazioni su un'*attività*, che definisce dove e come vengono AWS DataSync trasferiti i dati.

## Sintassi della richiesta
<a name="API_DescribeTask_RequestSyntax"></a>

```
{
   "TaskArn": "string"
}
```

## Parametri della richiesta
<a name="API_DescribeTask_RequestParameters"></a>

Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [TaskArn](#API_DescribeTask_RequestSyntax) **   <a name="DataSync-DescribeTask-request-TaskArn"></a>
Speciifica l'Amazon Resource Name (ARN) dell'attività di trasferimento su cui desideri informazioni.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$`   
Obbligatorio: sì

## Sintassi della risposta
<a name="API_DescribeTask_ResponseSyntax"></a>

```
{
   "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
<a name="API_DescribeTask_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [CloudWatchLogGroupArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CloudWatchLogGroupArn"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/configure-logging.html).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 562.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$` 

 ** [CreationTime](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CreationTime"></a>
L'ora in cui è stata creata l'attività.  
Tipo: Timestamp

 ** [CurrentTaskExecutionArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-CurrentTaskExecutionArn"></a>
L'ARN dell'esecuzione dell'attività più recente.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|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](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationLocationArn"></a>
L'ARN della località di destinazione del trasferimento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` 

 ** [DestinationNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-DestinationNetworkInterfaceArns"></a>
Le [interfacce ARNs di rete](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) DataSync create per la località di destinazione.  
Tipo: array 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](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorCode"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: String

 ** [ErrorDetail](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ErrorDetail"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/troubleshooting-datasync-locations-tasks.html).  
Tipo: String

 ** [Excludes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Excludes"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

 ** [Includes](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Includes"></a>
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](https://docs.aws.amazon.com/datasync/latest/userguide/filtering.html).  
Tipo: matrice di oggetti [FilterRule](API_FilterRule.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.

 ** [ManifestConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ManifestConfig"></a>
La configurazione del manifesto che elenca i file o gli oggetti che si desidera DataSync trasferire. Per ulteriori informazioni, vedere [Specificare quali DataSync trasferimenti utilizzando un manifesto](https://docs.aws.amazon.com/datasync/latest/userguide/transferring-with-manifest.html).  
Tipo: oggetto [ManifestConfig](API_ManifestConfig.md)

 ** [Name](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Name"></a>
Il nome dell'attività.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 256 caratteri.  
Modello: `^[a-zA-Z0-9\s+=._:@/-]+$` 

 ** [Options](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Options"></a>
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](API_Options.md)

 ** [Schedule](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Schedule"></a>
La pianificazione del momento in cui desideri che l'attività venga eseguita. Per ulteriori informazioni, vedere [Pianificazione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipo: oggetto [TaskSchedule](API_TaskSchedule.md)

 ** [ScheduleDetails](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-ScheduleDetails"></a>
I dettagli sulla [pianificazione delle attività](https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html).  
Tipo: oggetto [TaskScheduleDetails](API_TaskScheduleDetails.md)

 ** [SourceLocationArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceLocationArn"></a>
L'ARN della posizione di origine del trasferimento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` 

 ** [SourceNetworkInterfaceArns](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-SourceNetworkInterfaceArns"></a>
Le [interfacce ARNs di rete](https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces) DataSync create per la posizione di origine.  
Tipo: array 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](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-Status"></a>
Lo stato dell'attività. Per informazioni sul significato di ogni stato, consulta [Stati delle attività.](https://docs.aws.amazon.com/datasync/latest/userguide/create-task-how-to.html#understand-task-creation-statuses)  
Tipo: String  
Valori validi: `AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE` 

 ** [TaskArn](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskArn"></a>
L'ARN della tua attività.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 128.  
Modello: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:task/task-[0-9a-f]{17}$` 

 ** [TaskMode](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskMode"></a>
La modalità di attività che stai utilizzando. Per ulteriori informazioni, vedere [Scelta di una modalità di operazione per il trasferimento dei dati](https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html).  
Tipo: String  
Valori validi: `BASIC | ENHANCED` 

 ** [TaskReportConfig](#API_DescribeTask_ResponseSyntax) **   <a name="DataSync-DescribeTask-response-TaskReportConfig"></a>
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à](https://docs.aws.amazon.com/datasync/latest/userguide/task-reports.html).  
Tipo: oggetto [TaskReportConfig](API_TaskReportConfig.md)

## Errori
<a name="API_DescribeTask_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** 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
<a name="API_DescribeTask_Examples"></a>

### Richiesta di esempio
<a name="API_DescribeTask_Example_1"></a>

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
<a name="API_DescribeTask_Example_2"></a>

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
<a name="API_DescribeTask_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeTask) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeTask)