Python SDK 手册

错误处理

异常处理

调用 Client 类的相关接口时，如果抛出异常，则表明操作失败，否则操作成功。抛出异常时，方法返回的数据无效。SDK 中所有异常均属于 NOSException 类，其下分为两个子类：ClientException、ServiceException。在调用 PYTHON SDK 接口的时候，捕捉这些异常并打印必要的信息有利于定位问题。

异常处理实例

错误处理代码如下所示:

try:
  resp = client.XXX(bucket=bucket, key=key)
except nos.exceptions.ServiceException as e:
  print (
    "ServiceException: %s\n"
    "status_code: %s\n"
    "error_type: %s\n"
    "error_code: %s\n"
    "request_id: %s\n"
    "message: %s\n"
  ) % (
    e,
    e.status_code,  # 错误 http 状态码
    e.error_type,   # NOS 服务器定义错误类型
    e.error_code,   # NOS 服务器定义错误码
    e.request_id,   # 请求 ID，有利于 nos 开发人员跟踪异常请求的错误原因
    e.message       # 错误描述信息
)
except nos.exceptions.ClientException as e:
  print (
    "ClientException: %s\n"
    "message: %s\n"
  ) % (
    e,
    e.message       # 客户端错误信息
  )

NOSException

ClientException

ClientException 包含 SDK 客户端的异常。比如，上传对象时对象名为空，就会抛出该异常。 ClientException 类下有如下子类，用于细分客户端异常：

ServiceException

ServiceException 包含 NOS 服务器返回的异常。当 NOS 服务器返回 4xx 或 5xx 的 HTTP 错误码时，PYTHON SDK 会将 NOS Server 的响应转换为 ServiceException。 ServiceException 类下有如下子类，用于细分 NOS 服务器返回的异常：