Property Collector Retrieve Properties Ex

Property Collector Retrieve Properties Ex

Retrieves the specified properties of the specified managed objects.

This method is similar to creating the filters, receiving the property values, and destroying the filters. The main difference is that the output blends the results from all the filters and reports a given managed object at most once no matter how many filters apply.

The filter creation step can throw all of the same faults as CreateFilter.

Required privileges: System.Anonymous

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

string
release
Required

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


Request Body
RetrievePropertiesExRequestType of type(s) application/json
Required
{
    "specSet": [
        {
            "_typeName": "string",
            "propSet": [
                {
                    "_typeName": "string",
                    "type": "string",
                    "all": false,
                    "pathSet": [
                        "string"
                    ]
                }
            ],
            "objectSet": [
                {
                    "_typeName": "string",
                    "obj": {
                        "type": "string",
                        "value": "string"
                    },
                    "skip": false,
                    "selectSet": [
                        {
                            "_typeName": "string",
                            "name": "string"
                        }
                    ]
                }
            ],
            "reportMissingObjectsInResults": false
        }
    ],
    "options": {
        "maxObjects": 0
    }
}
specSet
Required

Specifies the properties to retrieve.

options
Required

options

Authentication
This operation uses the following authentication methods.
Responses
200

retrieved objects or null if there are no matching objects.

Returns RetrieveResult of type(s) application/json
This response body class contains all of the following: DataObject
{
    "_typeName": "string",
    "token": "string",
    "objects": [
        {
            "_typeName": "string",
            "obj": {
                "type": "string",
                "value": "string"
            },
            "propSet": [
                {
                    "_typeName": "string",
                    "name": "string",
                    "val": {
                        "_typeName": "string"
                    }
                }
            ],
            "missingSet": [
                {
                    "_typeName": "string",
                    "path": "string",
                    "fault": {
                        "faultCause": "MethodFault Object",
                        "faultMessage": [
                            {
                                "_typeName": "string",
                                "key": "string",
                                "arg": [
                                    {
                                        "_typeName": "string",
                                        "key": "string",
                                        "value": {
                                            "_typeName": "string"
                                        }
                                    }
                                ],
                                "message": "string"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
string
token
Optional

A token used to retrieve further retrieve results.

If set, the token should be passed to PropertyCollector.ContinueRetrievePropertiesEx to retrieve more results. Each token may be passed to continueRetrievePropertiesEx only once, and only in the same session in which it was returned and to the same PropertyCollector object that returned it.

If unset, there are no further results to retrieve after this RetrieveResult.

objects
Required

retrieved objects.


500
Returns InvalidProperty of type(s) application/json
This response body class contains all of the following: MethodFault
{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ],
    "name": "string"
}
string
name
Required

The property name that generated the error.