UpdateTask - AWS DataSync
Syntaxe de la requêteParamètres de demandeÉléments de réponseErreursVoir aussi

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 requête

{
   "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, voir Paramètres communs.

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

CloudWatchLogGroupArn

L'Amazon Resource Name (ARN) du groupe deCloudWatch journaux Amazon.

Type : String

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

Spécifie une liste de règles de filtre qui excluent des données spécifiques lors de votre transfert. Pour plus d'informations et des exemples, consultez Filtrage des données transférées parDataSync.

Type : tableau d’objets FilterRule

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément.

Obligatoire : non

Includes

Spécifie une liste de règles de filtre qui incluent des données spécifiques lors de votre transfert. Pour plus d'informations et des exemples, consultez Filtrage des données transférées parDataSync.

Type : tableau d’objets FilterRule

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 1 élément.

Obligatoire : non

Name

Le nom du la tâche à mettre à jour.

Type : String

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

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

Obligatoire : non

Options

Configure les paramètres de vosAWS DataSync tâches. Ces options incluent la manièreDataSync dont les fichiers, les objets et leurs métadonnées associées sont gérés. Vous pouvez également spécifier commentDataSync vérifier l'intégrité des données, définir des limites de bande passante pour votre tâche, entre autres options.

Chaque paramètre du paramètre du paramètre du paramètre du paramètre du paramètre du paramètre du paramètre du À moins que vous n'en ayez besoin, vous n'avez pas besoin de les configurerOptions avant de commencer votre tâche.

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, toutes les semaines ou certains jours de la semaine. Vous déterminez à quel moment de la journée ou de l'heure vous souhaitez que la tâche soit exécutée. L'heure que vous spécifiez est l'heure UTC. Pour plus d'informations, veuillez consulter la rubrique Planification de votre tâche.

Type : objet TaskSchedule

Obligatoire : non

TaskArn

L'Amazon Resource Name (ARN) de le nom du nom du nom du nom du nom du nom du nom du nom du nom du nom du nom du nom du nom

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}: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, consultezErreurs courantes.

InternalException

Cette exception est déclenchée lorsqu'une erreur se produit dans leAWS DataSync service.

Code d'état HTTP : 500

InvalidRequestException

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

Code d'état HTTP : 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 :