You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

请输入
  • 文档首页
    • 对象存储SDK 参考Rust存储桶接口桶标签GetBucketTagging（Rust SDK）
复制全文
下载 pdf
我的收藏
桶标签
GetBucketTagging（Rust SDK）
复制全文
下载 pdf
我的收藏
GetBucketTagging（Rust SDK）
get_bucket_tagging 接口用于获取存储桶标签集合，本文介绍如何通过 Rust SDK 的 get_bucket_tagging 接口读取桶标签键值列表。​
注意事项​
  • 您需要根据实际情况，填写示例代码中的地域和访问域名，详细介绍，请参见 地域和访问域名。​
  • 为了防止密钥泄露，本文示例代码需要从环境变量中读取 Access Key ID 和 Secret Access Key。因此使用 SDK 前，您需要配置长期访问凭证，详细介绍，请参见 配置长期访问凭证。​
  • 若存储桶未设置任何标签，响应返回 200 OK，TagSet.Tags 为空数组。​
  • 标签 Key 与 Value 须符合命名规范，否则在设置阶段即被拒绝，获取时不会返回非法数据。​
权限说明​
火山引擎主账号默认拥有全部权限，但是 IAM 用户默认没有任何权限。如果您需要使用子账号执行 get_bucket_tagging 操作，火山引擎主账号需通过 IAM策略和桶策略为该子账号授予以下权限：​
tos:GetBucketTagging​
代码示例​
获取指定存储桶的标签信息​
​
use async_trait::async_trait;​
use futures_core::future::BoxFuture;​
use std::env;​
use std::future::Future;​
use std::time::Duration;​
use tokio::runtime::Handle;​
use ve_tos_rust_sdk::common::init_tracing_log;​
use ve_tos_rust_sdk::asynchronous::bucket::BucketAPI;​
use ve_tos_rust_sdk::asynchronous::tos;​
use ve_tos_rust_sdk::asynchronous::tos::AsyncRuntime;​
use ve_tos_rust_sdk::bucket::{GetBucketTaggingInput, GetBucketTaggingOutput};​
use ve_tos_rust_sdk::common::{Tag, TagSet};​
use ve_tos_rust_sdk::error::TosError;​
​
#[derive(Debug, Default)]​
pub struct TokioRuntime {}​
​
#[async_trait]​
impl AsyncRuntime for TokioRuntime {​
type JoinError = tokio::task::JoinError;​
async fn sleep(&self, duration: Duration) {​
tokio::time::sleep(duration).await;​
}​
​
fn spawn<'a, F>(&self, future: F) -> BoxFuture<'a, Result<F::Output, Self::JoinError>>​
where​
F: Future + Send + 'static,​
F::Output: Send + 'static,​
{​
Box::pin(Handle::current().spawn(future))​
}​
​
fn block_on<F: Future>(&self, future: F) -> F::Output {​
Handle::current().block_on(future)​
}​
}​
​
#[tokio::main]​
async fn main() {​
// Initialize logging​
let _guard = init_tracing_log("info", "temp/logs", "app.log");​
​
// Load configuration from environment variables​
let ak = env::var("TOS_ACCESS_KEY").unwrap_or("".to_string());​
let sk = env::var("TOS_SECRET_KEY").unwrap_or("".to_string());​
let endpoint = "https://tos-cn-beijing.volces.com";​
let region = "cn-beijing";​
​
// Create TOS client​
let client = tos::builder::<TokioRuntime>()​
.connection_timeout(3000)​
.request_timeout(10000)​
.max_retry_count(3)​
.ak(ak)​
.sk(sk)​
.region(region)​
.endpoint(endpoint)​
.build().unwrap();​
​
// Case: 获取指定存储桶的标签信息​
let bucket_name = "example-bucket";​
let input = GetBucketTaggingInput::new(bucket_name);​
let output = client.get_bucket_tagging(&input).await;​
​
match output {​
Ok(res) => {​
println!("Successfully retrieved bucket tagging information. Request ID: {}", res.request_id());​
let tag_set = res.tag_set();​
println!("Total tags: {}", tag_set.tags().len());​
for (index, tag) in tag_set.tags().iter().enumerate() {​
println!("Tag {}: Key = {}, Value = {}", index + 1, tag.key(), tag.value());​
}​
},​
Err(err) => {​
match err {​
TosError::TosClientError { message, .. } => {​
println!("Client error occurred: {}", message);​
},​
TosError::TosServerError { request_id, ec, code, status_code, .. } => {​
println!("Server error: Request ID = {}, Error Code = {}, Status Code = {}", request_id, ec, status_code);​
},​
_ => println!("Unexpected error: {:?}", err),​
}​
}​
}​
}​
​
相关文档​
关于 GetBucketTagging 的 API 文档，请参见 GetBucketTagging。​
​
最近更新时间：2025.12.22 16:33:48
这个页面对您有帮助吗？
有用
有用
无用
无用