すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:アクセスポイントを使用する

最終更新日:Apr 08, 2024

アクセスポイントを作成すると、Object Storage Service (OSS) はアクセスポイントのエイリアスを自動的に生成します。 アクセスポイントのエイリアスを使用して、アクセスポイントが関連付けられているデータにアクセスできます。

前提条件

アクセスポイントが作成されます。 詳細については、「アクセスポイントの作成」をご参照ください。

OSS SDKの使用

アクセスポイントのエイリアスを使用してOSSからデータをダウンロードできるのは、Java V3.16.3以降のOSS SDKとPython V2.18.0以降のOSS SDKのみです。

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
ホスト: ap-01-9387d8ec9e23cb25320effffd78374 **** -ossalias.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

アクセスポイントのエイリアス互換操作

アクセスポイントのエイリアスを使用して、次の操作を呼び出すことができます。

API操作

説明

PutAccessPointPolicy

アクセスポイントポリシーを設定します。

GetAccessPointPolicy

アクセスポイントポリシーの設定を照会します。

DeleteAccessPointPolicy

アクセスポイントポリシーを削除します。

ListObjects (GetBucket)

バケット内のすべてのオブジェクトを一覧表示します。

ListObjectsV2 (GetBucketV2)

PutObject

オブジェクトをアップロード

GetObject

オブジェクトを照会します。

CopyObject

オブジェクトをコピーします。

AppendObject

追加アップロードを使用してオブジェクトをアップロードします。

DeleteObject

オブジェクトを削除します。

DeleteMultipleObjects

一度に複数のオブジェクトを削除します。

HeadObject

オブジェクトのコンテンツを返さずに、オブジェクトのすべてのメタデータを照会します。

GetObjectMeta

オブジェクトのコンテンツを返さずに、ETag、Size、LastModifiedなど、オブジェクトの一部のメタデータを照会します。

PostObject

HTMLフォームを使用してオブジェクトをアップロードします。

RestoreObject

アーカイブ、コールドアーカイブ、およびDeep Cold Archiveオブジェクトを復元します。

SelectObject

オブジェクトに対してSQL文を実行し、実行結果を照会します。

InitiateMultipartUpload

マルチパートアップロードタスクを開始します。

UploadPart

指定されたオブジェクト名とアップロードIDに基づいて、オブジェクトをパーツごとにアップロードします。

UploadPartCopy

x-oss-copy-sourceリクエストヘッダーをUploadPartリクエストに追加して、既存のオブジェクトからデータをコピーしてパーツをアップロードします。

CompleteMultipartUpload

アップロードされたすべてのパーツを1つのオブジェクトに結合して、マルチパートアップロードタスクを完了します。

AbortMultipartUpload

マルチパートアップロードタスクをキャンセルし、アップロードしたパーツを削除します。

ListMultipartUploads

開始されたが完了またはキャンセルされていないタスクを含む、進行中のすべてのマルチパートアップロードタスクを一覧表示します。

リストパーツ

指定されたアップロードIDを持つマルチパートアップロードタスクによってアップロードされたすべてのパーツを一覧表示します。

PutObjectACL

オブジェクトのACLを設定します。

GetObjectACL

オブジェクトのACLを照会します。

PutSymlink

Creates a symbolic link.

GetSymlink

シンボリックリンクを照会します。

PutObjectTagging

オブジェクトのタグを構成または更新します。

GetObjectTagging

オブジェクトのタグを照会します。

DeleteObjectTagging

オブジェクトのタグを削除します。