Skip to main content

POST – Compose a System

  1. Client creates a composed system after identifying the needed ResourceBlock and the given capabilities information in the ResourceZone.

  2. In the request, the client is creating a new Computer System using the Resource Blocks "ComputeBlock", "DrivesBlock" and "NetworkBlock".

  3. For composing a system, an unused ResourceBlock link must be given under "ResourceBlocks" property.

  4. The "ComputeBlock" must be provided in the POST request ResourceBlock property only when Processors/Memory instances are available.

  5. The "DrivesBlock" must be provided in the POST request ResourceBlock property only when Storage/SimpleStorage instances are available.

  6. The "NetworkBlock" must be provided in the POST request ResourceBlock property only when EthernetInterfaces instances are available.

Request​

POST https://{{ip}}/redfish/v1/Systems
Content-Type: application/json

Request example​

{
    "Name": "NewSystem",
    "Links": {
        "ResourceBlocks": [
            {
                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock"
            },
            {
                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/DrivesBlock"
            },
            {
                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/NetworkBlock"
            }
        ]
    },
    "HostName": "Intel"
}

Response example​

The response status is 201 with below response. For Error Responses, please refer to Error Response.

{
    "@odata.context": "/redfish/v1/$metadata#ComputerSystem.ComputerSystem",
    "@odata.etag": "W/\"1593017717\"",
    "@odata.id": "/redfish/v1/Systems",
    "@odata.type": "#ComputerSystem.v1_8_0.ComputerSystem",
    "Actions": {
        "#ComputerSystem.Reset": {
            "@Redfish.ActionInfo": "/redfish/v1/Systems/Self/ResetActionInfo",
            "target": "/redfish/v1/Systems/Self/Actions/ComputerSystem.Reset"
        }
    },
    "Boot": {
        "BootSourceOverrideEnabled": "Continuous",
        "BootSourceOverrideEnabled@Redfish.AllowableValues": [
            "Disabled",
            "Once",
            "Continuous"
        ],
        "BootSourceOverrideTarget": "Pxe",
        "BootSourceOverrideTarget@Redfish.AllowableValues": [
            "None",
            "Pxe",
            "Floppy",
            "Cd",
            "Usb",
            "Hdd",
            "BiosSetup",
            "Utilities",
            "Diags",
            "UefiShell",
            "UefiTarget",
            "SDCard",
            "UefiHttp",
            "RemoteDrive",
            "UefiBootNext"
        ]
    },
    "Description": "Computer System",
    "HostName": "Intel",
    "Id": "NewSystem",
    "Links": {
        "ResourceBlocks": [
            {
                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock"
            },
            {
                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/DrivesBlock"
            }
        ]
    },
    "Memory": {
        "@odata.id": "/redfish/v1/Systems/Self/Memory"
    },
    "Name": "NewSystem",
    "PowerState": "Off",
    "Processors": {
        "@odata.id": "/redfish/v1/Systems/Self/Processors"
    },
    "SimpleStorage": {
        "@odata.id": "/redfish/v1/Systems/Self/SimpleStorage"
    },
    "Storage": {
        "@odata.id": "/redfish/v1/Systems/Self/Storage"
    },
    "SystemType": "Composed",
    "UUID": "e0128b8c-b73f-410f-a48e-0fc4930716bb"
}