Update Adapter Instance Using PUT

Update Adapter Instance Using PUT

The request body can accept a collectorId or a collectorGroupId, but not both.

Request
URI
PUT
https://{api_host}/api/adapters
COPY
Request Body

The adapter instance request for the update

adapter-instance of type(s) application/json
Required
{
    "adapter-certificates": [
        {
            "certificateDetails": "string",
            "expires": "string",
            "issuedBy": "string",
            "issuedTo": "string",
            "thumbprint": "string"
        }
    ],
    "collectorGroupId": "string",
    "collectorId": 0,
    "credentialInstanceId": "string",
    "description": "string",
    "id": "string",
    "lastCollected": "string",
    "lastHeartbeat": "string",
    "links": [
        {
            "description": "string",
            "href": "string",
            "name": "string",
            "rel": "string"
        }
    ],
    "messageFromAdapterInstance": "string",
    "monitoringInterval": 0,
    "monitoringIntervalMinutes": 0,
    "monitoringIntervalSeconds": 0,
    "numberOfMetricsCollected": 0,
    "numberOfResourcesCollected": 0,
    "resourceKey": {
        "adapterKindKey": "string",
        "extension": {
            "anyObjects": [
                {}
            ]
        },
        "links": [
            {
                "description": "string",
                "href": "string",
                "name": "string",
                "rel": "string"
            }
        ],
        "name": "string",
        "resourceIdentifiers": [
            {
                "identifierType": {
                    "dataType": "string",
                    "extension": {
                        "anyObjects": [
                            {}
                        ]
                    },
                    "isPartOfUniqueness": false,
                    "links": [
                        {
                            "description": "string",
                            "href": "string",
                            "name": "string",
                            "rel": "string"
                        }
                    ],
                    "name": "string"
                },
                "key": "string",
                "links": [
                    {
                        "description": "string",
                        "href": "string",
                        "name": "string",
                        "rel": "string"
                    }
                ],
                "name": "string",
                "uniquelyIdentifying": false,
                "value": "string"
            }
        ],
        "resourceKindKey": "string"
    }
}
adapter-certificates
Optional

The set of untrusted certificates returned by the adapter source

string As uuid As uuid
collectorGroupId
Optional

The ID of the collector group. If not specified, the system will choose an appropriate Collector group for you

integer As int32 As int32
collectorId
Optional

The ID of the Collector that manages this adapter instance. This is optional and if not specified, system will choose an appropriate collector.

string As uuid As uuid
credentialInstanceId
Optional

The Credential Instance identifier used by this adapter instance

string
description
Optional

Optional description of the Adapter instance

string As uuid As uuid
id
Optional

The UUID of the adapter instance

string As date-time As date-time
lastCollected
Optional

Last time adapter instance reported collection of resources/stats.

string As date-time As date-time
lastHeartbeat
Optional

When was the last time this adapter instance communicated with vRealize Operations Manager Server.

array of link
links
Optional

links

string
messageFromAdapterInstance
Optional

Any message from the adapter instance.

integer As int32 As int32
monitoringInterval
Optional

Minutes part of the monitoring Interval of the Adapter Instance.

integer As int32 As int32
monitoringIntervalMinutes
Optional

monitoringIntervalMinutes

integer As int32 As int32
monitoringIntervalSeconds
Optional

Seconds part of the monitoring Interval of the Adapter Instance

integer As int32 As int32
numberOfMetricsCollected
Optional

The number of metrics reported by this adapter instance.

integer As int32 As int32
numberOfResourcesCollected
Optional

The number of resources being monitored by this resource.

resourceKey
Optional

Represents a composite key for uniquely identifying a Resource.

Authentication
This operation uses the following authentication methods.
Responses
200

The adapter instance that was updated

Returns adapter-instance of type(s) application/json
{
    "adapter-certificates": [
        {
            "certificateDetails": "string",
            "expires": "string",
            "issuedBy": "string",
            "issuedTo": "string",
            "thumbprint": "string"
        }
    ],
    "collectorGroupId": "string",
    "collectorId": 0,
    "credentialInstanceId": "string",
    "description": "string",
    "id": "string",
    "lastCollected": "string",
    "lastHeartbeat": "string",
    "links": [
        {
            "description": "string",
            "href": "string",
            "name": "string",
            "rel": "string"
        }
    ],
    "messageFromAdapterInstance": "string",
    "monitoringInterval": 0,
    "monitoringIntervalMinutes": 0,
    "monitoringIntervalSeconds": 0,
    "numberOfMetricsCollected": 0,
    "numberOfResourcesCollected": 0,
    "resourceKey": {
        "adapterKindKey": "string",
        "extension": {
            "anyObjects": [
                {}
            ]
        },
        "links": [
            {
                "description": "string",
                "href": "string",
                "name": "string",
                "rel": "string"
            }
        ],
        "name": "string",
        "resourceIdentifiers": [
            {
                "identifierType": {
                    "dataType": "string",
                    "extension": {
                        "anyObjects": [
                            {}
                        ]
                    },
                    "isPartOfUniqueness": false,
                    "links": [
                        {
                            "description": "string",
                            "href": "string",
                            "name": "string",
                            "rel": "string"
                        }
                    ],
                    "name": "string"
                },
                "key": "string",
                "links": [
                    {
                        "description": "string",
                        "href": "string",
                        "name": "string",
                        "rel": "string"
                    }
                ],
                "name": "string",
                "uniquelyIdentifying": false,
                "value": "string"
            }
        ],
        "resourceKindKey": "string"
    }
}
adapter-certificates
Optional

The set of untrusted certificates returned by the adapter source

string As uuid As uuid
collectorGroupId
Optional

The ID of the collector group. If not specified, the system will choose an appropriate Collector group for you

integer As int32 As int32
collectorId
Optional

The ID of the Collector that manages this adapter instance. This is optional and if not specified, system will choose an appropriate collector.

string As uuid As uuid
credentialInstanceId
Optional

The Credential Instance identifier used by this adapter instance

string
description
Optional

Optional description of the Adapter instance

string As uuid As uuid
id
Optional

The UUID of the adapter instance

string As date-time As date-time
lastCollected
Optional

Last time adapter instance reported collection of resources/stats.

string As date-time As date-time
lastHeartbeat
Optional

When was the last time this adapter instance communicated with vRealize Operations Manager Server.

array of link
links
Optional

links

string
messageFromAdapterInstance
Optional

Any message from the adapter instance.

integer As int32 As int32
monitoringInterval
Optional

Minutes part of the monitoring Interval of the Adapter Instance.

integer As int32 As int32
monitoringIntervalMinutes
Optional

monitoringIntervalMinutes

integer As int32 As int32
monitoringIntervalSeconds
Optional

Seconds part of the monitoring Interval of the Adapter Instance

integer As int32 As int32
numberOfMetricsCollected
Optional

The number of metrics reported by this adapter instance.

integer As int32 As int32
numberOfResourcesCollected
Optional

The number of resources being monitored by this resource.

resourceKey
Optional

Represents a composite key for uniquely identifying a Resource.


400

If update 'adapter instance' failed. Typically the service will return extra information as to why update failed.

Operation doesn't return any data structure