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

对象存储

请输入
  • 文档首页
    • 对象存储SDK 参考Rust存储桶接口跨域资源共享PutBucketCORS（Rust SDK）
复制全文
下载 pdf
我的收藏
跨域资源共享
PutBucketCORS（Rust SDK）
复制全文
下载 pdf
我的收藏
PutBucketCORS（Rust SDK）
put_bucket_cors 接口用于为存储桶设置 CORS 规则，本文介绍如何通过 Rust SDK 的 put_bucket_cors 接口配置跨域访问。​
注意事项​
  • 您需要根据实际情况，填写示例代码中的地域和访问域名，详细介绍，请参见 地域和访问域名。​
  • 为了防止密钥泄露，本文示例代码需要从环境变量中读取 Access Key ID 和 Secret Access Key。因此使用 SDK 前，您需要配置长期访问凭证，详细介绍，请参见 配置长期访问凭证。​
  • 所有 CORS 规则总大小不可超过 20 KiB。​
  • 若设置 ResponseVary 为 true，响应会携带 Vary: Origin 头，可能增加浏览或回源次数。​
权限说明​
火山引擎主账号默认拥有全部权限，但是 IAM 用户默认没有任何权限。如果您需要使用子账号执行 put_bucket_cors 操作，火山引擎主账号需通过 IAM策略和桶策略为该子账号授予以下权限：​
tos:PutBucketCORS​
代码示例​
设置存储桶的 CORS 规则​
​
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::{CORSRule, PutBucketCORSInput};​
​
#[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() {​
let _guard = init_tracing_log("info", "temp/logs", "app.log");​
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";​
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();​
​
// 设置单个存储桶的CORS规则​
let bucket_name = "my-single-bucket";​
let mut rule = CORSRule::new();​
rule.set_allowed_origins(vec!["*".to_string()]);​
rule.set_allowed_methods(vec!["PUT".to_string(), "GET".to_string()]);​
rule.set_allowed_headers(vec!["Authorization".to_string()]);​
rule.set_expose_headers(vec!["x-tos-request-id".to_string()]);​
rule.set_max_age_seconds(1024);​
rule.set_response_vary(true);​
​
let input = PutBucketCORSInput::new_with_rules(bucket_name, vec![rule]);​
let output = client.put_bucket_cors(&input).await;​
​
match output {​
Ok(_) => println!("Successfully set CORS rules for bucket: {}", bucket_name),​
Err(err) => eprintln!("Failed to set CORS rules: {:?}", err),​
}​
}​
​
相关文档​
关于 PutBucketCORS 的 API 文档，请参见 PutBucketCORS。​
​
最近更新时间：2026.02.10 10:31:12
这个页面对您有帮助吗？
有用
有用
无用
无用