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

Modifie les paramètres du répertoire d'exportation d'un service de protocole. Vous ne pouvez modifier que le groupe de permissions et la description. L'identifiant du VPC et l'identifiant du vSwitch ne peuvent pas être modifiés. Pour les modifier, supprimez le répertoire d'exportation et créez-en un nouveau.

Description de l'opération

Avant de commencer : cette opération s'applique uniquement aux systèmes de fichiers Cloud Parallel File Storage (CPFS).
Prérequis d'état : avant d'appeler cette opération, le répertoire d'exportation correspondant à ExportId doit être à l'état AVAILABLE. Appelez DescribeProtocolMountTarget pour interroger l'état et attendez que la création soit terminée avant de réessayer.
Chaîne de dépendance :
1. Appelez DescribeFileSystems (avec FileSystemType défini sur cpfs) pour obtenir le système de fichiers CPFS.
2. Appelez DescribeProtocolService pour vérifier que le service de protocole est à l'état Running.
3. Appelez DescribeProtocolMountTarget pour vérifier que le répertoire d'exportation est à l'état AVAILABLE.
4. Si aucun répertoire d'exportation n'existe, appelez CreateProtocolMountTarget pour en créer un d'abord.

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. Appelez DescribeProtocolService pour obtenir les informations du service de protocole.	ptc-197ed6a00f2b****
ExportId	string	Oui	L'identifiant du répertoire d'exportation du service de protocole. Appelez DescribeProtocolMountTarget pour obtenir les informations du répertoire d'exportation.	exp-19abf5beab8d****
FileSystemId	string	Oui	L'identifiant du système de fichiers. Appelez DescribeFileSystems (avec FileSystemType défini sur cpfs) pour obtenir les informations du système de fichiers.	cpfs-099394bd928c****
Description	string	Non	La description du répertoire d'exportation 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 (_) et des traits d'union (-).	Description de ce répertoire d'exportation
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 conditions de dépendance sans modifier réellement le répertoire d'exportation ni engendrer de frais. Valeurs valides : true : envoie une requête de test à blanc sans modifier le répertoire d'exportation. Les éléments vérifiés incluent les paramètres requis, le format de la requête et les conditions de dépendance métier. DryRun=true effectue également des vérifications de l'état des ressources (y compris l'exigence que le répertoire d'exportation soit à l'état AVAILABLE). Si l'état du répertoire d'exportation ne répond pas aux exigences (comme CREATING), l'erreur correspondante est renvoyée. DryRun ne contourne pas les vérifications d'état. Il valide uniquement la validité des paramètres de la requête et les dépendances de base. 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 (valeur par défaut) : envoie une requête normale. Une fois la vérification réussie, les paramètres du répertoire d'exportation sont directement modifiés.	true
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur unique depuis votre client pour vous assurer que différentes requêtes ont des valeurs ClientToken uniques. ClientToken prend uniquement en charge 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 le RequestId de la requête API comme ClientToken. Le RequestId peut varier pour chaque requête API.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

É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.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

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	MissingExportId	ExportId is mandatory for this action.	Le paramètre ExportId n'est pas spécifié.
400	MissingAccessGroupName	AccessGroupName is mandatory for this action.	Aucun groupe d'autorisations n'est 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	OperationDenied.InvalidMntStatus	The operation is denied due to invalid protocol mount targte status.
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.
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	InvalidExportId.NotFound	The specified ExportId does not exist.	Le répertoire d'exportation spécifié du service de protocole n'existe pas.
404	InvalidAccessGroupName.NotFound	The specified access group does not exist.	Le groupe de permissions spécifié n'existe pas.
404	InvalidAccessGroupName.NotAccessRule	There has no rule in access group.	Le groupe de permissions spécifié ne contient aucune règle.
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.