Host Profile Manager Validate Host Profile Composition Task

Host Profile Manager Validate Host Profile Composition Task

Validates the proposed host profile composition.

Required privileges: Profile.Edit

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/HostProfileManager/{moId}/ValidateHostProfileComposition_Task
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case HostProfileManager/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
Required
"ValidateHostProfileCompositionRequestType Object"
source
Required

The source host profile of the configurations for composition.

array of object
targets
Optional

The array of target host profiles that the configurations composite into.

toBeMerged
Optional

A HostApplyProfile object contains the sub profiles that will be merged from the source to the target host profiles, and all the ancestors of these sub profiles. For singleton sub profile, it will be added into a target host profile if it doesn't exist in the target; otherwise, it replaces the one in the target. The member variable ApplyProfile.toBeMerged of these sub profiles should have a value of true. The member variables ApplyProfile.toBeMerged ApplyProfile.toReplaceWith, ApplyProfile.toBeDeleted of the ancestors should have a value of false.

toReplaceWith
Optional

A HostApplyProfile object contains the sub profiles that will be used to replace the array in the target host profiles, and all the ancestors of these sub profiles. Similar to above except that the member variable ApplyProfile.toReplaceWith is turned on.

toBeDeleted
Optional

A HostApplyProfile object contains the sub profiles that will be deleted from the source and the target host profiles, and all the ancestors of these sub profiles. Similar to above except that the member variable ApplyProfile.toBeDeleted is turned on.

enableStatusToBeCopied
Optional

A HostApplyProfile object contains the sub profiles that the member variable ApplyProfile.enabled will be copied from the source host profile to all the target host profiles, and all the ancestors of these sub profiles. The member variable ApplyProfile.copyEnableStatus of these sub profiles is turned on. The member variable ApplyProfile.copyEnableStatus of the ApplyProfile.copyEnableStatus of the ancestors should have a value of false.

boolean
errorOnly
Optional

Indicates that the validation result for each target don't contain the source-target difference.

Authentication
This operation uses the following authentication methods.
Responses
200

This method will returns a Task object with which to monitor the operation. The Task.info.result will contain a HostProfileManagerCompositionValidationResult object containing the status of the operation, any validation errors and the validation results.

Returns MoRefTask of type(s) application/json
"MoRefTask Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/HostProfileManager/{moId}/ValidateHostProfileComposition_Task