Object Storage Classicへのアクセス
トピック:
- Webコンソールを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
- REST APIを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
- Oracle Cloud Infrastructure Object Storage ClassicリソースのREST URLについて
- Javaライブラリを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
- Oracle Cloud Infrastructure Storage Software Applianceを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
- File Transfer Manager APIを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
- FTM CLIを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
- 一時URLを使用したOracle Cloud Infrastructure Object Storage Classicでのオブジェクトへのアクセス
Webコンソールを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
このトピックはOracle Cloud at Customerには適用されません。
- Oracle Cloudアカウントにサインインします。
Oracle Cloudにサインインしたときにページの上部にInfrastructure Classicが表示される場合、「Infrastructure Classicコンソール」を使用してサービスにアクセスしており、サブスクリプションで「インフラストラクチャ・コンソール」へのアクセスがサポートされていません。 「Oracle Cloudスタート・ガイド」の「あなたのクラウド・アカウントにサインイン」を参照してください。
「インフラストラクチャ・コンソール」からサービスにアクセスできる場合は、Oracle Cloud Infrastructureドキュメントの「コンソールへのサインイン」に関する項を参照してください。
- 「Infrastructure Classicコンソール」と「インフラストラクチャ・コンソール」のどちらを使用しているかに応じて、次のいずれかの方法でサービスにアクセスできます。
- 「Infrastructure Classicコンソール」を使用している場合は、ナビゲーション・メニューでStorage Classicをクリックします。
- 「インフラストラクチャ・コンソール」を使用している場合は、ナビゲーション・メニューの「Oracle Cloud Servicesの追加」で「クラシック・インフラストラクチャ・サービス」をポイントし、Storage Classicをクリックします。
Oracle Cloud Infrastructure Object Storage Classicコンソールが表示されます。
REST APIを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
REST APIには、HTTP(Hypertext Transfer Protocol)を正しく理解し、インターネットに接続できるアプリケーションまたはプログラミング・プラットフォームからアクセスできます。 REST APIは、HTTPS、HTTPヘッダー、および特殊なHTTP動詞(PUT、DELETE)を介した安全な通信など、HTTPの高度なファセットを使用します。
これらの要件を満たすアプリケーションは、次のとおりです:
- cURL - cURLは、HTTPリクエストを送信してREST API呼び出しを呼び出すために使用できるコマンドライン・ツールです。
cURLを使用するには、http://curl.haxx.seを参照してください。
- Webブラウザ - サポートはベンダーによって異なります。 完全なサポートのためには、一部のブラウザ・プラグ・インが必要な場合があります。
多くのプログラミング・プラットフォーム(Java、Ruby、Perl、PHP、.NETなど)もこれらの要件を満たしていますが、完全サポートのためにサードパーティ・ライブラリを使用する必要があるものもあります。 ガイダンスについては、プログラミング・プラットフォームのマニュアルを参照してください。
Oracle Cloud Infrastructure Object Storage ClassicリソースのREST URLについて
Oracle Cloud Infrastructure Object Storage Classicインスタンス内のアカウント、コンテナ、およびオブジェクトは、RESTリソースとして表され、HTTPのユニフォーム・リソース・ロケータ(URL)を介してアクセスできます。
注意:
アカウントの作成時期によっては、アカウントに複数のREST APIエンドポイントURLがある場合があります。Oracle CloudアカウントのRESTエンドポイントURL形式
- Identity Cloud Serviceのクラウド・アカウント
- 従来のクラウド・アカウント(Cloud Serviceアカウントとも呼ばれます)
Oracle Cloudアカウントのタイプについて詳しくは、「Oracle Cloudアカウントのタイプ」を参照してください。
次の表は、Oracle Cloudアカウントの「RESTエンドポイントURL」形式について説明しています。
| アカウント・タイプ | 作成時 | RESTエンドポイントURLフォーマット |
|---|---|---|
|
Identity Cloud Serviceのクラウド・アカウント |
2017年11月以降 | 「Identity Cloud Serviceのクラウド・アカウントのRESTエンドポイントURLフォーマット(2017年11月以降に作成)」を参照してください。 |
| 2017年11月まで | 「Identity Cloud Serviceのクラウド・アカウントのRESTエンドポイントURL形式(2017年11月以前に作成)」を参照してください。 | |
|
従来のアカウント |
2017年11月以降 | 「従来のアカウントのRESTエンドポイントURL形式(2017年11月以降に作成)」を参照してください。 |
| 2017年11月まで | 「従来のアカウントのRESTエンドポイントURL形式(2017年11月以前に作成)」を参照してください。 |
サインイン資格証明を使用してアカウントにアクセスするには、「アカウントの詳細を使用する」を参照してください。
クラウド・アカウントのRESTエンドポイントURLの検索
RESTエンドポイントURLは、アカウントのURLでもあります。
Oracle Cloud Infrastructure Object Storage ClassicアカウントのRESTエンドポイントURLを見つけるには:
- Oracle Cloudアカウントにサインインします。
Oracle Cloudにサインインしたときにページの上部にInfrastructure Classicが表示される場合、「Infrastructure Classicコンソール」を使用してサービスにアクセスしており、サブスクリプションで「インフラストラクチャ・コンソール」へのアクセスがサポートされていません。 「Oracle Cloudスタート・ガイド」の「あなたのクラウド・アカウントにサインイン」を参照してください。
「インフラストラクチャ・コンソール」からサービスにアクセスできる場合は、Oracle Cloud Infrastructureドキュメントの「コンソールへのサインイン」に関する項を参照してください。
- 「インフラストラクチャ・コンソール」からサービスにアクセスできる場合は、次のステップを実行してRESTエンドポイントURLを取得します:
- ナビゲーション・メニューの「Oracle Cloud Servicesの追加」で、「クラシック・インフラストラクチャ・サービス」をポイントし、Storage Classicをクリックします。
Oracle Cloud Infrastructure Object Storage Classicコンソールが表示されます。
- 「アカウント」タブをクリックします。
- 「Restエンドポイント」フィールドに表示されるRestエンドポイントURLに注意してください。
- ナビゲーション・メニューの「Oracle Cloud Servicesの追加」で、「クラシック・インフラストラクチャ・サービス」をポイントし、Storage Classicをクリックします。
- 「Infrastructure Classicコンソール」からサービスにアクセスできる場合は、次のステップを実行してRESTエンドポイントURLおよび認証URLを取得します:
- ダッシュボードで、Storage Classicを探します。
- 「Actions」メニューから「View Details」を選択します。 または、「ダッシュボード」ページのStorage Classicリンクをクリックします。
表示されるページに、Oracle Cloud Infrastructure Object Storage Classicアカウントの詳細が表示されます。
- 2017年11月以前に作成されたアカウントの場合
URLは、「追加情報」セクションの下の「RESTエンドポイント」フィールドに表示されます。
- 2017年11月以降に作成されたアカウントの場合
「追加情報」セクションの下に、次のRESTエンドポイントURLが表示されます。
RESTエンドポイントURLタイプ 説明 いつ使う? 例 サービス永続的RESTエンドポイントURL このURLは、「RESTエンドポイント(永続的)」フィールドに表示されます。 このURLには、アカウントの自動生成されたGUIDが含まれ、アカウントのconstantが残ります。
このRESTエンドポイントURLを使用してください: - アカウント内のコンテナのレプリケーション・ポリシーを設定するには
「REST APIを使用したコンテナ固有のポリシーの設定」を参照してください。
- あらゆる状況下でURLがconstantのままであることを保証する。
たとえば、Storage Classicリソースに対する操作を実行するために、コード・スクリプト内の永続URLをハードコードすることができます。
https://storage-7b16fede61e1417ab83eb52e06f0e365.storage.oraclecloud.com/v1/Storage-7b16fede61e1417ab83eb52e06f0e365サービスに優しいRESTエンドポイントURL このURLは、「RESTエンドポイント」フィールドに表示されます。 注意:
Storage Classicアカウント名を変更すると、サービス・フレンドリなRESTエンドポイントURLと認証URLも変更されます。
適切な最新のURLを使用していることを確認してください。
このURLを使用して、Storage Classicリソース上の任意の操作を目的のインタフェース経由で実行します。 https://acme.storage.oraclecloud.com/v1/Storage-acme - アカウント内のコンテナのレプリケーション・ポリシーを設定するには
- 2017年11月以前に作成されたアカウントの場合
アカウントの詳細を使用する
アカウントにアクセスし、目的のインタフェースを使用して操作を実行するには、ログイン資格証明が必要です。
アカウントにサインアップすると、サインイン資格証明のウェルカム・メールが届きます。
次の例に示すように、サインイン資格証明を書き留めます。 
図new_account_information_email-2017.jpgの説明
ウェルカム・メールがない場合は、アカウント管理者にサインイン資格証明を問い合わせてください。
Identity Cloud Serviceのクラウド・アカウントのRESTエンドポイントURLフォーマット(2017年11月以降に作成)
- IDCS GUID
- アカウント名の条件
- ユーザー名
- IDCS GUID:
idcs-b75f75ed2528447fb59a798c1f08a38d - アカウント名:
acme - ユーザー名:
john.doe@example.com
| URL | 書式 |
|---|---|
|
RESTエンドポイントURL:
|
Oracle Cloud 「Infrastructure Classicコンソール」の「追加情報」の下にある次のフィールドをチェックインします。
|
|
認証URL |
Oracle Cloud 「Infrastructure Classicコンソール」の「追加情報」の下にある「Auth V1エンドポイント」内フィールドをチェックインします。
フォーマット:
注意: Oracle Cloud 「Infrastructure Classicコンソール」で認証URLが使用できない場合は、認証URLを構築する必要があります。 「Object Storage Classicへのアクセスの認証」を参照してください。 サンプル・アカウントの認証URL:
|
例: cURLコマンドと出力 - 上記のサンプル・クラウド・アカウントの認証トークン・リクエスト
cURLコマンド:
-
X-Storage-Userヘッダーのアカウント名を使用する:curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0出力:
-
ヘッダー
X-Storage-Userのサービス恒久RESTエンドポイントからのGUIDの使用:curl -v -X GET -H "X-Storage-User: Storage-7b16fede61e1417ab83eb52e06f0e365:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0
出力:
Identity Cloud Serviceのクラウド・アカウントのRESTエンドポイントURL形式(2017年11月以前に作成)
- IDCS GUID
- アカウント名の条件
- ユーザー名
- IDCS GUID:
idcs-b75f75ed2528447fb59a798c1f08a38d - アカウント名:
acme - ユーザー名:
john.doe@example.com
| URL | 書式 |
|---|---|
|
RESTエンドポイントURL |
Oracle Cloud 「Infrastructure Classicコンソール」の「追加情報」の下にある「RESTエンドポイント」内フィールドをチェックインします。
フォーマット:
RESTサンプル・アカウントのエンドポイントURL:
|
|
認証URL |
Oracle Cloud 「Infrastructure Classicコンソール」の「追加情報」の下にある「Auth V1エンドポイント」内フィールドをチェックインします。
フォーマット:
注意: 「Infrastructure Classicコンソール」で認証URLが使用できない場合は、認証URLを構築する必要があります。 「Object Storage Classicへのアクセスの認証」を参照してください。 サンプル・アカウントの認証URL:
|
例: cURLコマンドと出力 - 上記のサンプル・クラウド・アカウントの認証トークン・リクエスト
cURLコマンド:
curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0
出力:
従来のアカウントのRESTエンドポイントURL形式(2017年11月以降に作成)
- アイデンティティ・ドメイン
- アカウント名の条件
- ユーザー名
- アイデンティティ・ドメイン:
acme - アカウント名:
acme - ユーザー名:
john.doe@example.com
注意:
従来のアカウントでは、アイデンティティ・ドメイン名とアカウント名は同じです。| URL | 書式 |
|---|---|
|
RESTエンドポイントURL
|
「Infrastructure Classicコンソール」の「追加情報」の下にある次のフィールドをチェックインします。
|
|
認証URL |
「Infrastructure Classicコンソール」の「追加情報」の下にある「Auth V1エンドポイント」フィールドをチェックインします。
フォーマット:
注意: 「Infrastructure Classicコンソール」で認証URLが使用できない場合は、認証URLを構築する必要があります。 「Object Storage Classicへのアクセスの認証」を参照してください。 サンプル・アカウントの認証URL:
|
例: cURLコマンドと出力 - 上記のサンプルの従来のアカウントの認証トークン・リクエスト
cURLコマンド:
-
ヘッダー
X-Storage-Userにアイデンティティ・ドメイン名を使用する:curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0出力:
-
ヘッダー
X-Storage-Userのサービス恒久RESTエンドポイントからのGUIDの使用:curl -v -X GET -H "X-Storage-User: Storage-7b16fede61e1417ab83eb52e06f0e365:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0
出力:
従来のアカウントのRESTエンドポイントURL形式(2017年11月以前に作成)
- アイデンティティ・ドメイン
- アカウント名の条件
- ユーザー名
- アイデンティティ・ドメイン:
acme - アカウント名:
acme - ユーザー名:
john.doe@example.com
注意:
従来のアカウントでは、アイデンティティ・ドメイン名とアカウント名は同じです。| URL | 書式 |
|---|---|
|
RESTエンドポイントURL |
「Infrastructure Classicコンソール」の「追加情報」の下にある「RESTエンドポイント」フィールドをチェックインします。
フォーマット:
RESTサンプル・アカウントのエンドポイントURL:
|
|
認証URL |
「Infrastructure Classicコンソール」の「追加情報」の下にある「Auth V1エンドポイント」フィールドをチェックインします。
フォーマット:
注意: 「追加情報」で認証URLが利用できない場合は、認証URLを作成する必要があります。 「Object Storage Classicへのアクセスの認証」を参照してください。 サンプル・アカウントの認証URL:
|
例: cURLコマンドと出力 - 上記のサンプルの従来のアカウントの認証トークン・リクエスト
cURLコマンド:
curl -v -X GET -H "X-Storage-User: Storage-acme:john.doe@example.com" -H "X-Storage-Pass: Welcome1" http://acme.storage.oraclecloud.com/auth/v1.0
出力:
Javaライブラリを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
Javaライブラリは、REST APIを使用します。 このため、Javaライブラリもインターネット接続を必要とします。
Javaライブラリには、Java Runtime Environment (JRE)バージョン1.6以降が必要です。 Javaライブラリにはいくつかのランタイム依存Javaライブラリがあり、そのすべてがダウンロード可能なJava SDKに含まれます。
注意:
Java APIを使用してarchiveコンテナを作成することはできません。
独自のJavaアプリケーションでJavaライブラリを使用するには:
- Oracle Cloud Infrastructure Object Storage Classic Java SDKをダウンロード: http://www.oracle.com/technetwork/topics/cloud/downloads/cloud-service-java-sdk-2121032.html
- Javaライブラリのクラスおよびランタイム依存関係をJavaアプリケーションのクラス・パスのどこかに抽出します。
- JavaライブラリのクラスおよびインタフェースをJavaアプリケーションにインポートします。
Oracle Cloud Infrastructure Storage Software Applianceを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
Oracle Cloud Infrastructure Storage Software Applianceは、社内にインストールして、オンプレミスのアプリケーションとワークフローをOracle Cloud Infrastructure Object Storage Classicに簡単に接続するために使用できるツールです。
Oracle Cloud Infrastructure Storage Software Applianceを使用すると、アプリケーションはサービスへの直接REST APIコールを呼び出すことなく、標準のファイルベースのネットワーク・プロトコルを使用してOracle Cloud Infrastructure Object Storage Classicとやりとりできます。
Oracle Cloud Infrastructure Storage Software Applianceを使用してOracle Cloud Infrastructure Object Storage Classicアカウントで実行できるタスクの一覧については、「Object Storage Classicのインタフェースでサポートされているタスク」を参照してください。
File Transfer Manager APIを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
File Transfer Manager APIは、Oracle Cloud Infrastructure Object Storage Classic内のstandardおよびarchiveコンテナに、さまざまなサイズの個別および複数のオブジェクトをアップロードまたはダウンロードするためのシンプルなインタフェースを提供するJavaライブラリです。
- http://www.oracle.com/technetwork/topics/cloud/downloads/file-transfer-manager-2956858.htmlからSDKをダウンロードします。
- SDKを抽出し、Javaライブラリを
libsフォルダからJavaアプリケーションのクラス・パスに含めます。 - JavaのクラスおよびインタフェースをJavaアプリケーションにインポートします。 インポートする前に、SDKの
samplesフォルダにあるサンプル・コードを参照してください。
FTM CLIを使用したOracle Cloud Infrastructure Object Storage Classicへのアクセス
Oracle Cloud Infrastructure Object Storage Classic File Transfer Manager CLI (FTM CLI)は、Oracle Cloud Infrastructure Object Storage Classicのstandardおよびarchiveコンテナにオブジェクトをアップロードおよびダウンロードするために使用できるクロス・プラットフォームのJavaベースのコマンドライン・ツールです。
一時URLを使用したOracle Cloud Infrastructure Object Storage Classicでのオブジェクトへのアクセス
一時URLは、構成された期限を過ぎると期限切れになる、時間制限のあるURLです。 一時URLを作成すると、Oracle Cloud Infrastructure Object Storage Classicアカウントのオブジェクトなどの保護されたリソースに安全かつ一時的にアクセスできます。 Oracle Cloud Infrastructure Object Storage Classicにアクセスできないユーザーは、提供する一時URLを使用してサービスからオブジェクトをダウンロードできます。
一時URLを使用したオブジェクトのダウンロードを参照してください。