简介

什么是对象存储服务
对象存储服务(Object Storage Service,OBS)是一个基于对象的海量存储服务,为客户提供海量、安全、高可靠、低成本的数据存储能力。
我们一般是用Minio,但华为是用这个的。
桶是OBS中存储对象的容器,每个桶都有自己的存储类别、访问权限、所属区域等属性,用户在互联网上通过桶的访问域名来定位桶。
对象是OBS中数据存储的基本单位,一个对象实际是一个文件的数据与其相关属性信息的集合体,包括Key、Metadata、Data三部分:
- Key:键值,即对象的名称,为经过UTF-8编码的长度大于0且不超过1024的字符序列。一个桶里的每个对象必须拥有唯一的对象键值。
- Metadata:元数据,即对象的描述信息,包括系统元数据和用户元数据,这些元数据以键值对(Key-Value)的形式被上传到OBS中。
- 系统元数据由OBS自动产生,在处理对象数据时使用,包括Date,Content-length,Last-modify,ETag等。
- 用户元数据由用户在上传对象时指定,是用户自定义的对象描述信息。
- Data:数据,即文件的数据内容。
针对OBS提供的REST API进行了二次开发,为您提供了管理控制台、SDK和各类工具,方便您在不同的场景下轻松访问OBS桶以及桶中的对象。您也可以利用OBS提供的SDK和API,根据您业务的实际情况自行开发,以满足不同场景的海量数据存储诉求。

OBS浏览器
Obs Browser Plus
Obs Browser Plus下载地址:
下载OBS Browser+_OBS Browser+_工具指南_对象存储服务 OBS-华为云
登录Obs Browser Plus:

在OBS浏览器创建桶

| 参数 | 说明 |
|---|---|
| 区域 | 选择新建桶所在的Region。
|
| 存储类别 | 桶的存储类别。 不同的存储类别可以满足客户业务对存储性能、成本的不同诉求。
创建桶时选择的存储类别会作为上传对象的默认存储类别,您也可以在上传对象时指定对象的存储类别。 更多详情请参见存储类别。 |
| 桶ACL | 桶的读写权限控制。
|
| 多AZ | 开启多AZ后,桶中的数据在同区域的多个可用区(AZ)中存储。 桶创建成功后,不支持修改数据冗余存储策略。 |
| 桶名称 | 输入需要创建的桶的名称,“桶名称”需全局唯一。 具体命名规则如下:
桶创建成功后,不支持修改桶名称。 每个用户最多可在OBS 对象存储中创建100个桶。 说明:
|
搜索

查看桶的基本信息

删除桶

Obsutils
obsutil是一款用于访问管理华为云对象存储服务(Object Storage Service,OBS)的命令行工具,您可以使用该工具对OBS进行常用的配置管理操作,如创建桶、上传文件/文件夹、下载文件/文件夹、删除文件/文件夹等。对于熟悉命令行程序的用户,obsutil能在执行批量处理、自动化任务场景能为您带来更优体验。
obsutil适用于Windows、Linux和macOS三大主流的操作系统。
下载
针对不同操作系统,obsutil的下载地址如表1所示。
| 操作系统 | 软件包下载地址 | SHA256校验和 |
|---|---|---|
| Windows 64位 | 5d2ac96e400fdc71c75859e845aa4e8de983c8cec5e34bd0664d469c8dc2df9d | |
| Linux AMD 64位 (Linux x86 64位) | 7f7febcd65351830cc5ac31b5707d9709e893d9d0ac66d8b7531c29b2e0a42c3 | |
| Linux ARM 64位 | 1e3584a3db9aa08126f3fb0ba573f8c93a7b10e3abff1915ea906885d377f509 | |
| macOS 64位 | 231dcc350ee0ef901bafd385d639a25d053ccaac2025d7717b02ade86654c28d |
使用方法
以Windows环境为例,双击exe文件打开:


在命令行输入密钥和endpoint
创建一个桶:
obsutil mb obs://tntxia-bucket-test2 -location=cn-north-4

上传一个文件
obsutil cp /aa.jpg obs://tntxia-bucket-test2/aa.jpg

下载文件:
obsutil cp obs://tntxia-bucket-test2/aa.jpg bb.jpg
这个命令和上传是一样的,只是源文件和目标文件交换了。

分享文件
obsutil sign obs://tntxia-bucket-test2/aa.jpg

OBS SDK
如果你是程序员,那么你大概率还是使用主流语言来处理OBS。那么你一定需要使用OBS SDK
OBS提供了以下主流语言SDK供开发者使用:
| 语言 | Github地址 | SDK开发指南 | API参考 |
|---|---|---|---|
| Java | - | ||
| Python | - | ||
| C | - | ||
| Go | - | ||
| BrowserJS | |||
| .NET | |||
| Android | |||
| iOS | NA | ||
| PHP | |||
| Node.js | - | ||
| Harmony | NA | - |
这里以JDK为例
首先加入Maven依赖:
<dependency>
<groupId>com.huaweicloud</groupId>
<artifactId>esdk-obs-java-bundle</artifactId>
<version>3.23.9</version>
</dependency>
创建桶
package com.tntxia.javatest.obssdk;
/**
* @author chenshixian
**/
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.AccessControlList;
import com.obs.services.model.AvailableZoneEnum;
import com.obs.services.model.CreateBucketRequest;
import com.obs.services.model.ObsBucket;
import com.obs.services.model.StorageClassEnum;
public class CreateBucket001 {
public static void main(String[] args) {
// 您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入。如果使用硬编码可能会存在泄露风险。
// 您可以登录访问管理控制台获取访问密钥AK/SK
String ak = System.getenv("ACCESS_KEY_ID");
String sk = System.getenv("SECRET_ACCESS_KEY_ID");
// 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。
// 您可以通过环境变量获取访问密钥AK/SK/SecurityToken,也可以使用其他外部引入方式传入。
// String securityToken = System.getenv("SECURITY_TOKEN");
// endpoint填写桶所在的endpoint, 此处以华北-北京四为例,其他地区请按实际情况填写。
String endPoint = "https://obs.cn-north-4.myhuaweicloud.com";
// 您可以通过环境变量获取endPoint,也可以使用其他外部引入方式传入。
//String endPoint = System.getenv("ENDPOINT");
// 创建ObsClient实例
// 使用永久AK/SK初始化客户端
ObsClient obsClient = new ObsClient(ak, sk,endPoint);
// 使用临时AK/SK和SecurityToken初始化客户端
// ObsClient obsClient = new ObsClient(ak, sk, securityToken, endPoint);
try {
CreateBucketRequest request = new CreateBucketRequest();
//示例桶名
String exampleBucket = "examplebucket";
//示例桶区域位置
String exampleLocation = "cn-north-4";
request.setBucketName(exampleBucket);
// 设置桶ACL为私有读写,默认也是私有读写
request.setAcl(AccessControlList.REST_CANNED_PRIVATE);
// 设置桶的存储类别为标准存储
request.setBucketStorageClass(StorageClassEnum.STANDARD);
// 设置桶区域位置(以区域为华北-北京四为例),location 需要与 endpoint的位置信息一致
request.setLocation(exampleLocation);
// 指定创建多AZ桶,如果不设置,默认创建单AZ桶
request.setAvailableZone(AvailableZoneEnum.MULTI_AZ);
// 创建桶
ObsBucket bucket = obsClient.createBucket(request);
// 创建桶成功
System.out.println("CreateBucket successfully");
System.out.println("RequestId:"+bucket.getRequestId());
} catch (ObsException e) {
System.out.println("CreateBucket failed");
// 请求失败,打印http状态码
System.out.println("HTTP Code: " + e.getResponseCode());
// 请求失败,打印服务端错误码
System.out.println("Error Code:" + e.getErrorCode());
// 请求失败,打印详细错误信息
System.out.println("Error Message: " + e.getErrorMessage());
// 请求失败,打印请求id
System.out.println("Request ID:" + e.getErrorRequestId());
System.out.println("Host ID:" + e.getErrorHostId());
} catch (Exception e) {
System.out.println("CreateBucket failed");
// 其他异常信息打印
e.printStackTrace();
}
}
}

上传文件
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.PutObjectRequest;
import java.io.File;
public class PutObject004 {
public static void main(String[] args) {
// 您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入。如果使用硬编码可能会存在泄露风险。
// 您可以登录访问管理控制台获取访问密钥AK/SK
String ak = System.getenv("ACCESS_KEY_ID");
String sk = System.getenv("SECRET_ACCESS_KEY_ID");
// 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。
// 您可以通过环境变量获取访问密钥AK/SK/SecurityToken,也可以使用其他外部引入方式传入。
// String securityToken = System.getenv("SECURITY_TOKEN");
// endpoint填写桶所在的endpoint, 此处以华北-北京四为例,其他地区请按实际情况填写。
String endPoint = "https://obs.cn-north-4.myhuaweicloud.com";
// 您可以通过环境变量获取endPoint,也可以使用其他外部引入方式传入。
//String endPoint = System.getenv("ENDPOINT");
// 创建ObsClient实例
// 使用永久AK/SK初始化客户端
ObsClient obsClient = new ObsClient(ak, sk,endPoint);
// 使用临时AK/SK和SecurityToken初始化客户端
// ObsClient obsClient = new ObsClient(ak, sk, securityToken, endPoint);
try {
// 文件上传
// localfile 为待上传的本地文件路径,需要指定到具体的文件名
PutObjectRequest request = new PutObjectRequest();
request.setBucketName("examplebucket");
request.setObjectKey("objectkey");
request.setFile(new File("localfile"));
obsClient.putObject(request);
System.out.println("putObject successfully");
} catch (ObsException e) {
System.out.println("putObject failed");
// 请求失败,打印http状态码
System.out.println("HTTP Code:" + e.getResponseCode());
// 请求失败,打印服务端错误码
System.out.println("Error Code:" + e.getErrorCode());
// 请求失败,打印详细错误信息
System.out.println("Error Message:" + e.getErrorMessage());
// 请求失败,打印请求id
System.out.println("Request ID:" + e.getErrorRequestId());
System.out.println("Host ID:" + e.getErrorHostId());
e.printStackTrace();
} catch (Exception e) {
System.out.println("putObject failed");
// 其他异常信息打印
e.printStackTrace();
}
}
}

下载文件
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.ObsObject;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
public class GetObject001 {
public static void main(String[] args) {
// 您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入。如果使用硬编码可能会存在泄露风险。
// 您可以登录访问管理控制台获取访问密钥AK/SK
String ak = System.getenv("ACCESS_KEY_ID");
String sk = System.getenv("SECRET_ACCESS_KEY_ID");
// 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。
// 您可以通过环境变量获取访问密钥AK/SK/SecurityToken,也可以使用其他外部引入方式传入。
// String securityToken = System.getenv("SECURITY_TOKEN");
// endpoint填写桶所在的endpoint, 此处以华北-北京四为例,其他地区请按实际情况填写。查看桶所在的endpoint请参见:https://support.huaweicloud.com/usermanual-obs/obs_03_0312.html。
String endPoint = "https://obs.cn-north-4.myhuaweicloud.com";
// 您可以通过环境变量获取endPoint,也可以使用其他外部引入方式传入。
//String endPoint = System.getenv("ENDPOINT");
// 创建ObsClient实例
// 使用永久AK/SK初始化客户端
ObsClient obsClient = new ObsClient(ak, sk,endPoint);
// 使用临时AK/SK和SecurityToken初始化客户端
// ObsClient obsClient = new ObsClient(ak, sk, securityToken, endPoint);
try {
// 流式下载
ObsObject obsObject = obsClient.getObject("examplebucket", "objectname");
// 读取对象内容
System.out.println("Object content:");
InputStream input = obsObject.getObjectContent();
byte[] b = new byte[1024];
ByteArrayOutputStream bos = new ByteArrayOutputStream();
int len;
while ((len = input.read(b)) != -1) {
bos.write(b, 0, len);
}
System.out.println("getObjectContent successfully");
System.out.println(new String(bos.toByteArray()));
bos.close();
input.close();
} catch (ObsException e) {
System.out.println("getObjectContent failed");
// 请求失败,打印http状态码
System.out.println("HTTP Code:" + e.getResponseCode());
// 请求失败,打印服务端错误码
System.out.println("Error Code:" + e.getErrorCode());
// 请求失败,打印详细错误信息
System.out.println("Error Message:" + e.getErrorMessage());
// 请求失败,打印请求id
System.out.println("Request ID:" + e.getErrorRequestId());
System.out.println("Host ID:" + e.getErrorHostId());
e.printStackTrace();
} catch (Exception e) {
System.out.println("getObjectContent failed");
// 其他异常信息打印
e.printStackTrace();
}
}
}
列出对象
import com.obs.services.ObsClient;
import com.obs.services.exception.ObsException;
import com.obs.services.model.ObjectListing;
import com.obs.services.model.ObsObject;
public class ListObjects001 {
public static void main(String[] args) {
// 您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入。如果使用硬编码可能会存在泄露风险。
// 您可以登录访问管理控制台获取访问密钥AK/SK
String ak = System.getenv("ACCESS_KEY_ID");
String sk = System.getenv("SECRET_ACCESS_KEY_ID");
// 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。
// 您可以通过环境变量获取访问密钥AK/SK/SecurityToken,也可以使用其他外部引入方式传入。
// String securityToken = System.getenv("SECURITY_TOKEN");
// endpoint填写桶所在的endpoint, 此处以华北-北京四为例,其他地区请按实际情况填写。
String endPoint = "https://obs.cn-north-4.myhuaweicloud.com";
// 您可以通过环境变量获取endPoint,也可以使用其他外部引入方式传入。
//String endPoint = System.getenv("ENDPOINT");
// 创建ObsClient实例
// 使用永久AK/SK初始化客户端
ObsClient obsClient = new ObsClient(ak, sk,endPoint);
// 使用临时AK/SK和SecurityToken初始化客户端
// ObsClient obsClient = new ObsClient(ak, sk, securityToken, endPoint);
try {
// 简单列举
ObjectListing result = obsClient.listObjects("examplebucket");
for (ObsObject obsObject : result.getObjects()) {
System.out.println("listObjects successfully");
System.out.println("ObjectKey:" + obsObject.getObjectKey());
System.out.println("Owner:" + obsObject.getOwner());
}
} catch (ObsException e) {
System.out.println("listObjects failed");
// 请求失败,打印http状态码
System.out.println("HTTP Code:" + e.getResponseCode());
// 请求失败,打印服务端错误码
System.out.println("Error Code:" + e.getErrorCode());
// 请求失败,打印详细错误信息
System.out.println("Error Message:" + e.getErrorMessage());
// 请求失败,打印请求id
System.out.println("Request ID:" + e.getErrorRequestId());
System.out.println("Host ID:" + e.getErrorHostId());
e.printStackTrace();
} catch (Exception e) {
System.out.println("listObjects failed");
// 其他异常信息打印
e.printStackTrace();
}
}
}
删除文件
public void deleteObject(String objectKey) {
try {
// 删除单个对象
obsClient.deleteObject(bucketName, objectKey);
System.out.println("deleteObject successfully");
} catch (ObsException e) {
System.out.println("deleteObject failed");
// 请求失败,打印http状态码
System.out.println("HTTP Code:" + e.getResponseCode());
// 请求失败,打印服务端错误码
System.out.println("Error Code:" + e.getErrorCode());
// 请求失败,打印详细错误信息
System.out.println("Error Message:" + e.getErrorMessage());
// 请求失败,打印请求id
System.out.println("Request ID:" + e.getErrorRequestId());
System.out.println("Host ID:" + e.getErrorHostId());
e.printStackTrace();
} catch (Exception e) {
System.out.println("deleteObject failed");
// 其他异常信息打印
throw new RuntimeException(e);
}
}
758

被折叠的 条评论
为什么被折叠?



