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 :