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

Consulte les répertoires d'exportation 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).

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

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

nas:DescribeProtocolMountTarget

list

*FileSystem

acs:nas:{#regionId}:{#accountId}:filesystem/{#FileSystemId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
NextToken	string	Non	Le jeton utilisé pour initier la requête suivante lorsque la réponse est tronquée. Vous pouvez utiliser ce jeton pour récupérer les résultats restants à partir de l'endroit où la troncature s'est produite.	aBcdg==
MaxResults	integer	Non	Le nombre maximal de résultats à renvoyer par requête. Valeurs valides : 10 à 100. Valeur par défaut : 20.	20
FileSystemId	string	Oui	L'identifiant du système de fichiers.	cpfs-099394bd928c****
Filters	array<object>	Non	Les clés de filtre pour interroger les répertoires d'exportation du service de protocole.
	object	Non	Les clés de filtre pour interroger les répertoires d'exportation du service de protocole.
Key	string	Non	Le nom de la clé de filtre. ProtocolServiceIds : filtre par identifiant de service de protocole. ExportIds : filtre par identifiant de répertoire d'exportation. VpcIds : filtre par identifiant de VPC. FsetIds : filtre par identifiant de fileset. Paths : filtre par chemin du système de fichiers correspondant à la cible de montage. AccessGroupNames : filtre par nom de groupe d'autorisations.	ExportIds
Value	string	Non	La valeur de la clé de filtre. Les caractères génériques ne sont pas pris en charge. Si Key est défini sur ProtocolServiceIds, définissez Value sur un identifiant de service de protocole. Vous pouvez spécifier jusqu'à 10 identifiants de service de protocole. Exemple : `ptc-12345678` ou `ptc-12345678,ptc-12345679`. Si Key est défini sur ExportIds, définissez Value sur un identifiant de répertoire d'exportation. Vous pouvez spécifier jusqu'à 10 identifiants de répertoire d'exportation. Exemple : `exp-12345678` ou `exp-12345678,exp-12345679`. Si Key est défini sur VpcIds, définissez Value sur l'identifiant de VPC du service de protocole. Vous pouvez spécifier jusqu'à 10 identifiants de VPC. Exemple : `vpc-12345678` ou `vpc-12345678,vpc-12345679`. Si Key est défini sur FsetIds, définissez Value sur un identifiant de fileset. Vous pouvez spécifier jusqu'à 10 identifiants de fileset. Exemple : `fset-12345678` ou `fset-12345678,fset-12345679`. Si Key est défini sur Paths, définissez Value sur le répertoire du système de fichiers correspondant à la cible de montage. Vous pouvez spécifier jusqu'à 10 chemins. Exemple : `/cpfs/mnt_1/` ou `/cpfs/mnt_1/,/cpfs/mnt_2/`. Si Key est défini sur AccessGroupNames, définissez Value sur le nom du groupe d'autorisations du service de protocole. Vous pouvez spécifier jusqu'à 10 noms de groupe d'autorisations. Exemple : `ag-12345678` ou `ag-12345678,ag-12345679`.	exp-19abf5beab8d**, exp-19acf6beaf7d**
ClientToken	string	Non	Garantit l'idempotence de la requête. Générez une valeur de paramètre unique depuis votre client pour vous assurer que la valeur est unique parmi 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 le RequestId de la requête API comme ClientToken. Le RequestId peut varier pour chaque requête API.	123e4567-e89b-12d3-a456-42665544****
ProtocolServiceIds	string	Non	La liste des identifiants de service de protocole.	ptc-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-A3DC0****
NextToken	string	Le marqueur utilisé pour récupérer les répertoires d'exportation restants lors des requêtes suivantes.	aBcdeg==
ProtocolMountTargets	array<object>	La collection des répertoires d'exportation du service de protocole.
	object	Le répertoire d'exportation du service de protocole.
ExportId	string	L'identifiant du répertoire d'exportation du service de protocole.	exp-19abf5beab8d****
ProtocolMountTargetDomain	string	Le nom de domaine du répertoire d'exportation du service de protocole.	cpfs-123****.cn-hangzhou.cpfs.aliyuncs.com
ProtocolType	string	Le type de protocole pris en charge par le service de protocole.	NFS
VpcId	string	L'identifiant de VPC du répertoire d'exportation du service de protocole.	vpc-2vct297b8157bth9z****
VSwitchId	string	L'identifiant de vSwitch du répertoire d'exportation du service de protocole.	vsw-2vc3c2lybvdllxyq4****
FsetId	string	L'identifiant de fileset du répertoire d'exportation du service de protocole.	fset-1902718ea0ae****
Path	string	Le répertoire exporté du service de protocole.	/path/
AccessGroupName	string	Le groupe d'autorisations associé au répertoire d'exportation du service de protocole.	DEFAULT_VPC_GROUP_NAME
CreateTime	string	L'heure de création du répertoire d'exportation du service de protocole. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ.	2018-12-12T07:28:38Z
Status	string	L'état de la cible de montage.	CREATING
ProtocolServiceId	string	L'identifiant du service de protocole.	ptc-123****
Description	string	La description du répertoire d'exportation du service de protocole.	Description de ce répertoire d'exportation du service de protocole
VSwitchIds	array	La liste des identifiants de vSwitch à redondance interzone.
	string	La liste des identifiants de vSwitch à redondance interzone.	vsw-123xxx

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0****",
  "NextToken": "aBcdeg==",
  "ProtocolMountTargets": [
    {
      "ExportId": "exp-19abf5beab8d****",
      "ProtocolMountTargetDomain": "cpfs-123****.cn-hangzhou.cpfs.aliyuncs.com",
      "ProtocolType": "NFS",
      "VpcId": "vpc-2vct297b8157bth9z****",
      "VSwitchId": "vsw-2vc3c2lybvdllxyq4****",
      "FsetId": "fset-1902718ea0ae****",
      "Path": "/path/",
      "AccessGroupName": "DEFAULT_VPC_GROUP_NAME",
      "CreateTime": "2018-12-12T07:28:38Z",
      "Status": "CREATING",
      "ProtocolServiceId": "ptc-123****",
      "Description": "此协议服务导出目录的描述。",
      "VSwitchIds": [
        "vsw-123xxx"
      ]
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	MissingFileSystemId	FileSystemId is mandatory for this action.	The FileSystemId parameter is not specified.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	The specified file system does not exist.
404	InvalidParameter.InvalidNextToken	The specified NextToken is invaild.
404	InvalidParameter.InvalidMaxResults	The specified MaxResults is invalid.	The specified MaxResults is invalid.
404	InvalidFilterValue	The specified Filter.N.Value is invalid.	The specified Filter.N.Value parameter is invalid.
404	InvalidFilterParam	The specified Filter.N.Key is invalid.	The specified Filter.N.Key parameter is invalid.

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

Notes de version

Consultez Notes de version pour la liste complète.