pub struct RequestBuilder { /* private fields */ }Expand description
RequestBuilder provides a mechanism for setting optional parameters on a request.
Each RequestBuilder parameter method call returns Self, so setting of multiple
parameters can be chained.
To finalize and submit the request, invoke .await, which
which will convert the RequestBuilder into a future
executes the request and returns a Result with the parsed
response.
In order to execute the request without polling the service
until the operation completes, use .send().await instead.
If you need lower-level access to the raw response details
(e.g. to inspect response headers or raw body data) then you
can finalize the request using the
RequestBuilder::send() method which returns a future
that resolves to a lower-level Response value.
Implementations§
source§impl RequestBuilder
impl RequestBuilder
sourcepub fn timeout(self, timeout: i64) -> Self
pub fn timeout(self, timeout: i64) -> Self
The timeout parameter is expressed in seconds. For more information, see Setting Timeouts for Blob Service Operations.
sourcepub fn if_modified_since(
self,
if_modified_since: impl Into<OffsetDateTime>
) -> Self
pub fn if_modified_since( self, if_modified_since: impl Into<OffsetDateTime> ) -> Self
Specify this header value to operate only on a blob if it has been modified since the specified date/time.
sourcepub fn if_unmodified_since(
self,
if_unmodified_since: impl Into<OffsetDateTime>
) -> Self
pub fn if_unmodified_since( self, if_unmodified_since: impl Into<OffsetDateTime> ) -> Self
Specify this header value to operate only on a blob if it has not been modified since the specified date/time.
sourcepub fn if_match(self, if_match: impl Into<String>) -> Self
pub fn if_match(self, if_match: impl Into<String>) -> Self
Specify an ETag value to operate only on blobs with a matching value.
sourcepub fn if_none_match(self, if_none_match: impl Into<String>) -> Self
pub fn if_none_match(self, if_none_match: impl Into<String>) -> Self
Specify an ETag value to operate only on blobs without a matching value.
Specify a SQL where clause on blob tags to operate only on blobs with a matching value.
sourcepub fn x_ms_client_request_id(
self,
x_ms_client_request_id: impl Into<String>
) -> Self
pub fn x_ms_client_request_id( self, x_ms_client_request_id: impl Into<String> ) -> Self
Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the analytics logs when storage analytics logging is enabled.
sourcepub fn send(self) -> BoxFuture<'static, Result<Response>>
pub fn send(self) -> BoxFuture<'static, Result<Response>>
Returns a future that sends the request and returns a Response object that provides low-level access to full response details.
You should typically use .await (which implicitly calls IntoFuture::into_future()) to finalize and send requests rather than send().
However, this function can provide more flexibility when required.
Trait Implementations§
source§impl Clone for RequestBuilder
impl Clone for RequestBuilder
source§fn clone(&self) -> RequestBuilder
fn clone(&self) -> RequestBuilder
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more