Object Storage Service:アクセスポイントによる OSS へのアクセス

特定のアクセスポイント

1. バケット一覧 に移動し、対象のバケット名をクリックします。

2. 左側のナビゲーションウィンドウで、アクセスの制御 > バケットポリシー を選択し、構文でルールを追加 タブをクリックします。

3. 編集 をクリックし、エディターに JSON 形式で権限付与ポリシーを入力します。

   説明

   ポリシーを構成する際は、例に含まれる UID、バケット名、リージョン ID、およびアクセスポイント名を実際の値に置き換えてください。バケットポリシーにすでに文が含まれている場合は、このルールを Statement 配列に追加します。

   {
     "Version": "1",
     "Statement": [{
       "Effect": "Allow",
       "Action": [
         "oss:*"
       ],
       "Principal": [
         "*"
       ],
       "Resource": [
         "acs:oss:*:179882766168****:example-bucket",
         "acs:oss:*:179882766168****:example-bucket/*"
       ],
       "Condition": {
         "StringEquals": {
           "oss:DataAccessPointArn": [
             "acs:oss:oss-{region-id}:179882766168****:accesspoint/{ap-name}"
           ]
         }
       }
     }]
   }

4. 保存 をクリックして、バケットポリシーを適用します。

すべてのアクセスポイント

1. バケット一覧 に移動し、対象のバケット名をクリックします。

2. 左側のナビゲーションウィンドウで、アクセスの制御 > バケットポリシー を選択し、構文でルールを追加 タブをクリックします。

3. 編集 をクリックし、エディターに JSON 形式で権限付与ポリシーを入力します。

   説明

   ポリシーを構成する際は、例に含まれる UID およびバケット名を実際の値に置き換えてください。バケットポリシーにすでに文が含まれている場合は、このルールを Statement 配列に追加します。

   {
     "Version": "1",
     "Statement": [{
       "Effect": "Allow",
       "Action": [
         "oss:*"
       ],
       "Principal": [
         "*"
       ],
       "Resource": [
         "acs:oss:*:179882766168****:example-bucket",
         "acs:oss:*:179882766168****:example-bucket/*"
       ],
       "Condition": {
         "StringEquals": {
           "oss:DataAccessPointAccount": [
             "179882766168****"
           ]
         }
       }
     }]
   }

4. 保存 をクリックして、バケットポリシーを適用します。

ネットワークオリジン別

1. バケット一覧 に移動し、対象のバケット名をクリックします。

2. 左側のナビゲーションウィンドウで、アクセスの制御 > バケットポリシー を選択し、構文でルールを追加 タブをクリックします。

3. 編集 をクリックし、エディターに JSON 形式で権限付与ポリシーを入力します。

   説明

   • ポリシーを構成する際は、例に含まれる UID およびバケット名を実際の値に置き換えてください。バケットポリシーにすでに文が含まれている場合は、このルールを Statement 配列に追加します。

   • oss:AccessPointNetworkOrigin を internet に設定すると、ネットワークオリジンがインターネットであるすべてのアクセスポイントに対して権限が委譲されます。この構成では、インターネットおよび VPC の両方からのアクセスが許可されます。VPC からのアクセスのみを許可するには、値を vpc に変更してください。

   {
     "Version": "1",
     "Statement": [{
       "Effect": "Allow",
       "Action": [
         "oss:*"
       ],
       "Principal": [
         "*"
       ],
       "Resource": [
         "acs:oss:*:179882766168****:example-bucket",
         "acs:oss:*:179882766168****:example-bucket/*"
       ],
       "Condition": {
         "StringEquals": {
           "oss:AccessPointNetworkOrigin": [
             "internet"
           ]
         }
       }
     }]
   }

4. 保存 をクリックして、バケットポリシーを適用します。

SDK

現在、OSS リソースにアクセスポイントエイリアスを使用してアクセスできるのは、Java SDK および Python SDK のみです。

import com.aliyun.sdk.service.oss2.OSSClient;
import com.aliyun.sdk.service.oss2.credentials.CredentialsProvider;
import com.aliyun.sdk.service.oss2.credentials.StaticCredentialsProvider;
import com.aliyun.sdk.service.oss2.models.GetObjectRequest;

import java.io.File;

/**
 * OSS Java SDK V2 例：アクセスポイントを使用してオブジェクトをローカルファイルにダウンロードします。
 */
public class DownloadObjectWithAccessPoint {

