Test Connection

Test Adapter Instance connection

Request

URI

POST

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

COPY

Request Body

The adapter instance connection request

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

Required

Show optional properties

{
    "name": "string",
    "adapterKindKey": "string"
}

"{\n  \"name\" : \"VC Adapter Instance\",\n  \"description\" : \"A vCenter Adapter Instance\",\n  \"collectorId\" : \"1\",\n  \"adapterKindKey\" : \"VMWARE\",\n  \"resourceIdentifiers\" : [ {\n    \"name\" : \"AUTODISCOVERY\",\n    \"value\" : \"true\"\n  }, {\n    \"name\" : \"PROCESSCHANGEEVENTS\",\n    \"value\" : \"true\"\n  }, {\n    \"name\" : \"VCURL\",\n    \"value\" : \"VC_IP_Address\"\n  } ],\n  \"credential\" : {\n    \"name\" : \"Principal Credential\",\n    \"adapterKindKey\" : \"VMWARE\",\n    \"credentialKindKey\" : \"PRINCIPALCREDENTIAL\",\n    \"fields\" : [ {\n      \"name\" : \"USER\",\n      \"value\" : \"user_name\"\n    }, {\n      \"name\" : \"PASSWORD\",\n      \"value\" : \"passwd\"\n    } ]\n  },\n  \"monitoringInterval\" : 1\n}"

string

name

Required

Constraints: minLength: 3 maxLength: 300

The name of the Adapter instance

string

description

Optional

Optional description of the Adapter instance

string

collectorId

Optional

The Collector instance used by this adapter instance. If not specified, the system will choose an appropriate Collector for you

string As uuid As uuid

collectorGroupId

Optional

The Collector Group ID to be used for this Adapter Instance. If not specified, the system will choose an appropriate Collector group for you

string

adapterKindKey

Required

The Adapter Kind key

array of object

resourceIdentifiers

Optional

Adapter instance specific resource identifiers

object

credential

Optional

The Credential Instance information

integer As int32 As int32

monitoringInterval

Optional

Constraints: minimum: 0

Minutes part of the monitoring Interval of the Adapter Instance, where the monitoring Interval is the frequency of data source query for stats and properties.

integer As int32 As int32

monitoringIntervalSeconds

Optional

Constraints: minimum: 0

Seconds part of the monitoring Interval of the Adapter Instance, where the monitoring Interval is the frequency of data source query for stats and properties.

string As uuid As uuid

physicalDatacenterId

Optional

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

Authentication

This operation uses the following authentication methods.

Token-based-authorization

Responses

201

The adapter instance that was created

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

"{\n  \"resourceKey\" : {\n    \"name\" : \"VC Adapter Instance\",\n    \"adapterKindKey\" : \"VMWARE\",\n    \"resourceKindKey\" : \"VMwareAdapter Instance\",\n    \"resourceIdentifiers\" : [ ]\n  },\n  \"description\" : \"A vCenter Adapter Instance\",\n  \"collectorId\" : 1,\n  \"credentialInstanceId\" : \"3c355aea-00ff-4d46-84bd-37b14738ce70\",\n  \"adapter-certificates\" : [ {\n    \"thumbprint\" : \"a07f2502-f0aa-4ce4-af59-e92424ca4d3e\",\n    \"certificateDetails\" : \"Issued by VMware, Inc. Expires: 01/01/2020\"\n  } ],\n  \"id\" : \"d3afdc54-86ae-4372-8312-afe91178e95c\"\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 Test 'adapter instance connection' failed. Typically the service will return extra information as to why the creation failed.

Operation doesn't return any data structure

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"adapterKindKey:"string","name:"string"}' https://{api_host}/suite-api/api/adapters/testConnection

On This Page

Description

Request

Request Body

Authentication

Response

201 Response Body

Errors

Adapters Operations

GET

Enumerate Adapter Instances

PUT