Container Service for Kubernetes:Call an ACK API operation with Java SDK

Étape 1 : Consulter la documentation de l'API

Avant d'effectuer l'appel, consultez la rubrique Créer un cluster managé ACK à l'aide d'une opération OpenAPI pour connaître les paramètres requis et les autorisations nécessaires. Reportez-vous à la section Présentation de l'API pour obtenir des détails sur les paramètres.

Étape 2 : Créer un utilisateur RAM et lui accorder des autorisations

Vous pouvez effectuer cet appel avec un compte Alibaba Cloud, un utilisateur RAM ou un rôle RAM. Consultez la rubrique sur l'identité pour comprendre les différences entre ces entités.

1. Créer un utilisateur RAM.

   1. Connectez-vous à la console RAM avec votre compte Alibaba Cloud.

   2. Dans le volet de navigation de gauche, choisissez Credential Management > User.

   3. Sur la page User, cliquez sur Create User.

   4. Sur la page Create User, définissez les champs Logon Name et Display Name, puis sélectionnez l'option Console Password Logon pour le paramètre Access Method.

   5. Cliquez sur OK.

      Après la création, notez le nom de connexion et le mot de passe, car ils seront nécessaires pour vous connecter au portail OpenAPI Developer Portal.

2. Accordez la stratégie AliyunCSFullAccess à l'utilisateur RAM. Consultez la rubrique Gérer les autorisations d'un utilisateur RAM.

   Remarque

   AliyunCSFullAccess: Accès complet à Container Service for Kubernetes.

   AliyunCSReadOnlyAccess: Accès en lecture seule à Container Service for Kubernetes.

   Pour créer une stratégie personnalisée, consultez la rubrique Informations sur l'autorisation.

3. Sur la page de détails de l'utilisateur RAM, accédez à l'onglet Authentication et cliquez sur Create AccessKey. Consultez la rubrique Créer une AccessKey.

Étape 3 : Appeler l'API

Cet exemple montre comment appeler l'opération CreateCluster en tant qu'utilisateur RAM avec le SDK Java pour créer un cluster ACK Pro. Pour les autres langages, consultez le . Pour découvrir d'autres méthodes d'appel, reportez-vous à la rubrique Méthodes d'appel d'une opération.

Configurer les variables d'environnement

Configurez les variables d'environnement pour les identifiants avant d'effectuer l'appel. Consultez la rubrique Configurer les variables d'environnement sous Linux, macOS et Windows.

Télécharger l'exemple de code du SDK

1. Accédez à la page CreateCluster.

2. Dans la section Parameters, spécifiez les paramètres requis et cliquez sur Initiate Call.

   • Exemple de valeur pour name : test

   • Exemple de valeur pour region_id : cn-beijing

   • Exemple de valeur pour cluster_type : ManagedKubernetes

   • Exemple de valeur pour cluster_spec : ack.pro.small

   • Exemple de valeur pour cluster_version : 1.30.1-aliyun.1

   • Exemple de valeur pour vpcid : vpc-2zedl8cyb7tnkaux1****

   • Exemple de valeur pour container_cidr : 10.0.0.0/8

   • Exemple de valeur pour service_cidr : 172.21.0.0/20

   • Exemple de valeur pour vswitch_ids : vsw-2ze7hfp0ah8rk1nz9****

3. Dans l'onglet SDK Sample, sélectionnez la version 2.0 du SDK et votre langage de programmation, puis cliquez sur Download Project. Décompressez le package téléchargé sur votre machine locale.

   Remarque

   Utilisez le SDK V2.0. Consultez la rubrique Différences entre le SDK V1.0 et le SDK V2.0 pour comparer les versions.

   Après avoir spécifié des paramètres tels que name, region_id, cluster_type, cluster_spec et cluster_version dans l'onglet Parameters, le volet de code génère automatiquement l'exemple de code correspondant au langage sélectionné.

Exécuter l'exemple de code du SDK

1. Ouvrez IntelliJ IDEA. Accédez à File > Open, sélectionnez le dossier du projet et attendez que Maven installe les dépendances.

2. Exécutez l'exemple de code.

   Double-cliquez sur le fichier Sample, vérifiez qu'aucune erreur n'apparaît, puis exécutez-le.

3. Consultez le résultat.

   Dans la console inférieure, repérez le champ statusCode. La valeur "statusCode": 202 indique que l'appel a réussi et que la création du cluster a commencé. Vous pouvez visualiser le nouveau cluster sur la page Clusters de la console ACK.

   {
     "headers": {
       "content-type": "application/json;charset=utf-8",
       "access-control-expose-headers": "*",
       "x-acs-trace-id": "30c74bc83a7fae0a081e5f5846be703e"
     },
     "statusCode": 202,
     "body": {
       "clusterId": "c6104ee21d6304ef8..."
     }
   }