Administer > RTSM > RTSM Developer Reference > Using APIs > Internal-Global ID Conversion API > How to Convert RTSM Internal IDs to Global IDs

How to Convert RTSM Internal IDs to Global IDs

To convert a given internal CI ID to a global CI ID, use the following URL:

http://<omi.server.example>/topaz/bsmservices/customers/{customerId}/rtsm/convertRtsmToGlobalIds?ciIds={ciIds}

Parameters

  • customerId - customer ID (use 1 for non-SaaS deployment)

  • ciIds - comma separated CI IDs

If the CI ID does not exist, it will not appear in the result map.

If no global ID is defined for a CI, 32 '0' characters are retrieved as the global ID mapped to the internal ID.

Example

HTTP Command

http://omi.server.example/topaz/bsmservices/customers/1/rtsm/
convertRtsmToGlobalIds?ciIds=35845d64ba6250d4d45d0e75e3e59001,
316e438afc58135f9e87113bd4427d37,175fe30654e9a9dd16ddab66b2237c92,
cb8a27f8ce900aa380c41ac1c74d8153,8066fe1fcb712926fe3793a75b0e733c,
bbbc37f7ce900aa380c41ac1c74d8153

Result map

<map>

    <entry>

        <key>8066fe1fcb712926fe3793a75b0e733c</key>

        <value>00000000000000000000000000000000</value>

    </entry>

    <entry>

        <key>cb8a27f8ce900aa380c41ac1c74d8153</key>

        <value>cb8a27f8ce900aa380c41ac1c74d8153</value>

    </entry>

    <entry>

        <key>175fe30654e9a9dd16ddab66b2237c92</key>

        <value>175fe30654e9a9dd16ddab66b2237c92</value>

    </entry>

    <entry>

        <key>316e438afc58135f9e87113bd4427d37</key>

        <value>316e438afc58135f9e87113bd4427d37</value>

    </entry>

    <entry>

        <key>35845d64ba6250d4d45d0e75e3e59001</key>

        <value>00000000000000000000000000000000</value>

    </entry>

</map>

In this example, there are two CIs that have no global ID and will be mapped to 00000000000000000000000000000000.

Since there is no CI with ID that matches the last passed ID, it does not appear in the result map.

Error handling

Name

Error Code

Reason

BAD_REQUEST

400

Missing CI IDs or wrong input for ciIds parameter.

Number of passed CI IDs reaches the limit, which is 10000.

INTERNAL_SERVER_ERROR

500

General failure to run query against RTSM

Send Help Center feedback