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

Modifie un service de protocole. Vous pouvez modifier la description d'un service de protocole.

Description de l'opération

Cette opération s'applique uniquement aux systèmes de fichiers Cloud Parallel File Storage (CPFS).

Cette opération vous permet de modifier la description d'un service de protocole.
Vous pouvez obtenir l'identifiant du service de protocole (ProtocolServiceId) en utilisant l'une des méthodes suivantes :
- Appelez l'opération CreateProtocolService pour créer un service de protocole. L'identifiant du service de protocole est renvoyé dans la réponse.
- Appelez l'opération DescribeProtocolService pour interroger les services de protocole existants.

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
ProtocolServiceId	string	Oui	L'identifiant du service de protocole. Vous pouvez obtenir l'identifiant du service de protocole à partir de la réponse de l'opération CreateProtocolService, ou l'interroger en appelant l'opération DescribeProtocolService.	ptc-197ed6a00f2b****
FileSystemId	string	Oui	L'identifiant du système de fichiers.	cpfs-099394bd928c****
Description	string	Non	La description du service de protocole. Limites : La description doit comporter entre 2 et 128 caractères. La description doit commencer par une lettre ou un caractère chinois 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 (-). Les espaces et autres caractères spéciaux ne sont pas autorisés. Exemple valide : `My-Protocol-Service_01`.	My-Protocol-Service_01
DryRun	boolean	Non	Indique si un test à blanc doit être effectué pour cette requête de modification. Un test à blanc vérifie la validité des paramètres et les dépendances sans réellement modifier l'instance ni engendrer de frais. Valeurs valides : true : envoie une requête de test à blanc sans modifier le service de protocole. Le test à blanc vérifie si les paramètres requis sont spécifiés, si le format de la requête est valide et si les contraintes métier et les dépendances sont respectées. 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é. false (par défaut) : envoie une requête normale. Une fois la vérification réussie, le service de protocole est directement modifié.	false
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais assurez-vous que le jeton est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne doit 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 varier pour chaque requête API.	123e4567-e89b-12d3-a456-42665544****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
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	MissingFileSystemId	FileSystemId is mandatory for this action.	Le paramètre FileSystemId n'est pas spécifié.
400	MissingProtocolServiceId	ProtocolServiceId is mandatory for this action.	Le paramètre ProtocolServiceId n'est pas spécifié.
403	Instance.IncorrectStatus	The specified instance is in an incorrect status.	L'opération n'est pas autorisée dans l'état actuel.
403	InvalidProtocolSpec.NotSupported	The specified protocol spec does not supported.	Le ProtocolSpec spécifié n'est pas pris en charge.
403	PermissionDenied.ThroughputInvalid	Standard protocol service should not specified throughput.	Le service de protocole à usage général ne permet pas de spécifier la bande passante du service.
403	InvalidVSwitchId.IpShortage	The specified vswitch ip shortage.
403	OperationDenied.InvalidPtcStatus	The operation is denied due to invalid protocol service status.	L'état actuel du service de protocole ne prend pas en charge cette opération.
403	OperationDenied.InvalidState	The operation is denied due to invalid file system state.
403	OperationDenied.NotSupported	The operation is denied due to not supported.	Le système de fichiers ne prend pas en charge le service de protocole.
403	PermissionDenied.CLThroughputInvalid	Throughput of caching protocol service is invalid.	La bande passante du service de protocole de type cache n'est pas valide.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Le système de fichiers spécifié n'existe pas.
404	InvalidProtocolService.NotFound	The specified protocol service does not exist.	Le service de protocole spécifié n'existe pas.
404	InvalidDescription.InvalidFormat	Description format is invalid.	Le format de la description spécifiée n'est pas valide.
404	OperationDenied.NoStock	The operation is denied due to no stock.	Le système de fichiers est à court de ressources.

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

Notes de version

Consultez Notes de version pour la liste complète.