Criar a instância do adaptador

Depois de identificar os tipos de objeto necessários para o adaptador, forneça valores de parâmetro para os tipos de objeto para criar uma instância do adaptador. Sua solicitação POST inclui um corpo de solicitação com os parâmetros necessários.

Para criar uma instância do adaptador, a configuração VCURL é obrigatória.

Pré-requisitos

Verifique se você tem um endereço IP e credenciais para um vCenter.

Procedimento

1. Faça uma solicitação POST para criar a instância do adaptador.

   POST https://operations.example.com/suite-api/api/adapters

2. Examine a resposta para localizar o nome da Solução vSphere e seus tipos de adaptador.
   Consulte a parte de resposta de Instância do adaptador.

Exemplo: Instância do adaptador

Este exemplo cria a instância do adaptador para um vCenter com os seguintes parâmetros:

• Nome para exibição: Instância do Adaptador VC
• Descrição: uma instância de adaptador vCenter para VC 12.345.678.9
• vCenter Server Endereço IP: https://12.345.678.9
• Nome da credencial: VC-Credential-1
• Nome de usuário: [email protected]
• Senha: VC-dummy-passwd

AUTODISCOVERY e PROCESSCHANGEEVENTS são opcionais, mas estão incluídos para mostrar exemplos adicionais de identificadores de recursos no corpo da solicitação e na resposta.

Cabeçalho da solicitação:

POST https://operations.example.com/suite-api/api/adapters

Corpo da solicitação no 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" : "[email protected]"
      }, 
      {
        "name" : "PASSWORD",
        "value" : "VC-dummy-passwd"
      } 
    ],
  },
}

Trecho da resposta em 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"
}

A API cria um novo adaptador com um UUID gerado internamente que identifica exclusivamente o objeto. A resposta da API inclui os certificados que o vCenter 12.345.678.9 apresenta. O valor do ID da instância do adaptador é usado para iniciar o monitoramento e a coleta de dados.