アダプタに必要なオブジェクト タイプを特定したら、オブジェクト タイプのパラメータ値を指定して、アダプタ インスタンスを作成します。POST 要求には、必要なパラメータを含む要求本文が含まれています。
アダプタ インスタンスを作成するには、VCURL 設定が必要です。
前提条件
vCenter サーバの IP アドレスと認証情報が用意されていることを確認します。
手順
例: アダプタ インスタンス
この例では、次のパラメータを使用して、vCenter のアダプタ インスタンスを作成します。
- 表示名:VC アダプタ インスタンス
- 説明:VC 12.345.678.9 の vCenter アダプタ インスタンス
- vCenter Server IP アドレス:https://12.345.678.9
- 認証情報名:VC-Credential-1
- ユーザー名:[email protected]
- パスワード:VC-dummy-passwd
AUTODISCOVERY と PROCESSCHANGEEVENTS はオプションですが、要求本文と応答でリソース識別子のその他の例を表示する場合に指定します。
要求ヘッダー:
POST https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/adaptersJSON 形式の要求本文:
{ "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 の値は、データの監視と収集を開始するために使用されます。