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
Restituisce i metadati relativi a un'attività.
Sintassi della richiesta
{
"TaskArn": "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.
- TaskArn
-
L'Amazon Resource Name (ARN) dell'attività da descrivere.
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}$
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"
}
],
"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"
},
"SourceLocationArn": "string",
"SourceNetworkInterfaceArns": [ "string" ],
"Status": "string",
"TaskArn": "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) del gruppo di CloudWatch log di Amazon utilizzato per monitorare e registrare gli eventi nell'attività.
Per ulteriori informazioni su questi gruppi, consultare Utilizzo di gruppi di registri e flussi di registro nella Guida per l'CloudWatchutente di Amazon.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 562.
Pattern:
^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'Amazon Resource Name (ARN) dell'attività di trasferimento dei file.
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}$
- DestinationLocationArn
-
L'Amazon Resource Name (ARN) della risorsa di AWS storage di.
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}:location/loc-[0-9a-z]{17}$
- DestinationNetworkInterfaceArns
-
Gli Amazon Resource Name (ARN) delle interfacce di rete create per la posizione di destinazione. Per ulteriori informazioni, consulta Requisiti dell'interfaccia di rete.
Tipo: matrice di stringhe
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$
- ErrorCode
-
Errori AWS DataSync rilevati durante l'esecuzione dell'attività. È possibile utilizzare questo codice di errore per risolvere i problemi.
Tipo: String
- ErrorDetail
-
Descrizione dettagliata di un errore che si è verificato durante l'esecuzione dell'attività. È possibile utilizzare queste informazioni per risolvere i problemi.
Tipo: String
- 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.
- 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.
- Name
-
Il nome dell'attività descritta.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.
Pattern:
^[a-zA-Z0-9\s+=._:@/-]+$
- Options
-
Le opzioni di configurazione che controllano il comportamento dell'
StartTaskExecution
operazione. Alcune opzioni includono la conservazione dei metadati di file o oggetti e la verifica dell'integrità dei dati.È possibile sovrascrivere queste opzioni per ogni esecuzione di attività. Per ulteriori informazioni, vedere StartTaskExecution.
Tipo: Options oggetto
- Schedule
-
La pianificazione utilizzata per trasferire periodicamente i file da un'origine a una posizione di destinazione.
Tipo: TaskSchedule oggetto
- SourceLocationArn
-
L'Amazon Resource Name (ARN) della posizione del file system di origine.
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}:location/loc-[0-9a-z]{17}$
- SourceNetworkInterfaceArns
-
Gli Amazon Resource Name (ARN) delle interfacce di rete create per la posizione di origine dell'utente. Per ulteriori informazioni, consulta Requisiti dell'interfaccia di rete.
Tipo: matrice di stringhe
Limitazioni di lunghezza: lunghezza massima di 128.
Pattern:
^arn:aws[\-a-z]{0,}:ec2:[a-z\-0-9]*:[0-9]{12}:network-interface/eni-[0-9a-f]+$
- Status
-
Lo stato dell'attività descritta.
Per informazioni dettagliate sugli stati di esecuzione delle attività, vedere Understanding Task Statuses in the AWS DataSyncUser Guide.
Tipo: String
Valori validi:
AVAILABLE | CREATING | QUEUED | RUNNING | UNAVAILABLE
- TaskArn
-
L'Amazon Resource Name (ARN) dell'attività descritta.
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}$
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
Esempio
L'esempio seguente restituisce informazioni sull'attività specificata nella richiesta di esempio.
Richiesta di esempio
{
"TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
Esempio
Questo esempio illustra un utilizzo di. DescribeTask
Risposta di esempio
{
"CloudWatchLogGroupArn": "arn:aws:logs:us-east-2:111222333444:log-group"
"CreationTime": 1532660733.39,
"CurrentTaskExecutionArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026/execution/exec-04ce9d516d69bd52f",
"Options": {
"Atime": "BEST_EFFORT",
"BytesPerSecond": 1000,
"Gid": "NONE",
"Mtime": "PRESERVE",
"PosixPermissions": "PRESERVE",
"PreserveDevices": "NONE",
"PreserveDeletedFiles": "PRESERVE",
"Uid": "NONE",
"VerifyMode": "POINT_IN_TIME_CONSISTENT"
},
"DestinationLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50fb",
"ErrorCode": "???????",
"ErrorDetail": "??????",
"Name": "MyTask",
"SourceLocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa",
"Status": "CREATING",
"TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026"
}
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: