aws_sdk_iotsitewise/client/

update_gateway_capability_configuration.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`UpdateGatewayCapabilityConfiguration`](crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`gateway_id(impl Into<String>)`](crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder::gateway_id) / [`set_gateway_id(Option<String>)`](crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder::set_gateway_id):<br>required: **true**<br><p>The ID of the gateway to be updated.</p><br>
    ///   - [`capability_namespace(impl Into<String>)`](crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder::capability_namespace) / [`set_capability_namespace(Option<String>)`](crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder::set_capability_namespace):<br>required: **true**<br><p>The namespace of the gateway capability configuration to be updated. For example, if you configure OPC UA sources for an MQTT-enabled gateway, your OPC-UA capability configuration has the namespace <code>iotsitewise:opcuacollector:3</code>.</p><br>
    ///   - [`capability_configuration(impl Into<String>)`](crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder::capability_configuration) / [`set_capability_configuration(Option<String>)`](crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder::set_capability_configuration):<br>required: **true**<br><p>The JSON document that defines the configuration for the gateway capability. For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-sources.html#configure-source-cli">Configuring data sources (CLI)</a> in the <i>IoT SiteWise User Guide</i>.</p><br>
    /// - On success, responds with [`UpdateGatewayCapabilityConfigurationOutput`](crate::operation::update_gateway_capability_configuration::UpdateGatewayCapabilityConfigurationOutput) with field(s):
    ///   - [`capability_namespace(String)`](crate::operation::update_gateway_capability_configuration::UpdateGatewayCapabilityConfigurationOutput::capability_namespace): <p>The namespace of the gateway capability.</p>
    ///   - [`capability_sync_status(CapabilitySyncStatus)`](crate::operation::update_gateway_capability_configuration::UpdateGatewayCapabilityConfigurationOutput::capability_sync_status): <p>The synchronization status of the gateway capability configuration. The sync status can be one of the following:</p> <ul>  <li>   <p><code>IN_SYNC</code> - The gateway is running with the latest configuration.</p></li>  <li>   <p><code>OUT_OF_SYNC</code> - The gateway hasn't received the latest configuration.</p></li>  <li>   <p><code>SYNC_FAILED</code> - The gateway rejected the latest configuration.</p></li>  <li>   <p><code>UNKNOWN</code> - The gateway hasn't reported its sync status.</p></li>  <li>   <p><code>NOT_APPLICABLE</code> - The gateway doesn't support this capability. This is most common when integrating partner data sources, because the data integration is handled externally by the partner.</p></li> </ul> <p>After you update a capability configuration, its sync status is <code>OUT_OF_SYNC</code> until the gateway receives and applies or rejects the updated configuration.</p>
    /// - On failure, responds with [`SdkError<UpdateGatewayCapabilityConfigurationError>`](crate::operation::update_gateway_capability_configuration::UpdateGatewayCapabilityConfigurationError)
    pub fn update_gateway_capability_configuration(
        &self,
    ) -> crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder {
        crate::operation::update_gateway_capability_configuration::builders::UpdateGatewayCapabilityConfigurationFluentBuilder::new(
            self.handle.clone(),
        )
    }
}