バケットのリージョンを照会する - Object Storage Service - Alibaba Cloud ドキュメントセンター

このトピックでは、バケットのリージョンを照会する方法について説明します。

使用上の注意

このトピックのサンプルコードでは、中国 (杭州) リージョンのリージョン ID cn-hangzhou を使用しています。デフォルトでは、パブリックエンドポイントを使用してバケット内のリソースにアクセスします。同じリージョン内の他の Alibaba Cloud サービスからバケット内のリソースにアクセスする場合は、内部エンドポイントを使用します。OSS でサポートされているリージョンとエンドポイントについては、「リージョンとエンドポイント」をご参照ください。
バケットが配置されているリージョンを照会するには、oss:GetBucketLocation 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

サンプルコード

次のサンプルコードは、バケットのリージョンを照会する方法の例を示しています。

<?php

require_once __DIR__ . '/../vendor/autoload.php'; // 依存ライブラリをロードするために、autoload ファイルを導入します。

use AlibabaCloud\Oss\V2 as Oss;

// コマンドラインパラメータの説明を定義します。
$optsdesc = [
    "region" => ['help' => 'バケットが配置されているリージョン。', 'required' => True], // バケットが配置されているリージョンは必須です。例: oss-cn-hangzhou。
    "endpoint" => ['help' => '他のサービスが OSS にアクセスするために使用できるドメイン名。', 'required' => False], // (オプション) バケットが配置されているリージョンのエンドポイント。
    "bucket" => ['help' => 'バケットの名前', '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"]; // バケットの名前。

// 環境変数を使用して AccessKey ID と AccessKey シークレットをロードします。
$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\GetBucketLocationRequest($bucket); 

// getBucketLocation メソッドを呼び出します。
$result = $client->getBucketLocation($request); 

// 結果を表示します。
printf(
    'status code:' . $result->statusCode . PHP_EOL . // HTTP ステータスコード。
    'request id:' . $result->requestId . PHP_EOL . // リクエストの一意の ID。
    'bucket location:' . var_export($result->location, true) // バケットが配置されているリージョン。
);

Object Storage Service:バケットのリージョンを照会する

使用上の注意

サンプルコード

関連情報