GET /inventory/cmc/ManagedSystem

Returns the inventory details about all the managed systems that are connected to CMC.

Important: The versions v1 and v2 have the same response syntax. The information explained in this document uses the latest version v2. The same information also applies to v1. To use version v1 of this API, replace v2 by v1.

Resource Information

Response formats	JSON
Requires authentication?	Yes
Rate limited?	All API calls are automatically rate limited to a maximum of 10 calls per second.

Request Syntax

• For all managed systems: GET /v2/inventory/cmc/ManagedSystem
• For a particular managed system: GET /v2/inventory/cmc/ManagedSystem/{uuid}

URI Request Parameters

The request uses the following URI parameters:

Parameter	Required?	Description
uuid	Optional	The universally unique identifier (UUID) for a managed system. If you do not specify the UUID, details of all the managed systems are displayed.

Notes:

• If you have enabled the attribute masking feature, the values of the resource attributes will be masked in the API response. Attribute Masking is available with HMC V1040 and later.
• The API response will contain only the systems that are added to the allowlist.
• If you have enabled Data Filtering, the values of the attributes selected for filtering will be filtered out, and the API response will contain an empty string for that attribute.

Request headers

Authenticate the API by completing the following steps:

1. Set your client ID value in the X-CMC-Client-Id header in every request.
2. Set the client secret value in the X-CMC-Client-Secret header in every request.

To form the CMC API full URL, append the relative path of the endpoint you want to use to the Base URL. 

Example: https://<portal-url>/api/public/v2/inventory/cmc/ ManagedSystem/{uuid}

Request body

This request does not have a request body.

Response Syntax and Description

To review the response schema and for information about the parameters, see Response schema and parameter description for /inventory/cmc/ManagedSystem.

Errors

The following errors are the common errors for this API:

NotFoundException

The requested resource is not found. Make sure that the request URI is correct.

HTTP Status Code: 404

TooManyRequestsException

The request has reached its throttling limit. Retry after the specified time.

HTTP Status Code: 429

UnauthorizedException

The request is denied because the caller has insufficient permissions.

HTTP Status Code: 401

Sample Request

Review the following examples to understand how the API request and response work.

Request for all managed systems

GET /api/public/v2/inventory/cmc/ManagedSystem HTTP/1.1

Host: xxxxxxxxxxxx.powercmc.com

x-cmc-client-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

x-cmc-client-secret: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Request for a particular managed system

GET /api/public/v2/inventory/cmc/ManagedSystem/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx HTTP/1.1

Host: xxxxxxxxxxxx.powercmc.com

x-cmc-client-id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

x-cmc-client-secret: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Sample Response

The following response is a sample response for a particular managed system.

{

  "ManagedSystems": [

    {

      "MTMS": {

        "MachineType": "9009",

        "Model": "22A",

        "SerialNumber": "xxxxxxx"

      },

      "ManagingHMCs": [

        {

          "MTMS": {

            "MachineType": "V357",

            "Model": "f6d",

            "SerialNumber": "xxxxxxx"

          },

          "Name": "xxxxxxxx",

          "State": "Active",

          "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

        }

      ],

      "MemoryConfiguration": {

        "AvailableMemory": 123,

        "InstalledMemory": 256,

        "MemoryUsedByHypervisor": 10

      },

      "Name": "xxxxxxxx",

      "ProcessorConfiguration": {

        "AvailableProcessorUnits": 2.35,

        "InstalledProcessorUnits": 8

      },

      "IPAddress": "xxx.xxx.xxx.xxx",

      "State": "operating",

      "SystemFirmware": "VL930_FW930.03 (68)",

      "SystemLocation": "",

      "SystemType": "fsp",

      "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",

      "Partitions": [

        {

          "ID": "31",

          "Name": "xxxxxxxx",

          "State": "running",

          "PartitionType": "AIX",

          "UUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",

          "Link": "/api/public/v2/inventory/cmc/ManagedSystem/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Partition/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

        }

      ],

      "SharedProcessorPools": [

        {

          "AssignedPartitions": [

            {

              "PartitionUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",

              "PartitionName": "xxxxxxxx",

              "ID": "31"

            }

          ],

          "AvailableProcessingUnits": "0",

          "PoolID": "0",

          "PoolName": "xxxxxxxx"

        }

      ],

      "Tags": [

        {

          "Name": "Test"

        }

      ],

      "Description": "",

      "NumberOfLPARs": 52,

      "NumberOfVIOSs": 2,

      "ProcessorThrottling": false

    }

  ]

}