华为云OBS接口文档

一、接口概述

本文档描述华为云OBS文件存储服务的核心接口，包括临时凭证获取和签名URL生成功能。

二、接口列表

接口名称	请求方式	URL路径	说明
获取临时凭证	POST	/obs/temporary-credentials	获取OBS临时访问凭证
获取签名URL	POST	/obs/signed-url	获取文件下载/预览的签名URL

三、接口详情

3.1 获取临时凭证

3.1.1 接口说明

获取华为云OBS临时安全凭证，用于前端直传文件到OBS。临时凭证包含临时AK/SK和安全令牌，有效期默认为900秒（15分钟）。

3.1.2 请求信息

URL：/obs/temporary-credentials

请求方式：POST（RAW JSON）

请求参数：无

3.1.3 响应信息

响应参数：

参数名	类型	说明
bucketName	String	OBS存储桶名称
accessKey	String	临时访问密钥ID（AK）
secretKey	String	临时访问密钥（SK）
securityToken	String	安全令牌，使用临时AK/SK时必须携带
bucketDomain	String	桶访问域名，格式：https://{bucketName}.{endpoint}
expiresInSeconds	Integer	凭证剩余有效时间（秒）

3.1.4 请求示例

3.1.5 响应示例

成功响应：

{
  "code": 200,
  "msg": "success",
  "data": {
    "bucketName": "declare-dev",
    "accessKey": "临时AK值",
    "secretKey": "临时SK值",
    "securityToken": "安全令牌值",
    "bucketDomain": "https://declare-dev.obs.cn-south-1.myhuaweicloud.com",
    "expiresInSeconds": 880
  }
}

失败响应：

{
  "code": 500,
  "msg": "获取临时凭证失败: 错误详情",
  "data": null
}

3.1.6 错误码说明

错误信息	说明
获取临时凭证失败	IAM服务调用异常，可能是网络问题或AK/SK配置错误
获取临时凭证失败: 错误详情	具体错误原因会在错误详情中说明

文件服务接口文档

华为云OBS接口文档#

一、接口概述#

二、接口列表#

三、接口详情#

3.1 获取临时凭证#

3.1.1 接口说明#

3.1.2 请求信息#

3.1.3 响应信息#

3.1.4 请求示例#

3.1.5 响应示例#

3.1.6 错误码说明#