You need to enable JavaScript to run this app.
导航

初始化客户端

最近更新时间2023.12.18 14:39:24

首次发布时间2023.12.18 14:39:24

文件存储 vePFS Java 客户端提供了一系列接口与文件存储 vePFS 服务进行交互,用来管理资源。您需要先初始化 Java 客户端,才可以向文件存储 vePFS 服务发送 HTTP/HTTPS 请求。本文介绍如何初始化 Java 客户端。

  • 前提条件

  • 已下载并安装文件存储 vePFS Java SDK。具体操作步骤,请参见下载安装 SDK

  • 初始化客户端时,需要携带如下信息:

    • 账号的 Access Key ID(简称 AK)和Secret Access Key(简称 SK)信息。获取 AKSK 信息的方法,请参见查看 AKSK 信息

    • Region 信息。文件存储 vePFS 支持的 Region,请参见服务地址

配置环境变量

将 AccessKey 硬编码到业务代码中会带来一定的安全风险,因此我们推荐您通过配置环境变量的方法管理 AccessKey。

  • Linux / macOS 操作系统
    配置环境变量的方法如下所示:

    export VOLCENGINE_ACCESS_KEY_ID=<Your AccessKey ID>
    export VOLCENGINE_ACCESS_KEY_SECRET=<Your AccessKey Secret>
    
  • Windows 操作系统
    配置环境变量的方法如下所示:

    1. 新建环境变量文件,添加环境变量VOLCENGINE_ACCESS_KEY_IDVOLCENGINE_ACCESS_KEY_SECRET,并写入您的 AccessKey ID 和 AccessKey Secret。
    2. 重启 Windows 系统。
  • 初始化客户端

使用如下代码初始化客户端。

package com.volcengine.vepfs.examples;

import com.volcengine.ApiClient;
import com.volcengine.ApiException;
import com.volcengine.sign.Credentials;

import com.volcengine.vepfs.VepfsApi;
import com.volcengine.vepfs.model.*;

public class Main {
    public static VepfsApi api;
    
    public static void initClient() {
        // 设置您的ak
        String ak = System.getenv("VOLCENGINE_ACCESS_KEY_ID");
        // 设置您的sk
        String sk = System.getenv("VOLCENGINE_ACCESS_KEY_SECRET");
        // 设置您要访问的地域
        String region = "Your Region";

        // 创建一个 vepfs SDK 客户端,后续可以利用此客户端调用 API 执行任务请求
        ApiClient apiClient = new ApiClient()
                .setCredentials(Credentials.getCredentials(ak, sk))
                .setRegion(region);
        api = new VepfsApi(apiClient);
    }
}