赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 公共HTTP头定义

公共HTTP头定义

  • API参考
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

本文介绍了对象存储OSS的公共请求头和公共响应头的详细说明。

公共请求头(Common Request Headers)

OSS的RESTful接口中使用了一些公共请求头,这些请求头可以被所有的OSS请求使用,其详细定义请参见下表。

名称

类型

示例值

描述

Authorization

字符串

OSS4-HMAC-SHA256 Credential=****

在非匿名请求中,用于验证请求合法性的认证信息。关于Authorization计算方法的更多信息,请参见签名版本4(推荐)。

默认值:无

Content-Length

字符串

556

RFC 2616中定义的HTTP请求内容长度。

默认值:无

Content-Type

字符串

application/xml

RFC 2616中定义的HTTP请求内容类型。

默认值:无

Date

字符串

Sun, 05 Sep 2021 23:00:00 GMT

HTTP 1.1协议中规定的GMT时间。

默认值:无

Host

字符串

oss-example.oss-cn-hangzhou.aliyuncs.com

访问域名。支持以下三种类型:

  • Bucket域名:格式为BucketName.Endpoint,示例值为oss-example.oss-cn-hangzhou.aliyuncs.com。

    关于支持通过Bucket域名发起请求的API列表,请参见API概览。

  • 接入点别名域名:格式为AccessPointName-ossalias.Endpoint,示例值为ap-01-9adeed3cfa4c3208ceb8df5ad8f9a2****-ossalias.oss-cn-hangzhou.aliyuncs.com。

    关于支持通过接入点别名域名发起请求的API列表,请参见接入点别名域名兼容的操作。

  • 云盒域名:云盒域名分为管控域名和数据域名两种。

    • 管控域名:格式为<Cloudbox-Id>.<Region>.oss-cloudbox-control.aliyuncs.com,示例值为cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox-control.aliyuncs.com。

      更多信息,请参见管控域名支持的API列表。

    • 数据域名:格式为<Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com,示例值为cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com。

      更多信息,请参见数据域名支持的API列表。

默认值:无

x-oss-security-token

字符串

CAISowJ1q6Ft5B2yfSjIr5feHsPhtYh3+pONd2uCglI3dvxVt7DB1Tz2IHxMdHJsCeAcs/Q0lGFR5/sflqJIRoReREvCUcZr8sy2SqEGos2T1fau5Jko1be0ewHKeQKZsebWZ+LmNpy/Ht6md1HDkAJq3LL+bk/Mdle5MJqP+/kFC9MMRVuAcCZhDtVbLRcYgq18D3bKMuu3ORPHm3fZCFES2jBxkmRi86+ysIP+phPVlw/90fRH5dazcJW0Zsx0OJo6Wcq+3+FqM6DQlTNM6hwNtoUO1fYUommb54nDXwQIvUjfbtC5qIM/cFVLAYEhALNBofTGkvl1h/fejYyfyWwWYbkFCHiPFNr9kJCUSbr4a4sjF6zyPnPWycyCLYXleLzhxPWd/2kagAF6qLNY5paXF18NyRP0PISqxlWBuSQldMS3avlblTFB7apY8CUiAQcSY3uDYUhuxU+KFBxpGaq8c1SU5ARo+1JBA5nXhFlY2nbDnWONxa0mvNvE3XJ0FZJnDS7WBHyOMjC8nmw2GfaQ4bxQ0D2+20yrDNevWSSqnwh0qXMI3zY5****

仅在使用STS临时授权账号访问OSS时需要配置该选项。关于如何获取Security-Token的具体操作,请参见AssumeRole - 获取扮演角色的临时身份凭证。

公共响应头(Common Response Headers)

OSS的RESTful接口中使用了一些公共响应头。这些响应头可以被所有的OSS请求所使用,其详细定义请参见下表。

名称

类型

示例值

描述

Content-Length

字符串

556

RFC 2616中定义的HTTP请求内容长度。

默认值:无

Connection

枚举

keep-alive

标明客户端和OSS服务器之间的链接状态。

有效值:keep-alive、close

默认值:无

Date

字符串

Sun, 05 Sep 2021 23:00:00 GMT

HTTP 1.1协议中规定的GMT时间。

默认值:无

ETag

字符串

5B3C1A2E053D763E1B002CC607C5A0FE1****

ETag (entity tag) 在每个Object生成的时候被创建,用于标识一个Object的内容。对于Put Object请求创建的Object,ETag值是其内容的MD5值;对于其他方式创建的Object,ETag值是基于一定计算规则生成的唯一值,但不是其内容的MD5值。ETag值可以用于检查Object内容是否发生变化。

默认值:无

Server

字符串

AliyunOSS

生成Response的服务器。

默认值:AliyunOSS

x-oss-request-id

字符串

534B371674E88A4D8906****

用于唯一标识该次请求的UUID。您可以凭借此Request ID联系技术支持,排查并解决您遇到的问题。关于获取Request ID的具体操作,请参见获取Request ID。

默认值:无

相关文章

简介 2025-04-21 18:15

阿里云对象存储服务(Object Storage Service,简称OSS),是阿里云对外提供的海量、安全、低成本、高可靠的云存储服务。您可以通过本文档提供的简单的REST接口,在任何时间、任何地点、任何互联网设备上进行上传和下载数据。基于OSS,您可以搭建出各种多媒体分享网站、网盘、个人和企业数

API概览 2025-04-21 18:15

本文介绍对象存储OSS提供的相关API接口及其各API接口的用法。 关于Service操作

公共HTTP头定义 2025-04-21 18:15

本文介绍了对象存储OSS的公共请求头和公共响应头的详细说明。 公共请求头(Common Request Headers) O

关于Bucket操作 2025-04-21 18:15

关于Bucket操作的相关API,请参见下表。

关于Object操作 2025-04-21 18:15

本文为您介绍关于Object操作的API接口。 API功能列表 关于Object操作的相关API,请参见下表。

关于LiveChannel的操作 2025-04-21 18:15

您可以使用RTMP协议将音视频数据上传到OSS,转储为指定格式的音视频文件。上传前需要先创建一个LiveChannel,以获取对应的推流地址。 通过RTMP协议上传音视频数据目前有以下限制:

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号