常见头和错误代码
数据传输使用许多标准协议，并且具有独特的需求。 请密切关注最新的公共头和一些错误代码的参考信息。
公共请求头
下表列出了受支持的常用请求头。如果请求中包含未在下表中列出的常用请求头，IBM Cloud® Object Storage 将忽略这些请求头，但某些请求可能支持本文档中定义的其他请求头。
| 头 | 注释 |
|---|---|
| Authorization | 必需，适用于所有请求（OAuth2 bearer 令牌）。 |
ibm-service-instance-id |
必需，适用于创建或列出存储区的请求。 |
Content-MD5 |
有效内容的 Base64 编码的 128 位二进制 MD5 散列，用作完整性检查，可确保有效内容在传输中未变更。 必须对 MD5 散列的二进制输出执行 Base64 编码，而不是采用十六进制表示。 |
x-amz-checksum-crc32 |
该标头是对象的 Base64 编码、32 位 CRC32 校验和。 |
x-amz-checksum-crc32c |
该标头是对象的 Base64 编码、32 位 CRC32C 校验和。 |
x-amz-checksum-crc64nvme |
该标头是对象的 Base64 编码、64 位 CRC64NVME 校验和。 CRC64NVME 校验和始终是全对象校验和。 |
x-amz-checksum-sha1 |
该标头是对象的 Base64 编码、160 位 SHA1 摘要。 |
x-amz-checksum-sha256 |
该标头是对象的 Base64 编码、256 位 SHA256 摘要。 |
x-amz-sdk-checksum-algorithm |
表示使用 SDK 为对象创建校验和时使用的算法。 |
Expect |
值 100-continue 表示在发送有效内容之前，将等待系统确认头是否正确。 |
host |
{bucket-name}.{endpoint} 的端点或“虚拟主机”语法。 通常，系统会自动添加此头。 有关端点的更多信息，请参阅端点和存储位置。 |
Cache-Control |
可用于指定请求/应答链中的高速缓存行为。 有关更多信息，请转至 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9 |
定制元数据
使用对象存储器的优点是能够通过将键/值对作为头发送来添加定制元数据。 这些头的格式为 x-amz-meta-{KEY}。 请注意，与 AWS S3 不同，IBM Cloud Object Storage 会将具有相同元数据键的多个标头合并为以逗号分隔的值列表。
公共响应头
下表描述了公共响应头。
| 头 | 注释 |
|---|---|
Content-Length |
请求主体的长度（以字节为单位）。 |
Connection |
指示连接是打开还是关闭。 |
Date |
请求的时间戳记。 |
ETag |
请求的 MD5 散列值。 |
Server |
响应服务器的名称。 |
X-Clv-Request-Id |
为每个请求生成的唯一标识。 |
生命周期响应头
下表描述了归档对象的响应头
| 头 | 注释 |
|---|---|
x-amz-restore |
对象已复原或正在进行复原时，会包含此头。 |
x-amz-storage-class |
如果已归档或临时恢复，则返回 GLACIER 或 ACCELERATED。 |
x-ibm-archive-transition-time |
返回安排对象以转换到归档层的日期和时间。 |
x-ibm-transition |
对象具有转换元数据时，会包含此头，并返回转换的层和原始转换时间。 |
x-ibm-restored-copy-storage-class |
对象处于 RestoreInProgress 或 Restored 状态时，会包含此头，并返回存储区的存储类。 |
有关 错误代码 的列表，请参阅 API 文档