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

Object Storage Service:pay-by-requesterを有効にして、トラフィック、リクエスト、およびデータ処理に対してリクエスタに支払いを許可します

最終更新日:Feb 23, 2024

ほとんどの場合、バケットによって生成される料金を支払う必要があります。 ただし、バケットのpay-by-requesterを有効にして、認証された要求者がバケット内のデータにアクセスするときに生成される要求、データ処理、およびトラフィックに対して支払いを行うことができます。 ストレージ料金などのその他の料金のみを支払います。 pay-by-requesterを有効にして、追加料金なしでOSSでデータを共有できます。

シナリオ

  • 大きなデータセットを共有します。 たとえば、研究所は、郵便番号ディレクトリ、参照データ、地理空間情報、またはwebクロールデータを含むパブリックデータセットをOSSバケットにアップロードし、すべての顧客がデータセットにアクセスできるようにしたいと考えています。 さらに、研究所は、要求者がデータセットへのアクセスによって生成される要求とトラフィック料金を支払うことを望んでいます。

    このビジネス要件を満たすために、研究所はOSSで次の設定を構成できます。

    1. パブリックデータセットが保存されているバケットのアクセス制御リスト (ACL) をpublic-readに設定します。 詳細については、「バケットACL」をご参照ください。

    2. バケットのpay-by-requesterを有効にします。

  • 生産データを顧客またはパートナーに配信します。 たとえば、OSS内の本番データをパートナーがアクセスできるようにし、パートナーが本番データをダウンロードするときにリクエストとトラフィック料金を支払うようにしたいとします。

    このビジネス要件を満たすには、OSSで次の設定を構成します。

    1. 運用データが格納されているバケットのACLをprivateに設定します。 詳細については、「バケットACL」をご参照ください。

    2. バケットのpay-by-requesterを有効にします。

    3. バケットポリシーを使用して、バケット内の本番データにアクセスする権限をパートナーに付与します。 詳細については、「チュートリアル: バケットポリシーを追加して別のAlibaba CloudアカウントのRAMユーザーに権限を付与する」をご参照ください。

    重要

    バケット内の本番データにアクセスする権限をパートナーのRAMユーザーに付与してください。 要求者による支払いのために、Alibaba CloudアカウントのRAMユーザーのAccessKeyペアをパートナーと共有しないでください。 それ以外の場合、リクエスト者はAlibaba CloudアカウントのRAMユーザーを使用して本番データにアクセスするため、リクエスト料金とトラフィック料金が請求されます。

リクエスト方法

  • 匿名ユーザーからのリクエストは許可されません

    バケットのpay-by-requesterを有効にすると、匿名ユーザーはバケットにアクセスできません。 リクエスターは認証情報を提供する必要があります。 OSSは、指定された情報に基づいてリクエスタを識別できます。 このように、要求者は要求およびトラフィック料金を請求される。

    要求者がAlibaba CloudアカウントのRAMユーザーを使用してデータを要求する場合、RAMユーザーが属するAlibaba Cloudアカウントは、要求者から送信された要求と生成されたトラフィックに対して課金されます。

  • リクエストには、x-oss-request-payerヘッダーを含める必要があります。

    バケットのpay-by-requesterを有効にした場合、リクエスターはバケットへのリクエストにx-oss-request-payerヘッダーを指定し、ヘッダーの値をrequesterに設定する必要があります。 ヘッダーは、要求者が要求とトラフィックに対して課金されることを理解していることを示します。 それ以外の場合、リクエストは認証できません。

    バケット所有者は、バケットにアクセスするために送信されるリクエストにx-oss-request-payerヘッダーを含める必要はありません。 バケット所有者は、独自のリクエストと生成されたトラフィックに対して課金されます。

課金ルール

要求者による支払いが有効になっている場合、要求者は、要求内容に基づいて、次の請求可能項目の1つ以上に対して課金されます。API要求の数、インターネット上のアウトバウンドトラフィック、アウトバウンドオリジントラフィック、画像処理 (IMG) 、ビデオスナップショット、IAまたはアーカイブオブジェクトのデータ取得、および高度な画像圧縮。 バケット所有者は、オブジェクトストレージ、タグ、および転送アクセラレーションに対してのみ課金されます。 各課金可能アイテムの詳細については、「課金の概要」をご参照ください。

