Oracle Cloud Infrastructureドキュメント

オブジェクトの管理

Oracle Cloud Infrastructure Object Storageサービスでは、オブジェクトは、Object Storage namespace内のコンパートメント内のバケットにアップロードするファイルまたは非構造化データです。 オブジェクトには、マルチメディア・ファイル、データ・バックアップ、静的Webコンテンツ、ログなど、任意のタイプのデータを使用できます。 最大10個のTiBのオブジェクトを格納することができます。 オブジェクトは単一のエンティティとして処理されます。 オブジェクトへのデータの編集や追加はできませんが、オブジェクト全体を置き換えることはできます。

このトピックでは、単一バケット内でオブジェクトを管理する方法について説明します。 オブジェクトを別のバケットにコピーする方法の詳細は、「オブジェクトのコピー」を参照してください。

ヒント

オブジェクトのサイズによって、Oracle Cloud Infrastructure Object Storageにオブジェクトをアップロードするために使用する適切な管理インタフェースが決まります:

  • コンソールを使用して、最大2 GiBのサイズのオブジェクトをアップロードできます。
  • CLIまたはAPIを使用して、最大10個のTiBオブジェクトをアップロードできます。
  • マルチパート・アップロードAPIを使用して、100 MiB (推奨)を超えるオブジェクトをアップロードすることができます。 詳細については、「マルチパート・アップロードの使用」を参照してください。

必要なIAMポリシー

Oracle Cloud Infrastructureを使用するには、管理者が作成するポリシーで、コンソールまたはSDK、CLIまたはその他のツールを使用したREST APIのどちらを使用しているかにかかわらず、必要なタイプのアクセスを付与する必要があります。 アクションを実行しようとしたときに、権限のないメッセージや権限のないメッセージを取得する場合は、管理者に付与されているアクセスのタイプと作業するコンパートメントを確認してください。

新しいポリシーの場合は、「ポリシーの開始」「共通ポリシー」を参照してください。

ヒント

事前認証されたリクエスト

事前認証されたリクエストは、ユーザーが独自の資格証明を持たずにバケットまたはオブジェクトにアクセスできるようにします。 たとえば、ユーザーがAPIキーを所有せずにバケットにバックアップをアップロードできるようにするリクエストを作成できます。 詳細については、「事前認証されたリクエストの使用」を参照してください。

オブジェクト名

他のリソースとは異なり、オブジェクトにはOracle Cloud識別子(OCID)がありません。 代わりに、ユーザーはオブジェクトをアップロードするときにオブジェクト名を定義します。

オブジェクトに名前を付けるときは、次のガイドラインを使用してください:

  • 1〜1024文字で使用します。
  • 有効な文字は、改行、改行、およびNULL以外の文字(大文字または小文字)、数字、および文字です。
  • UTF-8エンコーディングが1024バイトを超えないUnicode文字のみを使用してください。 クライアントはURLエンコーディング文字を処理します。
  • 機密情報は含めないでください。
  • バケット内で一意の名前にします。 既存のオブジェクトを新しいオブジェクトまたは名前を変更したオブジェクトの内容で上書きする場合を除き、オブジェクトに名前を付けるときは、バケット内の既存のオブジェクトの名前を使用しないでください。

Object Storageは、オブジェクト名にObject Storageネームスペース文字列とバケット名を付加します:

/n/<object_storage_namespace>/b/<bucket>/o/<object_name>

オブジェクト名は/o/の後のすべてです。

例: /n/ansh8lvru1zp/b/accessories/o/backpack_75.jpg

ヒント

オブジェクト名には、/o/区切り文字に続く名前文字列に1つ以上のスラッシュ(/)文字を含めることができます。
オブジェクト名にスラッシュを使用して階層を作成する方法については、「プレフィクスと階層を使用したオブジェクトの命名」を参照してください。

プレフィクスと階層を使用したオブジェクトの命名

Object Storageネームスペース内では、バケットとオブジェクトはフラット階層に存在しますが、オブジェクト名に階層を追加するためにスラッシュ(/)を含むプレフィクス文字列を使用してディレクトリ構造をシミュレートできます。 そうすることで、一度に1つのディレクトリをリストすることができます。これは、多数のオブジェクトをナビゲートする際に役立ちます。

次に例を示します。

/n/ansh8tvru7zp/b/event_photos/o/marathon/finish_line.jpg

/n/ansh8tvru7zp/b/event_photos/o/marathon/participants/p_21.jpg

Object Storage内に階層として存在するようにオブジェクトの名前を指定した場合、Command Line Interface (CLI)を使用して、指定レベルの階層にあるすべてのオブジェクトの一括ダウンロードと一括削除を実行できます。以下。 上記の例では、marathon/participants/サブ・レベルでオブジェクトをダウンロードまたは削除せずに、CLIを使用してmarathon/レベルのすべてのオブジェクトをダウンロードまたは削除できます。

