Cette rubrique explique comment appeler l'opération DescribeEnsRegions via une API OpenAPI pour interroger la liste des zones de périphérie ENS disponibles.
Étape 1 : Consulter la documentation de l'API OpenAPI
Avant d'appeler une API OpenAPI, consultez la documentation correspondante, DescribeEnsRegions, afin de connaître les paramètres requis et les permissions nécessaires. Pour plus d'informations, voir Vue d'ensemble des API.
-
Sur la page Stacks, cliquez sur Create Stack. Dans la section Specify Template, cliquez sur Select an Existing Template.
RemarqueSi vous sélectionnez Create Template ou ROS Infrastructure Composer, vous êtes redirigé vers la page correspondante.
-
Définissez le paramètre Template Import Method sur Enter Template Content et le paramètre Template Content sur ROS. Saisissez ensuite le code.
Étape 2 : Créer un utilisateur RAM et accorder des permissions
Un compte Alibaba Cloud dispose des permissions d'accès pour toutes les opérations API. Pour l'accès aux API ou les opérations de maintenance courantes, créez et utilisez un utilisateur RAM.
Vous pouvez appeler cette opération à l'aide d'un compte Alibaba Cloud, d'un utilisateur Resource Access Management (RAM) ou d'un rôle RAM. Pour plus d'informations sur les différences entre ces identités, voir Identités.
Dans cette rubrique, un utilisateur RAM est utilisé pour appeler l'opération API.
-
Connectez-vous à la console RAM.
Dans le volet de navigation de gauche, choisissez .
Sur la page Users, cliquez sur Create User.
Sur la page Create User, définissez les champs Logon Name et Display Name. Définissez le paramètre Access Mode sur Console Access.
-
Cliquez sur OK.
Après avoir créé l'utilisateur RAM, notez son nom de connexion et son mot de passe. Vous en aurez besoin pour vous connecter au portail des développeurs OpenAPI Alibaba Cloud afin d'appeler les opérations OpenAPI.
-
Accordez des permissions à l'utilisateur RAM.
RemarqueAliyunENSFullAccess : Accorde les permissions de gestion des ressources Edge Node Service (ENS).
AliyunENSReadOnlyAccess : Accorde les permissions en lecture seule sur les ressources ENS.
Pour créer une stratégie personnalisée, voir Informations d'autorisation.
Accédez à la page utilisateurs.
Recherchez l'utilisateur RAM cible et cliquez sur Add Permissions dans la colonne Actions.
Dans la zone de texte, saisissez le mot-clé ENS pour rechercher la stratégie que vous souhaitez attacher. Sélectionnez la stratégie AliyunENSFullAccess.
Cliquez sur Grant permissions pour finaliser l'autorisation.
-
Accédez à la page de détails de l'utilisateur RAM. Sous l'onglet Authentication, cliquez sur Create AccessKey.
Pour plus d'informations, voir Créer une clé AccessKey.
Étape 3 : Appeler l'API OpenAPI
Cette rubrique utilise le SDK Java pour appeler l'API OpenAPI. Les SDK pour d'autres langages s'utilisent de manière similaire. Pour plus d'informations, consultez le SDK Edge Node Service. Vous pouvez également choisir d'autres méthodes pour appeler l'opération. Pour plus d'informations sur les méthodes d'appel, voir Méthodes d'appel.
Configurer les variables d'environnement
Les variables d'environnement sont des paramètres système spécifiques à un système d'exploitation. Elles contiennent des noms et des valeurs qui fournissent les paramètres d'exécution aux applications. Pour savoir comment configurer les paires AccessKey Alibaba Cloud en tant que variables d'environnement sur différents systèmes d'exploitation, voir Configurer les variables d'environnement sous Linux, macOS et Windows.
Télécharger l'exemple de code
Accédez à DescribeEnsRegions.
Sous l'onglet Parameters situé à gauche, saisissez les paramètres requis.
Sous l'onglet SDK Sample Code situé à droite, définissez SDK Version sur v2.0 et Language sur Java. Cliquez sur Download Project pour télécharger le package d'exemple de code.
Décompressez le package sur votre ordinateur et accédez au dossier alibabacloud_sample.
Ouvrir le projet
Utilisez IntelliJ IDEA pour charger le projet. Une fois les dépendances chargées, ouvrez le fichier src/main/java/com/aliyun/sample/Sample.java. Ajoutez du code pour afficher la valeur de retour en suivant les commentaires présents dans le fichier.
Exécuter le projet
Cliquez sur Run dans le coin supérieur droit de l'IDE pour afficher les journaux de sortie. L'exemple suivant renvoie le contenu ci-dessous :
{
"headers": {
"access-control-allow-origin": "*",
"date": "Tue, 18 Jul 2023 15:26:50 GMT",
"content-length": "92",
"keep-alive": "timeout=25",
"x-acs-request-id": "1589E192-A47E-5224-95E2-A18F2D1ED186",
"connection": "keep-alive",
"content-type": "application/json;charset=utf-8",
"etag": "9fcxMGIK+zckvQOS1NfD6GA2",
"access-control-expose-headers": "*",
"x-acs-trace-id": "bdfecedff57c1e8fc1b7970e909bca31"
},
"statusCode": 200,
"body": {
"code": 0,
"ensRegions": {
"ensRegions": [
{
"Area": "SouthWestChina",
"EnName": "",
"EnsRegionId": "cn-chongqing-unicom",
"Province": "Chongqing",
"Name": "China Unicom (Chongqing)"
}
]
},
"requestId": "1589E192-A47E-5224-95E2-A18F2D1ED186"
}
}