Skip to main content

UpdateServiceSimpleUpdateAction

Struct UpdateServiceSimpleUpdateAction 

Source
pub struct UpdateServiceSimpleUpdateAction {
    pub image_uri: Option<String>,
    pub transfer_protocol: Option<TransferProtocolType>,
    pub targets: Option<Vec<String>>,
    pub username: Option<String>,
    pub password: Option<String>,
    pub force_update: Option<Boolean>,
    pub stage: Option<Boolean>,
    pub local_image: Option<Boolean>,
    pub exclude_targets: Option<Vec<String>>,
}
Expand description

This action updates software components.

This action shall update installed software components in a software image file located at an ImageURI parameter-specified URI.

Fields§

§image_uri: Option<String>

The URI of the software image to install.

This parameter shall contain an RFC3986-defined URI that links to a software image that the update service retrieves to install software in that image. This URI should contain a scheme that describes the transfer protocol. If the TransferProtocol parameter is absent or not supported, and a transfer protocol is not specified by a scheme contained within this URI, the service shall use HTTP to get the image.

§transfer_protocol: Option<TransferProtocolType>

The network protocol that the update service uses to retrieve the software image file located at the URI specified by the ImageURI parameter. This parameter is ignored if the URI provided in ImageURI contains a scheme.

This parameter shall contain the network protocol that the update service shall use to retrieve the software image located at the URI specified by the ImageURI parameter. Services should ignore this parameter if the URI specified by the ImageURI parameter contains a scheme. If this parameter is not provided (or supported), and a transfer protocol is not specified by a scheme contained within this URI, the service shall use HTTP to retrieve the image.

§targets: Option<Vec<String>>

An array of URIs that indicate where to apply the update image.

This parameter shall contain zero or more URIs that indicate where to apply the update image. These targets should correspond to software inventory instances or their related items. If this parameter is not present or contains no targets, the service shall apply the software image to all applicable targets, as determined by the service. If the target specifies a device resource, the software image file shall be applied to the specified device. If the target specifies a resource collection, the software image shall be applied to each applicable member of the specified collection. If the target resource specifies an Aggregate resource, the software image file shall be applied to each applicable element of the specified aggregate. If the target resource specifies a ComputerSystem resource, the software image file shall be applied to the applicable components within the specified computer system.

§username: Option<String>

The username to access the URI specified by the ImageURI parameter.

This parameter shall contain the username to access the URI specified by the ImageURI parameter.

§password: Option<String>

The password to access the URI specified by the ImageURI parameter.

This parameter shall contain the password to access the URI specified by the ImageURI parameter.

§force_update: Option<Boolean>

An indication of whether the service should bypass update policies when applying the provided image. The default is false.

This parameter shall indicate whether the service should bypass update policies when applying the provided image, such as allowing a component to be downgraded. Services may contain update policies that are never bypassed, such as minimum version enforcement. If the client does not provide this parameter, the service shall default this value to false.

§stage: Option<Boolean>

An indication of whether the service stages the image on target devices for a client to activate at a later time.

This parameter shall indicate whether the service stages the image on target devices for a client to activate at a later time with the Activate action on the SoftwareInventory resource. If the client does not provide this parameter, the service shall default this value to false.

§local_image: Option<Boolean>

An indication of whether the service adds the image to the local image store.

This parameter shall indicate whether the service adds the image to the resource collection referenced by the LocalImageStore property. If the client does not provide this parameter, the service shall default this value to false.

§exclude_targets: Option<Vec<String>>

An array of URIs that indicate where not to apply the update image.

This parameter shall contain zero or more URIs that indicate where not to apply the update image. This parameter shall be ignored if the Targets parameter is provided and contains at least one member. These excluded targets should correspond to software inventory instances or their related items. If this parameter is not present or contains no targets, the service shall apply the software image to all applicable targets, as determined by the service. If an excluded target specifies a device resource, the software image file shall not be applied to that specified device. If an excluded target specifies a resource collection, the software image shall not be applied to each applicable member of the specified collection. If an excluded target resource specifies an Aggregate resource, the software image file shall not be applied to each applicable element of the specified aggregate. If an excluded target resource specifies a ComputerSystem resource, the software image file shall not be applied to the applicable components within the specified computer system.

Trait Implementations§

Source§

impl Debug for UpdateServiceSimpleUpdateAction

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Serialize for UpdateServiceSimpleUpdateAction

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

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
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more