GetObject
更新时间 2026-04-10 20:11:10
最近更新时间: 2026-04-10 20:11:10
功能说明
GetObject请求获取指定的对象。
请求消息样式
GET /{Bucket}/{Key}?versionId=VersionId HTTP/1.1
Host: xxx.zos.ctyun.cn
X-Amz-Content-Sha256: Content-SHA256
X-Amz-Date: Date
Authorization: Auth String
If-Match: Etag
If-Modified-Since: Date
If-None-Match: Etag
If-Unmodified-Since: Date
Range: bytes=beginbyte-endbyte请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： Bucket的名称。 | String | 是 |
| Key | 参数解释： 获取对象的Key。 | String | 是 |
| versionId | 参数解释： 对象的版本号。 | String | 否 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。 可以带附加消息头，附加请求消息头如下表所示：
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| If-Match | 参数解释： 仅当对象的Etag和提供的Etag匹配时下载，否则返回412。 | String | 否 |
| If-Modified-Since | 参数解释： 仅当对象在提供的时间后修改过时下载，否则返回304。 | Date | 否 |
| If-None-Match | 参数解释： 仅当对象的Etag和提供的Etag不匹配时下载，否则返回304。 | String | 否 |
| If-Unmodified-Since | 参数解释： 仅当对象在提供的时间后未修改过时下载，否则返回412。 | Date | 否 |
| Range | 参数解释： 指定下载对象的范围。 | String | 否 |
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-delete-marker: DeleteMarker
accept-ranges: AcceptRanges
x-amz-expiration: Expiration
Last-Modified: LastModified
Content-Length: ContentLength
ETag: ETag
x-amz-version-id: VersionId
x-amz-website-redirect-location: WebsiteRedirectLocation
x-amz-server-side-encryption: ServerSideEncryption
x-amz-server-side-encryption-customer-algorithm: SSECustomerAlgorithm
x-amz-server-side-encryption-customer-key-MD5: SSECustomerKeyMD5
x-amz-server-side-encryption-aws-kms-key-id: SSEKMSKeyId
x-amz-server-side-encryption-bucket-key-enabled: BucketKeyEnabled
x-amz-storage-class: StorageClass
x-amz-tagging-count: TagCount
x-amz-object-lock-mode: ObjectLockMode
x-amz-object-lock-retain-until-date: ObjectLockRetainUntilDate
x-amz-object-lock-legal-hold: ObjectLockLegalHoldStatus
x-rgw-object-type: ObjectType
x-amz-metadata-*: Metadata
Body响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。 除公共响应消息头之外，还可能返回如下的消息头：
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| x-amz-delete-marker | 参数解释： 指明对象是否是删除标记DeleteMarker。 | String |
| accept-ranges | 参数解释： 表明下载时指定的range。 | String |
| x-amz-expiration | 参数解释： 对象的过期时间。如果配置了对象过期（请参阅 PUT Bucket Lifecycle），则响应包含此标头。它包括提供对象过期信息的过期日期和规则ID键值对。 | String |
| Content-Length | 参数解释： Body的长度。 | Long |
| ETag | 参数解释： 对象的Etag。 | String |
| x-amz-version-id | 参数解释： 对象的VersionId。 | String |
| x-amz-website-redirect-location | 参数解释： 如果开启了website配置，重定向到指定的URL。 | String |
| x-amz-server-side-encryption | 参数解释： 服务器端加密的算法。 | String |
| x-amz-server-side-encryption-customer-algorithm | 参数解释： 如果请求使用客户提供的加密密钥进行服务器端加密，则响应将包含此参数，以确认所使用的加密算法。 | String |
| x-amz-server-side-encryption-customer-key-MD5 | 参数解释： 用户提供的加密密钥的MD5。如果请求使用客户提供的加密密钥进行服务器端加密，则响应将包含此标头以提供往返消息的完整性验证 。 | String |
| x-amz-server-side-encryption-aws-kms-key-id | 参数解释： 指明KMS key的ID。 | String |
| x-amz-server-side-encryption-bucket-key-enabled | 参数解释： 服务器端加密是否开启。 | String |
| x-amz-storage-class | 参数解释： 对象的存储级别。 | String |
| x-amz-tagging-count | 参数解释： 对象的tag数。 | Long |
| x-amz-object-lock-mode | 参数解释： 对象的Lock模式。 | String |
| x-amz-object-lock-retain-until-date | 参数解释： 对象Lock到期的时间。 | Date |
| x-amz-object-lock-legal-hold | 参数解释： 对象Legal hold是否开启。 | String |
| x-rgw-object-type | 参数解释： 对象类型，普通对象为 Normal，软链接对象为 Symlink | String |
| x-amz-metadata-[自定义后缀] | 参数解释： 用户指定的元数据信息。 | String |
响应消息元素
| 参数名称 | 参数描述 | 类型 |
|---|---|---|
| Body | 参数解释： 对象的内容。 | String |
错误码
请参见调用前必知-错误码-全局错误码。
