Patch Adapter Instance

This is typically used to indicate VMware Cloud Foundation operations that the certificates presented by
the (data source for which the adapter instance) was created are indeed valid
certificates.
Typically the response of the POST /api/adapters API in its entirety needs to be
sent as request body when making this PATCH /api/adapters API invocation.
NOTE: In case the provided certificate list is empty, the adapter instance self-signed certificates will be reset.

Request

URI

PATCH

https://{api_host}/suite-api/api/adapters

COPY

Request Body

The adapter instance creation request.

adapter-instance of type(s) application/json

Required

Show optional properties

{
    "resourceKey": {
        "name": "string",
        "adapterKindKey": "string",
        "resourceKindKey": "string"
    },
    "adapter-certificates": [
        {}
    ]
}

"{\n  \"resourceKey\" : {\n    \"name\" : \"Adapter for VC@https://ip/sdk\",\n    \"adapterKindKey\" : \"VMWARE\",\n    \"resourceKindKey\" : \"VMwareAdapter Instance\",\n    \"resourceIdentifiers\" : [ {\n      \"identifierType\" : {\n        \"name\" : \"AUTODISCOVERY\",\n        \"dataType\" : \"STRING\",\n        \"isPartOfUniqueness\" : true\n      },\n      \"value\" : \"true\"\n    }, {\n      \"identifierType\" : {\n        \"name\" : \"PROCESSCHANGEEVENTS\",\n        \"dataType\" : \"STRING\",\n        \"isPartOfUniqueness\" : true\n      },\n      \"value\" : \"true\"\n    }, {\n      \"identifierType\" : {\n        \"name\" : \"VCURL\",\n        \"dataType\" : \"STRING\",\n        \"isPartOfUniqueness\" : true\n      },\n      \"value\" : \"https://ip/sdk\"\n    } ]\n  },\n  \"description\" : \"update certificates for adapter instance...\",\n  \"adapter-certificates\" : [ {\n    \"thumbprint\" : \"2a1fbfb9-5d3d-42b7-ba3c-564b5d9fd8ed\"\n  } ],\n  \"physicalDatacenterId\" : \"d0195e44-9acd-4ffe-95fd-8ac95ab493ab\",\n  \"id\" : \"9c4f821a-4ab2-45fd-b95a-d0114ac6e21d\"\n}"

object

resourceKey

Required

Represents a composite key for uniquely identifying a Resource.

string

description

Optional

Optional description of the Adapter instance

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

collectorGroupId

Optional

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

string As uuid As uuid

credentialInstanceId

Optional

The Credential Instance identifier used by this adapter instance

integer As int32 As int32

monitoringInterval

Optional

Constraints: minimum: 0

Minutes part of the monitoring Interval of the Adapter Instance.

integer As int32 As int32

monitoringIntervalSeconds

Optional

Constraints: minimum: 0

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.

integer As int64 As int64

lastHeartbeat

Optional

Last time when this adapter instance communicated with VMware Cloud Foundation Operations Server.

integer As int64 As int64

lastCollected

Optional

Last time adapter instance reported collection of resources/stats.

string

messageFromAdapterInstance

Optional

Any message from the adapter instance.

array of object

adapter-certificates

Required

The set of untrusted certificates returned by the adapter source

array of object

links

Optional

Represents a HTTP 'link' element.
It is implicit that all the link tags support http 'GET' method.

string As uuid As uuid

physicalDatacenterId

Optional

The Physical Datacenter ID to be used for this Adapter Instance.It is Optional

string As uuid As uuid

Optional

The UUID of the adapter instance

Authentication

This operation uses the following authentication methods.

Token-based-authorization

Responses

200

The adapter instance that was updated

Returns adapter-instance of type(s) application/json

"{\n  \"resourceKey\" : {\n    \"name\" : \"VC Adapter for 10.20.88.111\",\n    \"adapterKindKey\" : \"VMWARE\",\n    \"resourceKindKey\" : \"Adapter\",\n    \"resourceIdentifiers\" : [ ]\n  },\n  \"description\" : \"A vCenter Adapter Instance\",\n  \"collectorId\" : 1,\n  \"credentialInstanceId\" : \"676589f8-873b-4a7f-84d9-74a0abcbc476\",\n  \"id\" : \"4f393aaf-248a-431e-93f4-b13ab265df4d\"\n}"

object

resourceKey

Required

Represents a composite key for uniquely identifying a Resource.

string

description

Optional

Optional description of the Adapter instance

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

collectorGroupId

Optional

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

string As uuid As uuid

credentialInstanceId

Optional

The Credential Instance identifier used by this adapter instance

integer As int32 As int32

monitoringInterval

Optional

Constraints: minimum: 0

Minutes part of the monitoring Interval of the Adapter Instance.

integer As int32 As int32

monitoringIntervalSeconds

Optional

Constraints: minimum: 0

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.

integer As int64 As int64

lastHeartbeat

Optional

Last time when this adapter instance communicated with VMware Cloud Foundation Operations Server.

integer As int64 As int64

lastCollected

Optional

Last time adapter instance reported collection of resources/stats.

string

messageFromAdapterInstance

Optional

Any message from the adapter instance.

array of object

adapter-certificates

Required

The set of untrusted certificates returned by the adapter source

array of object

links

Optional

Represents a HTTP 'link' element.
It is implicit that all the link tags support http 'GET' method.

string As uuid As uuid

physicalDatacenterId

Optional

The Physical Datacenter ID to be used for this Adapter Instance.It is Optional

string As uuid As uuid

Optional

The UUID of the adapter instance

400

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

Operation doesn't return any data structure

Code Samples

COPY

                    curl -X PATCH -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"adapter-certificates":["object"],"resourceKey:"object"}'

On This Page

Description

Request

Request Body

Authentication

Response

200 Response Body

Errors

Adapters Operations

GET

Enumerate Adapter Instances

PUT