Beispielnutzlast für VMware-Softwareinstallationsdatensätze
Eine Beispielnutzlast für das VMware-Herausgeberpaket, das die Tabelle für den erkannten VMware-Lizenzschlüsselverbrauch [samp_vmware_license_key_usage] mit Softwareinstallationsdatensätzen aus Discovery-Quellen von Drittanbietern füllt.
Nachdem Sie Softwareinstallationen über Ihre Discovery-Quelle erkannt haben, senden Sie eine Nutzlast über den IRE-REST-API-Endpunkt an die ServiceNow-Instanz, um die Tabelle für den erkannten VMware-Lizenzschlüsselverbrauch [samp_vmware_license_key_usage] mit Softwareinstallations-Datensätzen zu füllen.
Hinweis:
Stellen Sie sicher, dass auf der Seite „Eigenschaften“ die Eigenschaft Geplante Aufgaben aktivieren, wenn Integrations-Framework für Datenquellen von Drittparteien verwendet wird [com.snc.samp.ire.datasource.integration] aktiviert ist.
- Senden Sie eine Nutzlast, um einen Lizenzschlüssel in der Tabelle für erkannte VMware-Lizenzschlüssel [samp_vmware_license_key] zu erstellen.
- Kopieren Sie aus dem Antworttext der Nutzlast die Sys-ID des neuen Lizenzschlüssels, und fügen Sie sie zur späteren Verwendung in einen Texteditor ein.
- Verwenden Sie die erweiterte IRE-API, um die Sys-IDs der CIs abzufragen, die den neuen Lizenzschlüssel verwenden.
- Kopieren Sie aus dem Antworttext die Sys-IDs der CIs, und fügen Sie sie zur späteren Verwendung in einen Texteditor ein.
- Senden Sie eine Nutzlast mit der Sys-ID des Lizenzschlüssels und der Sys-ID der CIs.
- Führen Sie die geplante Aufgabe „SAM – Softwarenutzung aktualisieren“ aus, um die Tabelle für den erkannten VMware-Lizenzschlüsselverbrauch [samp_vmware_license_key_usage] mit den Softwareinstallationsdatensätzen zu füllen.
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"}| Element | Wert | Beschreibung |
|---|---|---|
| className | cmdb_ci_vcenter | Name der zugehörigen Tabelle [samp_vmware_license_key]. |
| className | samp_vmware_license_key | Name der Tabelle, in der der Lizenzschlüssel erstellt wird. |
| className | cmdb_ci_win_server | Der Name der Windows-Servertabelle |
| Name | VirtualMachine-WS2 | Name der virtuellen Maschine des Windows-Servers. |