Tous les produits
Search
Centre de documentation

Service Catalog:Présentation de l'intégration

Dernière mise à jour :Aug 11, 2026

Service Catalog prend en charge plusieurs méthodes d'intégration, notamment OpenAPI Explorer, Alibaba Cloud SDK et Terraform. Choisissez la méthode la plus adaptée à vos besoins.

, et Terraform

Présentation d'OpenAPI Explorer

OpenAPI Explorer vous permet de rechercher, déboguer et appeler des opérations API des services Alibaba Cloud. Il génère également automatiquement du code d'exemple SDK. Ses fonctionnalités incluent la recherche intelligente, la documentation, le débogage en ligne, le téléchargement de SDK, des exemples de code, le diagnostic d'erreurs et des statistiques d'appels. Pour plus d'informations, consultez Qu'est-ce qu'une API ?

Versions

OpenAPI Explorer utilise des numéros de version pour gérer les versions majeures des opérations API des services cloud. Par exemple, Service Catalog prend en charge l'API de la version 2021-09-01. 2021-09-01 est un numéro de version, et non la date de dernière mise à jour de l'API. Chaque version fournit les données API les plus récentes.

Version de l'API

Description

2021-09-01

Version recommandée.

Débogage en ligne

Vous pouvez appeler les opérations API de Service Catalog dans OpenAPI Explorer. Avant de commencer, assurez-vous de bien comprendre la version de l'API, les endpoints et les méthodes d'intégration.

Dans OpenAPI Explorer, sélectionnez l'opération GetProductAsEndUser pour le débogage. Pour Service Address, sélectionnez la région cible, par exemple China (Hangzhou). Dans la zone de configuration des paramètres, saisissez le paramètre requis ProductId (ID du produit, chaîne de caractères, par exemple prod-bp18r7q127****), puis cliquez sur Initiate Call. Avant d'effectuer l'appel, vérifiez qu'un administrateur a accordé à l'utilisateur final les permissions nécessaires pour utiliser le produit. Vous pouvez obtenir le ProductId à partir des réponses d'opérations telles que UpdateProduct, LaunchProduct, CreateProduct, ListProductsAsAdmin et GetProductVersion.

Page de débogage en ligne

Déboguez les opérations API sur la page suivante : Liste de débogage de l'API Service Catalog

Endpoints

Sélectionnez un endpoint en fonction de la région où réside votre ressource afin de réduire la latence. Par exemple, si votre Service Catalog se trouve dans la région China (Hangzhou), l'endpoint public est servicecatalog.cn-hangzhou.aliyuncs.com et l'endpoint VPC est servicecatalog-vpc.cn-hangzhou.aliyuncs.com.

  • Les endpoints publics sont accessibles partout dans le monde.

  • Les endpoints VPC ne sont accessibles que depuis un VPC situé dans une région spécifique d'Alibaba Cloud. Ils offrent les avantages suivants :

    • Sécurité renforcée : l'accès aux endpoints VPC étant restreint au sein d'un VPC, la sécurité et la confidentialité sont accrues.

    • Réponse plus rapide : en utilisant le réseau interne, les endpoints VPC garantissent des temps de réponse réduits et évitent les limites liées à la latence réseau et à la bande passante.

    • Coût réduit : l'accès aux endpoints VPC s'effectue via le réseau interne.

Pour plus d'informations, consultez Endpoints.

Identités utilisateur

Une fois connecté à OpenAPI Explorer avec votre compte Alibaba Cloud, cet outil utilise ce compte par défaut pour le débogage en ligne. Étant donné qu'un compte Alibaba Cloud dispose de permissions sur toutes les opérations API, son utilisation pour le débogage présente des risques de sécurité. Nous vous recommandons plutôt d'appeler les opérations API en tant qu'utilisateur RAM. Au préalable, accordez à cet utilisateur RAM les permissions requises selon vos besoins métier. L'utilisateur RAM doit disposer des permissions nécessaires pour gérer Service Catalog. Pour plus d'informations, consultez Utiliser RAM pour le contrôle d'accès.

Identité

Prise en charge

Compte Alibaba Cloud

Oui

Utilisateur RAM (recommandé)

Oui

Rôle RAM (recommandé)

Oui

Références

Méthodes d'intégration

Remarque

Les SDK s'intègrent facilement à votre application et couvrent la plus large gamme d'opérations. Nous vous recommandons d'utiliser les SDK pour appeler les opérations API.

Présentation des méthodes d'intégration

Méthode d'intégration

Prise en charge

SDK Alibaba Cloud (recommandé)

Oui

Alibaba Cloud CLI

Non

Resource Orchestration Service (ROS)

Non

Encapsulation personnalisée

Oui

  • SDK Alibaba Cloud

    • Alibaba Cloud fournit des SDK dans plusieurs langages de programmation, dont Java, C#, Go, Python, Node.js, TypeScript, PHP et C++. Ces SDK encapsulent la logique de signature, le mécanisme de délai d'attente et le mécanisme de nouvelle tentative, tout en retournant des objets de réponse structurés. Pour plus d'informations, consultez SDK Alibaba Cloud.

    • Utilisez un SDK Alibaba Cloud pour appeler les opérations de Service Catalog. Pour connaître les langages pris en charge et la procédure d'installation des dépendances, consultez SDK Service Catalog.

  • Alibaba Cloud CLI

    • Alibaba Cloud CLI permet d'exécuter des commandes aliyun pour gérer les services et ressources Alibaba Cloud. Pour plus d'informations, consultez Qu'est-ce qu'Alibaba Cloud CLI ?

    • L'appel des opérations API de Service Catalog n'est pas possible via Alibaba Cloud CLI.

  • ROS

    • ROS est un service Alibaba Cloud qui simplifie la gestion des ressources cloud. Créez un modèle décrivant les ressources nécessaires, telles que les instances ECS et ApsaraDB RDS, ainsi que leurs dépendances. ROS crée et configure ensuite automatiquement toutes les ressources en fonction de ce modèle. Pour plus d'informations, consultez Qu'est-ce que ROS ?

    • L'appel des opérations API de Service Catalog n'est pas possible via ROS.

Remarques d'utilisation

Si une erreur est retournée après l'appel d'une opération API, vérifiez la validité des paramètres et valeurs de la requête en vous basant sur le code d'erreur.

Notez également le RequestID issu de la réponse ou du message d'erreur du SDK, puis utilisez la page Diagnostic des problèmes OpenAPI pour un diagnostic en libre-service.

Références

  • Service Catalog est un service d'Infrastructure as Code (IaC) qui aide les entreprises à configurer des services conformes et à définir des contraintes de lancement. Les entreprises peuvent ainsi sélectionner des services adaptés à leurs besoins métier lors de la migration de charges de travail vers le cloud, ce qui améliore l'efficacité de la fourniture de services informatiques. Pour plus d'informations, consultez Qu'est-ce que Service Catalog ?

  • Pour plus d'informations sur les langages de programmation pris en charge par les SDK Service Catalog, consultez Présentation des SDK.