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

StartDiscoveryJob

Esegue un processo di DataSync rilevamento sul sistema di storage locale. Se non hai ancora aggiunto il sistema di storage a DataSync Discovery, esegui prima questa operazione utilizzando l'AddStorageSystemoperazione.

Sintassi della richiesta

{ "ClientToken": "string", "CollectionDurationMinutes": number, "StorageSystemArn": "string", "Tags": [ { "Key": "string", "Value": "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.

ClientToken

Specifica un token client per assicurarsi che le richieste con questa operazione API siano idempotenti. Se non specifichi un token client, ne DataSync genera uno automaticamente.

Tipo: stringa

Modello: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Campo obbligatorio: sì

CollectionDurationMinutes

Specifica in minuti per quanto tempo si desidera che venga eseguito il processo di rilevamento.

Nota

Per consigli più accurati, si consiglia una durata di almeno 14 giorni. Le durate più lunghe consentono di raccogliere un numero sufficiente di punti dati e di fornire una rappresentazione realistica delle prestazioni e dell'utilizzo dello storage.

Tipo: integer

Intervallo valido: valore minimo pari a 60. Valore massimo di 44640.

Campo obbligatorio: sì

StorageSystemArn

Specifica l'Amazon Resource Name (ARN) del sistema di storage locale su cui desideri eseguire il discovery job.

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}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

Campo obbligatorio: sì

Tags

Specifica le etichette che consentono di classificare, filtrare e cercare le risorse AWS .

Tipo: matrice di oggetti TagListEntry

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.

Campo obbligatorio: no

Sintassi della risposta

{ "DiscoveryJobArn": "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.

DiscoveryJobArn

L'ARN del processo di scoperta che hai iniziato.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

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

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: