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

Object Storage Service:バケットのタグ付け (PHP SDK V2)

最終更新日:Nov 09, 2025

このトピックでは、バケットのタグを管理する方法について説明します。

注意事項

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

サンプルコード

バケットのタグを設定する

次のサンプルコードを使用して、バケットにタグを設定できます。

<?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], // バケットが配置されているリージョン。この引数は必須です。
    "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"]; // バケットの名前。

// 環境変数を使用して、AccessKey ID と AccessKey Secret を含む認証情報をロードします。
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider();

// SDK のデフォルト構成を使用します。
$cfg = Oss\Config::loadDefault();

// 認証情報プロバイダーを設定します。
$cfg->setCredentialsProvider($credentialsProvider);

// リージョンを設定します。
$cfg->setRegion($region);

// エンドポイントが指定されている場合は、エンドポイントを設定します。
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]);
}

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

// 複数のキーと値のペアを含むバケットタグ付けオブジェクトを作成します。
$tagging = new Oss\Models\Tagging(
    tagSet: new Oss\Models\TagSet(
        tags: [new Oss\Models\Tag(key: 'key1', value: 'value1'), new Oss\Models\Tag(key: 'key2', value: 'value2')]
    )
);

// バケットタグを設定するためのリクエストオブジェクトを作成し、タグの内容を渡します。
$request = new Oss\Models\PutBucketTagsRequest(bucket: $bucket, tagging: $tagging);

// putBucketTags メソッドを呼び出して、バケットにタグを設定します。
$result = $client->putBucketTags($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"]; // バケットの名前。

// 環境変数を使用して、AccessKey ID と AccessKey Secret を含む認証情報をロードします。
$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); // OSS クライアントインスタンスを作成します。

// バケットのタグを取得するためのリクエストオブジェクトを作成します。
$request = new Oss\Models\GetBucketTagsRequest(bucket: $bucket); // 指定されたバケットのタグ情報を取得するためのリクエストオブジェクトを作成します。

// getBucketTags メソッドを呼び出して、バケットのタグを取得します。
$result = $client->getBucketTags($request); // getBucketTags メソッドを呼び出して、バケットのタグ情報を取得します。

// 応答を出力します。
printf(
    'status code:' . $result->statusCode . PHP_EOL . // 応答の HTTP ステータスコード。
    'request id:' . $result->requestId . PHP_EOL . // リクエストの一意の ID。
    'tags:' . var_export($result->tagging, true) // 返されたタグ情報。配列で表示されます。
);

バケットのすべてのタグを削除する

<?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"]; // バケットの名前。

// 環境変数を使用して、AccessKey ID と AccessKey Secret を含む認証情報をロードします。
$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); // OSS クライアントインスタンスを作成します。

// バケットタグを削除するためのリクエストオブジェクトを作成します。
$request = new Oss\Models\DeleteBucketTagsRequest(bucket: $bucket); 

// deleteBucketTags メソッドを呼び出して、バケットのタグを削除します。
$result = $client->deleteBucketTags($request); 

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

関連情報

  • バケットタグを設定する API 操作の詳細については、「PutBucketTags」をご参照ください。

  • バケットタグを取得する API 操作の詳細については、「GetBucketTags」をご参照ください。

  • バケットタグを削除する API 操作の詳細については、「DeleteBucketTags」をご参照ください。