更新时间:2025-01-26 gmt 08:00

获取桶元数据-九游平台

功能介绍

对桶拥有读权限的用户可以执行查询桶元数据是否存在的操作。

请求消息样式

1
2
3
4
head/http/1.1
host:bucketname.obs.cn-north-4.myhuaweicloud.com
date:date
authorization:authorization

请求消息参数

该请求消息中不带消息参数。

请求消息头

该请求使用公共消息头,具体参见表3

如果想要获取cors配置信息,则需要使用的消息头如下表1所示。

表1 获取cors配置的请求消息头

消息头名称

消息头类型

是否必选

描述

origin

string

参数解释:

预请求指定的跨域请求origin(通常为域名)。

约束限制:

允许多条匹配规则,以回车换行为间隔。每个匹配规则允许使用最多一个“*”通配符。

取值范围:

符合http协议的该头域的值。

默认取值:

access-control-request-headers

string

参数解释:

实际请求可以带的http头域。

约束限制:

允许的头域可设置多个,多个头域之间换行隔开,每行最多可填写一个*符号,不支持&、:、<、空格以及中文字符。

取值范围:

符合http协议的该头域的值。

默认取值:

请求消息元素

该请求消息中不带消息元素。

响应消息样式

1
2
3
http/1.1status_code
x-obs-bucket-location:cn-north-4
date:date

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

除公共响应消息头之外,还可能使用如下表2中的消息头。

表2 附加响应消息头

消息头名称

消息头类型

描述

x-obs-bucket-location

string

参数解释:

桶的区域位置信息。

约束限制:

取值范围:

默认取值:

x-obs-storage-class

string

参数解释:

桶的默认存储类型。

约束限制:

取值范围:

  • standard(标准存储)
  • warm(低频访问存储)
  • cold(归档存储)
  • deep_archive(深度归档存储)

默认取值:

x-obs-version

string

参数解释:

桶所在的obs服务版本号。

约束限制:

取值范围:

  • 3.0:最新版本的桶。
  • --:表示老版本的桶。

默认取值:

x-obs-fs-file-interface

string

参数解释:

判断是否为并行文件系统。

约束限制:

不携带此头域表示不属于并行文件系统。

取值范围:

取值包含enabled(并行文件系统)。

默认取值:

x-obs-epid

string

参数解释:

当前桶的企业项目id,开通企业项目的用户可以从企业项目服务获取。

约束限制:

格式为uuid,未开通企业项目的用户可以不带该头域。

取值范围:

获取方式参见如何获取企业项目id

默认取值:

x-obs-az-redundancy

string

参数解释:

桶的数据冗余存储策略属性,即az类型。

取值为3az,表示数据冗余存储在同一区域的多个可用区。

不携带此头域表示为单az存储,仅使用1个可用区存储。

约束限制:

归档存储和深度归档存储不支持多az。如果桶所在区域不支持多az存储,则该桶的存储类型默认为单az。

取值范围:

如果桶配置为多az,则返回值为“3az”。如果桶配置为单az,则返回值为none。

默认取值:

access-control-allow-origin

string

参数解释:

当桶设置了cors配置,如果请求的origin满足服务端的cors配置,则在响应中包含这个origin。

约束限制:

取值范围:

符合cors协议的取值范围。

默认取值:

access-control-allow-headers

string

参数解释:

当桶设置了cors配置,如果请求的headers满足服务端的cors配置,则在响应中包含这个headers。

约束限制:

取值范围:

符合cors协议的取值范围。

默认取值:

access-control-max-age

integer

参数解释:

当桶设置了cors配置,服务端cors配置中的maxageseconds。

约束限制:

取值范围:

大于等于0的整型数,单位:秒。

默认取值:

3000

access-control-allow-methods

string

参数解释:

当桶设置了cors配置,如果请求的access-control-request-method满足服务端的cors配置,则在响应中包含这条rule中的methods。

约束限制:

取值范围:

  • get
  • put
  • head
  • post
  • delete

默认取值:

access-control-expose-headers

string

参数解释:

桶cors规则中的exposeheader。exposeheader是指cors规则允许响应中可返回的附加头域,给客户端提供额外的信息。默认情况下浏览器只能访问以下头域:content-length、content-type,如果需要访问其他头域,需要在附加头域中配置。

约束限制:

不支持*、&、:、<、空格以及中文字符。

取值范围:

默认取值:

响应消息元素

该请求的响应中不带有响应元素。

错误响应消息

无特殊错误,所有错误已经包含在表2中。

请求示例:未携带获取cors配置

1
2
3
4
5
6
head/http/1.1
user-agent:curl/7.29.0
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
accept:*/*
date:wed,01jul201502:30:25gmt
authorization:obsh4ipjx0tqththebqqcec:nicqcugizpetkiyx1datxhzyylk=

响应示例:未携带获取cors配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
http/1.1200ok
server:obs
x-obs-request-id:bf260000016439c734e0788404623fa8
content-type:application/xml
x-obs-storage-class:standard
x-obs-id-2:32aaaqaaeaabaaaqaaeaabaaaqaaeaabcsxwlpq9hzf3onaxr pi/oplkdrtiqaf
date:wed,01jul201502:30:25gmt
x-obs-bucket-location:cn-north-4
x-obs-version:3.0
content-length:0

请求示例:桶设置了cors后,获取桶元数据和cors配置

1
2
3
4
5
6
7
8
head/http/1.1
user-agent:curl/7.29.0
host:examplebucket.obs.cn-north-4.myhuaweicloud.com
accept:*/*
date:wed,01jul201502:30:25gmt
authorization:obsh4ipjx0tqththebqqcec:nicqcugizpetkiyx1datxhzyylk=
origin:www.example.com
access-control-request-headers:allowedheader_1

响应示例:桶设置了cors后,获取桶元数据和cors配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
http/1.1200ok
server:obs
x-obs-request-id:bf260000016439c734e0788404623fa8
content-type:application/xml
x-obs-storage-class:standard
x-obs-id-2:32aaaqaaeaabaaaqaaeaabaaaqaaeaabcsxwlpq9hzf3onaxr pi/oplkdrtiqaf
date:wed,01jul201502:30:25gmt
x-obs-bucket-location:cn-north-4
access-control-allow-origin:www.example.com
access-control-allow-methods:post,get,head,put
access-control-allow-headers:allowedheader_1
access-control-max-age:100
access-control-expose-headers:exposeheader_1
x-obs-version:3.0
content-length:0

相关文档

网站地图