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

Object Storage Service:リクエスト元支払い (PHP SDK V2)

最終更新日:Nov 09, 2025

リクエスト元支払いモードでは、バケットからデータを読み取る際に発生するトラフィック料金とリクエスト料金はリクエスタが支払いますが、バケットの所有者はストレージ料金のみを支払います。この機能をバケットで有効にすると、バケットへのアクセス時に発生するリクエストやトラフィックの料金を負担することなく、データを共有できます。

使用上の注意

  • このトピックのサンプルコードでは、例として中国 (杭州) リージョンのリージョン ID cn-hangzhou を使用します。デフォルトでは、パブリックエンドポイントが使用されます。同じリージョン内の他の Alibaba Cloud プロダクトから OSS にアクセスする場合は、内部エンドポイントを使用します。OSS リージョンとエンドポイント間のマッピングの詳細については、「リージョンとエンドポイント」をご参照ください。

  • リクエスト元支払いモードを設定するには、oss:PutBucketRequestPayment 権限が必要です。リクエスト元支払いモードをクエリするには、oss:GetBucketRequestPayment 権限が必要です。詳細については、「RAM ユーザーにカスタムアクセスポリシーをアタッチする」をご参照ください。

サンプルコード

リクエスト元支払いモードの設定

次のサンプルコードを使用して、リクエスト元支払いモードを設定できます。

<?php

require_once __DIR__ . '/../vendor/autoload.php'; // 依存ライブラリをロードするためにオートローダーファイルをインポートします。

use AlibabaCloud\Oss\V2 as Oss;

// コマンドライン引数の説明を定義します。
$optsdesc = [
    "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // バケットが配置されているリージョン。このパラメーターは必須です。例: oss-cn-hangzhou。
    "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // 他のサービスが OSS にアクセスするために使用できるエンドポイント。このパラメーターはオプションです。
    "bucket" => ['help' => 'The name of the bucket', 'required' => True], // バケットの名前。このパラメーターは必須です。
];
$longopts = \array_map(function ($key) {
    return "$key:"; // 各パラメーターの後にコロン (:) を追加して、値が必要であることを示します。
}, array_keys($optsdesc));

// コマンドライン引数を解析します。
$options = getopt("", $longopts); 

// 必須の引数が欠落していないか確認します。
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help'];
        echo "Error: the following arguments are required: --$key, $help"; // 必須の引数が欠落していることをユーザーに通知します。
        exit(1); 
    }
}

// コマンドライン引数の値を取得します。
$region = $options["region"]; // バケットが配置されているリージョン。
$bucket = $options["bucket"]; // バケットの名前。

// 環境変数から認証情報 (AccessKeyId と AccessKeySecret) をロードします。
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider(); 

// SDK のデフォルト構成を使用します。
$cfg = Oss\Config::loadDefault(); // SDK のデフォルト構成をロードします。
$cfg->setCredentialsProvider($credentialsProvider); // 認証情報プロバイダーを設定します。
$cfg->setRegion($region); // リージョンを設定します。
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]); // エンドポイントが指定されている場合は、エンドポイントを設定します。
}

// OSS クライアントインスタンスを作成します。
$client = new Oss\Client($cfg); 

// バケットリクエストの支払方法を設定するためのリクエストオブジェクトを作成します。
$request = new Oss\Models\PutBucketRequestPaymentRequest(
    $bucket,
    new Oss\Models\RequestPaymentConfiguration('Requester') 
);

// putBucketRequestPayment メソッドを呼び出して、バケットリクエストの支払方法を設定します。
$result = $client->putBucketRequestPayment($request); 

// 結果を出力します。
printf(
    'status code:' . $result->statusCode . PHP_EOL . // HTTP 応答の状態コード。
    'request id:' . $result->requestId // リクエストの一意の ID。
);

リクエスト元支払い構成のクエリ

次のサンプルコードを使用して、リクエスト元支払い構成をクエリできます。

<?php

require_once __DIR__ . '/../vendor/autoload.php'; // 依存ライブラリをロードするためにオートローダーファイルをインポートします。

use AlibabaCloud\Oss\V2 as Oss;

// コマンドライン引数の説明を定義します。
$optsdesc = [
    "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // バケットが配置されているリージョン。このパラメーターは必須です。例: oss-cn-hangzhou。
    "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // 他のサービスが OSS にアクセスするために使用できるエンドポイント。このパラメーターはオプションです。
    "bucket" => ['help' => 'The name of the bucket', 'required' => True], // バケットの名前。このパラメーターは必須です。
];
$longopts = \array_map(function ($key) {
    return "$key:"; // 各パラメーターの後にコロン (:) を追加して、値が必要であることを示します。
}, array_keys($optsdesc));

// コマンドライン引数を解析します。
$options = getopt("", $longopts); 

// 必須の引数が欠落していないか確認します。
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help'];
        echo "Error: the following arguments are required: --$key, $help"; // 必須の引数が欠落していることをユーザーに通知します。
        exit(1); 
    }
}

// コマンドライン引数の値を取得します。
$region = $options["region"]; // バケットが配置されているリージョン。
$bucket = $options["bucket"]; // バケットの名前。

// 環境変数から認証情報 (AccessKeyId と AccessKeySecret) をロードします。
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider(); 

// SDK のデフォルト構成を使用します。
$cfg = Oss\Config::loadDefault(); // SDK のデフォルト構成をロードします。
$cfg->setCredentialsProvider($credentialsProvider); // 認証情報プロバイダーを設定します。
$cfg->setRegion($region); // リージョンを設定します。
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]); // エンドポイントが指定されている場合は、エンドポイントを設定します。
}

// OSS クライアントインスタンスを作成します。
$client = new Oss\Client($cfg); 

// バケットリクエストの支払方法をクエリするためのリクエストオブジェクトを作成します。
$request = new Oss\Models\GetBucketRequestPaymentRequest($bucket); 

// getBucketRequestPayment メソッドを呼び出して、バケットリクエストの支払方法をクエリします。
$result = $client->getBucketRequestPayment($request); 

// 結果を出力します。
printf(

    'status code:' . $result->statusCode . PHP_EOL . // HTTP 応答の状態コード。
    'request id:' . $result->requestId . PHP_EOL . // リクエストの一意の ID。
    'request payer:' . $result->requestPaymentConfiguration->payer // 返されたリクエストの支払方法 (BucketOwner または Requester)。
);

関連情報

  • リクエスト元支払いモードを設定するための完全なサンプルコードについては、「GitHub サンプル」をご参照ください。

  • リクエスト元支払いモードを設定するための API 操作の詳細については、「PutBucketRequestPayment」をご参照ください。

  • リクエスト元支払い構成をクエリするための完全なサンプルコードについては、「GitHub サンプル」をご参照ください。

  • リクエスト元支払い構成をクエリするための API 操作の詳細については、「GetBucketRequestPayment」をご参照ください。