edit-icon download-icon

インストール

最終更新日: Mar 05, 2019

関連リソース:

環境要件

このバージョンの Python SDK は、Python 2.6,2.7,3.3,3.4、および 3.5 に適用されます。まず、Python の適切なバージョンをインストールするには、python official website の指示に従ってください。

Once Python is installed:

  • Linux シェルで Python のバージョンを確認する:

    1. $ python -V
    2. Python 2.7.10

    上記の情報が表示された場合は、Python 2.7.10 を正常にインストールしたことを意味します。

  • Windows CMD で Python のバージョンを確認する:

    1. C:\> python -V
    2. Python 2.7.10

    上記の情報が表示された場合は、Python 2.7.10 を正常にインストールしたことを意味します。システムが”内部または外部のコマンドではありません”とプロンプトを出す場合は、環境変数 > Path の設定を確認し、Python のインストールパスを追加します。

SDK をインストールする

  • Pip で SDK をインストールする

    1. pip install oss2

    注意:ご利用の環境に Pip がインストールされていない場合は、Pip official website を参照して Pip をインストールしてください。

  • を参照して Pip をインストールしてください。

    github から適切なバージョンの SDK パッケージをダウンロードし、パッケージを解凍して、setup.py ファイルがあるかどうかを確認しますディレクトリ:

    1. python setup.py install
  • 検証

コマンドラインにpythonを入力し、Enter を押して Python 環境で SDK のバージョンを確認してください:

  1. >>> import oss2
  2. >>> oss2.__version__
  3. '2.0.0'

上記の情報が表示されている場合は、指定したバージョンの Python SDK が正常にインストールされたことを意味します(ここではバージョン 2.0.0 が使用されています)

oss2ライブラリはcrcmod モジュールを使用してCRCを計算します。crcmod は、oss2 のインストール時に自動的にインストールされます。crcmod で CRC を計算するには、C extension modePython-only modeの 2 つの方法があります。C 拡張モードのパフォーマンスは、Python 専用モードよりも優れています。詳細は、crcmod introduction を参照してください。

crcmod C 拡張モードが正常にインストールされているかどうかを確認するには、コマンドラインにpython と入力して Enterを押します(Python 環境では、 import crcmod._crcfunextと入力して Enterを押します)。

  • ImportError の場合:crcmod._crcfunext というプロンプトが表示され、C 拡張モジュールが正常にインストールされていないことを示します。次に、CRC を計算するために Python 専用モードが使用されます。

    1. >>> import crcmod._crcfunext
    2. Traceback (most recent call last):
    3. File "<stdin>", line 1, in <module>
    4. ImportError: No module named crcmod._crcfunext
  • import crcmod._crcfunext を入力して Enter を押すと例外が報告されない場合は、C 拡張モードが正常にインストールされ、C 拡張モードが CRC の計算に使用されていることを示します。

crcmod C 拡張モードが正常にインストールされていない場合は、CRC データ検証を無効にすることをお勧めします。機能を無効にする方法の詳細については、初期化を参照してください。

SDK をアンインストールする

Pip を使用して SDK をアンインストールすることを推奨します。

  1. pip uninstall oss2

サンプルプロジェクト

Python SDK のサンプルコードは examples ディレクトリの下にあります。

GitHub

サンプルには次の内容が含まれています。

サンプルファイル サンプル内容
object_basic.py アップロードダウンロードリスト削除などのオブジェクト関連の基本的な使い方を示します。
object_extra.py 中国語Object MetaCopy ObjectAppend Upload などのオブジェクト関連の高度な使い方を示します。
upload.py 再開可能アップロードやマルチパートアップロードのようなObject Uploadの高度な使い方を説明します。
download.py オブジェクトのダウンロード、範囲別のダウンロード、再開可能なダウンロードなど、Object Downloadの使い方をデモします。
object_check.py MD5やCRCを含む、アップロード/ダウンロード中のデータ検証の使い方を示します。
object_progress.py アップロードプログレスバーとダウンロードプログレスバーを含むプログレスバー機能の使用方法を説明します。
object_callback.py コールバックのアップロードの使用方法をデモします。
object_post.py PostObjectの使い方をデモします。PostObject 実装は Python SDK に依存しません。
sts.py 役割をデモするための一時的なユーザーキーを取得し、一時的なユーザーキーを使用して OSS にアクセスすることを含むSTSの使用方法を示します。
image.py Image Serviceの使い方をデモします。
bucket.py バケット操作と管理の使い方 、例えば、作成、削除、及びバケットを表示する方法を示します。

以前のバージョン

このバージョンの Python SDK は、以前のバージョン 0.4.2 と互換性がなく、コマンドラインツール OSSCMD を含んでいません。

以前のバージョンの Python SDK と OSSCMD をダウンロードするには、こちらをクリックしてください。