View Manager Create Container View

View Manager Create Container View

Create a ContainerView managed object for this session.

The method returns a reference to a ContainerView object that has a list of managed object references. The list references objects in the container and may include references to objects from additional containers. You can configure the resulting list of objects by specifying a type list and recursion. Once you have created the view, the object list always represents the current configuration of the virtual environment and reflects any subsequent changes that occur.

Required privileges: System.View

Request
URI
POST
https://{vcenter-host}/sdk/vim25/{release}/ViewManager/{moId}/CreateContainerView
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 ViewManager/{moId}.

string
release
Required

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


Request Body
CreateContainerViewRequestType of type(s) application/json
Required

Show optional properties

{
    "container": {},
    "recursive": false
}
{
    "container": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    },
    "type": [
        "string"
    ],
    "recursive": false
}
container
Required

Reference to an instance of the ManagedEntity managed object.

array of string
type
Optional

An optional list of managed entity types. The server associates only objects of the specified type(s) with the view. If you specify an empty array, the server uses all types.

boolean
recursive
Required

Whether to include only the immediate children of the container instance, or to include additional objects by following paths beyond the immediate children.

When recursive is false, the list of objects contains only immediate children. When recursive is true, the server populates the list by following references beyond the immediate children (using a child's references, and then references in the resulting objects, and so on).

Depending on the container type, the server will use the following properties of the container instance to obtain objects for the view's object list:

  • Folder object - Folder.childEntity property. If recursive is false, the container list includes the reference to the child entity in the folder instance. If recursive is true, the server will follow the child folder path(s) to collect additional childEntity references.
  • ResourcePool object - ResourcePool.vm and ResourcePool.resourcePool properties. If recursive is false, the object list will contain references to the virtual machines associated with this resource pool, and references to virtual machines associated with the immediate child resource pools. If recursive is true, the server will follow all child resource pool paths extending from the immediate children (and their children, and so on) to collect additional references to virtual machines.
  • ComputeResource object - ComputeResource.host and ComputeResource.resourcePool properties. If recursive is false, the object list will contain references to the host systems associated with this compute resource, references to virtual machines associated with the host systems, and references to virtual machines associated with the immediate child resource pools. If recursive is true, the server will follow the child resource pool paths (and their child resource pool paths, and so on) to collect additional references to virtual machines.
  • Datacenter object - Datacenter.vmFolder, Datacenter.hostFolder, Datacenter.datastoreFolder, and Datacenter.networkFolder properties. If recursive is set to false, the server uses the immediate child folders for the virtual machines, hosts, datastores, and networks associated with this datacenter. If recursive is set to true, the server will follow the folder paths to collect references to additional objects.
  • HostSystem object - HostSystem.vm property. The view object list contains references to the virtual machines associated with this host system. The value of recursive does not affect this behavior.
Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns MoRefContainerView of type(s) application/json
This response body class contains all of the following: MoRefManagedObjectView
{
    "_typeName": "string",
    "type": "string",
    "value": "string"
}