本文介绍如何通过SDK调用OpenAPI创建一个ACK托管集群。
步骤一:查看OpenAPI文档
在调用OpenAPI前,建议您先阅读对应的接口文档通过OpenAPI创建ACK托管集群,了解、学习调用该接口所需要的参数及权限等,更多参数请参见API概览。
步骤二:创建RAM用户并完成授权
您可以使用阿里云账号(主账号)、RAM用户、RAM角色调用该接口,有关各种身份的差异请参见身份。
阿里云账号拥有所有API的访问权限,建议您创建并使用RAM用户进行API访问或日常运维。
使用阿里云账号登录RAM访问控制。
在左侧导航栏,选择
。在用户页面,单击创建用户。
在创建用户页面,设置登录名称和显示名称、访问方式为控制台访问。
单击确定。
创建RAM用户成功后,请记录用户登录名称和密码。在调用OpenAPI时,需要使用该RAM用户登录阿里云OpenAPI开发者门户。
为RAM用户授予AliyunCSFullAccess权限。具体操作,请参见为RAM用户授权。
说明AliyunCSFullAccess:管理容器服务 Kubernetes 版的权限。
AliyunCSReadOnlyAccess:只读访问容器服务 Kubernetes 版的权限。
如果您需要新建自定义权限,请参见授权信息。
进入对应的RAM用户详情页,在认证管理页签,单击创建 AccessKey。具体操作,请参见创建AccessKey。
步骤三:调用OpenAPI
本示例使用RAM用户调用CreateCluster创建一个ACK集群Pro版,通过Java语言SDK为例介绍,其他语言SDK的用法类似,更多信息请参见容器服务Kubernetes版SDK。您也可根据业务的实际需要选择其他调用方式,更多调用方法请参见调用方式。
配置环境变量
调用接口前,您需要配置环境变量以获取访问凭证。环境变量配置操作,请参见在Linux、macOS和Windows系统配置环境变量。
下载SDK示例代码
在左侧参数配置区域,填写需要的参数信息,然后单击发起调用。
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****
在右侧SDK示例页签,选择SDK版本为2.0和SDK语言,然后单击下载完整工程,下载后在本地完成解压。
说明SDK版本推荐使用V2.0版本。关于V2.0和V1.0的区别,请参见V1.0 SDK和V2.0 SDK区别。
运行SDK示例代码
打开IntelliJ IDEA,单击File->Open,选择解压后的工程文件夹,等待Maven自动安装依赖信息。
运行示例代码。
双击打开Sample,确认无报错后,运行代码。
查看运行结果。
在底部控制台搜索
statusCode
,如果看到"statusCode":202
表示调用成功已开始创建集群。您可以在容器服务管理控制台的集群列表页面看到新创建的集群。