ListVpcEndpoints - - Centre de documentation Alibaba Cloud

Consulte la liste des points de terminaison.

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.

privatelink:ListVpcEndpoints

get

*VpcEndpoint.

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région des points de terminaison que vous souhaitez interroger. Vous pouvez appeler l'opération DescribeRegions pour obtenir l'identifiant de la région.	cn-huhehaote
NextToken	string	Non	Indique si un jeton pour la requête suivante doit être fourni. Valeurs valides : S'il s'agit de la première requête ou s'il n'y a pas de requête suivante, vous n'avez pas besoin de spécifier ce paramètre. Si une requête suivante doit être envoyée, définissez la valeur sur la valeur de NextToken renvoyée lors du dernier appel.	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	Non	Le nombre d'entrées par page. Valeurs valides : 1 à 1000. Valeur par défaut : 50.	50
EndpointId	string	Non	L'identifiant du point de terminaison que vous souhaitez interroger.	ep-hp33b2e43fays7s8****
ServiceName	string	Non	Le nom du service de point de terminaison associé au point de terminaison que vous souhaitez interroger.	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****
VpcId	string	Non	Le cloud privé virtuel (VPC) auquel le point de terminaison appartient.	vpc-fdjkf789dfdfdfde****
EndpointName	string	Non	Le nom du point de terminaison.	test
EndpointType	string	Non	Le type de point de terminaison. Valeurs valides : Interface : point de terminaison d'interface. Reverse : point de terminaison inverse. GatewayLoadBalancer : point de terminaison Gateway Load Balancer (GWLBe).	Interface
EndpointStatus	string	Non	L'état du point de terminaison. Valeurs valides : Creating : en cours de création. Active : actif. Pending : en cours de modification. Deleting : en cours de suppression.	Active
ConnectionStatus	string	Non	L'état de la connexion du point de terminaison. Valeurs valides : Pending : en cours de modification. Connecting : en cours de connexion. Connected : connecté. Disconnecting : en cours de déconnexion. Disconnected : déconnecté. Deleting : en cours de suppression. ServiceDeleted : le service associé au point de terminaison a été supprimé.	Disconnected
Tag	array<object>	Non	La liste des balises.
	object	Non	La balise.
Key	string	Non	La clé de balise de l'instance. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 64 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`.	FinanceDept
Value	string	Non	La valeur de balise de l'instance. Vous pouvez spécifier jusqu'à 20 valeurs de balise. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et ne peut pas commencer par `aliyun` ou `acs:`. Elle ne peut pas contenir `http://` ou `https://`.	FinanceJoshua
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	1
AddressIpVersion	string	Non	La version du protocole. Valeurs valides : IPv4 : IPv4. DualStack : double pile.	IPv4
ServiceRegionId	string	Non	L'identifiant de la région du service de point de terminaison.	cn-huhehaote

Éléments de réponse

Élément	Type	Description	Exemple
	object
Endpoints	array<object>	Les informations sur les points de terminaison.
	array<object>	Les informations sur les points de terminaison.
VpcId	string	Le cloud privé virtuel (VPC) auquel le point de terminaison appartient.	vpc-hp356stwkxg3fn2xe****
EndpointName	string	Le nom du point de terminaison.	test
EndpointType	string	Le type de point de terminaison. Valeurs valides : Interface : point de terminaison d'interface. Reverse : point de terminaison inverse. GatewayLoadBalancer : point de terminaison Gateway Load Balancer (GWLBe).	Interface
CreateTime	string	L'heure de création du point de terminaison. L'heure est au format ISO 8601 YYYY-MM-DDTHH:mm:ssZ. L'heure est affichée en UTC.	2021-09-24T18:00:07Z
ServiceId	string	L'identifiant du service de point de terminaison associé au point de terminaison.	epsrv-hp3vpx8yqxblby3i****
ZoneAffinityEnabled	boolean	Indique si l'affinité de zone est activée pour le nom de domaine du point de terminaison afin de se connecter au service. Valeurs valides : true : l'affinité de zone est activée. false : l'affinité de zone est désactivée.	true
EndpointDomain	string	Le nom de domaine du point de terminaison.	ep-hp33b2e43fays7s8**.epsrv-hp3xdsq46ael67lo**.cn-huhehaote.privatelink.aliyuncs.com
EndpointStatus	string	L'état du point de terminaison. Valeurs valides : Creating : en cours de création. Active : actif. Pending : en cours de modification. Deleting : en cours de suppression.	Active
RegionId	string	L'identifiant de la région du point de terminaison.	cn-huhehaote
ResourceOwner	boolean	Indique si le point de terminaison et le service de point de terminaison appartiennent au même compte Alibaba Cloud. Valeurs valides : true : le point de terminaison et le service de point de terminaison appartiennent au même compte Alibaba Cloud. false : le point de terminaison et le service de point de terminaison appartiennent à des comptes Alibaba Cloud différents.	true
Bandwidth	integer	La bande passante de la connexion du point de terminaison. Unité : Mbit/s.	1024
ConnectionStatus	string	L'état de la connexion du point de terminaison. Valeurs valides : Pending : en cours de modification. Connecting : en cours de connexion. Connected : connecté. Disconnecting : en cours de déconnexion. Disconnected : déconnecté. Deleting : en cours de suppression. ServiceDeleted : le service associé au point de terminaison a été supprimé.	Disconnected
EndpointDescription	string	La description du point de terminaison.	This is my Endpoint.
EndpointId	string	L'identifiant du point de terminaison.	ep-hp33b2e43fays7s8****
EndpointBusinessStatus	string	L'état commercial du point de terminaison. Valeurs valides : Normal : normal. FinancialLocked : verrouillé en raison d'un retard de paiement.	Normal
ServiceName	string	Le nom du service de point de terminaison associé au point de terminaison.	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3xdsq46ael67lo****
Tags	array<object>	La liste des balises.
	object	La liste des balises.
