アクセスポイントを作成すると、Object Storage Service (OSS) はアクセスポイントのエイリアスを自動的に生成します。アクセスポイントのエイリアスを使用して、アクセスポイントに関連付けられているデータにアクセスできます。
前提条件
アクセスポイントが作成されていること。 詳細については、「アクセスポイントの作成」をご参照ください。
OSS SDK の使用
OSS SDK for Java V3.16.3 以降および OSS SDK for Python V2.18.0 以降でのみ、アクセスポイントエイリアスを使用して OSS からデータをダウンロードできます。
Java
// アクセスポイントのネットワークソースがインターネットの場合、バケットのパブリックエンドポイントまたは内部エンドポイントを使用できます。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// アクセスポイントのネットワークソースが VPC の場合、バケットの内部エンドポイントを使用する必要があります。
// String endpoint = "https://oss-cn-hangzhou-internal.aliyuncs.com";
// アクセスポイントエイリアスを指定します。
String bucketName = "ap-01-d571827a1e2ed76490899a8a922262****-ossalias";Python
# アクセスポイントのネットワークソースがインターネットの場合、バケットのパブリックエンドポイントまたは内部エンドポイントを使用できます。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# アクセスポイントのネットワークソースが VPC の場合、バケットの内部エンドポイントを使用する必要があります。
# endpoint = "https://oss-cn-hangzhou-internal.aliyuncs.com"
# アクセスポイントエイリアスを指定します。
bucket_name = "ap-01-d571827a1e2ed76490899a8a922262****-ossalias"ossutil の使用
ossutil を使用してアクセスポイントエイリアスでバケット内のデータにアクセスする場合、アクセスポイントエイリアスはバケット名として機能します。次のサンプルコマンドは、アクセスポイントエイリアスを使用して OSS のデータにアクセスする方法の例を示しています。
ossutil cp oss://ap-01-d571827a1e2ed76490899a8a922262****-ossalias/demo.txt /Users/demo/Desktop/demo.txt一般的なコマンドの詳細については、「一般的なコマンド」をご参照ください。
RESTful API の使用
API 操作とアクセスポイントエイリアスを使用してバケット内のリソースをリクエストする場合、Host ヘッダーにアクセスポイントエイリアスを含める必要があります。次のサンプルリクエストは、アクセスポイントエイリアスを使用して OSS のデータにアクセスする方法の例を示しています。
GET /ObjectName HTTP/1.1
Host: ap-01-9387d8ec9e23cb25320effffd78374****-ossalias.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueアクセスポイントエイリアスと互換性のある操作
アクセスポイントエイリアスを使用して、次の操作を呼び出すことができます。
API 操作 | 説明 |
アクセスポイントポリシーを設定します。 | |
アクセスポイントポリシーの設定をクエリします。 | |
アクセスポイントポリシーを削除します。 | |
バケット内のすべてのオブジェクトを一覧表示します。 | |
オブジェクトをアップロードします。 | |
オブジェクトをクエリします。 | |
オブジェクトをコピーします。 | |
追加アップロードを使用してオブジェクトをアップロードします。 | |
オブジェクトを削除します。 | |
一度に複数のオブジェクトを削除します。 | |
オブジェクトのコンテンツを返さずに、オブジェクトのすべてのメタデータをクエリします。 | |
オブジェクトのコンテンツを返さずに、ETag、Size、LastModified などのオブジェクトのメタデータをクエリします。 | |
HTML フォームを使用してオブジェクトをアップロードします。 | |
アーカイブ、コールドアーカイブ、およびディープコールドアーカイブオブジェクトを復元します。 | |
オブジェクトに対して SQL ステートメントを実行し、実行結果をクエリします。 | |
マルチパートアップロードタスクを開始します。 | |
指定されたオブジェクト名とアップロード ID に基づいて、パートごとにオブジェクトをアップロードします。 | |
UploadPart リクエストに x-oss-copy-source リクエストヘッダーを追加して、既存のオブジェクトからデータをコピーしてパートをアップロードします。 | |
アップロードされたすべてのパートを単一のオブジェクトに結合して、マルチパートアップロードタスクを完了します。 | |
マルチパートアップロードタスクをキャンセルし、アップロードされたパートを削除します。 | |
開始されたが完了またはキャンセルされていないタスクを含む、進行中のすべてのマルチパートアップロードタスクを一覧表示します。 | |
指定されたアップロード ID を持つマルチパートアップロードタスクによってアップロードされたすべてのパートを一覧表示します。 | |
オブジェクトの ACL を設定します。 | |
オブジェクトの ACL をクエリします。 | |
シンボリックリンクを作成します。 | |
シンボリックリンクをクエリします。 | |
オブジェクトのタグを設定または更新します。 | |
オブジェクトのタグをクエリします。 | |
オブジェクトのタグを削除します。 |