本文将为您介绍在使用 API 时会出现的公共响应头部(Response Header),下文提到的头部在后续的具体 API 文档中不再赘述。
响应头部列表
Header 名称 | 描述 | 类型 | 是否必返 |
Content-Length | RFC 2616 中定义的 HTTP 响应内容长度(字节)。 | string | 视响应而定 |
Content-Type | RFC 2616 中定义的 HTTP 响应内容类型(MIME)。 | string | 视响应而定 |
Connection | RFC 2616 中定义,表明响应完成后是否会关闭网络连接。枚举值: keep-alive、close。 | enum | 是 |
Date | RFC 1123 中定义的 GMT 格式服务端响应时间,例如 Wed, 29 May 2019 04:10:12 GMT。 | string | 是 |
Server | 接收请求并返回响应的服务器名称,固定为 Rapid Bucket。 | string | 是 |
ETag | 全称为 Entity Tag,是对象被创建时标识对象内容的信息标签,可用于检查对象的内容是否发生变化。格式为 "<etag_value>",前后携带双引号,中间为 ASCII 字符串,例如 "ee8de918d05640145b18f70f4c3aa602"。仅对象相关接口(GetObject、HeadObject、PutObject、PutObjectCopy、UploadPart、UploadPartCopy、CompleteMultipartUpload)的成功响应会返回该头部。 | string | 否 |
Last-Modified | 对象最近一次被修改的时间,格式为 RFC 1123 GMT,例如 Tue, 28 May 2019 08:30:00 GMT。是否返回视具体接口而定。 | string | 否 |
x-cos-hash-crc64ecma | 对象内容的 CRC64-ECMA 校验值,十进制字符串。仅文件对象会返回;目录对象(Key 以 / 结尾)不返回。 | string | 否 |
x-cos-request-id | 服务端为每次请求生成的唯一 ID。无论请求成功还是失败,响应中都会携带;排查问题时请提供此 ID。 | string | 是 |