Tous les produits
Search
Centre de documentation

:DescribeServiceEndpoints

Dernière mise à jour :Aug 07, 2026

Obtient la liste des points de terminaison de service.

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.

Syntaxe de la requête

GET /api/v2/services/{ClusterId}/{ServiceName}/endpoints HTTP/1.1

Paramètres de chemin

Paramètre

Type

Requis

Description

Exemple

ClusterId

string

Non

L'identifiant de la région.

cn-hangzhou

ServiceName

string

Oui

Le nom du service. Pour plus d'informations, consultez ListServices.

service_name

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

Éléments de réponse

Élément

Type

Description

Exemple

object

La réponse.

RequestId

string

L'identifiant de la requête.

739998B5-FB39-12A3-8323-0FA340317298

Message

string

Le message renvoyé.

Successful

AccessToken

string

Le jeton de service.

Nzc5N2FhN****TQ0YzBmYTIyN2MxZTUxN2NkYjg4MTJmMWQxZmY1****

Endpoints

array<object>

La liste des points de terminaison de service.

object

EndpointType

string

Le type de connexion du point de terminaison de service. Valeurs valides :

  • DefaultGateway : Le service est connecté à l'aide d'une passerelle partagée.

  • PrivateGateway : Le service est connecté à l'aide d'une passerelle dédiée.

  • Nlb : Le service est associé à une instance d'équilibreur de charge réseau (NLB).

  • Nacos : Le service est associé à une instance Nacos.

Nlb

BackendId

string

L'identifiant du service backend. La valeur de ce paramètre varie en fonction de la valeur de EndpointType :

  • Si EndpointType est DefaultGateway, ce paramètre est défini sur default.

  • Si EndpointType est PrivateGateway, ce paramètre correspond à l'identifiant de la passerelle dédiée.

  • Si EndpointType est Nlb, ce paramètre correspond à l'identifiant de l'instance NLB.

  • Si EndpointType est Nacos, ce paramètre correspond à l'identifiant de l'instance Nacos.

nlb-5q4sp7u6oorkha****

PathType

string

Le type du point de terminaison. Valeurs valides :

  • Group : le point de terminaison d'un groupe d'audience.

  • Service : le point de terminaison d'un service.

Service

IntranetEndpoints

array

La liste des points de terminaison internes.

string

Le point de terminaison interne.

nlb-5q4sp7u6oor****jvv.cn-hangzhou.nlb.aliyuncs.com

InternetEndpoints

array

La liste des points de terminaison orientés Internet.

string

Le point de terminaison orienté Internet.

null

Port

integer

Le numéro de port. Ce paramètre est renvoyé uniquement lorsque le service est attaché à une instance NLB ou Nacos.

9090

Exemples

JSON format

{
  "RequestId": "739998B5-FB39-12A3-8323-0FA340317298",
  "Message": "Execution succeeded.",
  "AccessToken": "Nzc5N2FhN****TQ0YzBmYTIyN2MxZTUxN2NkYjg4MTJmMWQxZmY1****",
  "Endpoints": [
    {
      "EndpointType": "Nlb",
      "BackendId": "nlb-5q4sp7u6oorkha****",
      "PathType": "Service",
      "IntranetEndpoints": [
        "nlb-5q4sp7u6oor****jvv.cn-hangzhou.nlb.aliyuncs.com"
      ],
      "InternetEndpoints": [
        "null"
      ],
      "Port": 9090
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.