次のシナリオでは、pay-by-requesterが有効になっているバケットへのリクエストが失敗し、OSSがHTTPステータスコード403を返します。 バケット所有者はリクエストに対して課金されます。

  • POST、GET、またはHEADリクエストには、x-oss-request-payerヘッダーは含まれません。

  • リクエストの認証に失敗しました。

  • リクエストは匿名です。

手順

OSSコンソールの使用

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

  2. 左側のナビゲーションウィンドウで、バケットリスト をクリックします。 [バケット] ページで、目的のバケットを見つけてクリックします。

  3. 左側のナビゲーションツリーで、バケットの設定 > リクエスタ・ペイ を選択します。

  4. Pay-by-requester ページで、リクエスタ・ペイ をオンにします。

  5. 表示されるメッセージで、OK をクリックします。

    説明

    pay-by-requesterを無効にする場合は、リクエスタ・ペイ をオフにして、表示されるメッセージの OK をクリックします。

OSS SDKの使用

次のコードは、一般的なプログラミング言語のOSS SDKを使用して、バケットのpay-by-requesterを設定する方法の例を示しています。 他のプログラミング言語のOSS SDKを使用してバケットの従量課金リクエストを設定する方法の詳細については、「概要」をご参照ください。

com.aliyun.oss.OSSをインポートします。impor t com.aliyun.oss.com mon.auth.*;
com.aliyun.oss.OSSClientBuilderをインポートします。com.aliyun.oss.OSSExceptionをインポートします。com.aliyun.oss.mo delをインポートします。*;

public classデモ {
    public static void main(String[] args) throws Exception {
        // この例では、中国 (杭州) リージョンのエンドポイントが使用されます。 実際のエンドポイントを指定します。 
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // バケットの名前を指定します。 例: examplebucket. 
        String bucketName = "examplebucket";

        // Create an OSSClient instance. 
        OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);
        try {
            // バケットのpay-by-requesterを有効にします。 
            支払人支払人=支払人。リクエスター;
            ossClient.setBucketRequestPayment(bucketName, payer);
        } catch (Exception e) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "しかし、何らかの理由でエラー応答で拒否されました。");
            System.out.println("エラーメッセージ:" + oe.getErrorMessage());
            System.out.println("エラーコード:" + oe.getErrorCode());
            System.out.println("リクエストID:" + oe.getRequestId());
            System.out.println("ホストID:" + oe.getHostId());
        } catch (投げられるce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + 「ネットワークにアクセスできないなど」;
            System.out.println("エラーメッセージ:" + ce.getMessage());
        } 最後に{
            // Shut down the OSSClient instance. 
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
} 
<?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';
}

OSS\OssClientを使用します。OSS\Core\OssExceptionを使用します。// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数を指定していることを確認してください。 
$accessKeyId = getenv("OSS_ACCESS_KEY_ID");
$accessKeySecret = getenv("OSS_ACCESS_KEY_SECRET");
// この例では、中国 (杭州) リージョンのエンドポイントが使用されます。 実際のエンドポイントを指定します。 
$end point = "http://oss-cn-hangzhou.aliyuncs.com";
// バケットの名前を指定します。 例: examplebucket. 
$bucket= "examplebucket";

$ossClient = new OssClient($accessKeyId, $accessKeySecret, $end point, false);

try {
    // バケットのpay-by-requesterを有効にします。 
    $ossClient->putBucketRequestPayment($bucket、"Requester");
} catch (OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage()) 。 "\n");
    戻ります。}

print(__FUNCTION__) 。 ": OK" 。 "\n"); 
const OSS = require('ali-OSS ')

const client = new OSS({
  // バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンをoss-cn-Hangzhouに設定します。 
  region: 'yourregion' 、
  // 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、環境変数OSS_ACCESS_KEY_IDとOSS_ACCESS_KEY_SECRETが設定されていることを確認してください。 
  accessKeyId: process.env.OSS_ACCESS_KEY_ID、
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET
});

