Retrieve all Instance NVLink Interfaces

GET

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/instance/:instanceId/nvlink-interface

GET

/v2/org/:org/nico/instance/:instanceId/nvlink-interface

$ curl https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/instance/instanceId/nvlink-interface \
>      -H "Authorization: Bearer <token>"

1 [
2   {
3     "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
4     "instanceId": "64d2028c-ae87-4069-a624-66089d957ef9",
5     "nvLinkLogicalPartitionId": "05ef7e84-1d4e-4e4d-980d-38589479a0fe",
6     "nvLinkDomainId": "4b145552-0d8f-45ff-b652-eed105f93e50",
7     "deviceInstance": 0,
8     "gpuGuid": "5108732638879268442",
9     "status": "Ready",
10     "created": "2019-08-24T14:15:22Z",
11     "updated": "2019-08-24T14:15:22Z"
12   },
13   {
14     "id": "8a7c3b21-1ffc-4c78-9a00-2a6f3859d099",
15     "instanceId": "64d2028c-ae87-4069-a624-66089d957ef9",
16     "nvLinkLogicalPartitionId": "05ef7e84-1d4e-4e4d-980d-38589479a0fe",
17     "nvLinkDomainId": "4b145552-0d8f-45ff-b652-eed105f93e50",
18     "deviceInstance": 1,
19     "gpuGuid": "5108732638879268443",
20     "status": "Provisioning",
21     "created": "2019-08-24T14:15:22Z",
22     "updated": "2019-08-24T14:15:22Z"
23   }
24 ]

Get all NVLink Interfaces for an Instance

Org must have a Tenant entity. User must have authorization role with TENANT_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

instanceIdstringRequired

ID of the Instance

Query parameters

statusstringOptional

Filter NVLink Interfaces by Status. Can be specified multiple times to filter on more than one 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

idstringformat: "uuid">=1 character

Unique UUID v4 identifier for the NVLinkInterface

instanceIdstringformat: "uuid"

ID of the associated Instance

nvLinkLogicalPartitionIdstringformat: "uuid"

ID of the NVLink Logical Partition associated with this interface

nvLinkDomainIdstring or nullformat: "uuid"

ID of the NVLink Domain associated with this Interface

deviceInstanceinteger

Index of the device, used to identify the GPU associated with this Interface

gpuGuidstring or null

Unique ID of the GPU

statusenum

Status of the NVLinkInterface

createddatetimeRead-only

Date/time when the NVLinkInterface was created

updateddatetimeRead-only

Date/time when the NVLinkInterface was last updated

deprecationslist of objects

Deprecations active for this resource. Returned only if there are active deprecations.

Errors

403

Forbidden Error