Skip to main content

CustomizationSpecManager

Struct CustomizationSpecManager 

Source
pub struct CustomizationSpecManager { /* private fields */ }
Expand description

The CustomizationSpecManager managed object is used to manage customization specifications stored on the VirtualCenter server.

Implementations§

Source§

impl CustomizationSpecManager

Source

pub fn new(client: Arc<dyn VimClient>, mo_id: &str) -> Self

Source

pub async fn check_customization_resources(&self, guest_os: &str) -> Result<()>

Deprecated as of vSphere 9.0, and there is no replacement for it.

Validate that required resources are available on the server to customize a particular guest operating system.

These would include sysprep for Windows and the debugfs and changefs volume editors for Linux guests.

Required privileges: System.View

§Parameters:
§guest_os

Short name from the guest OS descriptor list describing the OS we intend to customize.

§Errors:

MissingLinuxCustResources:

MissingWindowsCustResources:

UncustomizableGuest:

Source

pub async fn create_customization_spec( &self, item: &CustomizationSpecItem, ) -> Result<()>

Creates a new specification.

Required privileges: VirtualMachine.Provisioning.ModifyCustSpecs

§Parameters:
§item
§Errors:

AlreadyExists:

CannotDecryptPasswords:

Source

pub async fn delete_customization_spec(&self, name: &str) -> Result<()>

Deletes a specification.

Required privileges: VirtualMachine.Provisioning.ModifyCustSpecs

§Parameters:
§name
§Errors:

NotFound:

Source

pub async fn duplicate_customization_spec( &self, name: &str, new_name: &str, ) -> Result<()>

Duplicates a specification.

Required privileges: VirtualMachine.Provisioning.ModifyCustSpecs

§Parameters:
§name
§new_name
§Errors:

NotFound:

AlreadyExists:

Source

pub async fn does_customization_spec_exist(&self, name: &str) -> Result<bool>

Whether or not a specification exists.

Required privileges: VirtualMachine.Provisioning.ReadCustSpecs

§Parameters:
§name
Source

pub async fn get_customization_spec( &self, name: &str, ) -> Result<CustomizationSpecItem>

Obtains a specification for the given name.

Required privileges: VirtualMachine.Provisioning.ReadCustSpecs

§Parameters:
§name

Unique name identifying the requested customization specification.

§Errors:

NotFound:

Source

pub async fn is_guest_os_customizable(&self, guest_id: &str) -> Result<bool>

Whether or not the guest OS is customizable.

Since: vSphere API Release 9.0.0.0

Required privileges: System.View

§Parameters:
§guest_id

Short name from the guest OS descriptor list describing the OS we intend to check.

Source

pub async fn overwrite_customization_spec( &self, item: &CustomizationSpecItem, ) -> Result<()>

Overwrites an existing specification, possibly after retrieving (by using ‘get’) and editing it.

If, based on the item’s changeVersion value, the overwrite process detects that the specification has changed since its retrieval, then the API uses the SpecModified exception to warn clients that they might overwrite another client’s change.

Required privileges: VirtualMachine.Provisioning.ModifyCustSpecs

§Parameters:
§item
§Errors:

NotFound:

ConcurrentAccess:

CannotDecryptPasswords:

Source

pub async fn rename_customization_spec( &self, name: &str, new_name: &str, ) -> Result<()>

Renames a specification.

Required privileges: VirtualMachine.Provisioning.ModifyCustSpecs

§Parameters:
§name
§new_name
§Errors:

NotFound:

AlreadyExists:

Source

pub async fn customization_spec_item_to_xml( &self, item: &CustomizationSpecItem, ) -> Result<String>

Converts a specification item to XML text

Required privileges: System.View

§Parameters:
§item
Source

pub async fn xml_to_customization_spec_item( &self, spec_item_xml: &str, ) -> Result<CustomizationSpecItem>

Converts an XML string to a specification item

Required privileges: System.View

§Parameters:
§spec_item_xml
§Errors:

Failure

Source

pub async fn encryption_key(&self) -> Result<Option<Vec<i8>>>

Gets a binary public encryption key that can be used to encrypt passwords in stored specifications.

Required privileges: System.View

Source

pub async fn info(&self) -> Result<Option<Vec<CustomizationSpecInfo>>>

Gets a list of information on available specifications.

Required privileges: VirtualMachine.Provisioning.ReadCustSpecs

Trait Implementations§

Source§

impl Clone for CustomizationSpecManager

Source§

fn clone(&self) -> CustomizationSpecManager

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. 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> AsAny for T
where T: 'static,

Source§

fn as_any_ref<'a>(&'a self) -> &'a (dyn Any + 'static)

Cast a reference to Any trait.

Source§

fn as_any_box(self: Box<T>) -> Box<dyn Any>

Cast to a boxed reference to Any trait.

Source§

fn type_id(&self) -> TypeId

Get the underlying type identifier.
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<To, T> CastInto<To> for T
where To: CastFrom<T> + ?Sized, T: 'static + ?Sized,

Source§

fn into_ref<'a>(&'a self) -> Option<&'a To>

Casts a reference to a trait object. If the cast fails, std::option::Option::None is returned.
Source§

fn into_box(self: Box<T>) -> Result<Box<To>, Box<dyn Any>>

Casts a boxed trait object to another trait object. If the cast fails, the original boxed trait object is returned in std::result::Result::Err.
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. 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
Source§

impl<T> ErasedDestructor for T
where T: 'static,