async関数setBucketRequestPayment(bucket, Payer) {
  try {
    // pay-by-requesterを有効にするバケットの名前を指定します。 
    // 支払人をリクエスターまたはBucketOwnerに設定します。 
    // PayerがRequesterに設定されている場合、pay-by-requesterはバケットに対して有効になります。 要求者は、要求者がバケット内のデータを読み取るときに生成されるトラフィックおよび要求料金を課金される。 
    // 支払人がBucketOwnerに設定されている場合、pay-by-requesterはバケットに対して無効になります。 これは、バケットのデフォルト設定です。 この場合、バケット所有者は生成されたリクエスト料金を請求されます。 
    const result = await client.putBucketRequestPayment(bucket, Payer);
    console.log (結果);
  } catch (e) {
    console.log(e);
  }
}

setBucketRequestPayment('bucketName', 'Requester')
# -*-コーディング: utf-8 -*-

oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
oss2.modelsからPAYER_BUCKETOWNER、PAYER_REQUESTERをインポート

# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 例: examplebucket. 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')

# バケットのpay-by-requesterを有効にします。 デフォルトのリクエスト支払いモードはPAYER_BUCKETOWNERです。 
result = bucket.put_bucket_request_payment(PAYER_REQUESTER)

Aliyun.OSSを使用した
Aliyun.OSS.Common; を使用

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
var endpoint = "yourEndpoint";
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。 
var bucketName = "examplebucket";

// OSSClientインスタンスを作成します。 
var client = new OssClient (エンドポイント、accessKeyId、accessKeySecret);
トライ
{
    // バケットのpay-by-requesterを有効にします。 
    var request = new SetBucketRequestPaymentRequest(bucketName, RequestPayer.Requester);
    client.SetBucketRequestPayment (リクエスト);
    Console.WriteLine("Set bucket:{0} RequestPayment succeed", bucketName);
}
キャッチ (OssException ex)
{
    Console.WriteLine("Failed with error code: {0}; エラー情報: {1} 。 \nRequestID:{2}\tHostID:{3}"、
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}
キャッチ (例外ex)
{
    Console.WriteLine("Failed with error info: {0}" 、メッセージなど);
} 
の印刷 ("http responstatus:", result.status) 
パッケージメイン

import (import (import)
"fmt"
"os"

「github.com/aliyun/aliyun-oss-go-sdk/oss」
)

func main() {
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// OSSClientインスタンスを作成します。 
	// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 実際のエンドポイントを指定します。 
	client, err := oss.New("yourEndpoint", ", " ", ", oss.SetCredentialsProvider(&provider))
if err! =nil {
fmt.Println("新しいエラー:", err)
os.Exit(-1)
}

// pay-by-requesterモードを初期化します。 
	reqPayConf := oss.RequestPaymentConfiguration {
支払人: "Requester" 、}

// バケットのpay-by-requesterを有効にします。 
	err = client.SetBucketRequestPayment("<yourBucketName>", reqPayConf)
if err! =nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
} 
#include <alibabacloud/oss/OssClient.h>
名前空間listaCloud::OSSを使用します。int main(void)
{
    /* OSSへのアクセスに使用されるアカウントに関する情報を初期化します。 */
    
    /* バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 */
    std::string Endpoint = "yourEndpoint";
    /* バケットの名前を指定します。 例: examplebucket. */
    std::string BucketName = "examplebucket";

    /* ネットワークリソースなどのリソースを初期化します。 */
    InitializeSdk();

    ClientConfiguration conf;
    /* 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClientクライアント (Endpoint, credentialsProvider, conf);

    /* バケットのpay-by-requesterを有効にします。 */
    SetBucketRequestPaymentRequestリクエスト (BucketName);
    request.setRequestPayer(RequestPayer::Requester);

    auto outcome = client.SetBucketRequestPayment(request);

    if (!outcome.isSuccess()) {
        /* 例外を処理します。 */
        std::cout << "SetBucketRequestPayment fail" <<
        ",code:" << outcome.error().Code() <<
        ",message:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }

    /* ネットワークリソースなどのリソースを解放します。 */
    ShutdownSdk();
    0を返します。} 

ossutilの使用

ossutilを使用してバケットのpay-by-requesterを設定する方法の詳細については、「request-payment (configure pay-by-requester) 」をご参照ください。

OSS RESTful APIの使用

プログラムにカスタムオプションが必要な場合は、RESTful API操作を呼び出すことができます。 RESTful APIを呼び出すには、コードに署名計算を含める必要があります。 詳細については、「PutBucketRequestPayment」をご参照ください。