StartDiscoveryJob - AWS DataSync

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

StartDiscoveryJob

Exécute une tâche de DataSync découverte sur votre système de stockage sur site. Si vous n'avez pas encore ajouté le système de stockage à DataSync Discovery, faites-le d'abord en utilisant l'AddStorageSystemopération.

Syntaxe de la requête

{ "ClientToken": "string", "CollectionDurationMinutes": number, "StorageSystemArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

Cette demande accepte les données suivantes au format JSON.

ClientToken

Spécifie un jeton client pour s'assurer que les demandes effectuées avec cette opération d'API sont idempotentes. Si vous ne spécifiez aucun jeton client, il en DataSync génère un automatiquement pour vous.

Type : chaîne

Modèle : [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Obligatoire : oui

CollectionDurationMinutes

Spécifie en minutes la durée pendant laquelle vous souhaitez que la tâche de découverte s'exécute.

Note

Pour des recommandations plus précises, nous recommandons une durée d'au moins 14 jours. Les durées plus longues laissent le temps de collecter un nombre suffisant de points de données et fournissent une représentation réaliste des performances et de l'utilisation du stockage.

Type : entier

Plage valide : Valeur minimum de 60. Valeur maximale de 44640.

Obligatoire : oui

StorageSystemArn

Spécifie le nom de ressource Amazon (ARN) du système de stockage sur site sur lequel vous souhaitez exécuter la tâche de découverte.

Type : String

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^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}$

Obligatoire : oui

Tags

Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS .

Type : tableau d’objets TagListEntry

Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments.

Obligatoire : non

Syntaxe de la réponse

{ "DiscoveryJobArn": "string" }

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

DiscoveryJobArn

L'ARN de la tâche de découverte que vous avez lancée.

Type : String

Contraintes de longueur : longueur maximale de 256.

Modèle : ^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}$

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

InternalException

Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service.

Code d’état HTTP : 500

InvalidRequestException

Cette exception est levée lorsque le client soumet une demande mal formée.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :