Une fois que vous avez identifié les types d'objet requis pour l'adaptateur, indiquez les valeurs de paramètre pour les types d'objet afin de créer une instance de l'adaptateur. Votre demande POST comprend le corps de la demande avec les paramètres requis.

Le paramètre VCURL est obligatoire pour créer une instance de l'adaptateur.

Conditions préalables

Vérifiez que vous disposez d'une adresse IP et d'informations d'identification pour un vCenter.

Procédure

  1. Effectuez une demande POST pour créer l'instance de l'adaptateur.
    POST https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/adapters
  2. Examinez la réponse pour trouver le nom de la solution vSphere et ses types d'adaptateur.
    Reportez-vous à la section réponse de Instance de l'adaptateur.

Exemple : Instance de l'adaptateur

Cet exemple crée l'instance de l'adaptateur pour un vCenter avec les paramètres suivants :

  • Nom complet : instance de l'adaptateur VC
  • Description : instance de l'adaptateur vCenter pour VC 12.345.678.9
  • Adresse IP de vCenter Server : https://12.345.678.9
  • Nom des informations d'identification : VC-Credentials-1
  • Nom d'utilisateur : administrator@vsphere.local
  • Mot de passe : VC-dummy-passwd

AUTODISCOVERY et PROCESSCHANGEEVENTS sont facultatifs, mais sont tout de même inclus pour afficher des exemples supplémentaires d'identifiants de ressources dans le corps de la demande et dans la réponse.

En-tête de la demande :
POST https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/adapters
Corps de la demande au format 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"
      } 
    ],
  },
}
Extrait de la réponse au format 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"
}

L'API crée un nouvel adaptateur avec un UUID généré en interne qui identifie l'objet de manière unique. La réponse de l'API comporte les certificats présentés par vCenter 12.345.678.9. La valeur de l'ID d'instance de l'adaptateur est utilisée pour démarrer la surveillance et la collecte des données.