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

手順1: カスタムドメイン名のマッピング

カスタムドメイン名をバケットにマッピングする手順は、所有者アカウントとドメインレジストラによって異なります。

手順2: ドメイン名マッピングの確認

カスタムドメイン名をバケットのデフォルトドメイン名にマッピングした後、nslookupまたはdigコマンドを実行して、ドメイン解決が有効かどうかを確認できます。 CNAMEがバケットのパブリックドメイン名であることを出力が示す場合、CNAMEレコードが有効になります。

nslookup -type=CNAME static.example.com

dig CNAME static.example.com

手順3: カスタムドメイン名を使用してバケットにアクセスする

ドメインマッピングが有効になったら、カスタムドメイン名を使用してHTTP経由でバケット内のオブジェクトにアクセスできます。

1. バケットにオブジェクトを 1 つアップロードします。

   詳細は、｢簡易アップロード (Simple upload)」をご参照ください。

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

   一時オブジェクトURLの取得

   オブジェクトの一時URLを取得するには、次の手順を実行します。

   1. オブジェクトのアクセス制御リスト (ACL) をprivateに設定します。

      詳細については、「オブジェクトACL」をご参照ください。

   2. プライベートオブジェクトのURLの形式は、http:// YourDomain/ObjectName? 署名パラメーターです。 次のいずれかの方法を使用して、プライベートオブジェクトURLを取得し、URLの有効期間を指定できます。

   OSS コンソールの使用

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

   2. 左側のナビゲーションウィンドウで、[バケット] をクリックします。 [バケット] ページで、プライベートオブジェクトが保存されているバケットの名前をクリックします。

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

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

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

      

   ossbrowser の使用

   ossbrowserを使用して、OSSコンソールで実行できるのと同じオブジェクトレベルの操作を実行できます。 ossbrowserの画面上の指示に従って、署名付きURLを取得できます。

   OSS SDKの使用

   1. カスタムドメイン名を使用してOSSClientインスタンスを作成します。

   Java

   // Specify a custom domain name. 
   String endpoint = "yourEndpoint";
   
   // Obtain access credentials from environment variables. Before you run the sample code, make sure that the environment variables are configured. 
   EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
   
   // Create ClientBuilderConfiguration and change the default values of the parameters based on your business requirements. 
   ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
   
   // Specify whether to use CNAME. CNAME is used to map the custom domain name to the bucket. 
   conf.setSupportCname(true);
   
   // Create an OSSClient instance. 
   OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider, conf);
   
   // Shut down the OSSClient instance. 
   ossClient.shutdown();                    

   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\Credentials\EnvironmentVariableCredentialsProvider;
   use OSS\OssClient;
   use OSS\CoreOssException;
   
   // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.  
   $provider = new EnvironmentVariableCredentialsProvider();
   // Specify the custom domain name. Example: http://example.com. 
   $endpoint = "http://example.com";
   
   try {
       $config = array(
           "provider" => $provider,
           "endpoint" => $endpoint,
           "cname"	=> true
       );
       $ossClient = new OssClient($config);    
   } catch (OssException $e) {
       print $e->getMessage();
   }    
                   

   Node.js

   const OSS = require('ali-oss')
   
   const client = new OSS({
     // Use a custom domain name as the endpoint of a bucket to access the bucket. 
     endpoint: 'http://img.example.com', 
     // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
     accessKeyId: process.env.OSS_ACCESS_KEY_ID,
     accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
     authorizationV4: true,
     // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
     region: 'yourRegion',
     cname: true
   });

   Python

   # -*- coding: utf-8 -*-
   import oss2
   from oss2.credentials import EnvironmentVariableCredentialsProvider
   
   # Obtain access credentials from environment variables. Before you run the sample code, make sure that the environment variables are configured. 
   auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
   
   # Specify the custom domain name that is mapped to the bucket. Example: example.com. 
   cname = 'http://example.com'
   
   # Specify the name of the bucket and set is_cname to True to enable CNAME. CNAME is used to map a custom domain name to a bucket. 
   bucket = oss2.Bucket(auth, cname, 'examplebucket', is_cname=True)   

   Browser.js

   <!DOCTYPE html>
   <html lang="en">
     <head>
       <meta charset="UTF-8" />
       <meta name="viewport" content="width=device-width, initial-scale=1.0" />
       <title>Document</title>
       <script src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"></script>
     </head>
     <body>
       <script>
         const client = new OSS({
           // Enter a custom domain name. Example: example.com. 
           // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to oss-cn-hangzhou.
           region: 'yourRegion',
           endpoint: "example.com",
           authorizationV4: true,
           // Specify the temporary AccessKey pair obtained from Security Token Service (STS). The AccessKey pair consists of an AccessKey ID and an AccessKey secret. 
           accessKeyId: "yourAccessKeyId",
           accessKeySecret: "yourAccessKeySecret",
           // Specify the security token obtained from STS. 
           stsToken: 'yourSecurityToken',
           // Specify the name of the bucket. Example: examplebucket. 
           bucket: "examplebucket",
           cname: true,
         });    
             
       </script>
     </body>
   </html>
   

   .NET

   using Aliyun.OSS;
   using Aliyun.OSS.Common;
   // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
   var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
   var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
   // Specify the custom domain name. 
   const string endpoint = "yourDomain";
   
   // Create a ClientConfiguration instance and modify the default parameters based on your requirements. 
   var conf = new ClientConfiguration();
   
   // Specify that a CNAME can be used as an endpoint to create the OssClient instance. A CNAME record specifies the mapping relationship between a custom domain name and a bucket. 
   conf.IsCname = true;
   
   // Create an OSSClient instance. 
   var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);                    

   Android

   // Specify the custom domain name. 
   String endpoint = "yourEndpoint";
   // Specify the temporary AccessKey pair obtained from STS. 
   String accessKeyId = "yourAccessKeyId";
   String accessKeySecret = "yourAccessKeySecret";
   // Specify the security token obtained from STS. 
   String securityToken = "yourSecurityToken";
   // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou.
   String region = "yourRegion";
   
   OSSCredentialProvider credentialProvider = new OSSStsTokenCredentialProvider(accessKeyId, accessKeySecret, securityToken);
   ClientConfiguration config = new ClientConfiguration();
   config.setSignVersion(SignVersion.V4);
   // Create an OSSClient instance. 
   OSSClient oss = new OSSClient(getApplicationContext(), endpoint, credentialProvider);
   oss.setRegion(region);

   Go

   package main
   
   import (
   	"log"
   
   	"github.com/aliyun/aliyun-oss-go-sdk/oss"
   )
   
   // Call handleError to handle unrecoverable errors and terminate the program after recording the error messages.
   func handleError(err error) {
   	log.Fatalf("Error: %v", err)
   }
   
   // Use setupClient to create and configure an OSSClient instance and use CNAME as an endpoint.
   // Parameters:
   //
   //	endpoint: the custom domain name that you want to map to the bucket.
   //
   // Return the created OSSClient instance.
   func setupClient(endpoint string) (*oss.Client, error) {
   	// Obtain access credentials from environment variables.
   	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
   	if err != nil {
   		return nil, err
   	}
   
   	// Create an OSSClient instance and use CNAME as an endpoint.
   	// Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou. Specify the actual region.
   	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
   	clientOptions = append(clientOptions, oss.Region("yourRegion"))
   	clientOptions = append(clientOptions, oss.UseCname(true))
   	// Specify the version of the signature algorithm.
   	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
   	client, err := oss.New(endpoint, "", "", clientOptions...)
   	if err != nil {
   		return nil, err
   	}
   
   	return client, nil
   }
   
   func main() {
   	// Specify the endpoint of the region in which the bucket is located.
   	// Example: custom-domain-for-your-bucket.com.
   	endpoint := "yourEndpoint"
   
   	// Check whether the environment variables are configured.
   	if endpoint == "" {
   		log.Fatal("Please set yourEndpoint.")
   	}
   
   	// Create and configure an OSSClient instance and use CNAME as an endpoint.
   	client, err := setupClient(endpoint)
   	if err != nil {
   		handleError(err)
   	}
   
   	// Display the client information.
   	log.Printf("Client: %#v\n", client)
   }
   

   iOS

   // Specify a custom domain name. 
   NSString *endpoint = @"yourEndpoint";
   // Specify the temporary AccessKey pair obtained from STS. An AccessKey pair consists of an AccessKey ID and an AccessKey secret. 
   NSString *accessKeyId = @"yourAccessKeyId";
   NSString *accessKeySecret = @"yourAccessKeySecret";
   // Specify the security token obtained from STS. 
   NSString *securityToken = @"yourSecurityToken";
   
   id<OSSCredentialProvider> credentialProvider = [[OSSStsTokenCredentialProvider alloc] initWithAccessKeyId:accessKeyId secretKeyId:accessKeySecret securityToken:securityToken];
   OSSClient *client = [[OSSClient alloc] initWithEndpoint:endpoint credentialProvider:credentialProvider];

   C++

   #include <alibabacloud/oss/OssClient.h>
   using namespace AlibabaCloud::OSS;
   
   int main(void)
   {
       /* Initialize the information about the account that is used to access OSS. */
               
       /* Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. */
       std::string Endpoint = "yourEndpoint";
       
       /* Initialize resources, such as network resources. */
       InitializeSdk();
   
       ClientConfiguration conf;
       /* Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. */
       auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
       OssClient client(Endpoint, credentialsProvider, conf);   
   
       /* Release resources, such as network resources. */
       ShutdownSdk();
       return 0;
   }

   C

   #include "oss_api.h"
   #include "aos_http_io.h"
   # Specify the custom domain name. */
   const char *endpoint = "yourCustomEndpoint";
   
   void init_options(oss_request_options_t *options) {
       options->config = oss_config_create(options->pool);
       /* Use a char* string to initialize aos_string_t. */
       aos_str_set(&options->config->endpoint, endpoint);
       /* Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. */  
       aos_str_set(&options->config->access_key_id, getenv("OSS_ACCESS_KEY_ID"));
       aos_str_set(&options->config->access_key_secret, getenv("OSS_ACCESS_KEY_SECRET"));
       /* Enable CNAME and map the custom domain name to your bucket. */
       options->config->is_cname = 1;
       options->ctl = aos_http_controller_create(options->pool, 0);
   }
   int main() {
       aos_pool_t *p;
       oss_request_options_t *options;
       /* Initialize global variables. You need to initialize global variables only once in the program lifecycle. */
       if (aos_http_io_initialize(NULL, 0) != AOSE_OK) {
           return -1;
       }
       /* Initialize the memory pool and options. */
       aos_pool_create(&p, NULL);
       options = oss_request_options_create(p);
       init_options(options);
       /* The logic code. In this example, the logic code is omitted. */
       /* Release the memory pool. This operation releases the memory resources allocated for the request. */
       aos_pool_destroy(p);
       /* Release global resources that are allocated. You need to release global resources only once in the program lifecycle. */
       aos_http_io_deinitialize();
       return 0;
   }

   Ruby

   require 'aliyun/oss'
   
   client = Aliyun::OSS::Client.new(
     # Specify the custom domain name that you want to map to the bucket. 
     endpoint: 'http://example.com',
     # Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
     access_key_id: ENV['OSS_ACCESS_KEY_ID'],
     access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
     cname: true)
   )

   2. OSSClientインスタンスを使用してGeneratePresignedUrl操作を呼び出し、オブジェクトの署名付きURLを取得します。

      URLにV1署名を含める

   ossutil の使用

   1. ossutilの設定

   2. サイン

   永続オブジェクトURLの取得

   警告

   有効期限が切れない永続オブジェクトURLを取得するには、オブジェクトのACLをpublic-readに設定します。 オブジェクトのACLをpublic-readに設定すると、すべてのユーザーがインターネット経由でオブジェクトにアクセスできます。これにより、データリークやOSSの高額な請求が発生する可能性があります。 一時的なURLを使用することを推奨します。

   オブジェクトの永続URLを取得するには、次の手順を実行します。

   1. オブジェクトのACLをpublic-readに設定します。

      オブジェクトACL

   2. カスタムドメイン名とオブジェクト名を連結してオブジェクトURLを生成します。

      パブリック読み取りオブジェクトのURLに署名情報を含める必要はありません。 パブリック読み取りオブジェクトのURLの形式は、http:// YourDomainName/ObjectNameです。

      たとえば、中国 (杭州) リージョンのexamplebucketバケットにexample.jpgオブジェクトが含まれており、o static.example.comにマップされている場合、オブジェクトのURLが https://static.example.com/example.jpg されます。

3. オブジェクトURLを使用して、ブラウザからオブジェクトにアクセスします。