Extension Manager Find Extension

Extension Manager Find Extension

Returns extension with the given key, if any.

Required privileges: System.View

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/ExtensionManager/{moId}/FindExtension
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 ExtensionManager/{moId}.

string
release
Required

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


Request Body
FindExtensionRequestType of type(s) application/json
Required
"FindExtensionRequestType Object"
string
extensionKey
Required

Key to search for.

Authentication
This operation uses the following authentication methods.
Responses
200

Extension that matches given key, if any.

Returns Extension of type(s) application/json
"Extension Object"
object
description
Required

Static strings used for describing an object or property.

string
key
Required

Extension key.

Should follow java package naming conventions for uniqueness (e.g. "com.example.management").

Extension names can only contain characters belonging to the lower ASCII character set (UTF-7) with the exception of the following characters:

  1. All whitespace characters ("space" - ascii character 0x20 is allowed)
  2. Control characters
  3. Comma (ascii 0x2c), Forward slash (ascii 0x2f), Backward slash (ascii 0x5c), Hash/Pound (ascii 0x23), Plus (ascii 0x2b), Greater (ascii 0x3e), Lesser (ascii 0x3c), Equals (ascii 0x3d), Semi-colon (ascii 0x3b) and Double quote (ascii 0x22).
string
company
Optional

Company information.

string
type
Optional

Type of extension (example may include CP-DVS, NUOVA-DVS, etc.).

string
version
Required

Extension version number as a dot-separated string.

For example, "1.0.0"

string
subjectName
Optional

Subject name from client certificate.

array of object
server
Optional

Servers for this extension.

array of object
client
Optional

Clients for this extension.

array of object
taskList
Optional

Definitions of tasks defined by this extension.

array of object
eventList
Optional

Definitions of events defined by this extension.

array of object
faultList
Optional

Definitions of faults defined by this extension.

array of object
privilegeList
Optional

Definitions privileges defined by this extension.

array of object
resourceList
Optional

Resource data for all locales

string As date-time As date-time
lastHeartbeatTime
Required

Last extension heartbeat time.

object
healthInfo
Optional

This data object encapsulates the health specification for the extension.

object
ovfConsumerInfo
Optional

This data object contains configuration for extensions that also extend the OVF functionality of vCenter server.

Note: This feature is for internal use only.

object
extendedProductInfo
Optional

This data object encapsulates extended product information for an extension.

array of object
managedEntityInfo
Optional

Information about entities managed by this extension.

An extension can register virtual machines as managed by itself, by setting the managedBy property of the virtual machine.

boolean
shownInSolutionManager
Optional

Opt-in to the Solution Manager.

If set to true, this extension will be shown in the Solution Manager. If not set, or set to false, this extension is not shown in the Solution Manager.

object
solutionManagerInfo
Optional

This data object encapsulates the Solution Manager configuration for this extension.


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