---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# VMUtils - Global

# VMUtils - Global {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

The VMUtils script include provides methods for discovery and provisioning of virtual machines.

This script include is available in server-side scripts to convert between UUID and Correlation ID formats.

## VMUtils - turnCorrelationIdToUuid(String correlationId) {#ariaid-title2}

Converts a correlation ID into a UUID for a virtual machine in the ServiceNow
system.
{#r_VMU-turnCorrelationIdToUuid_S__table_ur3_kpw_4t__entry__3}

| Name | Type | Description |
|-|-|-|
| correlationId | String | The correlation ID to convert |
[Table 1. Parameters]

{#r_VMU-turnCorrelationIdToUuid_S__table_ur3_kpw_4t} {#r_VMU-turnCorrelationIdToUuid_S__table_vr3_kpw_4t__entry__2}

| Type | Description |
|-|-|
| String | The UUID, or an empty string if invalid. |
[Table 2. Returns]

{#r_VMU-turnCorrelationIdToUuid_S__table_vr3_kpw_4t}  

    gs.info(VMUtils.turnCorrelationIdToUuid('42 10 82 82 62 35 ca 68-b5 1c 1e f8 5c 0a 0d 5b'));

Output:

    42108282-6235-ca68-b51c-1ef85c0a0d5b

## VMUtils - turnUuidToCorrelationId(String uuid) {#ariaid-title3}

Converts a WMware universal unique identifier (UUID) to a format that matches the
original format in the ServiceNow system.
vCenter works with UUIDs where the ESXi Linux console worked with this format.
{#r_VMU-turnUuidToCorrelationId_S__table_nqb_54w_4t__entry__3}

| Name | Type | Description |
|-|-|-|
| uuid | String | The UUID to convert. |
[Table 3. Parameters]

{#r_VMU-turnUuidToCorrelationId_S__table_nqb_54w_4t} {#r_VMU-turnUuidToCorrelationId_S__table_oqb_54w_4t__entry__2}

| Type | Description |
|-|-|
| String | The identifier converted to the ServiceNow format. |
[Table 4. Returns]

{#r_VMU-turnUuidToCorrelationId_S__table_oqb_54w_4t}  

    gs.info(VMUtils.turnUuidToCorrelationId('13eb78d0-d504-11e1-9b23-0800200c9a66'));

Output:

    13 eb 78 d0 d5 04 11 e1-9b 23 08 00 20 0c 9a 66