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

How to Convert Global IDs to RTSM Internal IDs

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

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

Parameters

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

  • ciIds - comma separated CI IDs

If no CI with the given global ID appears in the RTSM model, no entry will appear in the result map.

Example

HTTP Command

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

Result map

<map>

    <entry>

        <key>316e438afc58135f9e87113bd4427d37</key>

        <value>316e438afc58135f9e87113bd4427d37</value>

    </entry>

    <entry>

        <key>175fe30654e9a9dd16ddab66b2237c92</key>

        <value>175fe30654e9a9dd16ddab66b2237c92</value>

    </entry>

    <entry>

        <key>cb8a27f8ce900aa380c41ac1c74d8153</key>

        <value>cb8a27f8ce900aa380c41ac1c74d8153</value>

    </entry>

</map>

Since there is no CI with a global ID that matches the first 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