アダプタに必要なオブジェクト タイプを特定したら、オブジェクト タイプのパラメータ値を指定して、アダプタ インスタンスを作成します。POST 要求には、必要なパラメータを含む要求本文が含まれています。

アダプタ インスタンスを作成するには、VCURL 設定が必要です。

前提条件

vCenter サーバの IP アドレスと認証情報が用意されていることを確認します。

手順

  1. POST 要求を作成して、アダプタ インスタンスを生成します。
    POST https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/adapters
  2. 応答を調べ、vSphere Solution の名前とそのアダプタ タイプを検索します。
    アダプタ インスタンス の応答部分を参照してください。

例: アダプタ インスタンス

この例では、次のパラメータを使用して、vCenter のアダプタ インスタンスを作成します。

  • 表示名:VC アダプタ インスタンス
  • 説明:VC 12.345.678.9 の vCenter アダプタ インスタンス
  • vCenter Server IP アドレス:https://12.345.678.9
  • 認証情報名:VC-Credential-1
  • ユーザー名:[email protected]
  • パスワード:VC-dummy-passwd

AUTODISCOVERYPROCESSCHANGEEVENTS はオプションですが、要求本文と応答でリソース識別子のその他の例を表示する場合に指定します。

要求ヘッダー:
POST https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/adapters
JSON 形式の要求本文:
{
  "name" : "VC Adapter Instance",
  "description" : "A vCenter Adapter Instance for VC 12.345.678.9",
  "collectorId" : "1",
  "adapterKindKey" : "VMWARE",
  "resourceIdentifiers" : [ 
    {
      "name" : "AUTODISCOVERY",
      "value" : "true"
    }, 
    {
      "name" : "PROCESSCHANGEEVENTS",
      "value" : "true"
    }, 
    {
      "name" : "VCURL",
      "value" : "https://12.345.678.9"
    } 
  ],
  "credential" : {
    "id" : null,
    "name" : "VC-Credential-1",
    "adapterKindKey" : "VMWARE",
    "credentialKindKey" : "PRINCIPALCREDENTIAL",
    "fields" : [ 
      {
        "name" : "USER",
        "value" : "[email protected]"
      }, 
      {
        "name" : "PASSWORD",
        "value" : "VC-dummy-passwd"
      } 
    ],
  },
}
JSON での応答のスニペット:
201 Created
{
  "resourceKey": {
    "name": "VC Adapter Instance",
    "adapterKindKey": "VMWARE",
    "resourceKindKey": "VMwareAdapter Instance",
    "resourceIdentifiers": [
      {
        "identifierType": {
          "name": "AUTODISCOVERY",
          "dataType": "STRING",
          "isPartOfUniqueness": false
        },
        "value": "true"
      },
      {
        "identifierType": {
          "name": "DISABLE_COMPUTATION_BASED_ON_CONSUMERS",
          "dataType": "STRING",
          "isPartOfUniqueness": false
        },
        "value": ""
      },
      {
        "identifierType": {
          "name": "DV_PORT_GROUP_DISABLED",
          "dataType": "STRING",
          "isPartOfUniqueness": false
        },
        "value": ""
      },
      {
        "identifierType": {
        "name": "DVS_DISABLED",
        "dataType": "STRING",
        "isPartOfUniqueness": false
        },
        "value": ""
      },
      {
        "identifierType": {
          "name": "PROCESSCHANGEEVENTS",
          "dataType": "STRING",
          "isPartOfUniqueness": false
        },
        "value": "true"
      },
      {
        "identifierType": {
          "name": "VCURL",
          "dataType": "STRING",
          "isPartOfUniqueness": true
        },
        "value": "https://12.345.678.9"
      },
      {
        "identifierType": {
          "name": "VM_FOLDER_DISABLED",
          "dataType": "STRING",
          "isPartOfUniqueness": false
        },
        "value": ""
      },
      {
        "identifierType": {
          "name": "VM_LIMIT",
          "dataType": "STRING",
          "isPartOfUniqueness": false
        },
        "value": ""
      }
    ]
  },
  "description": "A vCenter Adapter Instance for VC 12.345.678.9",
  "collectorId": 1,
  "collectorGroupId": "909c2fbf-2c2c-4957-9a75-21bf2a887d31",
  "credentialInstanceId": "65081a8d-d462-43b2-b4e0-596eaf3d497e",
  "monitoringInterval": 5,
  "adapter-certificates": [
    {
      "thumbprint": "2520fb4351bc91ee7b82ef7cc54a8d88fa893da9",
      "certificateDetails": "[ 
        Version: V3 Subject: C=US, CN=12.345.678.9 
        Signature Algorithm: SHA256withRSA, OID = 1.2.840.113549.1.1.11 
        Key: Sun RSA public key, 2048 bits modulus: ... 
        Validity: [From: Wed Jul 15 19:26:51 UTC 2015, To: Tue Jul 08 11:26:30 UTC 2025] 
        Issuer: O=W12R2UINanduVC, C=US, DC=local, DC=vsphere, CN=CA ...
          ...
      ]"
    }
  ],
  ...
  "id": "a97bd204-e3e5-404b-a219-e2b20cf158d2"
}

API は、オブジェクトを一意に識別する内部生成の UUID を持つ新しいアダプタを作成します。API 応答には、vCenter 12.345.678.9 によって提示される証明書が含まれています。アダプタ インスタンス ID の値は、データの監視と収集を開始するために使用されます。