Jump to

• Request
• Response

Get all ManagementSwitch objects by the list of ids.

put

https://{host}:{port}/{basePath}/ManagementSwitch/

get all ManagementSwitch objects by the list of ids.

Request

Header Parameters

• Auth-Token(required): string
  Auth-Token received from a successful login response.
• opc-request-id: string
  Unique identifier for the request

Supported Media Types

• application/x-www-form-urlencoded

Request Body - application/x-www-form-urlencoded ()

Root Schema : schema

Type: object

Show Source

• GetManagementSwitchByIdsIdsParam: array GetManagementSwitchByIdsIdsParam
  List of ids to retrieve the associated ManagementSwitchs.

{
    "properties":{
        "GetManagementSwitchByIdsIdsParam":{
            "type":"array",
            "items":{
                "type":"string"
            },
            "description":"List of ids to retrieve the associated ManagementSwitchs."
        }
    }
}

Nested Schema : GetManagementSwitchByIdsIdsParam

Type: array

List of ids to retrieve the associated ManagementSwitchs.

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    },
    "description":"List of ids to retrieve the associated ManagementSwitchs."
}

Security

• basicAuth: http
  Type: http

Back to Top

Response

Supported Media Types

• application/json

200 Response

Request completed successfully.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object ManagementSwitch
  The ManagementSwitch object represents a physical Management Switch within the Rack.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ManagementSwitch"
    }
}

Nested Schema : ManagementSwitch

Type: object

The ManagementSwitch object represents a physical Management Switch within the Rack.

Show Source

• coreCount: string
  Maximum Length: 64
• description(required): string
  Maximum Length: 1000
• faultIds: array faultIds
• firmwareVersion: string
  Maximum Length: 64
• generation: integer
• hardwareComponentIds: array hardwareComponentIds
• hostname: string
  Maximum Length: 64
• hwId: string
  Maximum Length: 64
• ilomHostname: string
  Maximum Length: 64
• ilomIp: string
  Maximum Length: 64
• ilomMac: string
  Maximum Length: 64
• ilomRunStateFault: string
  Allowed Values: [ "CRITICAL", "MAJOR", "MINOR", "WARNING" ]
• ilomState: string
  Maximum Length: 64
• ipAddress: string
  Maximum Length: 64
• macAddress: string
  Maximum Length: 64
• model: string
  Maximum Length: 64
• name(required): string
  Maximum Length: 256
• os: string
  Maximum Length: 64
• provisioningState: string
  Maximum Length: 64
• rackElevation: string
  Maximum Length: 64
• rackId: object Rack
  The Rack object represents a physical PCA Rack.
• runStateFault: string
  Allowed Values: [ "CRITICAL", "MAJOR", "MINOR", "WARNING" ]
• serialNumber: string
  Maximum Length: 64
• state: string
  Maximum Length: 64
• validationState: string
• vendor: string
  Maximum Length: 64
• workState: string

{
    "properties":{
        "provisioningState":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "hwId":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "macAddress":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "ipAddress":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "ilomIp":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "ilomMac":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "ilomHostname":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "ilomState":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "hostname":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "model":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "os":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "vendor":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "firmwareVersion":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "serialNumber":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "state":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "rackElevation":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "validationState":{
            "description":"",
            "type":"string"
        },
        "runStateFault":{
            "description":"",
            "enum":[
                "CRITICAL",
                "MAJOR",
                "MINOR",
                "WARNING"
            ],
            "type":"string"
        },
        "ilomRunStateFault":{
            "description":"",
            "enum":[
                "CRITICAL",
                "MAJOR",
                "MINOR",
                "WARNING"
            ],
            "type":"string"
        },
        "coreCount":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "hardwareComponentIds":{
            "description":"",
            "type":"array"
        },
        "rackId":{
            "description":"",
            "$ref":"#/components/schemas/Rack"
        },
        "description":{
            "description":"",
            "maxLength":1000,
            "type":"string"
        },
        "generation":{
            "description":"",
            "type":"integer"
        },
        "name":{
            "description":"",
            "maxLength":256,
            "type":"string"
        },
        "workState":{
            "description":"",
            "type":"string"
        },
        "faultIds":{
            "description":"",
            "type":"array"
        }
    },
    "required":[
        "description",
        "name"
    ],
    "type":"object",
    "description":"The ManagementSwitch object represents a physical Management Switch within the Rack."
}

Nested Schema : faultIds

Type: array

Nested Schema : hardwareComponentIds

Type: array

Nested Schema : Rack

Type: object

The Rack object represents a physical PCA Rack.

Show Source

• description(required): string
  Maximum Length: 1000
• faultIds: array faultIds
• generation: integer
• name(required): string
  Maximum Length: 256
• rackNumber: integer
• rackSerialNumber: string
  Maximum Length: 64
• rackType: string
  Maximum Length: 64
• rackUnitIds: array rackUnitIds
• validationState: string
  Allowed Values: [ "VALIDATED", "ERROR", "UNKNOWN" ]
• workState: string

{
    "properties":{
        "rackNumber":{
            "description":"",
            "type":"integer"
        },
        "rackSerialNumber":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "rackType":{
            "description":"",
            "maxLength":64,
            "type":"string"
        },
        "validationState":{
            "description":"",
            "enum":[
                "VALIDATED",
                "ERROR",
                "UNKNOWN"
            ],
            "type":"string"
        },
        "rackUnitIds":{
            "description":"",
            "type":"array"
        },
        "description":{
            "description":"",
            "maxLength":1000,
            "type":"string"
        },
        "generation":{
            "description":"",
            "type":"integer"
        },
        "name":{
            "description":"",
            "maxLength":256,
            "type":"string"
        },
        "workState":{
            "description":"",
            "type":"string"
        },
        "faultIds":{
            "description":"",
            "type":"array"
        }
    },
    "required":[
        "description",
        "name"
    ],
    "type":"object",
    "description":"The Rack object represents a physical PCA Rack."
}

Nested Schema : faultIds

Type: array

Nested Schema : rackUnitIds

Type: array

400 Response

Bad request

Body ()

Root Schema : Error

Type: object

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

401 Response

Unauthorized

Body ()

Root Schema : Error

Type: object

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

404 Response

Not Found

Body ()

Root Schema : Error

Type: object

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

500 Response

Internal Server Error

Body ()

Root Schema : Error

Type: object

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

Default Response

An error has occurred

Body ()

Root Schema : Error

Type: object

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing.
• message(required): string
  A human-readable error string.

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

Back to Top