Retrieve all Machines | NVIDIA Infra Controller

[
  {
    "id": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
    "infrastructureProviderId": "e94bcfda-f6cb-42e4-80ec-516811e5abbf",
    "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
    "instanceTypeId": null,
    "instanceId": null,
    "tenantId": null,
    "controllerMachineId": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
    "controllerMachineType": "x86_64",
    "hwSkuDeviceType": "cpu",
    "vendor": "Lenovo",
    "productName": "ThinkSystem SR670 V2",
    "serialNumber": "J1060ACR.D3KS2CS001G",
    "machineCapabilities": [
      {
        "type": "CPU",
        "name": "Intel(R) Xeon(R) Gold 6354 CPU @ 3.00GHz",
        "frequency": "3.0GHz",
        "cores": 18,
        "threads": 36,
        "count": 2
      },
      {
        "type": "Memory",
        "name": "Corsair Vengeance LPX",
        "capacity": "32GB",
        "count": 4
      }
    ],
    "machineInterfaces": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "machineId": "fm100ht4v4mce2qstjnl8970nnj3ie6ecek4mtjn27pea4kre5gsa49jg0g",
        "controllerInterfaceId": "ad3dac49-741d-4c1f-815c-c020127c532f",
        "controllerSegmentId": "f2207a3c-1847-42e5-bf2c-cd015f87a2bc",
        "subnetId": "1f232bf0-7b90-456e-b9b0-38d9fea4171a",
        "hostname": "example.com",
        "isPrimary": true,
        "macAddress": "00:00:5e:00:53:af",
        "ipAddresses": [
          "192.156.7.23",
          "202.88.37.112"
        ],
        "created": "2019-08-24T14:15:22Z",
        "updated": "2019-08-24T14:15:22Z"
      }
    ],
    "maintenanceMessage": null,
    "health": {
      "source": "aggregate-host-health",
      "observedAt": null,
      "successes": [
        {
          "id": "BgpDaemonEnabled",
          "target": null
        },
        {
          "id": "BgpStats",
          "target": null
        },
        {
          "id": "DhcpServer",
          "target": null
        },
        {
          "id": "DpuDiskUtilizationCheck",
          "target": null
        },
        {
          "id": "FanSpeed",
          "target": "System Board Fan1A"
        },
        {
          "id": "PowerSupply",
          "target": "PS1 Status"
        },
        {
          "id": "Temperature",
          "target": "CPU1 Temp"
        },
        {
          "id": "Temperature",
          "target": "System Board Exhaust Temp"
        },
        {
          "id": "Voltage",
          "target": "CPU1 1P8 PG"
        }
      ],
      "alerts": []
    },
    "labels": {
      "RackIdentifier": "GVX11F01C02",
      "ServerName": "SITE1-C03-Server-02"
    },
    "status": "Ready",
    "isUsableByTenant": true,
    "statusHistory": [
      {
        "status": "Ready",
        "message": "Machine is online and ready",
        "created": "2019-08-24T14:15:22Z",
        "updated": "2019-08-24T14:15:22Z"
      }
    ],
    "created": "2019-08-24T14:15:22Z",
    "updated": "2019-08-24T14:15:22Z"
  }
]

Get all Machines for Infrastructure Provider.

Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

Query parameters

siteIdstringOptional

Filter Machines by Site ID

idstringOptional

Filter Machines by ID. Can be specified multiple times to filter on more than one ID.

hasInstanceTypebooleanOptional

Filter Machines that have been assigned an Instance Type.

instanceTypeIdstringOptional

Filter Machines by Instance Type ID. Can be specified multiple times to filter on more than one Instance Type ID.

tenantIdstringOptional

Filter Machines by ID of tenant of assigned instance. Can be specified multiple times to filter on more than one Tenant ID.

hasInstancebooleanOptional

Filter Machines that are assigned to an Instance. siteId must be specified when using this param.

isMissingOnSitebooleanOptional

Filter Machines that are missing on Site.

includeMetadatabooleanOptional

Include Machine metadata e.g. BMC, DPU, GPU and Interface data. Can only be requested by Provider.

statusstringOptional

Filter Machines by Status. Can be specified multiple times to filter on more than one Status.

capabilityTypestringOptional

Filter Machines by Capability Type

capabilityNamestringOptional

Filter Machines by Capability Name. Can be specified multiple times to filter on more than one Capability Name.

hwSkuDeviceTypestringOptional

Filter Machines by hardware SKU Device Type. Example values: “gpu”, “cpu”, “storage”, “cache”

querystringOptional

Provide query to search for matches. Input will be matched against Machine ID, vendor, product name, hostname and status

includeRelationenumOptional

Related entity to expand

Allowed values:

pageNumberintegerOptional>=1Defaults to 1

Page number for pagination query

pageSizeintegerOptional1-100

Page size for pagination query

orderByenumOptional

Ordering for pagination query

Response headers

Response

idstringRead-only

Unique ID of Machine

infrastructureProviderIdstringRead-onlyformat: "uuid"

ID of the Provider that owns the Machine

siteIdstringformat: "uuid"

ID of the Site the Machine belongs to

instanceTypeIdstring or nullformat: "uuid"

ID of the Instance Type, if assigned

instanceIdstring or nullformat: "uuid"

ID of the Instance if this Machine is assigned to one

tenantIdstring or nullformat: "uuid"

ID of the Tenant that owns the Instance if the Machine is assigned to one

controllerMachineIdstring

ID of the Machine at Site, now same as the primary ID

controllerMachineTypestring or null

Denotes architecture (x86 vs ARM) of the Machine

hwSkuDeviceTypestring or null

SKU derived device type of the machine, e.g. cpu, gpu, cache, storage, etc.

vendorstring or null

Name of the vendor of the Machine

productNamestring or null

Product name of the Machine

serialNumberstring or null

Serial number of the Machine, only visible to Provider

machineCapabilitieslist of objects

List of capabilities of the machine

machineInterfaceslist of objects

List of admin interfaces of the machine

maintenanceMessagestring or null

If the Machine is in maintenance mode, this message will typically describe the reason and how long it is expected to be in maintenance

healthobject

Health information about the machine

metadataobject

Only available to Providers. Returned if the includeMetadata query parameter is specified. Otherwise attribute is omitted from response.

labelsmap from strings to strings

User-specified Machine labels

statusenum

Status represents the status of the machine

isUsableByTenantbooleanRead-only

Indicates whether the machine is usable by or currently in use by a tenant.

statusHistorylist of objects

Chronological status history for the Machine

createddatetimeRead-only

Date/time when the Machine was created

updateddatetimeRead-only

Date/time when the Machine was last updated

Errors

403

Forbidden Error