容器安全服务查询容器管理节点列表场景示例（Java版本，仅新版本容器安全支持，即将上线，敬请期待！）

0. 版本说明

本示例配套的SDK版本为：3.0.72

1. 简介

华为云提供了容器安全服务端SDK，您可以直接集成服务端SDK来调用容器安全服务的相关API，从而实现对容器安全服务的快速操作。该示例展示了如何通过java版SDK进行查询容器节点列表。

2. 开发前准备

已注册华为云，并完成实名认证。
已具备开发环境，支持Java JDK 1.8及其以上版本。
已获取华为云账号对应的Access Key（AK）和Secret Access Key（SK）。请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见访问密钥。
已获取容器安全服务对应区域的项目ID，请在华为云控制台“我的凭证 > API凭证”页面上查看项目ID。具体请参见 API凭证。

3. 安装SDK

您可以通过Maven方式获取和安装SDK，首先需要在您的操作系统中下载并安装Maven ，安装完成后您只需要在Java项目的pom.xml文件中加入相应的依赖项即可。

使用服务端SDK前，您需要安装“huaweicloud-sdk-core”和“huaweicloud-sdk-cgs”，具体的SDK版本号请参见 SDK开发中心。


                    
                    Copied!
                
<dependency>
    <groupId>com.huaweicloud.sdk</groupId>
    <artifactId>huaweicloud-sdk-core</artifactId>
    <version>3.0.72</version>
</dependency>
<dependency>
    <groupId>com.huaweicloud.sdk</groupId>
    <artifactId>huaweicloud-sdk-cgs</artifactId>
    <version>3.0.72</version>
</dependency>

4. 开始使用

4.1 导入依赖模块


                    
                    Copied!
                
// 用户身份认证
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.auth.ICredential;
// 请求异常类
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
// 导入cgs的客户端
import com.huaweicloud.sdk.cgs.v5.CgsClient;
// 导入待请求接口的request和response类 (以获取实时在线人数接口为例)
import com.huaweicloud.sdk.cgs.v5.model.ListContainerNodesRequest;
import com.huaweicloud.sdk.cgs.v5.model.ListContainerNodesResponse;


// 导入服务区域枚举
import com.huaweicloud.sdk.cgs.v5.region.CgsRegion;
// 日志打印
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
// 异常打印
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;

4.2 示例代码


                    
                    Copied!
                
import com.huaweicloud.sdk.cgs.v5.CgsClient;
import com.huaweicloud.sdk.cgs.v5.model.ListContainerNodesRequest;
import com.huaweicloud.sdk.cgs.v5.model.ListContainerNodesResponse;
import com.huaweicloud.sdk.cgs.v5.region.CgsRegion;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class ListContainerNodesDemo {
    private static final Logger LOGGER = LoggerFactory.getLogger(ListContainerNodesDemo.class.getName());

    public static void main(String[] args) {
        // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
        // 本示例以ak和sk保存在环境变量中来实现身份认证为例，运行示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
        String ak = System.getenv("HUAWEICLOUD_SDK_AK");
        String sk = System.getenv("HUAWEICLOUD_SDK_SK");
        ICredential auth = new BasicCredentials().withAk(ak).withSk(sk);

        // 初始化企业主机安全服务的客户端
        CgsClient client = CgsClient.newBuilder().withCredential(auth).withRegion(CgsRegion.CN_SOUTH_4).build();
        try {
            // 配置请求参数
            ListContainerNodesRequest request = new ListContainerNodesRequest();
            // 事件类型
            request.setLimit(10);
            // 发送请求
            ListContainerNodesResponse response = client.listContainerNodes(request);
            LOGGER.info(response.toString());
        } catch (ConnectionException e) {
            LOGGER.error(e.toString());
        } catch (RequestTimeoutException e) {
            LOGGER.error(e.toString());
        } catch (ServiceResponseException e) {
            LOGGER.error(String.valueOf(e.getHttpStatusCode()));
            LOGGER.error(e.getErrorCode());
            LOGGER.error(e.getErrorMsg());
        }
    }
}

4.3 接口及参数说明

请见查询容器节点列表

5. FAQ

暂无

6. 参考

更多信息请参考容器安全服务

修订记录

发布日期	文档版本	修订说明
2021-12-30	1.0	文档首次发布