本文主要描述镜像仓库 Java 语言 SDK 的安装和配置，及使用 Java SDK 调用云端 API 的示例。 ## 使用说明 * 仅支持 Java JDK 1.7 及以上版本。您可以从 [Java 官网](https://www.oracle.com/java/technologies/downloads/) 下载最新的版本。 * 如果使用 Java 9 及以上版本，需要依赖`javax.annotation-api`。由于在 Java 9 及以上的版本中， `javax.annotation-api`被移除，因此需要在项目文件中加入以下依赖。 ```xml javax.annotation javax.annotation-api 1.3.2 ``` ## 安装配置推荐通过 Maven 管理和使用 JAVA SDK。 1. 在本地使用 Maven 构建您的项目。 2. 添加 Maven 项目依赖。需要使用字节跳动的 Maven 仓库来完成依赖，请先编辑 Maven 安装目录的`conf/setting.xml`文件，增加镜像配置。 ```xml bytedanceMaven my-repo-id 字节跳动maven仓库 https://artifact.bytedance.com/repository/releases/ ``` 3. 导入并配置 pom.xml 文件。 ```xml com.volcengine volcengine-java-sdk-bom 0.1.6 pom import ``` 4. 使用 SDK Maven 模块。 ```xml com.volcengine volcengine-java-sdk-cr 1.0.75 ``` ## 证书配置镜像仓库支持如下两种证书配置方法： * 通过环境变量导入 ```shell export VOLCENGINE_ACCESS_KEY=your_ak // Access Key ID export VOLCENGINE_SECRET_KEY=your_sk // Secret Access Key ``` * 通过代码方式引入: ```shell Credentials credentials = Credentials.getCredentials(ak,sk); ``` ## SDK 示例本文以查询实例接口 [ListRegistries](https://www.volcengine.com/docs/6420/113746)为例。 ```java package com.volcengine.cr; import com.volcengine.ApiClient; import com.volcengine.ApiException; import com.volcengine.cr.model.FilterForListRegistriesInput; import com.volcengine.cr.model.ListRegistriesRequest; import com.volcengine.cr.model.ListRegistriesResponse; import com.volcengine.cr.model.StatusForListRegistriesInput; import com.volcengine.sign.Credentials; public class test { public static void main(String[] args) { String ak = "AKLT****"; // Access Key ID String sk = "WTJG****";// Secret Access Key String region = "cn-beijing";// Region ApiClient apiClient = new ApiClient() .setCredentials(Credentials.getCredentials(ak, sk)) .setRegion(region); CrApi crApi = new CrApi(apiClient); StatusForListRegistriesInput statusListRregistries = new StatusForListRegistriesInput(); statusListRregistries.setCondition("Ok"); statusListRregistries.setPhase("Running"); ListRegistriesRequest listRegistries = new ListRegistriesRequest(); listRegistries.setPageNumber((long) 1); listRegistries.setPageSize((long) 10); // For example:names_null_types_all_status_exist FilterForListRegistriesInput filterListRregistries = new FilterForListRegistriesInput(); filterListRregistries.addTypesItem("Basic"); filterListRregistries.addTypesItem("Enterprise"); filterListRregistries.addStatusesItem(statusListRregistries); listRegistries.setFilter(filterListRregistries); try { ListRegistriesResponse respListRegistries = crApi.listRegistries(listRegistries); System.out.println(listRegistries); System.out.println(respListRegistries); } catch (ApiException e) { System.out.println(e.getResponseBody()); } } } ```