Key	string	La clé de balise de l'instance.	FinanceDept
Value	string	La valeur de balise de l'instance.	FinanceJoshua
ResourceGroupId	string	L'identifiant du groupe de ressources.	1
PolicyDocument	string	La stratégie d'accès RAM. Pour plus d'informations sur la définition de la stratégie, consultez Éléments de base d'une stratégie d'autorisation.	{\n \"Version\": \"1\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": \"\",\n \"Principal\": \"\",\n \"Resource\": \"*\"\n }\n ]\n}
AddressIpVersion	string	La version du protocole. Valeurs valides : IPv4 : IPv4. DualStack : double pile.	IPv4
ServiceRegionId	string	L'identifiant de la région du service de point de terminaison associé au point de terminaison.	cn-huhehaote
CrossRegionBandwidth	integer	La bande passante interrégionale du point de terminaison. Unité : Mbit/s.	1000
ProtectedEnabled	boolean	Indique si la protection gérée est activée. Ce paramètre prend effet uniquement pour les appels effectués à l'aide du service de jeton de sécurité (STS). Valeurs valides : true : la protection gérée est activée. Une fois la protection gérée activée, seul l'utilisateur qui a créé le point de terminaison peut le modifier ou le supprimer à l'aide de STS. false : la protection gérée est désactivée.
NextToken	string	Indique si une requête suivante existe. Valeurs valides : Si NextToken est vide, aucune requête suivante n'existe. Si NextToken est renvoyé, la valeur indique le jeton pour la requête suivante.	caeba0bbb2be03f84eb48b699f0a****
RequestId	string	L'identifiant de la requête.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
MaxResults	integer	Le nombre d'entrées par page.	50
TotalCount	integer	Le nombre total d'entrées renvoyées.	12

Exemples

JSON format

{
  "Endpoints": [
    {
      "VpcId": "vpc-hp356stwkxg3fn2xe****",
      "EndpointName": "test",
      "EndpointType": "Interface",
      "CreateTime": "2021-09-24T18:00:07Z",
      "ServiceId": "epsrv-hp3vpx8yqxblby3i****",
      "ZoneAffinityEnabled": true,
      "EndpointDomain": "ep-hp33b2e43fays7s8****.epsrv-hp3xdsq46ael67lo****.cn-huhehaote.privatelink.aliyuncs.com",
      "EndpointStatus": "Active",
      "RegionId": "cn-huhehaote",
      "ResourceOwner": true,
      "Bandwidth": 1024,
      "ConnectionStatus": "Disconnected",
      "EndpointDescription": "Ceci est mon point de terminaison",
      "EndpointId": "ep-hp33b2e43fays7s8****",
      "EndpointBusinessStatus": "Normal",
      "ServiceName": "com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3xdsq46ael67lo****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "ResourceGroupId": "1",
      "PolicyDocument": "{\\n  \\\"Version\\\": \\\"1\\\",\\n  \\\"Statement\\\": [\\n    {\\n      \\\"Effect\\\": \\\"Allow\\\",\\n      \\\"Action\\\": \\\"*\\\",\\n      \\\"Principal\\\": \\\"*\\\",\\n      \\\"Resource\\\": \\\"*\\\"\\n    }\\n  ]\\n}",
      "AddressIpVersion": "IPv4",
      "ServiceRegionId": "cn-huhehaote",
      "CrossRegionBandwidth": 1000,
      "ProtectedEnabled": false
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "MaxResults": 50,
  "TotalCount": 12
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.