UpdateTask - 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.

UpdateTask

Met à jour les métadonnées associées à une tâche.

Syntaxe de la demande

{ "CloudWatchLogGroupArn": "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" }, "TaskArn": "string" }

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, voirParamètres courants.

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

CloudWatchLogGroupArn

L'Amazon Resource Name (ARN) du nom de ressource d'Amazon CloudWatch groupe de journaux.

Type : Chaîne

Contraintes de longueur : Longueur maximum de 562.

Modèle : ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]*:[0-9]{12}:log-group:([^:\*]*)(:\*)?$

Obligatoire Non

Excludes

Liste de règles de filtre qui détermine les fichiers à exclure d'une tâche. La liste doit contenir une seule chaîne de filtre composée des motifs à exclure. Les motifs sont délimités par « | » (c'est-à-dire une barre verticale), par exemple, "/folder1|/folder2".

Type : Array deFilterRuleobjets

Membres de tableau : Nombre minimal de 0 éléments. Nombre maximum de 1 élément.

Obligatoire Non

Includes

Liste de règles de filtre qui détermine les fichiers à inclure lors de l'exécution d'une tâche. Le modèle contient une seule chaîne de filtre composée des motifs à inclure. Les motifs sont délimités par « | » (c'est-à-dire une barre verticale), par exemple, "/folder1|/folder2".

Type : Array deFilterRuleobjets

Membres de tableau : Nombre minimal de 0 éléments. Nombre maximum de 1 élément.

Obligatoire Non

Name

Nom de la tâche à mettre à jour.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 256.

Modèle : ^[a-zA-Z0-9\s+=._:@/-]+$

Obligatoire Non

Options

Représente les options disponibles pour contrôler le comportement d'unStartTaskExecution. Le comportement inclut la conservation des métadonnées telles que l'ID utilisateur (UID), l'ID de groupe (GID) et les autorisations de fichiers, ainsi que le remplacement des fichiers dans la destination, la vérification de l'intégrité des données, etc.

Un ensemble d'options par défaut est associé à une tâche. Si vous ne spécifiez aucune option dansStartTaskExecution, la valeur par défaut est utilisée. Vous pouvez remplacer les options par défaut de chaque exécution de tâche en spécifiant un remplacementOptionsvaleur pourStartTaskExecution.

Type : objet Options

Obligatoire Non

Schedule

Spécifie une planification utilisée pour transférer périodiquement des fichiers d'une source vers un emplacement de destination. Vous pouvez configurer votre tâche pour qu'elle s'exécute toutes les heures, tous les jours, chaque semaine ou certains jours de la semaine. Vous contrôlez quand dans la journée ou l'heure où vous souhaitez que la tâche soit exécutée. L'heure que vous spécifiez est l'heure UTC. Pour de plus amples informations, veuillez consulterPlanification de votre tâche.

Type : objet TaskSchedule

Obligatoire Non

TaskArn

L'Amazon Resource Name (ARN) du nom de ressource de la tâche à mettre à jour.

Type : Chaîne

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}:task/task-[0-9a-f]{17}$

Obligatoire Oui

Éléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, voirErreurs courantes.

InternalException

Cette exception est renvoyée lorsqu'une erreur se produit dans leAWS DataSyncservice.

HTTP Status Code : 500

InvalidRequestException

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

HTTP Status Code : 400

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :