承载协议	HTTPS GET
接口方向	开发者服务器->华为服务器
接口URL	https://{domain}/{bucket_name}/{object_name}?metadata=query 注意 {bucket_name}为当前存储实例名称，{object_name}为文件名称。 {domain}为接口域名。中国站点的域名：ops-server-drcn.agcstorage.link/v0 德国站点的域名：ops-server-dre.agcstorage.link/v0 新加坡站点的域名：ops-server-dra.agcstorage.link/v0 俄罗斯站点的域名：ops-server-drru.agcstorage.link/v0 调用获取Token接口时使用的站点必须与本接口使用的站点保持一致。例如本接口使用的站点是德国，即接口域名为“ops-server-dre.agcstorage.link/v0”，则调用获取Token接口也必须使用德国站点，其接口域名需为“connect-api-dre.cloud.huawei.com”。
数据格式	请求：Content-Type: application/json 响应：Content-Type: application/json

请求参数

Header

展开

参数	类型	必选(M)/可选(O)	说明
Authorization	String	M	认证信息，格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
client_id	String	M	客户端ID，获取方法参考创建API客户端。
productId	String	M	项目ID，查询方法可参见查询项目ID。
X-Agc-Trace-Id	String	O	单个文件请求的Traceid。可不填或者随机生成，用于日志打印跟踪。

请求示例

收起
自动换行
深色代码主题
复制
GET /v0/testagc-02reg/test.jpg
client_id: 849033****232064
productId: 73643****61998
Content-Type: application/json
Authorization: Bearer ****
User-Agent: PostmanRuntime/7.6.0
Accept: */*
Host: ops-server-drcn.agcstorage.link
accept-encoding: gzip, deflate

响应参数

Header

展开

参数	类型	必选(M)/可选(O)	说明
status	Integer	M	HTTP响应码，200表示成功。
X-Agc-Trace-Id	String	O	单个文件请求的Traceid，与请求参数X-Agc-Trace-Id保持一致。

Body

展开

属性	类型	必选(M)/可选(O)	说明
productId	String	M	项目ID。
name	String	M	文件名称。
bucket	String	M	存储实例名称。
storageArea	String	M	存储区域名称。
storageRegion	String	M	后端OBS存储站点。
storageType	String	M	存储类型。
contentType	String	M	文件类型。Content-Type标头告诉客户端实际返回的内容类型。
contentDisposition	String	O	文件打开方式，响应头指示回复的内容该以何种形式展示，是以内联的形式（即网页的一部分），还是以附件的形式下载并保存到本地。
cacheControl	String	O	标准HTTP请求头字段Cache-Control。 public：文件可缓存到任何位置。 private：文件可以缓存到请求者的本地缓存中。 no-cache：文件可以缓存，但有请求发出时，缓存会将此请求发到服务器，服务器验证请求中所描述的缓存是否过期，若未过期，返回304，缓存可使用，否则不可使用。 no-store：缓存中不得存储任何关于客户端请求和服务端响应的内容。 max-age=TIME_IN_SECONDS：文件可缓存的时长。
contentEncoding	String	O	标准HTTP请求头Content-Encoding，是一个实体消息首部，用于对特定媒体类型的数据进行压缩。当这个首部出现的时候，它的值表示消息主体进行了何种方式的内容编码转换。
contentLanguage	String	O	标准HTTP请求头 Content-Language，用来说明访问者希望采用的语言或语言组合，这样的话用户就可以根据自己偏好的语言来定制不同的内容。
sha256	String	O	文件SHA256值。
size	long	M	文件大小。
createTime	String	M	上传时间，时间日期格式:yyyy-MM-ddTHH:mm:ssZ。
updateTime	String	M	更新时间，时间日期格式:yyyy-MM-ddTHH:mm:ssZ。
metadata	Map<String,String>	O	元数据，用户自定义元数据。

响应示例

收起
自动换行
深色代码主题
复制
HTTP/1.1 200
status: 200
Date: Mon, 27 Mar 2023 03:01:32 GMT
Content-Type: text/plain
Transfer-Encoding: chunked
Connection: keep-alive
X-Agc-Trace-Id: 98b5dbf2-d7ad-4c13-9858-c829480cf3ba
Server: elb
{"name":"test.jpg","metadata":{},"createTime":"2022-12-10T10:13:46Z","updateTime":"2022-12-10T10:13:46Z","storageArea":"CN","size":29797,"storageRegion":"cn-north-4","productId":"736430****1998","storageType":"STANDARD","bucket":"testagc-02reg","contentType":"image\/jpeg"}

调用示例

收起
自动换行
深色代码主题
复制
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;

import lombok.Builder;
import lombok.Getter;
import lombok.Setter;
import lombok.ToString;
import lombok.extern.slf4j.Slf4j;

import org.apache.commons.collections4.MapUtils;
import org.apache.http.Consts;
import org.apache.http.HttpStatus;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.junit.Ignore;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.util.HashMap;
import java.util.Map;

/**
 * 元数据管理REST API示例代码
 */
@Slf4j
public class MetadataManagingTest {

    /**
     * 查询元数据信息
     *
     * @param storageUrl 云存储url
     * @param param 查询元数据接口入参
     * @return 元数据信息
     * @throws Exception 异常
     */
    public static ObjectMetadata getObjectMetadata(String storageUrl, ObjectMetadataParam param) throws Exception {
        URIBuilder uriBuilder =
            new URIBuilder(storageUrl + param.getBucketName() + "/" + param.getObjectName() + "?metadata=query");
        HttpGet get = new HttpGet(uriBuilder.build());
        get.setHeader("productId", param.getProjectId());
        get.setHeader("client_id", param.getClientId());
        get.setHeader("Authorization", "Bearer " + param.getToken());

        CloseableHttpClient httpClient = HttpClients.createDefault();
        CloseableHttpResponse httpResponse = httpClient.execute(get);
        int statusCode = httpResponse.getStatusLine().getStatusCode();
        if (statusCode == HttpStatus.SC_OK) {
            BufferedReader br =
                new BufferedReader(new InputStreamReader(httpResponse.getEntity().getContent(), Consts.UTF_8));
            String result = br.readLine();
            JSONObject object = JSON.parseObject(result);
            log.info("getObjectMetadata result:{}", object.toJSONString());
            return JSONObject.toJavaObject(object, ObjectMetadata.class);
        } else {
            log.error("getObjectMetadata error, statusCode:{}", statusCode);
            return null;
        }
    }

    public void client() throws Exception {
        String clientToken = TokenServiceTest.getToken("https://connect-api.cloud.huawei.com/api/", "84903XXXXXX32064",
            "00E5CCADB655891XXXXXXXXXXXX8CDCC83ACF22");
        ObjectMetadataParam param = ObjectMetadataParam.builder()
            .projectId("73643XXXXXX61998")
            .clientId("84903XXXXXX32064")
            .token(clientToken)
            .bucketName("test-q36q0")
            .objectName("sha256/test3.jpg")
            .build();
        getObjectMetadata("https://ops-server-drcn.agcstorage.link/v0/", param);
    }

    public static void main(String[] args) throws Exception {
        new MetadataManagingTest().client();
    }

    @Builder
    @Getter
    static class ObjectMetadataParam {
        // 项目ID
        String projectId;

        // 客户端ID
        String clientId;

        // clientToken
        String token;

        // 云存储实例名
        String bucketName;

        // 待下载的文件的对象名，需要携带路径。
        String objectName;

        Map<String, String> metadata;
    }

    /**
     * 文件的元数据
     */
    @Getter
    @Setter
    @ToString
    static class ObjectMetadata {
        // 项目Id
        private String productId;

        // 存储的实例名
        private String bucket;

        // 存储的区域
        private String storageArea;

        // 后端OBS存储站点
        private String storageRegion;

        // 存储的类型
        private String storageType;

        // 文件名
        private String name;

        // 文件类型
        private String contentType;

        // 上传时间，时间日期格式:yyyy-MM-ddTHH:mm:ssZ
        private String createTime;

        // 更新时间，时间日期格式:yyyy-MM-ddTHH:mm:ssZ
        private String updateTime;

        // 文件大小
        private long size;

        // 可选，元数据，用户自定义元数据
        private Map<String, String> metadata;

        // 可选，标准HTTP请求头Content-Language
        private String contentLanguage;

        // 可选，标准HTTP请求头Content-Encoding
        private String contentEncoding;

        // 可选，标准HTTP请求头Cache-Control
        private String cacheControl;

        // 可选，文件打开方式
        private String contentDisposition;
    }
}

删除文件

修改文件元数据

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问