云服务器内容精选

  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token,使用Token鉴权方式时必填。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必填,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必填,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必填,携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 bucket 是 String OBS桶名 operation 是 Integer 操作 1:授权 0:取消授权
  • 响应参数 状态码: 200 表3 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号,以便任务跟踪。 状态码: 400 表4 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号,以便任务跟踪。 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 401 表6 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号,以便任务跟踪。 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 500 表8 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号,以便任务跟踪。 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述
  • 响应示例 状态码: 400 操作失败 { "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue" } 状态码: 401 请求失败,携带的X-Auth-Token错误 { "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue" } 状态码: 500 查询失败,服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError" }
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表2 请求Body参数 参数 是否必选 参数类型 描述 bucket 是 String OBS桶名 operation 是 Integer 操作,1-授权;0-取消授权 location 是 String 查询bucket所在的region cn-north-4 cn-north-1 cn-north-5 cn-north-6 cn-south-1 cn-east-2 project_id 否 String 租户华为云账号projectid
  • 操作步骤 登录OBS Browser。 在主页面右上角的搜索框中输入需要查找的桶名。 单击。 搜索到的桶会显示在桶列表中。如果想重新搜索其他桶,可单击删除已输入的关键字后重新输入需要搜索的桶名。 如果用户当前处于对象列表界面,需要快速切换到其他桶,则可单击页面左侧图标展开隐藏的桶列表,并在桶列表上方搜索框中搜索需要切换到的桶。 例如:您需要查找桶名中包含“test”字符的所有桶,您只需在主页面右上角的搜索框中输入“test”并单击,所有包含“test”字符的桶都会展示到桶列表中。
  • 请求示例 文件下载,其中文件类型为PUBLIC,文件链接如下。 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/data/download { "type" : "PUBLIC", "url" : "https://eihealth-6a713322-72ad-4080-bdcb-acf571576015.obs.cn-north-4.myhuaweicloud.com/test.txt" } { "type" : "PRIVATE", "url" : "projectName:/test.txt" }
  • URI POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/data/download 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 华为云项目ID,您可以从获取项目ID中获取。 最小长度:1 最大长度:128 eihealth_project_id 是 String 平台项目ID,您可以在平台单击所需的项目名称,进入项目设置页面查看。 最小长度:1 最大长度:128
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限, 获取Token 接口响应消息头中X-Subject-Token的值即为Token。 最小长度:1 最大长度:32768 表3 请求Body参数 参数 是否必选 参数类型 描述 type 否 String 下载类型(仅支持PRIVATE|PUBLIC) 枚举值: PRIVATE PUBLIC EXTRANET url 否 String 资源地址(支持https、obs地址) 最小长度:1 最大长度:2000
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Integer 数据(文件夹、文件)总数量 objects Array of BucketObjectDto objects 数据列表 表5 BucketObjectDto 参数 参数类型 描述 path String 对象全路径(项目名称:/路径) name String 名称 type String 类型 枚举值: FILE FOLDER size Long 大小 create_time String 创建时间
  • 响应示例 状态码: 200 OK { "count" : 1, "objects" : [ { "path" : "bucket:/test.txt", "name" : "test.txt", "type" : "FILE", "size" : 1024, "create_time" : "2021-02-01T14:25:34Z" } ] }
  • URI GET /v1/{project_id}/customer-buckets/{bucket_name}/objects 表1 路径参数 参数 是否必选 参数类型 描述 bucket_name 是 String 桶名称 最小长度:1 最大长度:128 project_id 是 String 华为云项目ID,您可以从获取项目ID中获取。 最小长度:1 最大长度:128 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 限制量,单次查询总量[1, 1000],默认100 最小值:1 最大值:1000 缺省值:100 offset 否 Integer 偏移量,查询起始偏移,默认为0 最小值:0 最大值:100000000 缺省值:0 path 否 String 子路径 最小长度:0 最大长度:2000 search_key 否 String 查询关键词 最小长度:0 最大长度:2000
  • 约束与限制 桶创建成功后,不能修改名称和所属区域。创建时,请设置合适的桶名和区域。 一个账号及账号下的所有IAM用户一共可创建100个桶。建议结合OBS细粒度权限控制能力,合理进行桶规划和使用。例如,建议在桶内根据对象前缀划分不同的目录,通过细粒度权限控制实现不同目录在不同业务部门之间的权限隔离。每个桶中存放的对象的数量和大小总和没有限制,用户不需要考虑数据的可扩展性。 考虑到桶名会作为访问 域名 的一部分,需要参与域名解析,因此桶名需要满足DNS域名规范。OBS系统在接受创桶请求时,会对桶名进行严格的检查,具体规则如下: 需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。用户删除桶后,立即创建同名桶或并行文件系统会创建失败,需要等待30分钟才能创建。 长度范围为3到63个字符,支持小写字母、数字、中划线(-)、英文句号(.)。 禁止两个英文句号(.)相邻,禁止英文句号(.)和中划线(-)相邻,禁止以英文句号(.)和中划线(-)开头或结尾。 禁止使用IP地址。 当使用HTTPS协议访问OBS系统时,由于SSL的通配符证书仅匹配不包含"."的桶。这将导致桶名包含"."的桶在访问OBS系统时,客户端会提示证书校验存在风险,比如浏览器安全提示会呈现红色告警。因此如非必要,请尽量不要在桶名中包含"."。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数 最小值:0 最大值:100 size Integer 本页数量 最小值:0 最大值:100 items Array of ObsBucketInfo objects 对象列表 数组长度:0 - 100 表5 ObsBucketInfo 参数 参数类型 描述 responseHeaders Object 响应头 originalHeaders Object 请求头 statusCode Integer 状态 bucketName String 桶名称 owner owner object 桶拥有者信息 creationDate String 桶的创建时间 location String 桶的位置信息 storageClass Object 对象的存储类型 metadata Object 桶元数据 acl Object 桶ACL bucketStorageClass Object 桶的存储类型 bucketType String 桶类型 requestId String 请求id 表6 owner 参数 参数类型 描述 displayName String 显示名称 id String 用户的DomainID(帐号ID) 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 403 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 404 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128 状态码: 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:1 最大长度:128 error_msg String 错误消息 最小长度:1 最大长度:512 error_details String 具体错误消息 最小长度:1 最大长度:1024 request_id String 请求处理ID 最小长度:1 最大长度:128
  • 响应示例 状态码: 400 { "error_code" : "EG.00014000", "error_msg" : "Bad request" } 状态码: 401 { "error_code" : "EG.00014010", "error_msg" : "Incorrect token or token resolution failed" } 状态码: 403 { "error_code" : "EG.00014030", "error_msg" : "No permissions to request this method" } 状态码: 404 { "error_code" : "EG.00014040", "error_msg" : "Not request resource found" } 状态码: 500 { "error_code" : "EG.00015000", "error_msg" : "Internal Server Error" }
  • URI GET /v1/{project_id}/subscriptions/obsbuckets 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目ID 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量,表示从此偏移量开始查询,偏移量不能小于0 最小值:0 最大值:100 缺省值:0 limit 否 Integer 每页显示的条目数量,不能小于1或大于1000 最小值:1 最大值:1000 缺省值:15 sort 否 String 指定查询排序 缺省值:created_time:DESC