更新时间:2024-03-26 GMT+08:00

SDK公共结果对象(Python SDK)

功能说明

调用ObsClient的相关接口完成后均会返回SDK公共结果对象(ObsClient.createSignedUrl和ObsClient.createPostSignature接口除外),可从SDK公共结果对象中获取HTTP状态码,判断操作是否成功。

参数描述

表1 GetResult

参数名称

参数类型

描述

status

int

参数解释:

HTTP状态码。

取值范围:

状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态。完整的状态码列表请参见状态码

默认取值:

reason

str

参数解释:

HTTP文本描述。

默认取值:

errorCode

str

参数解释:

OBS服务端错误码,当status参数小于300时为空。

默认取值:

errorMessage

str

参数解释:

OBS服务端错误描述,当status参数小于300时为空。

默认取值:

requestId

str

参数解释:

OBS服务端返回的请求ID。

默认取值:

indicator

str

参数解释:

OBS服务端返回的错误定位码。

默认取值:

hostId

str

参数解释:

请求的服务端ID,当status参数小于300时为空。

默认取值:

resource

str

参数解释:

发生错误时相关的桶或对象,当status参数小于300时为空。

默认取值:

header

list

参数解释:

响应消息头列表,由多个元组构成。每个元组均包含两个元素,代表响应头的键值对。

默认取值:

body

object

参数解释:

操作成功后的结果数据,当status大于300时为空。该值根据调用接口的不同而不同,参见“桶相关接口”章节和“对象相关接口”章节的详细描述。

默认取值:

成功返回结果示例
{
    'status': 200,
    'reason': 'OK',
    'body': {
	...此处省略
    },
    'requestId': '000001************B5512',
    'header': [...此处省略]
}

代码样例

try:
    resp = obsClient.getObject('bucketname', 'objectname', loadStreamInMemory=True) 
          
    if resp.status < 300: 
        print('requestId:', resp.requestId)
        # 获取对象内容 
        print('buffer:', resp.body.buffer) 
        print('size:', resp.body.size) 
    else: 
        print('errorCode:', resp.errorCode) 
        print('errorMessage:', resp.errorMessage)
except:
    import traceback
    print(traceback.format_exc())

设置loadStreamInMemory参数为True进行二进制式下载,对象的内容将被包含在返回结果中的body.buffer字段。