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

Crée un répertoire d'exportation pour 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).
Avant de commencer

Le système de fichiers CPFS cible doit être à l'état Running et un service de protocole doit avoir été créé.
Autres informations
- Le bloc CIDR du VPC de l'exportation du service de protocole ne doit pas chevaucher le bloc CIDR du VPC du système de fichiers.
- Les blocs CIDR du VPC de plusieurs exportations sur le même service de protocole ne doivent pas se chevaucher.
- Vous pouvez créer jusqu'à 10 répertoires d'exportation pour un seul service de protocole.
- La création d'un répertoire d'exportation de service de protocole consomme des adresses IP du vSwitch spécifié (jusqu'à 32 adresses IP). Assurez-vous que le vSwitch cible dispose de ressources d'adresses IP suffisantes.

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.	ptc-197ed6a00f2b****
FileSystemId	string	Oui	L'identifiant du système de fichiers. Remarque Le système de fichiers CPFS cible doit être à l'état Running avant d'appeler cette opération. Après la création, il faut environ 20 à 40 minutes pour que le système de fichiers atteigne l'état Running. Vous pouvez appeler DescribeFileSystems pour interroger le champ Status (Running indique qu'il est prêt).	cpfs-099394bd928c****
VpcId	string	Non	L'identifiant du VPC pour l'exportation du service de protocole. Remarque Le bloc CIDR du VPC sélectionné ne doit pas chevaucher le bloc CIDR du VPC du système de fichiers CPFS cible. Vous pouvez appeler l'opération DescribeVpcs de VPC pour interroger le champ CidrBlock de chaque VPC à des fins de comparaison, et sélectionner un VPC qui n'entre pas en conflit et qui se trouve dans la même zone que le système de fichiers.	vpc-2vct297b8157bth9z****
VSwitchId	string	Non	L'identifiant du vSwitch pour l'exportation du service de protocole. Si le type de redondance de stockage du système de fichiers n'est pas un stockage redondant interzone (ZRS), ce paramètre est requis lorsque VpcId est spécifié. Remarque Le vSwitch doit se trouver dans la même zone que le système de fichiers CPFS cible (les valeurs ZoneId doivent correspondre). Vous pouvez appeler DescribeFileSystems pour interroger le champ ZoneId du système de fichiers, puis sélectionner un vSwitch dans la même zone.	vsw-2vc3c2lybvdllxyq4****
FsetId	string	Non	L'identifiant du jeu de fichiers à exporter. Limites : Le jeu de fichiers doit déjà exister. Un seul répertoire d'exportation peut être créé pour chaque jeu de fichiers. Vous devez spécifier un et un seul des paramètres FsetId et Path.	fset-1902718ea0ae****
Path	string	Non	Le chemin du répertoire CPFS à exporter. Limites : Le répertoire doit déjà exister sur le système de fichiers CPFS. Une seule exportation peut être créée pour le même répertoire. Vous devez spécifier un et un seul des paramètres FsetId et Path. Format : Le chemin doit comporter de 1 à 1 024 caractères. Le chemin doit être encodé en UTF-8. Le chemin doit commencer et se terminer par une barre oblique (/). Le répertoire racine est `/`.	/
AccessGroupName	string	Non	Le nom du groupe d'autorisations. Valeur par défaut : DEFAULT_VPC_GROUP_NAME.	DEFAULT_VPC_GROUP_NAME
Description	string	Non	La description du répertoire d'exportation du service de protocole. Elle est affichée sous le nom Nom du répertoire d'exportation dans la console. Limites : La description doit comporter de 2 à 128 caractères et peut contenir des lettres et des caractères chinois. La description doit commencer par une lettre ou un caractère chinois. Elle 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
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 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 automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut varier pour chaque requête API.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
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 les dépendances sans créer réellement l'instance ni engendrer de frais. Valeurs valides : true : envoie une requête de test à blanc sans créer le répertoire d'exportation. Les éléments vérifiés incluent la spécification des paramètres requis, le format de la requête et les dépendances des limites métier. 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 ExportId est vide. false (par défaut) : envoie une requête normale. Une fois la vérification réussie, l'instance est directement créée.	true
VSwitchIds	array	Non	La liste des identifiants de vSwitch pour l'exportation du service de protocole.
	string	Non	La liste des identifiants de vSwitch pour l'exportation du service de protocole. Si le type de redondance de stockage du système de fichiers est un stockage redondant interzone (ZRS), vous devez spécifier des identifiants de vSwitch dans trois zones différentes au sein du VPC lorsque VpcId est spécifié.	vsw-123xxx

É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
ExportId	string	L'identifiant du répertoire d'exportation du service de protocole.	exp-19abf5beab8d****

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "ExportId": "exp-19abf5beab8d****"
}

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	InvalidVSwitchId.IpShortage	The specified vswitch ip shortage.
403	InvalidFset.InUse	Fset already used by other export.	Le Fileset spécifié est déjà utilisé.
403	MntPathConflict.InvalidParam	FilesetId and Path must and can only be specified one.	Exactement l'un des paramètres Fileset et Path doit être spécifié.
403	OperationDenied.TooManyDepth	The operation is denied due to Fsets path too deep.	La profondeur du chemin d'accès du répertoire intelligent dépasse le seuil.
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.CrossVPCExceedLimit	Cross vpc mount exceed limit.	Le nombre de répertoires d'exportation inter-VPC a dépassé la limite supérieure de la spécification actuelle du service de protocole.
403	OperationDenied.NoMountTargetQuota	No mount target quota on this protocol service.	Le quota du répertoire d'exportation du service de protocole est épuisé.
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	InvalidVpcId.ConflictVpcCidr	Vpc cidr conflict with file system	Le bloc CIDR du VPC spécifié chevauche le bloc CIDR du VPC du système de fichiers.
404	InvalidFsetId.NotFound	The specified fileset ID does not exist.
404	Fset.IncorrectStatus	The specified fset is in an incorrect status.	Le fileset spécifié n'est pas disponible.
404	InvalidFileSystemPath.InvalidCharacters	The specified fileset path contains invalid characters.	Le chemin du Fileset spécifié contient des caractères non valides.
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.
404	InvalidParameter.VpcNotFound	The specified VPC does not exist.	Le VPC spécifié n'existe pas.
404	InvalidParameter.VswNotFound	The specified VSwitch does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.