Carga de amostra para registros de instalação de software VMware

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Uma carga de amostra do pacote de fornecedor VMware que preenche a tabela Consumo de chave de licença descoberta VMware [samp_vmware_license_key_usage] com registros de instalação de software de fontes de descoberta de terceiros.

    Depois de descobrir instalações de software por meio de sua origem de descoberta, envie uma carga por meio do endpoint IRE REST API para a instância da ServiceNow para preencher a tabela Consumo de chave de licença descoberta do VMware [samp_vmware_license_key_usage] com registros de instalação de software.
    Nota:
    Na página Propriedades, certifique-se de selecionar a propriedade Habilitar trabalhos agendados ao usar Estrutura de integração de fonte de dados de terceiros [com.snc.samp.ire.datasource.integration].
    1. Envie uma carga para criar uma chave de licença na tabela Chave de licença descoberta do VMware [samp_vmware_license_key].
    2. No corpo de resposta da carga, copie o sys ID da nova chave de licença e cole-o em um editor de texto para uso posterior.
    3. Use a API IRE aprimorada para consultar os sys IDs dos ICs que usam a nova chave de licença.
    4. No corpo da resposta, copie os sys IDs dos ICs e cole-os em um editor de texto para uso posterior.
    5. Envie uma carga com o sys ID da chave de licença e o sys ID dos ICs.
    6. Execute o trabalho de programação SAM- Atualizar uso de software para preencher a tabela Consumo de chave de licença descoberta do VMware [samp_vmware_license_key_usage] com os registros de instalação de software.
    Request Body
    { 'items': [
                    {'className':'cmdb_ci_vcenter',
                  'related': [
                              {
                              className:'samp_vmware_license_key',
                                values:{
                                 'cost_unit':'cpuPackage',
                                          'edition':'esxEnterprisePlus.vram',
                                          'features':'autodeploy,das,dpvmotion',
                                          'license_key':'SYDOJ-28J5Q-78X48-0NC24-REKAR',
                                          'product_name':'VMware vSphere 5 Enterprise Plus',
                                          'product_version':'5.0',
                                          'rights_owned':'8',
                                          'rights_used':'6'
                                  }
                              }
                            
                            ],
                  'values': {
                     'name':'VCenter Ref 1A'
                      }
                  },
                  {
                    'className':'cmdb_ci_win_server',
                     'values': {'name':'VirtualMachine-WS2'
                               }
                          }
                  ],
                  'relations':[{
                       'type':'Runs on::Runs',
                       'parent':0,
                       'child':1
                     }]
                }
    
    Response Body
    {
      "result": {
        "items": [
          {
            "className": "cmdb_ci_vcenter",
            "operation": "INSERT",
            "sysId": "8fb47793e7cc10107aea07d8d2f6a93a",
            "relatedSysIds": [
              "cbb47793e7cc10107aea07d8d2f6a93f"
            ],
            "relatedItems": [
              {
                "className": "samp_vmware_license_key",
                "sysId": "cbb47793e7cc10107aea07d8d2f6a93f",
                "markers": [],
                "inputIndices": [
                  {
                    "mainIndex": 0,
                    "subIndex": 0
                  }
                ]
              }
            ],
            "additionalRelatedItems": [],
            "identifierEntrySysId": "Unknown",
            "identificationAttempts": [
              {
                "attributes": [
                  "name"
                ],
                "identifierName": "VMWare VCenter Ref CI",
                "attemptResult": "NO_MATCH",
                "searchOnTable": "cmdb_ci_vcenter",
                "hybridEntryCiAttributes": []
              }
            ],
            "errorCount": 0,
            "markers": [],
            "inputIndices": [
              0
            ]
          },
          {
            "className": "cmdb_ci_win_server",
            "operation": "UPDATE",
            "sysId": "30ccb31ddbe7720087b9fd441d961992",
            "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
            "identificationAttempts": [
              {
                "attributes": [
                  "serial_number",
                  "serial_number_type"
                ],
                "identifierName": "Hardware Rule",
                "attemptResult": "SKIPPED",
                "searchOnTable": "cmdb_serial_number",
                "hybridEntryCiAttributes": []
              },
              {
                "attributes": [
                  "serial_number"
                ],
                "identifierName": "Hardware Rule",
                "attemptResult": "SKIPPED",
                "searchOnTable": "cmdb_ci_hardware",
                "hybridEntryCiAttributes": []
              },
              {
                "attributes": [
                  "name"
                ],
                "identifierName": "Hardware Rule",
                "attemptResult": "MATCHED",
                "searchOnTable": "cmdb_ci_hardware",
                "hybridEntryCiAttributes": []
              }
            ],
            "errorCount": 0,
            "markers": [],
            "inputIndices": [
              1
            ]
          }
        ],
        "additionalCommittedItems": [],
        "relations": [
          {
            "className": "cmdb_rel_ci",
            "operation": "INSERT",
            "sysId": "43b47793e7cc10107aea07d8d2f6a940",
            "identifierEntrySysId": "Unknown",
            "errorCount": 0,
            "markers": [],
            "inputIndices": [
              0
            ]
          }
        ],
        "additionalCommittedRelations": []
      }
    }
    
    From this we get the samp_vmware_license_key sys id
    "relatedSysIds": [
              "cbb47793e7cc10107aea07d8d2f6a93f"
            ]
    
    -- Obtaining the CI sys id (POST)
    role: sam_admin
    
    
    https://k8s0057813-node1.thunder.lab3.service-now.com/api/now/identifyreconcile/queryEnhanced?sysparm_data_source=ServiceNow
    
    Request Body
    { 'items': [ {'className':'cmdb_ci_win_server', 'values': {'name':'Server-WS11'} }]}
    
    Response Body
    {
      "result": {
        "items": [
          {
            "className": "cmdb_ci_win_server",
            "operation": "UPDATE",
            "sysId": "99ccb31ddbe7720087b9fd441d9619da",
            "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
            "identificationAttempts": [
              {
                "identifierName": "Hardware Rule",
                "attemptResult": "SKIPPED",
                "attributes": [
                  "serial_number",
                  "serial_number_type"
                ],
                "searchOnTable": "cmdb_serial_number",
                "hybridEntryCiAttributes": []
              },
              {
                "identifierName": "Hardware Rule",
                "attemptResult": "SKIPPED",
                "attributes": [
                  "serial_number"
                ],
                "searchOnTable": "cmdb_ci_hardware",
                "hybridEntryCiAttributes": []
              },
              {
                "identifierName": "Hardware Rule",
                "attemptResult": "MATCHED",
                "attributes": [
                  "name"
                ],
                "searchOnTable": "cmdb_ci_hardware",
                "hybridEntryCiAttributes": []
              }
            ],
            "markers": [],
            "inputIndices": [
              0
            ],
            "mergedPayloadIds": [],
            "errorCount": 0
          }
        ],
        "additionalCommittedItems": [],
        "relations": [],
        "additionalCommittedRelations": []
      }
    }
    
    where  "sysId": "99ccb31ddbe7720087b9fd441d9619da" is the sys id of the ci/used_by
    
    
    // create usage table
    POST 
    https://k8s0057813-node1.thunder.lab3.service-now.com/api/now/table/samp_vmware_license_key_usage?sysparm_fields=sys_id
    
    {"license_key":"cbb47793e7cc10107aea07d8d2f6a93f","rights_used":"1","used_by":"99ccb31ddbe7720087b9fd441d9619da"}
    Elemento Valor Descrição
    nomeClasse cmdb_ci_vcenter Nome da tabela relacionada [samp_vmware_license_key]
    nomeClasse samp_vmware_license_key Nome da tabela em que a chave de licença é criada.
    nomeClasse cmdb_ci_win_server O nome da tabela do servidor Windows
    nome VirtualMachine-WS2 Nome da máquina virtual do servidor Windows.