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
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.
POST https://operations.example.com/suite-api/api/adaptersCorpo 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" } ], }, }
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.