    public static void main(String[] args) {
        // OSS クライアントを作成します。
        String accessKeyId = System.getenv("OSS_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("OSS_ACCESS_KEY_SECRET");
        CredentialsProvider provider = new StaticCredentialsProvider(accessKeyId, accessKeySecret);
        OSSClient client = OSSClient.newBuilder()
                .credentialsProvider(provider)
                .region("<region-id>")
                .build();

        // アクセスポイントエイリアスを使用して、オブジェクトをローカルファイルにダウンロードします。
        String bucket = "example-ap-b156d01070a10322664d6704cd1d47****-ossalias";
        String key = "example.jpg";
        File file = new File("example.jpg");
        client.getObjectToFile(GetObjectRequest.newBuilder()
                .bucket(bucket)
                .key(key)
                .build(), file);
        System.out.println("Download complete: " + key + " -> " + file.getPath());

        // クライアントを閉じます。
        try {
            client.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""OSS Python SDK V2 例：アクセスポイントを使用してオブジェクトをローカルファイルにダウンロードします。"""

import alibabacloud_oss_v2 as oss


def main() -> None:
    """メイン関数"""
    # OSS クライアントを作成します。
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
    config = oss.config.load_default()
    config.credentials_provider = credentials_provider
    config.region = "<region-id>"
    config.endpoint = "oss-<region-id>.aliyuncs.com"
    client = oss.Client(config)

    # アクセスポイントエイリアスを使用して、オブジェクトをローカルファイルにダウンロードします。
    bucket = "example-ap-b156d01070a10322664d6704cd1d47****-ossalias"
    key = "example.jpg"
    file_path = "example.jpg"
    request = oss.GetObjectRequest(bucket, key)
    client.get_object_to_file(request, file_path)
    print(f"Download complete: {key} -> {file_path}")


if __name__ == "__main__":
    main()

ossutil

ossutil を使用して OSS リソースにアクセスする場合は、バケット名としてアクセスポイントエイリアスを使用します。

ossutil cp oss://example-ap-b156d01070a10322664d6704cd1d47****-ossalias/example.jpg /tmp

REST API

REST API を使用して OSS リソースにアクセスする場合は、Host ヘッダーにアクセスポイントエイリアスを使用します。以下にリクエスト例を示します。

GET /ObjectName HTTP/1.1
Host: example-ap-b156d01070a10322664d6704cd1d47****-ossalias.oss-{region-id}.aliyuncs.com 
Date: GMT Date
Authorization: SignatureValue

ap-01：読み取り専用アクセス

{
  "Version": "1",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "oss:GetObject",
      "oss:GetObjectAcl",
      "oss:ListObjects",
      "oss:RestoreObject",
      "oss:ListObjectVersions",
      "oss:GetObjectVersion",
      "oss:GetObjectVersionAcl",
      "oss:RestoreObjectVersion"
    ],
    "Principal": [
      "26571698800555****"
    ],
    "Resource": [
      "acs:oss:{region-id}:137918634953****:accesspoint/ap-01/object/dir1/*"
    ]
  },{
    "Effect": "Allow",
    "Action": [
      "oss:ListObjects",
      "oss:GetObject"
    ],
    "Principal": [
      "26571698800555****"
    ],
    "Resource": [
      "acs:oss:{region-id}:137918634953****:accesspoint/ap-01"
    ],
    "Condition": {
      "StringLike": {
        "oss:Prefix": [
          "dir1/*"
        ]
      }
    }
  }]
}

ap-02：読み取り/書き込みアクセス

{
  "Version": "1",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "oss:GetObject",
      "oss:PutObject",
      "oss:GetObjectAcl",
      "oss:PutObjectAcl",
      "oss:ListObjects",
      "oss:AbortMultipartUpload",
      "oss:ListParts",
      "oss:RestoreObject",
      "oss:ListObjectVersions",
      "oss:GetObjectVersion",
      "oss:GetObjectVersionAcl",
      "oss:RestoreObjectVersion"
    ],
    "Principal": [
      "25770968794578****"
    ],
    "Resource": [
      "acs:oss:{region-id}:137918634953****:accesspoint/ap-02/object/*"
    ]
  },{
    "Effect": "Allow",
    "Action": [
      "oss:ListObjects",
      "oss:GetObject"
    ],
    "Principal": [
      "25770968794578****"
    ],
    "Resource": [
      "acs:oss:{region-id}:137918634953****:accesspoint/ap-02"
    ],
    "Condition": {
      "StringLike": {
        "oss:Prefix": [
          "*"
        ]
      }
    }
  }]
}

ap-03：VPC 読み取り/書き込みアクセス

{
  "Version": "1",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "oss:GetObject",
      "oss:PutObject",
      "oss:GetObjectAcl",
      "oss:PutObjectAcl",
      "oss:ListObjects",
      "oss:AbortMultipartUpload",
      "oss:ListParts",
      "oss:RestoreObject",
      "oss:ListObjectVersions",
      "oss:GetObjectVersion",
      "oss:GetObjectVersionAcl",
      "oss:RestoreObjectVersion"
    ],
    "Principal": [
      "26806658794579****"
    ],
    "Resource": [
      "acs:oss:{region-id}:137918634953****:accesspoint/ap-03/object/dir2/*"
    ]
  },{
    "Effect": "Allow",
    "Action": [
      "oss:ListObjects",
      "oss:GetObject"
    ],
    "Principal": [
      "26806658794579****"
    ],
    "Resource": [
      "acs:oss:{region-id}:137918634953****:accesspoint/ap-03"
    ],
    "Condition": {
      "StringLike": {
        "oss:Prefix": [
          "dir2/*"
        ]
      }
    }
  }]
}

統一委譲

{
  "Version": "1",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "oss:*"
    ],
    "Principal": [
      "*"
    ],
    "Resource": [
      "acs:oss:*:137918634953****:examplebucket",
      "acs:oss:*:137918634953****:examplebucket/*"
    ],
    "Condition": {
      "StringEquals": {
        "oss:DataAccessPointAccount": [
          "137918634953****"
        ]
      }
    }
  }]
}

個別委譲

{
  "Version": "1",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "oss:*"
    ],
    "Principal": [
      "*"
    ],
    "Resource": [
      "acs:oss:*:137918634953****:examplebucket",
      "acs:oss:*:137918634953****:examplebucket/*"
    ],
    "Condition": {
      "StringEquals": {
        "oss:DataAccessPointArn": [
          "acs:oss:oss-{region-id}:137918634953****:accesspoint/ap-01",
          "acs:oss:oss-{region-id}:137918634953****:accesspoint/ap-02",
          "acs:oss:oss-{region-id}:137918634953****:accesspoint/ap-03"
        ]
      }
    }
  }]
}