文档

Java SDK调用示例

更新时间:

本文介绍如何通过SDK调用OpenAPI创建一个ACK托管集群

步骤一:查看OpenAPI文档

在调用OpenAPI前,建议您先阅读对应的接口文档通过OpenAPI创建Kubernetes托管版集群,了解、学习调用该接口所需要的参数及权限等,更多参数请参见API概览

步骤二:创建RAM用户并完成授权

您可以使用阿里云账号(主账号)、RAM用户、RAM角色调用该接口,有关各种身份的差异请参见身份

重要

阿里云账号拥有所有API的访问权限,建议您创建并使用RAM用户进行API访问或日常运维。

  1. 创建RAM用户

    1. 使用阿里云账号登录RAM访问控制

    2. 在左侧导航栏,选择身份管理 > 用户

    3. 用户页面,单击创建用户

    4. 创建用户页面,设置登录名称显示名称访问方式控制台访问

    5. 单击确定

      创建RAM用户成功后,请记录用户登录名称和密码。在调用OpenAPI时,需要使用该RAM用户登录阿里云OpenAPI开发者门户。

  2. 为RAM用户授予AliyunCSFullAccess权限。具体操作,请参见为RAM用户授权

    说明

    AliyunCSFullAccess管理容器服务 Kubernetes 版的权限。

    AliyunCSReadOnlyAccess:只读访问容器服务 Kubernetes 版的权限。

    如果您需要新建自定义权限,请参见授权信息

  3. 进入对应的RAM用户详情页,在认证管理页签,单击创建 AccessKey。具体操作,请参见创建AccessKey

步骤三:调用OpenAPI

本示例使用RAM用户调用CreateCluster创建一个ACK集群Pro版,通过Java语言SDK为例介绍,其他语言SDK的用法类似,更多信息请参见容器服务Kubernetes版SDK。您也可根据业务的实际需要选择其他调用方式,更多调用方法请参见调用方式

配置环境变量

调用接口前,您需要配置环境变量以获取访问凭证。环境变量配置操作,请参见在Linux、macOS和Windows系统配置环境变量

下载SDK示例代码

  1. 访问CreateCluster

  2. 在左侧参数配置区域,填写需要的参数信息,然后单击发起调用

    • name示例值:test

    • region_id示例值:cn-beijing

    • cluster_type示例值:ManagedKubernetes

    • cluster_spec示例值:ack.pro.small

    • cluster_version示例值:1.30.1-aliyun.1

    • vpcid示例值:vpc-2zedl8cyb7tnkaux1****

    • container_cidr示例值:10.0.0.0/8

    • service_cidr示例值:172.21.0.0/20

    • vswitch_ids示例值:vsw-2ze7hfp0ah8rk1nz9****

  3. 在右侧SDK示例页签,选择SDK版本为2.0和SDK语言,然后单击下载完整工程,下载后在本地完成解压。

    说明

    SDK版本推荐使用V2.0版本。关于V2.0和V1.0的区别,请参见V1.0 SDK和V2.0 SDK区别

    image

运行SDK示例代码

  1. 打开IntelliJ IDEA,单击File->Open,选择解压后的工程文件夹,等待Maven自动安装依赖信息。

  2. 运行示例代码。

    双击打开Sample,确认无报错后,运行代码。

  3. 查看运行结果。

    在底部控制台搜索statusCode,如果看到"statusCode":202表示调用成功已开始创建集群。您可以在容器服务管理控制台集群列表页面看到新创建的集群。image