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à.
StartTaskExecution
Avvia l'AWS DataSyncattività. Per ogni attività, è possibile eseguire solo un'operazione alla volta.
L'esecuzione di un'attività prevede diverse fasi. Per ulteriori informazioni, consulta Stati dell'esecuzione delle attività.
Importante
Se hai intenzione di trasferire dati da o verso una sede Amazon S3, consulta prima di iniziare come DataSync possono influire i costi della tua richiesta S3 e la pagina DataSync dei prezzi
Sintassi della richiesta
{
"Excludes": [
{
"FilterType": "string",
"Value": "string"
}
],
"Includes": [
{
"FilterType": "string",
"Value": "string"
}
],
"OverrideOptions": {
"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"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"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.
- Excludes
-
Specifica un elenco di regole di filtro che determina i file da escludere da un'attività. L'elenco contiene una singola stringa di filtro costituita dai modelli da escludere. I modelli sono delimitati da "|" (cioè una barra verticale), ad esempio:
"/folder1|/folder2".Tipo: matrice di oggetti FilterRule
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.
Required: No
- Includes
-
Specifica un elenco di regole di filtro che determina i file da includere durante l'esecuzione di un'attività. Il modello deve contenere una singola stringa di filtro costituita dai modelli da includere. I modelli sono delimitati da "|" (cioè una barra verticale), ad esempio:
"/folder1|/folder2".Tipo: matrice di oggetti FilterRule
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 1 elemento.
Required: No
- OverrideOptions
-
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 attività ha un valore predefinito. A meno che non sia necessario, non è necessario configurare nessuno di questi elementi
Optionsprima di iniziare l'attività.Tipo: Options oggetto
Required: No
- Tags
-
Specifica i tag da applicare al nome della risorsa Amazon (ARN) che rappresenta l'esecuzione dell'attività.
I tag sono coppie chiave-valore che facilitano la gestione, il filtraggio e la ricerca delle tue DataSync risorse.
Tipo: matrice di oggetti TagListEntry
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.
Required: No
- TaskArn
-
Specifica l'ARN (Amazon Resource Name) dell'attività da avviare.
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
{
"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.
- TaskExecutionArn
-
L'ARN dell'esecuzione dell'attività in 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}$
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 avvia l'esecuzione di un'attività utilizzando le opzioni predefinite per l'attività specificata.
{ "OverrideOptions": { "Atime": "BEST_EFFORT", "BytesPerSecond": 1000, "Gid": "NONE", "Mtime": "PRESERVE", "PosixPermissions": "PRESERVE", "PreserveDevices": "NONE", "PreserveDeletedFiles": "PRESERVE", "Uid": "NONE", "VerifyMode": "POINT_IN_TIME_CONSISTENT" }, "TaskArn": "arn:aws:datasync:us-east-2:111222333444:task/task-08de6e6697796f026" }
Risposta di esempio
Questo esempio illustra un utilizzo di. StartTaskExecution
{ "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:
