Después de identificar los tipos de objeto necesarios para el adaptador, deberá proporcionar los valores de los parámetros para los tipos de objeto a fin de crear una instancia de adaptador. La solicitud POST incluye un cuerpo de solicitud con los parámetros necesarios.

Para crear una instancia de adaptador, la configuración de VCURL es obligatoria.

Requisitos previos

Compruebe que tenga una dirección IP y credenciales para un vCenter.

Procedimiento

  1. Realice una solicitud POST para crear la instancia del adaptador. 
    POST https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/adapters
  2. Examine la respuesta para encontrar el nombre de la solución de vSphere y sus tipos de adaptador.
    Consulte la fracción de la respuesta de Instancia de adaptador.

Ejemplo: Instancia de adaptador

En este ejemplo, se crea la instancia del adaptador para un vCenter con los siguientes parámetros:

  • Nombre para mostrar: instancia del adaptador de VC
  • Descripción: una instancia del adaptador de vCenter para VC 12.345.678.9
  • Dirección IP de vCenter Server: https://12.345.678.9
  • Nombre de la credencial: VC-Credential-1
  • Nombre de usuario: administrator@vsphere.local
  • Contraseña: VC-dummy-passwd

AUTODISCOVERY y PROCESSCHANGEEVENTS son opcionales, pero se incluyen para mostrar ejemplos adicionales de identificadores de recursos en el cuerpo de la solicitud y en la respuesta.

Encabezado de solicitud: 
POST https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/adapters
Cuerpo de la solicitud en formato 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" : "administrator@vsphere.local"
      }, 
      {
        "name" : "PASSWORD",
        "value" : "VC-dummy-passwd"
      } 
    ],
  },
}
Fragmento de la respuesta en 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"
}

La API crea un nuevo adaptador con un UUID generado internamente que identifica de forma exclusiva el objeto. La respuesta de la API incluye los certificados que presenta vCenter 12.345.678.9. El valor del ID de instancia del adaptador se utiliza para iniciar la supervisión y la recopilación de datos.