pub struct PutObject<'a> { /* private fields */ }Expand description
Header字段中:
- content_md5: 由程序自动添加
- content_length:由程序自动添加
- e_tag:不添加
Implementations§
Source§impl<'a> PutObject<'a>
impl<'a> PutObject<'a>
Sourcepub async fn send(
&self,
object_name: &'a str,
object: PutObjectBody<'a>,
) -> Result<PutObjectResponseHeader, Error>
pub async fn send( &self, object_name: &'a str, object: PutObjectBody<'a>, ) -> Result<PutObjectResponseHeader, Error>
content_type,不会进行MIME合法性检查object_name:遵守OSS的Object命名规则data:如果需要创建文件夹,object_name以/结尾,Vec大小为0即可
Sourcepub async fn generate_presigned_url(
&self,
object_name: &str,
expires: i32,
) -> Result<String, Error>
pub async fn generate_presigned_url( &self, object_name: &str, expires: i32, ) -> Result<String, Error>
生成用于上传的预签名URL(Presigned URL),生成的url使用PUT方法上传文件
§参数
object_name:要上传的对象名称。必须遵守 OSS Object 命名规则。expires:URL 的有效期,单位为秒。过期后将无法使用。
阿里云oss文档不建议使用预签名URL上传带有回调的对象:
该方式常用于预签名URL上传文件的场景,通过将回调参数Base64编码后拼接在URL中实现自动回调。 但由于回调信息暴露在 URL 中,存在一定的安全风险,仅建议用于临时访问或低敏感场景。callback签名
§当使用 STS 临时访问凭证时的注意事项
- 本方法通过在 URL 中包含签名的方式进行授权,如果使用 STS 访问方式,会自动在查询参数中追加
x-oss-security-token,因此无需再在 Header 中携带该字段。 - 如需使用 POST 预签名表单上传,请根据 STS 凭证自行构造表单并在表单中携带
x-oss-security-token字段。 - 其它正常的 API 请求(非预签名 URL 的方式),需要在 Header 中携带
x-oss-security-token字段。
Trait Implementations§
Auto Trait Implementations§
impl<'a> Freeze for PutObject<'a>
impl<'a> !RefUnwindSafe for PutObject<'a>
impl<'a> Send for PutObject<'a>
impl<'a> Sync for PutObject<'a>
impl<'a> Unpin for PutObject<'a>
impl<'a> UnsafeUnpin for PutObject<'a>
impl<'a> !UnwindSafe for PutObject<'a>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more