Object Storage Service:例外処理

例外処理の例

次のサンプルコードは、存在しないオブジェクトをダウンロードしようとしたときに、例外を処理し、エラーのHTTPステータスコードとリクエストIDを表示する方法の例を示しています。

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Obtain access credentials from the environment variables. Before you run the sample code, make sure that you have configured environment variables OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET. 
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. 
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# Specify the ID of the region that maps to the endpoint. Example: cn-hangzhou. This parameter is required if you use the signature algorithm V4.
region = "cn-hangzhou"

# Specify the name of the bucket.
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

try:
    # Specify the name of the downloaded object. Example: exampleobject.txt. 
    stream = bucket.get_object('exampleobject.txt')
except oss2.exceptions.NoSuchKey as e:
    print('status={0}, request_id={1}'.format(e.status, e.request_id))            

ClientError

クライアントの入力が正しくないため、ClientErrorが発生します。 たとえば、bucket.batch_delete_objectsメソッドを使用して空のオブジェクトリストを受け取った場合にエラーが発生します。 ClientErrorのstatusの値はoss2.exceptions.OSS_CLIENT_ERROR_STATUSです。

RequestError

HTTPライブラリがエラーをスローすると、OSS SDK for PythonはエラーをRequestErrorに変換します。 RequestErrorのstatusの値はoss2.exceptions.OSS_REQUEST_ERROR_STATUSです。

ServerError

OSSサーバーがHTTPステータスコードを返すと、OSS SDK for PythonはステータスコードをServerErrorに変換します。 ServerErrorは、HTTPステータスコードとOSSエラーコードに基づいて複数のサブクラスを導出します。 NotFoundサブクラスは、HTTPステータスコード404に対応します。 Conflictサブクラスは、HTTPステータスコード409に対応します。

次の表に、一般的なエラーコードを示します。