Search Index Find Child

Finds a particular child based on a managed entity name.

This only searches the immediate children of a managed entity. For a Datacenter, the host and vm folders are considered children. For a ComputeResource, the hosts and root ResourcePool are considered children.

Required privileges: System.View

Request

URI

POST

https://{api_host}/sdk/vim25/{release}/SearchIndex/{moId}/FindChild

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 SearchIndex/{moId}.

string

release

Required

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

Request Body

FindChildRequestType of type(s) application/json

Required

"FindChildRequestType Object"

entity

Required

A reference to a managed entity.

string

name

Required

The name of the child object.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

The managed entity that is found, or null if no match is found.

This response body class contains all of the following: MoRefManagedEntity

{
    "0": "M",
    "1": "o",
    "2": "R",
    "3": "e",
    "4": "f",
    "5": "M",
    "6": "a",
    "7": "n",
    "8": "a",
    "9": "g",
    "10": "e",
    "11": "d",
    "12": "E",
    "13": "n",
    "14": "t",
    "15": "i",
    "16": "t",
    "17": "y",
    "18": " ",
    "19": "O",
    "20": "b",
    "21": "j",
    "22": "e",
    "23": "c",
    "24": "t"
}

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/SearchIndex/{moId}/FindChild

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

200 Response Body

Virtual Infrastructure Operations

POST

Search Index Find All By Dns Name

POST