1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::upload_entity_definitions::_upload_entity_definitions_output::UploadEntityDefinitionsOutputBuilder;
pub use crate::operation::upload_entity_definitions::_upload_entity_definitions_input::UploadEntityDefinitionsInputBuilder;
impl UploadEntityDefinitionsInputBuilder {
/// Sends a request with this input using the given client.
pub async fn send_with(
self,
client: &crate::Client,
) -> ::std::result::Result<
crate::operation::upload_entity_definitions::UploadEntityDefinitionsOutput,
::aws_smithy_http::result::SdkError<
crate::operation::upload_entity_definitions::UploadEntityDefinitionsError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let mut fluent_builder = client.upload_entity_definitions();
fluent_builder.inner = self;
fluent_builder.send().await
}
}
/// Fluent builder constructing a request to `UploadEntityDefinitions`.
///
/// <p>Asynchronously uploads one or more entity definitions to the user's namespace. The <code>document</code> parameter is required if <code>syncWithPublicNamespace</code> and <code>deleteExistingEntites</code> are false. If the <code>syncWithPublicNamespace</code> parameter is set to <code>true</code>, the user's namespace will synchronize with the latest version of the public namespace. If <code>deprecateExistingEntities</code> is set to true, all entities in the latest version will be deleted before the new <code>DefinitionDocument</code> is uploaded.</p>
/// <p>When a user uploads entity definitions for the first time, the service creates a new namespace for the user. The new namespace tracks the public namespace. Currently users can have only one namespace. The namespace version increments whenever a user uploads entity definitions that are backwards-incompatible and whenever a user sets the <code>syncWithPublicNamespace</code> parameter or the <code>deprecateExistingEntities</code> parameter to <code>true</code>.</p>
/// <p>The IDs for all of the entities should be in URN format. Each entity must be in the user's namespace. Users can't create entities in the public namespace, but entity definitions can refer to entities in the public namespace.</p>
/// <p>Valid entities are <code>Device</code>, <code>DeviceModel</code>, <code>Service</code>, <code>Capability</code>, <code>State</code>, <code>Action</code>, <code>Event</code>, <code>Property</code>, <code>Mapping</code>, <code>Enum</code>. </p>
#[deprecated(note = "since: 2022-08-30")]
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct UploadEntityDefinitionsFluentBuilder {
handle: ::std::sync::Arc<crate::client::Handle>,
inner: crate::operation::upload_entity_definitions::builders::UploadEntityDefinitionsInputBuilder,
config_override: ::std::option::Option<crate::config::Builder>,
}
impl
crate::client::customize::internal::CustomizableSend<
crate::operation::upload_entity_definitions::UploadEntityDefinitionsOutput,
crate::operation::upload_entity_definitions::UploadEntityDefinitionsError,
> for UploadEntityDefinitionsFluentBuilder
{
fn send(
self,
config_override: crate::config::Builder,
) -> crate::client::customize::internal::BoxFuture<
crate::client::customize::internal::SendResult<
crate::operation::upload_entity_definitions::UploadEntityDefinitionsOutput,
crate::operation::upload_entity_definitions::UploadEntityDefinitionsError,
>,
> {
::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
}
}
impl UploadEntityDefinitionsFluentBuilder {
/// Creates a new `UploadEntityDefinitions`.
pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: ::std::default::Default::default(),
config_override: ::std::option::Option::None,
}
}
/// Access the UploadEntityDefinitions as a reference.
pub fn as_input(&self) -> &crate::operation::upload_entity_definitions::builders::UploadEntityDefinitionsInputBuilder {
&self.inner
}
/// 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](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> ::std::result::Result<
crate::operation::upload_entity_definitions::UploadEntityDefinitionsOutput,
::aws_smithy_http::result::SdkError<
crate::operation::upload_entity_definitions::UploadEntityDefinitionsError,
::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
>,
> {
let input = self.inner.build().map_err(::aws_smithy_http::result::SdkError::construction_failure)?;
let runtime_plugins = crate::operation::upload_entity_definitions::UploadEntityDefinitions::operation_runtime_plugins(
self.handle.runtime_plugins.clone(),
&self.handle.conf,
self.config_override,
);
crate::operation::upload_entity_definitions::UploadEntityDefinitions::orchestrate(&runtime_plugins, input).await
}
/// Consumes this builder, creating a customizable operation that can be modified before being
/// sent.
// TODO(enableNewSmithyRuntimeCleanup): Remove `async` and `Result` once we switch to orchestrator
pub async fn customize(
self,
) -> ::std::result::Result<
crate::client::customize::orchestrator::CustomizableOperation<
crate::operation::upload_entity_definitions::UploadEntityDefinitionsOutput,
crate::operation::upload_entity_definitions::UploadEntityDefinitionsError,
Self,
>,
::aws_smithy_http::result::SdkError<crate::operation::upload_entity_definitions::UploadEntityDefinitionsError>,
> {
::std::result::Result::Ok(crate::client::customize::orchestrator::CustomizableOperation::new(self))
}
pub(crate) fn config_override(mut self, config_override: impl Into<crate::config::Builder>) -> Self {
self.set_config_override(Some(config_override.into()));
self
}
pub(crate) fn set_config_override(&mut self, config_override: Option<crate::config::Builder>) -> &mut Self {
self.config_override = config_override;
self
}
/// <p>The <code>DefinitionDocument</code> that defines the updated entities.</p>
pub fn document(mut self, input: crate::types::DefinitionDocument) -> Self {
self.inner = self.inner.document(input);
self
}
/// <p>The <code>DefinitionDocument</code> that defines the updated entities.</p>
pub fn set_document(mut self, input: ::std::option::Option<crate::types::DefinitionDocument>) -> Self {
self.inner = self.inner.set_document(input);
self
}
/// <p>The <code>DefinitionDocument</code> that defines the updated entities.</p>
pub fn get_document(&self) -> &::std::option::Option<crate::types::DefinitionDocument> {
self.inner.get_document()
}
/// <p>A Boolean that specifies whether to synchronize with the latest version of the public namespace. If set to <code>true</code>, the upload will create a new namespace version.</p>
pub fn sync_with_public_namespace(mut self, input: bool) -> Self {
self.inner = self.inner.sync_with_public_namespace(input);
self
}
/// <p>A Boolean that specifies whether to synchronize with the latest version of the public namespace. If set to <code>true</code>, the upload will create a new namespace version.</p>
pub fn set_sync_with_public_namespace(mut self, input: ::std::option::Option<bool>) -> Self {
self.inner = self.inner.set_sync_with_public_namespace(input);
self
}
/// <p>A Boolean that specifies whether to synchronize with the latest version of the public namespace. If set to <code>true</code>, the upload will create a new namespace version.</p>
pub fn get_sync_with_public_namespace(&self) -> &::std::option::Option<bool> {
self.inner.get_sync_with_public_namespace()
}
/// <p>A Boolean that specifies whether to deprecate all entities in the latest version before uploading the new <code>DefinitionDocument</code>. If set to <code>true</code>, the upload will create a new namespace version.</p>
pub fn deprecate_existing_entities(mut self, input: bool) -> Self {
self.inner = self.inner.deprecate_existing_entities(input);
self
}
/// <p>A Boolean that specifies whether to deprecate all entities in the latest version before uploading the new <code>DefinitionDocument</code>. If set to <code>true</code>, the upload will create a new namespace version.</p>
pub fn set_deprecate_existing_entities(mut self, input: ::std::option::Option<bool>) -> Self {
self.inner = self.inner.set_deprecate_existing_entities(input);
self
}
/// <p>A Boolean that specifies whether to deprecate all entities in the latest version before uploading the new <code>DefinitionDocument</code>. If set to <code>true</code>, the upload will create a new namespace version.</p>
pub fn get_deprecate_existing_entities(&self) -> &::std::option::Option<bool> {
self.inner.get_deprecate_existing_entities()
}
}