Oracle Cloud Infrastructureドキュメント

マルチパート・アップロードの実行

Compute Cloud@Customerでは、複数のパートでオブジェクトをアップロードできます。

マルチパート・アップロードでは、オブジェクトの個々の部分を並行してアップロードしてアップロードに費やす時間を短縮できます。

マルチパート・アップロードは、単一のアップロード操作に対して大きすぎるオブジェクトに対応します。オブジェクト・パートは50 GiB以下である必要があります。

個々のパートのアップロードを一時停止し、スケジュールとリソースで許可されたらアップロードを再開できます。

オブジェクト・パーツ

マルチパート・アップロードでは、アップロードするオブジェクトを個々のパートに分割します。個々のパートは、50 GiB程度の大きさにすることができます。アップロードされるオブジェクトの最大サイズは10 TiBです。

各パートに使用するパート番号を決定します。パート番号は1から10,000の範囲です。連続した番号を割り当てる必要はありませんが、Object Storageは、パート番号を昇順に並べることでオブジェクトを構築します。

マルチパート・アップロードAPI

マルチパート・アップロードAPIを使用する前に、アップロードするパートを作成する必要があります。オブジェクト・ストレージは、残りのステップのAPI操作を提供します。

APIを使用して実行されるマルチパート・アップロードは、次のステップで構成されます:

  1. アップロードを開始します。

  2. オブジェクト・パートをアップロードします。

  3. アップロードをコミットします。

また、サービスでは、進行中のマルチパート・アップロードのリスト表示、進行中のマルチパート・アップロードのオブジェクト・パートのリスト表示、およびAPIを介して開始された進行中のマルチパート・アップロードの中断を行うためのAPI操作も提供します。

マルチパート・アップロードCLI

CLIを使用してマルチパート・アップロードを実行する場合、APIで行う必要があるため、オブジェクトをパートに分割する必要はありません。かわりに、選択したパートのサイズを指定すると、オブジェクト・ストレージでは、オブジェクトがパートに分割され、すべてのパートのアップロードが自動的に実行されます。並行してアップロードできるパートの最大数を設定できます。デフォルトでは、CLIは、並行してアップロードできるパートの数を3つに制限しています。CLIを使用する場合、アップロードの完了時にコミットを実行する必要はありません。

また、CLIを使用して、進行中のマルチパート・アップロードをリストし、APIを介して開始されたマルチパート・アップロードを取り消すこともできます。

  • このタスクはコンソールでは使用できません。

  • oci os object putコマンドと必要なパラメータを使用して、オブジェクトを複数のパートにアップロードします。

    構文:

    oci os object put --namespace-name <object_storage_namespace> --bucket-name <bucket_name> --file <file_location> --parallel-upload-count <maximum_number_parallel_uploads> --part-size <upload_part_size_in_MB> --force [OPTIONS]

    例:

    oci os object put   \
--namespace-name examplenamespace  \
--file /boot/initramfs-0-rescue-e542c19f0fbf4e41a41428d933a7357f.img   \
--parallel-upload-count 5   \
--part-size 15   \
--force

Upload ID: a21bba2c-8922-4b9c-a98a-9ef3569c0138
Split file into 6 parts for upload.
Uploading object [####################################] 100%
{
  "etag": "0964effc8dc4394fd317f03a025ae5d0",
  "last-modified": "2021-05-11T21:35:19",
  "opc-multipart-md5": "UIVRhiwSHY6o0E4pi/yfGg==-6"
}

    CLIコマンド、フラグおよびオプションの完全なリストは、コマンドライン・リファレンスを参照してください。

  • APIを使用して実行されるマルチパート・アップロードは、次のステップで構成されます:

    1. アップロードを開始します。
    2. オブジェクト・パーツをアップロードしています。
    3. アップローをコミットしています。

    マルチパート・アップロードAPIを使用する前に、アップロードするパートを作成する責任があります。オブジェクト・ストレージは、残りのステップのAPI操作を提供します。また、サービスでは、進行中のマルチパート・アップロードのリスト表示、進行中のマルチパート・アップロードのオブジェクト・パートのリスト表示、およびAPIを介して開始された進行中のマルチパート・アップロードの中断を行うためのAPI操作も提供します。

    ノート

    これらのマルチパート・アップロードAPI要件は、CLIには適用されません。

    複数パート・アップロードAPIの使用方法の詳細は、マルチパート・アップロードAPIの使用方法を参照してください。

    PutObject操作を使用して、オブジェクトを複数のパートにアップロードします。

    APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKについては、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。