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で行う必要があるときにオブジェクトをパートに分割する必要はありません。かわりに、選択したパートのサイズを指定すると、Object Storageはオブジェクトをパートに分割し、すべてのパートのアップロードを自動的に実行します。パラレルにアップロードできるパートの最大数を設定できます。デフォルトでは、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については、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。