pub struct ListFragments { /* private fields */ }
Expand description
Fluent builder constructing a request to ListFragments
.
Returns a list of Fragment
objects from the specified stream and timestamp range within the archived data.
Listing fragments is eventually consistent. This means that even if the producer receives an acknowledgment that a fragment is persisted, the result might not be returned immediately from a request to ListFragments
. However, results are typically available in less than one second.
You must first call the GetDataEndpoint
API to get an endpoint. Then send the ListFragments
requests to this endpoint using the --endpoint-url parameter.
If an error is thrown after invoking a Kinesis Video Streams archived media API, in addition to the HTTP status code and the response body, it includes the following pieces of information:
-
x-amz-ErrorType
HTTP header – contains a more specific error type in addition to what the HTTP status code provides. -
x-amz-RequestId
HTTP header – if you want to report an issue to AWS, the support team can better diagnose the problem if given the Request Id.
Both the HTTP status code and the ErrorType header can be utilized to make programmatic decisions about whether errors are retry-able and under what conditions, as well as provide information on what actions the client programmer might need to take in order to successfully try again.
For more information, see the Errors section at the bottom of this topic, as well as Common Errors.
Implementations
sourceimpl ListFragments
impl ListFragments
sourcepub async fn send(
self
) -> Result<ListFragmentsOutput, SdkError<ListFragmentsError>>
pub async fn send(
self
) -> Result<ListFragmentsOutput, SdkError<ListFragmentsError>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
sourcepub fn stream_name(self, input: impl Into<String>) -> Self
pub fn stream_name(self, input: impl Into<String>) -> Self
The name of the stream from which to retrieve a fragment list. Specify either this parameter or the StreamARN
parameter.
sourcepub fn set_stream_name(self, input: Option<String>) -> Self
pub fn set_stream_name(self, input: Option<String>) -> Self
The name of the stream from which to retrieve a fragment list. Specify either this parameter or the StreamARN
parameter.
sourcepub fn stream_arn(self, input: impl Into<String>) -> Self
pub fn stream_arn(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) of the stream from which to retrieve a fragment list. Specify either this parameter or the StreamName
parameter.
sourcepub fn set_stream_arn(self, input: Option<String>) -> Self
pub fn set_stream_arn(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) of the stream from which to retrieve a fragment list. Specify either this parameter or the StreamName
parameter.
sourcepub fn max_results(self, input: i64) -> Self
pub fn max_results(self, input: i64) -> Self
The total number of fragments to return. If the total number of fragments available is more than the value specified in max-results
, then a ListFragmentsOutput$NextToken
is provided in the output that you can use to resume pagination.
sourcepub fn set_max_results(self, input: Option<i64>) -> Self
pub fn set_max_results(self, input: Option<i64>) -> Self
The total number of fragments to return. If the total number of fragments available is more than the value specified in max-results
, then a ListFragmentsOutput$NextToken
is provided in the output that you can use to resume pagination.
sourcepub fn next_token(self, input: impl Into<String>) -> Self
pub fn next_token(self, input: impl Into<String>) -> Self
A token to specify where to start paginating. This is the ListFragmentsOutput$NextToken
from a previously truncated response.
sourcepub fn set_next_token(self, input: Option<String>) -> Self
pub fn set_next_token(self, input: Option<String>) -> Self
A token to specify where to start paginating. This is the ListFragmentsOutput$NextToken
from a previously truncated response.
sourcepub fn fragment_selector(self, input: FragmentSelector) -> Self
pub fn fragment_selector(self, input: FragmentSelector) -> Self
Describes the timestamp range and timestamp origin for the range of fragments to return.
sourcepub fn set_fragment_selector(self, input: Option<FragmentSelector>) -> Self
pub fn set_fragment_selector(self, input: Option<FragmentSelector>) -> Self
Describes the timestamp range and timestamp origin for the range of fragments to return.
Trait Implementations
sourceimpl Clone for ListFragments
impl Clone for ListFragments
sourcefn clone(&self) -> ListFragments
fn clone(&self) -> ListFragments
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
Auto Trait Implementations
impl !RefUnwindSafe for ListFragments
impl Send for ListFragments
impl Sync for ListFragments
impl Unpin for ListFragments
impl !UnwindSafe for ListFragments
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcepub fn borrow_mut(&mut self) -> &mut T
pub fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcepub fn to_owned(&self) -> T
pub fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
sourcepub fn clone_into(&self, target: &mut T)
pub fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more