ModifyDataFlow - Cloud Parallel File Storage - Centre de documentation Alibaba Cloud

Modifie les attributs d'un flux de données.

Description de l'opération

CPFS 2.2.0 et versions ultérieures ainsi que CPFS for Lingjun 2.4.0 et versions ultérieures prennent en charge les flux de données.
Seuls les flux de données à l'état Running (Normal) peuvent voir leurs propriétés modifiées.
La modification d'un flux de données prend généralement de 2 à 5 minutes. Vous pouvez appeler DescribeDataFlows pour interroger l'état de la modification du flux de données.
Spécifications des flux de données CPFS :
- La bande passante du flux de données (Throughput) prend en charge trois spécifications : 600 Mo/s, 1 200 Mo/s et 1 500 Mo/s. La bande passante du flux de données correspond à la bande passante de transmission maximale pouvant être atteinte lorsque le flux de données importe ou exporte des données.
- Requête d'inventaire : lorsque vous définissez DryRun sur true, vous pouvez vérifier si les ressources nécessaires pour modifier le flux de données avec les spécifications indiquées sont suffisantes.
Facturation de CPFS

La modification de la bande passante du flux de données (Throughput) entraîne la facturation de la bande passante du flux de données. Familiarisez-vous au préalable avec les méthodes de facturation de CPFS. Pour plus de détails, consultez Facturation de CPFS.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
FileSystemId	string	Oui	L'identifiant du système de fichiers. CPFS : l'identifiant doit commencer par `cpfs-`, par exemple cpfs-125487**. CPFS for Lingjun : l'identifiant doit commencer par `bmcpfs-`, par exemple bmcpfs-0015**.	cpfs-099394bd928c****
DataFlowId	string	Oui	L'identifiant du flux de données.	df-194433a5be31****
Description	string	Non	La description du flux de données. Limites : La description doit comporter entre 2 et 128 caractères. La description doit commencer par une lettre et ne peut pas commencer par http:// ou https://. La description peut contenir des chiffres, des deux-points (:), des traits de soulignement (_) ou des traits d'union (-).	Bucket01DataFlow
Throughput	integer	Non	La bande passante de transmission maximale du flux de données. Unité : Mo/s. Valeurs valides : 600 1200 1500 Remarque La bande passante de transmission du flux de données doit être inférieure à la bande passante d'E/S du système de fichiers. Ce paramètre est requis lorsque le type de système de fichiers est CPFS. Valeurs valides : 600 : 600 MB/s 1200 : 1200 MB/s 1500 : 1500 MB/s 2000 : 2000 MB/s	600
DryRun	boolean	Non	Indique si un test à blanc doit être effectué pour cette requête. Un test à blanc vérifie la validité des paramètres et la disponibilité des ressources sans créer réellement l'instance ni engendrer de frais. Valeurs valides : true : envoie une requête de vérification sans créer l'instance. Les éléments vérifiés incluent la spécification des paramètres requis, le format de la requête, les limites métier et l'inventaire NAS. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'état HTTP 200 est renvoyé, mais FileSystemId est vide. false (par défaut) : envoie une requête normale. Une fois la vérification réussie, l'instance est directement créée.	false
ClientToken	string	Non	Garantit l'idempotence de la requête. Générez une valeur de paramètre depuis votre client pour vous assurer que la valeur est unique pour les différentes requêtes. ClientToken ne prend en charge que les caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut différer pour chaque requête API.	123e4567-e89b-12d3-a456-42665544****

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	98696EF0-1607-4E9D-B01D-F20930B6****

Exemples

JSON format

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	IllegalCharacters	The parameter contains illegal characters.	Le paramètre n'est pas valide.
400	MissingFileSystemId	FileSystemId is mandatory for this action.	Le paramètre FileSystemId n'est pas spécifié.
400	MissingDataFlowId	DataFlowId is mandatory for this action.	Le paramètre DataFlowId n'est pas spécifié.
403	OperationDenied.DependencyViolation	The operation is denied due to dependancy violation.	Les conditions requises pour cette opération ne sont pas remplies.
403	OperationDenied.NoStock	The operation is denied due to no stock.
403	OperationDenied.ConflictOperation	The operation is denied due to a conflict with an ongoing operation.	Le flux de données ne peut pas être créé car il est en conflit avec l'opération actuelle du système de fichiers.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	L'état actuel du système de fichiers ne prend pas en charge cette opération.
403	OperationDenied.DataFlowNotSupported	The operation is not supported.	Le système de fichiers ne prend pas en charge le flux de données.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Le système de fichiers spécifié n'existe pas.
404	InvalidDataFlow.NotFound	The specified data flow does not exist.	Le flux de données spécifié n'existe pas.
404	InvalidThroughput.OutOfBounds	Throughput is out of bounds.	Le débit spécifié n'est pas compris dans la plage valide.
404	InvalidDescription.InvalidFormat	Description format is invalid.	Le format de la description spécifiée n'est pas valide.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.