Struct opendal::services::Obs

pub struct Obs { /* private fields */ }

Available on crate feature services-obs only.

Huawei-Cloud Object Storage Service (OBS) support

Capabilities

This service can be used to:

• stat
• read
• write
• create_dir
• delete
• copy
• rename
• list
• presign
• blocking

Configuration

• root: Set the work directory for backend
• bucket: Set the container name for backend
• endpoint: Customizable endpoint setting
• access_key_id: Set the access_key_id for backend.
• secret_access_key: Set the secret_access_key for backend.

You can refer to ObsBuilder’s docs for more information

Example

Via Builder

use anyhow::Result;
use opendal::services::Obs;
use opendal::Operator;

#[tokio::main]
async fn main() -> Result<()> {
    // create backend builder
    let mut builder = Obs::default()
        // set the storage bucket for OpenDAL
        .bucket("test")
        .endpoint("obs.cn-north-1.myhuaweicloud.com")
        // Set the access_key_id and secret_access_key.
        //
        // OpenDAL will try load credential from the env.
        // If credential not set and no valid credential in env, OpenDAL will
        // send request without signing like anonymous user.
        .access_key_id("access_key_id")
        .secret_access_key("secret_access_key");

    let op: Operator = Operator::new(builder)?.finish();

    Ok(())
}

Implementations

impl ObsBuilder

pub fn root(self, root: &str) -> Self

Set root of this backend.

All operations will happen under this root.

pub fn endpoint(self, endpoint: &str) -> Self

Set endpoint of this backend.

Both huaweicloud default domain and user domain endpoints are allowed. Please DO NOT add the bucket name to the endpoint.

• https://obs.cn-north-4.myhuaweicloud.com
• obs.cn-north-4.myhuaweicloud.com (https by default)
• https://custom.obs.com (port should not be set)

pub fn access_key_id(self, access_key_id: &str) -> Self

Set access_key_id of this backend.

• If it is set, we will take user’s input first.
• If not, we will try to load it from environment.

pub fn secret_access_key(self, secret_access_key: &str) -> Self

Set secret_access_key of this backend.

• If it is set, we will take user’s input first.
• If not, we will try to load it from environment.

pub fn bucket(self, bucket: &str) -> Self

Set bucket of this backend. The param is required.

pub fn http_client(self, client: HttpClient) -> Self

Specify the http client that used by this service.

Notes

This API is part of OpenDAL’s Raw API. HttpClient could be changed during minor updates.

Trait Implementations

impl Builder for ObsBuilder

const SCHEME: Scheme = Scheme::Obs

Associated scheme for this builder. It indicates what underlying service is.

type Config = ObsConfig

Associated configuration for this builder.

fn build(self) -> Result<impl Access>

Consume the accessor builder to build a service.

impl Clone for ObsBuilder

fn clone(&self) -> ObsBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ObsBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ObsBuilder

fn default() -> ObsBuilder

Returns the “default value” for a type.