Object Storage Service:バケットのデフォルトドメイン名にカスタムドメイン名をマップする

ステップ 1: カスタムドメイン名をマップする

カスタムドメイン名をバケットにマップするプロセスは、ドメインレジストラと所有アカウントによって異なります。Alibaba Cloud WHOIS ページでドメインレジストラをクエリし、Alibaba Cloud DNS コンソールで関連付けられている所有アカウントを確認できます。

ステップ 2: カスタムドメイン名を確認する

カスタムドメイン名をバケットにマップすると、カスタムドメイン名を使用して行われたリクエストはすべて、DNS を介してバケットのデフォルトドメイン名に解決されます。カスタムドメイン名の DNS レコードを確認するには、nslookup コマンドまたは dig コマンドを実行できます。

nslookup -type=CNAME static.example.com

dig CNAME static.example.com

ステップ 3: カスタムドメイン名を使用する

カスタムドメイン名の DNS レコードが有効になったら、HTTP プロトコルとカスタムドメイン名を使用して URL を構築できます。これには、署名と有効期間が含まれます。URL 形式は http://YourDomain/ObjectName?SignatureInformation です。その後、URL を使用して OSS バケット内のオブジェクトにアクセスできます。

1. プレサイン URL を取得します。

   OSS コンソールを使用する

   1. OSS コンソール にログインします。

   2. 左側のナビゲーションウィンドウで、[バケット] をクリックします。[バケット] ページで、バケットの名前をクリックします。

   3. 左側のナビゲーションツリーで、ファイル > オブジェクト を選択します。

   4. [オブジェクト] ページで、オブジェクトの名前をクリックします。

   5. [詳細の表示] パネルで、[カスタムドメイン名] フィールドのバケットにマップされているカスタムドメイン名を選択し、その他のパラメータのデフォルト設定を保持してから、[オブジェクト URL をコピー] をクリックします。

      

   ossbrowser を使用する

   ossbrowser を使用して、OSS コンソールで実行できるのと同じオブジェクトレベルの操作を実行できます。ossbrowser の画面上の指示に従って、プレサイン URL を取得できます。ossbrowser のダウンロード方法については、「ossbrowser 1.0」をご参照ください。

   1. カスタムドメイン名を使用して ossbrowser にログインします。

   1. オブジェクトの URL を取得します。

   OSS SDK を使用する

   カスタムドメイン名を使用して OssClient インスタンスを作成し、プレサイン URL を生成できます。

   Java

   import com.aliyun.oss.*;
   import com.aliyun.oss.common.auth.*;
   import com.aliyun.oss.common.comm.SignVersion;
   
   import java.net.URL;
   import java.util.Date;
   
   public class Demo {
       public static void main(String[] args) throws Throwable {
           // カスタムドメイン名を指定します。例: static.example.com。
           String endpoint = "http://static.example.com";
           // エンドポイントにマップするリージョンの ID を指定します。例: cn-hangzhou。
           String region = "cn-hangzhou";
   
           // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、環境変数が構成されていることを確認してください。
           EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
   
           // OSSClient インスタンスを作成します。
           ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
           // このパラメータを true に設定して、CNAME を有効にします。
           clientBuilderConfiguration.setSupportCname(true);
           // V4 署名アルゴリズムの使用を明示的に宣言します
           clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
           OSS ossClient = OSSClientBuilder.create()
                   .endpoint(endpoint)
                   .credentialsProvider(credentialsProvider)
                   .clientConfiguration(clientBuilderConfiguration)
                   .region(region)
                   .build();
   
           try {
               // プレサイン URL の有効期間を指定します。単位: ミリ秒。この例では、有効期間は 1 時間に設定されています。
               Date expiration = new Date(new Date().getTime() + 3600 * 1000L);
               // HTTP GET リクエストを許可するプレサイン URL を生成します。この例では、追加のリクエストヘッダーは指定されていません。他のユーザーは、ブラウザを使用して関連コンテンツに直接アクセスできます。
               String bucketName = "examplebucket";
               String objectName = "demo.png";
               URL url = ossClient.generatePresignedUrl(bucketName, objectName, expiration);
               System.out.println(url);
           } catch (OSSException oe) {
               System.out.println("OSSException がキャッチされました。これは、リクエストが OSS に到達しましたが、"
                       + "何らかの理由でエラーレスポンスで拒否されたことを意味します。");
               System.out.println("エラーメッセージ:" + oe.getErrorMessage());
               System.out.println("エラーコード:" + oe.getErrorCode());
               System.out.println("リクエスト ID:" + oe.getRequestId());
               System.out.println("ホスト ID:" + oe.getHostId());
           } catch (ClientException ce) {
               System.out.println("ClientException がキャッチされました。これは、クライアントが OSS と通信しようとしているときに、"
                       + "ネットワークにアクセスできないなど、重大な内部問題が発生したことを意味します。");
               System.out.println("エラーメッセージ:" + ce.getMessage());
           } finally {
               if (ossClient != null) {
                   ossClient.shutdown();
               }
           }
       }
   }

   Python

   # -*- coding: utf-8 -*-
   import oss2
   from oss2.credentials import EnvironmentVariableCredentialsProvider
   
   # 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID 環境変数と OSS_ACCESS_KEY_SECRET 環境変数が構成されていることを確認してください。
   auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
   
   # バケットが配置されているリージョンを指定します。例: cn-hangzhou。V4 署名アルゴリズムを使用する場合は、このパラメータが必要です。
   region = "cn-hangzhou"
   
   # カスタムドメイン名 (例: static.example.com) を指定します。
   endpoint = 'http://static.example.com'
   
   # yourBucketName をバケットの名前に置き換えます。
   bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region, is_cname=True)
   
   
   # オブジェクトのフルパス (例: exampledir/exampleobject.txt) を指定します。オブジェクトのフルパスにバケット名を含めないでください。
   object_name = 'exampledir/exampleobject.txt'
   
   # オブジェクトをダウンロードするためのプレサイン URL を生成します。URL は 600 秒間有効です。
   # プレサイン URL が生成されると、OSS はオブジェクトのフルパスにあるスラッシュ (/) をエスケープ文字として識別します。その結果、生成されたプレサイン URL は直接使用できません。
   # slash_safe パラメータを True に設定します。このようにして、OSS はオブジェクトのフルパスにあるスラッシュ (/) をエスケープ文字として識別せず、プレサイン URL を直接使用できます。
   url = bucket.sign_url('GET', object_name, 600, slash_safe=True, params=params)
   print('プレサイン URL のアドレスは次のとおりです。', url)

   Node.js

   const OSS = require("ali-oss");
   
   // 署名付き URL を生成するために使用される関数を指定します。
   async function generateSignatureUrl(fileName) {
     // 署名付き URL を取得します。
     const client = await new OSS({
         // バケットにマップするカスタムドメイン名を指定します。
         endpoint: 'http://static.example.com', 
         // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID 環境変数と OSS_ACCESS_KEY_SECRET 環境変数が構成されていることを確認してください。
         accessKeyId: process.env.OSS_ACCESS_KEY_ID,
         accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
         bucket: 'examplebucket',
         // バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを oss-cn-hangzhou に設定します。
         region: 'oss-cn-hangzhou',
         authorizationV4: true,
         cname: true
     });
   
     return await client.signatureUrlV4('GET', 3600, {
         headers: {} // 実際のリクエストヘッダーに基づいてリクエストヘッダーを指定します。
     }, fileName);
   }
   // 関数を呼び出し、オブジェクトの名前を渡します。
   generateSignatureUrl('yourFileName').then(url => {
     console.log('生成された署名付き URL:', url);
   }).catch(err => {
     console.error('署名付き URL の生成エラー:', err);
   });

   PHP

   <?php
   if (is_file(__DIR__ . '/../autoload.php')) {
       require_once __DIR__ . '/../autoload.php';
   }
   if (is_file(__DIR__ . '/../vendor/autoload.php')) {
       require_once __DIR__ . '/../vendor/autoload.php';
   }
   
   use OSS\OssClient;
   use OSS\Core\OssException;
   use OSS\Http\RequestCore;
   use OSS\Http\ResponseCore;
   use OSS\Credentials\EnvironmentVariableCredentialsProvider;
   
   // 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID 環境変数と OSS_ACCESS_KEY_SECRET 環境変数が構成されていることを確認してください。
   $provider = new EnvironmentVariableCredentialsProvider();
   // バケットが配置されているリージョンのエンドポイントを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、エンドポイントを http://static.example.com に設定します。
   $endpoint = "http://static.example.com";
   // バケットの名前を指定します。
   $bucket= "examplebucket";
   // オブジェクトのフルパスを指定します。フルパスにバケット名を含めないでください。
   $object = "exampleobject.txt";
   // 署名付き URL の有効期間を 600 秒に設定します。最大値: 32400。
   $timeout = 600;
   try {
       $config = array(  
           "provider" => $provider,
           "endpoint" => $endpoint,
           'signatureVersion'=>OssClient::OSS_SIGNATURE_VERSION_V4,
           "cname"	=> true,
           "region"=> "cn-hangzhou"
       );
       $ossClient = new OssClient($config);
       // 署名付き URL を生成します。
       $signedUrl = $ossClient->signUrl($bucket, $object, $timeout, "GET");
       print_r($signedUrl);
   } catch (OssException $e) {
       printf(__FUNCTION__ . ": 失敗\n");
       printf($e->getMessage() . "\n");
       return;
   }

   Go

   package main
   
   import (
   	"context"
   	"flag"
   	"log"
   	"time"
   
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
   	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
   )
   
   // グローバル変数を定義します
   var (
   	region     string // バケットが配置されているリージョン。
   	bucketName string // バケットの名前。
   	objectName string // オブジェクトの名前。
   )
   
   // init 関数を使用してコマンドラインパラメータを初期化します
   func init() {
   	flag.StringVar(&region, "region", "", "バケットが配置されているリージョン。")
   	flag.StringVar(&bucketName, "bucket", "", "バケットの名前。")
   	flag.StringVar(&objectName, "object", "", "オブジェクトの名前。")
   }
   
   func main() {
   	// コマンドラインパラメータを解析します
   	flag.Parse()
   
   	// バケット名が空かどうかを確認します
   	if len(bucketName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("無効なパラメータ、バケット名が必要です")
   	}
   
   	// リージョンが空かどうかを確認します
   	if len(region) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("無効なパラメータ、リージョンが必要です")
   	}
   
   	// オブジェクト名が空かどうかを確認します
   	if len(objectName) == 0 {
   		flag.PrintDefaults()
   		log.Fatalf("無効なパラメータ、オブジェクト名が必要です")
   	}
   
   	// デフォルトの構成を読み込み、認証情報プロバイダとリージョンを指定します
   	cfg := oss.LoadDefaultConfig().
   		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
   		WithRegion(region).
   		WithEndpoint("http://static.example.com").
   		WithUseCName(true)
   
   	// OSS クライアントを作成します
   	client := oss.NewClient(cfg)
   
   	// GetObject リクエストの署名付き URL を生成します
   	result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
   		Bucket: oss.Ptr(bucketName),
   		Key:    oss.Ptr(objectName),
   		//RequestPayer: oss.Ptr("requester"), // リクエスタの ID を指定します
   	},
   		oss.PresignExpires(10*time.Minute),
   	)
   	if err != nil {
   		log.Fatalf("オブジェクトのプレサインの取得に失敗しました %v", err)
   	}
   
   	log.Printf("リクエストメソッド: %v\n", result.Method)
   	log.Printf("リクエストの有効期限: %v\n", result.Expiration)
   	log.Printf("リクエスト URL: %v\n", result.URL)
   	if len(result.SignedHeaders) > 0 {
   		// レスポンス結果に署名付きヘッダーが含まれている場合は、署名付き URL を使用して HTTP GET リクエストを送信するときに、対応するリクエストヘッダーを含める必要があります。これにより、リクエストの失敗や署名エラーの原因となる可能性のある不整合を回避できます。
   		log.Printf("署名付きヘッダー:\n")
   		for k, v := range result.SignedHeaders {
   			log.Printf("%v: %v\n", k, v)
   		}
   	}
   }

   ossutil を使用する

   presign コマンドを実行して、カスタムドメイン名を使用してオブジェクトのプレサイン URL を生成します。

   ossutil presign oss://examplebucket/exampleobject.txt --endpoint "http://static.example.com” --addressing-style "cname"

   ossutil コマンドがカスタムドメイン名を毎回手動で指定する代わりに自動的に使用できるようにするには、カスタムドメイン名を 構成ファイル に追加します。

2. ブラウザでプレサイン URL にアクセスします。