文档

OpenAPI集成示例(SDK)

更新时间:

本文为您介绍如何通过SDK调用OpenAPI为指定容器镜像仓库创建命名空间。

查看OpenAPI文档

阅读API概览,选择为指定容器镜像仓库创建命名空间的OpenAPI:CreateNamespace - 创建镜像仓库命名空间。根据接口文档,了解调用该接口需要的参数及权限。

创建RAM用户并授权

身份

您可以使用阿里云账号(主账号)、RAM用户、RAM角色调用该接口,有关各种身份的差异请参见身份、凭据、授权。本案例中,我们使用RAM用户进行接口调用。登录RAM访问控制,创建一个仅允许API调用的RAM用户,记录AK信息,更多详情请参见创建RAM用户

授权

  1. 访问RAM用户列表,单击目标RAM用户操作列的添加权限

  2. 选择权限区块中输入关键字ContainerRegistry进行搜索,选择需要授权的策略。

  3. 单击确定,完成授权操作。

凭据

在创建RAM用户时会默认生成一个AccessKey,可直接使用。您也可进入到对应的RAM用户详情页,在认证管理页签,单击创建 AccessKey。具体操作,请参见创建AccessKey

调用OpenAPI

本文使用Java语言SDK

配置环境变量

通过在环境变量中设置AccessKey信息避免在代码中直接硬编码AccessKey给业务带来安全风险。

配置环境变量的方法,请参见在Linux、macOS和Windows系统配置环境变量

下载示例代码

  1. 访问CreateNamespace

  2. 在左侧的参数配置页签,填写参数信息。

    • InstanceId实例ID,填写镜像仓库实例ID。

    • NamespaceName命名空间名称,填写创建命名空间名称。

  3. 在右侧的SDK示例页签,SDK版本选择v2.0,语言选择Java语言,单击下载完整工程按钮,下载示例代码包。

  4. 本地解压并进入alibabacloud_sample目录。

打开并运行项目

使用IntelliJ IDEA加载项目,待相关依赖加载完毕后,打开 src/main/java/com/aliyun/sample/Sample.java。根据代码中的注释提示自行添加打印返回值的代码。

单击IDE右上角的运行按钮。执行完成后,在指定的镜像仓库中,查看创建的命名空间。

image