Skip to main content
API Explorer|API Explorer
Compute Management/Host Related Interfaces
GETHost Related InterfacesSince 3.9.0SynchronousAuth Required

Query Host Bond Information

Query Host Bond Information

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Request Inputs

This API requires no request parameters.

Responses

200 OK

On success, this API returns the following response structure.

  • errorErrorCodeRequired

    Error code. If not null, the operation failed. If null, the operation succeeded. See details error

    • codeStringRequired

      Error code number, globally unique identifier of the error, e.g. SYS.1000, HOST.1001

    • descriptionStringRequired

      Brief description of the error

    • detailsStringRequired

      Detailed error information

    • elaborationStringRequired

      Reserved field, default is null

    • opaqueLinkedHashMapRequired

      Reserved field, default is null

    • causeErrorCodeRequired

      Root cause, the error that caused the current error. If there is no original error, this field is null

  • inventoriesListRequired

    See details inventories

    • uuidStringRequired

      Resource UUID, uniquely identifies the resource

    • hostUuidStringRequired

      Host UUID

    • bondingNameStringRequired

      Bond name

    • modeStringRequired

      Bond mode

    • xmitHashPolicyStringRequired

      Hash policy

    • miiStatusStringRequired

      MII status

    • macStringRequired

      MAC address

    • ipAddressesListRequired

      IP addresses

    • miimonLongRequired

      MII monitor interval

    • allSlavesActiveBooleanRequired

      No description provided.

    • createDateTimestampRequired

      Creation time

    • lastOpDateTimestampRequired

      Last modification time

    • slavesListRequired

      See details slaves

      • uuidStringRequired

        Resource UUID, uniquely identifies the resource

      • hostUuidStringRequired

        Host UUID

      • bondingUuidStringRequired

        Bond UUID

      • interfaceNameStringRequired

        NIC name

      • interfaceTypeStringRequired

        NIC usage state, can be nomaster, bridgeSlave, bondSlave

      • speedLongRequired

        NIC speed

      • slaveActiveBooleanRequired

        Bond link status

      • carrierActiveBooleanRequired

        Physical link status

      • ipAddressesListRequired

        IP addresses

      • macStringRequired

        MAC address

      • pciDeviceAddressStringRequired

        NIC PCI address

      • createDateTimestampRequired

        Creation time

      • lastOpDateTimestampRequired

        Last modification time

Endpoint

GET/zstack/v1/hosts/bondings

/zstack/v1/hosts/bondings

Operation ID

QueryHostNetworkBonding

Permalink

Request Example

curl -X GET 'http://{host}/zstack/v1/hosts/bondings' -H 'Authorization: OAuth {sessionUuid}'

Response Example

200
{ "inventories": [ { "uuid": "2e2226e18e853f20a5791684a1b644c8", "hostUuid": "903696c585a639bb8049713b98d93437", "bondingName": "bond0", "mode": "active-backup 1", "xmitHashPolicy": "layer2 0", "miiStatus": "up", "mac": "ac:1f:6b:93:6c:8c", "ipAddresses": [ "172.20.0.116/16" ], "miimon": 100.0, "allSlavesActive": true, "createDate": "Nov 14, 2017 10:20:57 PM", "lastOpDate": "Nov 14, 2017 10:20:57 PM", "slaves": [ { "uuid": "17a40aa475cf322494ea82e09066892e", "hostUuid": "903696c585a639bb8049713b98d93437", "bondingUuid": "2e2226e18e853f20a5791684a1b644c8", "interfaceName": "eno1", "interfaceType": "bondingSlave", "speed": 1000.0, "slaveActive": true, "carrierActive": true, "mac": "ac:1f:6b:93:6c:8c", "createDate": "Nov 14, 2017 10:20:57 PM", "lastOpDate": "Nov 14, 2017 10:20:57 PM" }, { "uuid": "c3716c87b9173cbb8315e7d7f3645bc4", "hostUuid": "903696c585a639bb8049713b98d93437", "bondingUuid": "2e2226e18e853f20a5791684a1b644c8", "interfaceName": "eno2", "interfaceType": "bondingSlave", "speed": 1000.0, "slaveActive": false, "carrierActive": false, "mac": "ac:1f:6b:93:6c:8c", "createDate": "Nov 14, 2017 10:20:57 PM", "lastOpDate": "Nov 14, 2017 10:20:57 PM" } ] } ] }

Change History

This API has no change history records yet.

View all change history