#[non_exhaustive]pub struct DocumentBuilder { /* private fields */ }Expand description
A builder for Document.
Implementations§
Source§impl DocumentBuilder
impl DocumentBuilder
Sourcepub fn id(self, input: impl Into<String>) -> Self
pub fn id(self, input: impl Into<String>) -> Self
A identifier of the document in the index.
Note, each document ID must be unique per index. You cannot create a data source to index your documents with their unique IDs and then use the BatchPutDocument API to index the same documents, or vice versa. You can delete a data source and then use the BatchPutDocument API to index the same documents, or vice versa.
Sourcepub fn set_id(self, input: Option<String>) -> Self
pub fn set_id(self, input: Option<String>) -> Self
A identifier of the document in the index.
Note, each document ID must be unique per index. You cannot create a data source to index your documents with their unique IDs and then use the BatchPutDocument API to index the same documents, or vice versa. You can delete a data source and then use the BatchPutDocument API to index the same documents, or vice versa.
Sourcepub fn get_id(&self) -> &Option<String>
pub fn get_id(&self) -> &Option<String>
A identifier of the document in the index.
Note, each document ID must be unique per index. You cannot create a data source to index your documents with their unique IDs and then use the BatchPutDocument API to index the same documents, or vice versa. You can delete a data source and then use the BatchPutDocument API to index the same documents, or vice versa.
Sourcepub fn blob(self, input: Blob) -> Self
pub fn blob(self, input: Blob) -> Self
The contents of the document.
Documents passed to the Blob parameter must be base64 encoded. Your code might not need to encode the document file bytes if you're using an Amazon Web Services SDK to call Amazon Kendra APIs. If you are calling the Amazon Kendra endpoint directly using REST, you must base64 encode the contents before sending.
Sourcepub fn set_blob(self, input: Option<Blob>) -> Self
pub fn set_blob(self, input: Option<Blob>) -> Self
The contents of the document.
Documents passed to the Blob parameter must be base64 encoded. Your code might not need to encode the document file bytes if you're using an Amazon Web Services SDK to call Amazon Kendra APIs. If you are calling the Amazon Kendra endpoint directly using REST, you must base64 encode the contents before sending.
Sourcepub fn get_blob(&self) -> &Option<Blob>
pub fn get_blob(&self) -> &Option<Blob>
The contents of the document.
Documents passed to the Blob parameter must be base64 encoded. Your code might not need to encode the document file bytes if you're using an Amazon Web Services SDK to call Amazon Kendra APIs. If you are calling the Amazon Kendra endpoint directly using REST, you must base64 encode the contents before sending.
Sourcepub fn s3_path(self, input: S3Path) -> Self
pub fn s3_path(self, input: S3Path) -> Self
Information required to find a specific file in an Amazon S3 bucket.
Sourcepub fn set_s3_path(self, input: Option<S3Path>) -> Self
pub fn set_s3_path(self, input: Option<S3Path>) -> Self
Information required to find a specific file in an Amazon S3 bucket.
Sourcepub fn get_s3_path(&self) -> &Option<S3Path>
pub fn get_s3_path(&self) -> &Option<S3Path>
Information required to find a specific file in an Amazon S3 bucket.
Sourcepub fn attributes(self, input: DocumentAttribute) -> Self
pub fn attributes(self, input: DocumentAttribute) -> Self
Appends an item to attributes.
To override the contents of this collection use set_attributes.
Custom attributes to apply to the document. Use the custom attributes to provide additional information for searching, to provide facets for refining searches, and to provide additional information in the query response.
For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.
Sourcepub fn set_attributes(self, input: Option<Vec<DocumentAttribute>>) -> Self
pub fn set_attributes(self, input: Option<Vec<DocumentAttribute>>) -> Self
Custom attributes to apply to the document. Use the custom attributes to provide additional information for searching, to provide facets for refining searches, and to provide additional information in the query response.
For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.
Sourcepub fn get_attributes(&self) -> &Option<Vec<DocumentAttribute>>
pub fn get_attributes(&self) -> &Option<Vec<DocumentAttribute>>
Custom attributes to apply to the document. Use the custom attributes to provide additional information for searching, to provide facets for refining searches, and to provide additional information in the query response.
For example, 'DataSourceId' and 'DataSourceSyncJobId' are custom attributes that provide information on the synchronization of documents running on a data source. Note, 'DataSourceSyncJobId' could be an optional custom attribute as Amazon Kendra will use the ID of a running sync job.
Sourcepub fn access_control_list(self, input: Principal) -> Self
pub fn access_control_list(self, input: Principal) -> Self
Appends an item to access_control_list.
To override the contents of this collection use set_access_control_list.
Information on principals (users and/or groups) and which documents they should have access to. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.
Sourcepub fn set_access_control_list(self, input: Option<Vec<Principal>>) -> Self
pub fn set_access_control_list(self, input: Option<Vec<Principal>>) -> Self
Information on principals (users and/or groups) and which documents they should have access to. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.
Sourcepub fn get_access_control_list(&self) -> &Option<Vec<Principal>>
pub fn get_access_control_list(&self) -> &Option<Vec<Principal>>
Information on principals (users and/or groups) and which documents they should have access to. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.
Sourcepub fn hierarchical_access_control_list(
self,
input: HierarchicalPrincipal,
) -> Self
pub fn hierarchical_access_control_list( self, input: HierarchicalPrincipal, ) -> Self
Appends an item to hierarchical_access_control_list.
To override the contents of this collection use set_hierarchical_access_control_list.
The list of principal lists that define the hierarchy for which documents users should have access to.
Sourcepub fn set_hierarchical_access_control_list(
self,
input: Option<Vec<HierarchicalPrincipal>>,
) -> Self
pub fn set_hierarchical_access_control_list( self, input: Option<Vec<HierarchicalPrincipal>>, ) -> Self
The list of principal lists that define the hierarchy for which documents users should have access to.
Sourcepub fn get_hierarchical_access_control_list(
&self,
) -> &Option<Vec<HierarchicalPrincipal>>
pub fn get_hierarchical_access_control_list( &self, ) -> &Option<Vec<HierarchicalPrincipal>>
The list of principal lists that define the hierarchy for which documents users should have access to.
Sourcepub fn content_type(self, input: ContentType) -> Self
pub fn content_type(self, input: ContentType) -> Self
The file type of the document in the Blob field.
If you want to index snippets or subsets of HTML documents instead of the entirety of the HTML documents, you must add the HTML start and closing tags (content) around the content.
Sourcepub fn set_content_type(self, input: Option<ContentType>) -> Self
pub fn set_content_type(self, input: Option<ContentType>) -> Self
The file type of the document in the Blob field.
If you want to index snippets or subsets of HTML documents instead of the entirety of the HTML documents, you must add the HTML start and closing tags (content) around the content.
Sourcepub fn get_content_type(&self) -> &Option<ContentType>
pub fn get_content_type(&self) -> &Option<ContentType>
The file type of the document in the Blob field.
If you want to index snippets or subsets of HTML documents instead of the entirety of the HTML documents, you must add the HTML start and closing tags (content) around the content.
Sourcepub fn access_control_configuration_id(self, input: impl Into<String>) -> Self
pub fn access_control_configuration_id(self, input: impl Into<String>) -> Self
The identifier of the access control configuration that you want to apply to the document.
Sourcepub fn set_access_control_configuration_id(self, input: Option<String>) -> Self
pub fn set_access_control_configuration_id(self, input: Option<String>) -> Self
The identifier of the access control configuration that you want to apply to the document.
Sourcepub fn get_access_control_configuration_id(&self) -> &Option<String>
pub fn get_access_control_configuration_id(&self) -> &Option<String>
The identifier of the access control configuration that you want to apply to the document.
Trait Implementations§
Source§impl Clone for DocumentBuilder
impl Clone for DocumentBuilder
Source§fn clone(&self) -> DocumentBuilder
fn clone(&self) -> DocumentBuilder
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moreSource§impl Debug for DocumentBuilder
impl Debug for DocumentBuilder
Source§impl Default for DocumentBuilder
impl Default for DocumentBuilder
Source§fn default() -> DocumentBuilder
fn default() -> DocumentBuilder
Source§impl PartialEq for DocumentBuilder
impl PartialEq for DocumentBuilder
impl StructuralPartialEq for DocumentBuilder
Auto Trait Implementations§
impl Freeze for DocumentBuilder
impl RefUnwindSafe for DocumentBuilder
impl Send for DocumentBuilder
impl Sync for DocumentBuilder
impl Unpin for DocumentBuilder
impl UnwindSafe for DocumentBuilder
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
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the foreground set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red() and
green(), which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg():
use yansi::{Paint, Color};
painted.fg(Color::White);Set foreground color to white using white().
use yansi::Paint;
painted.white();Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self with the background set to
value.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red() and
on_green(), which have the same functionality but
are pithier.
§Example
Set background color to red using fg():
use yansi::{Paint, Color};
painted.bg(Color::Red);Set background color to red using on_red().
use yansi::Paint;
painted.on_red();Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute value.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold() and
underline(), which have the same functionality
but are pithier.
§Example
Make text bold using attr():
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);Make text bold using using bold().
use yansi::Paint;
painted.bold();Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi Quirk value.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask() and
wrap(), which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk():
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);Enable wrapping using wrap().
use yansi::Paint;
painted.wrap();Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting() due to conflicts with Vec::clear().
The clear() method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted only when both stdout and stderr are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);