オブジェクトに名前を付けるときには、区切り文字なしでプレフィクス文字列を使用することもできます。これにより、オブジェクト名のプレフィクス部分を照合することで特定のバルク操作をCLIで実行できるようになります。 たとえば、以下のオブジェクト名では、文字列gloves_27_は、バルクのダウンロードまたは削除を実行する際の一致のためのプレフィクスとして機能します:

/n/ansh8tvru7zp/b/apparel/o/gloves_27_dark_green.jpg
/n/ansh8tvru7zp/b/apparel/o/gloves_27_light_blue.jpg
        

CLIを使用して一括アップロードを実行する場合は、アップロードするファイルの名前の前にプレフィクス文字列を付けることができます。

オブジェクト・ライフサイクル管理

オブジェクト・ライフサイクル管理機能を使用すると、事前定義済のスケジュールに従ってオブジェクトのアーカイブおよび削除を自動的に管理できます。 この機能の詳細は、「オブジェクト・ライフサイクル管理の使用」を参照してください。

マルチパートのアップロードとダウンロード

Oracle Cloud Infrastructure Object Storageサービスは、オブジェクトのマルチパートのアップロードとダウンロードをサポートします。 マルチパート・アップロードの詳細については、「マルチパート・アップロードの使用」トピックを参照してください。 このページには、この機能のAPIドキュメントへのリンクが含まれています。 マルチパートのダウンロードについては、CLIの手順「マルチパート・ダウンロードを使用してオブジェクトをダウンロードするには」を参照してください。 マルチパートのダウンロードに関するAPIドキュメントについては、GetObject API呼び出しとそのrangeパラメータを参照してください。

リソースのモニター

Oracle Cloud Infrastructureリソースのヘルス、容量、およびパフォーマンスをモニターするには、メトリック、アラーム、および通知を使用します。 詳細は、「Monitoring概要」および「Notifications概要」を参照してください。

オブジェクトのモニターの詳細は、「Object Storageメトリック」を参照してください。

Storage Gatewayを使用したオブジェクトのアップロードおよびダウンロード

Storage Gatewayは、Oracle Cloud Infrastructure Object Storageからオブジェクトをアップロードしてダウンロードする別の方法です。

Storage Gatewayは、Oracle Cloud Infrastructureコンピュート・インスタンスに、またはオンプレミス・データセンター内の1つ以上のホスト上にLinux Dockerインスタンスとしてインストールされます。 オブジェクト対応アプリケーションは、Oracle Cloud Infrastructure Object StorageからStorage Gatewayに作成する「ファイル・システム」まで、オブジェクトを格納および取得します。 Storage Gatewayは、NFSv4クライアントをサポートする任意のホストにマウントできるNFSマウント・ポイントを公開します。 Storage Gatewayマウント・ポイントは、オブジェクトをアップロードおよびダウンロードするためにObject Storageバケットにマップされます。

詳細については、「Storage Gatewayの概要」を参照してください。

コンソールを使用した場合

オブジェクトをバケットにアップロードするには
バケットからオブジェクトをダウンロードするには
オブジェクトの詳細を表示するには
オブジェクトの名前を変更する手順
Archive Storageからオブジェクトをリストアするには
Archive Storageオブジェクト・リストアのステータスを確認するには
オブジェクトをバケットから削除するには

コマンド・ライン・インタフェース(CLI)の使用

CLIの使用方法については、「コマンド・ライン・インタフェース(CLI)」を参照してください。 CLIコマンドで使用可能なフラグおよびオプションの完全なリストについては、「CLIヘルプ」を参照してください。

オブジェクトをバケットに表示するには
オブジェクトの詳細を取得するには
オブジェクトをバケットにアップロードするには
オブジェクトをバケットに一括アップロードするには
バケットからオブジェクトをダウンロードするには
マルチパート・ダウンロードを使用してオブジェクトをダウンロードするには
バケット内のすべてのオブジェクトを一括ダウンロードするには
オブジェクト名プレフィクス文字列でオブジェクトを一括ダウンロードするには
指定された階層レベルでオブジェクトを一括ダウンロードするには
オブジェクトの名前を変更する手順
Archive Storage層オブジェクトをリストアするには
Archive Storageオブジェクト・リストアのステータスを確認するには
オブジェクトを削除するには
バケット内のすべてのオブジェクトを一括で削除するには
オブジェクト名プレフィクス文字列でオブジェクトを一括削除するには
指定した階層レベルでオブジェクトを一括削除するには

APIの使用

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

オブジェクトを管理するには、次の操作を使用します: