Boot Orchestration Service v2

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

The Boot Orchestration Service (BOS) provides coordinated provisioning actions over defined hardware sets to enable boot, reboot, shutdown, configuration and staging for specified hardware subsets. These provisioning actions apply state through numerous system management APIs at the request of system administrators for managed product environments.

The default content type for the BOS API is “application/json”. Unsuccessful API calls return a content type of “application/problem+json” as per RFC 7807.

Resources

Session Template

A Session Template sets the operational context of which nodes to operate on for any given set of nodes. It is largely comprised of one or more boot sets and their associated software configuration.

A Boot Set defines a list of nodes, the image you want to boot/reboot the nodes with, kernel parameters to use to boot the nodes, and additional configuration management framework actions to apply during node bring up.

Session

A BOS Session applies a provided action to the nodes defined in a Session Template.

Workflow: Create a New Session

  1. Choose the Session Template to use.

Session Templates which do not belong to a tenant are uniquely identified by their names. All Session Templates that belong to a given tenant are uniquely identified by their names, but may share names with Session Templates that belong to other tenants or that do not belong to a tenant.

a. List available Session Templates.

GET /v1/sessiontemplate or /v2/sessiontemplates

b. Create a new Session Template if desired.

POST /v1/sessiontemplate or PUT /v2/sessiontemplate/{template_name}

If no Session Template exists that satisfies requirements,
then create a new Session Template.
This Session Template can be used to create a new Session later.
  1. Create the Session.

POST /v1/session or /v2/sessions

Specify template_name and an operation to create a new Session. The template_name corresponds to the Session Template name. A new Session is launched as a result of this call (in the case of /v2/sessions, the option to stage but not begin the Session also exists).

A limit can also be specified to narrow the scope of the Session. The limit can consist of nodes, groups, or roles in a comma-separated list. Multiple groups are treated as separated by OR, unless “&” is added to the start of the component, in which case this becomes an AND. Components can also be preceded by “!” to exclude them.

Note, the response from a successful Session launch contains links. Within links, href is a string that uniquely identifies the Session. href is constructed using the Session Template name and a generated UUID. Use the entire href string as the path parameter session_id to uniquely identify a Session.

  1. Get details on the Session.

GET /v1/session/{session_id} or /v2/sessions/{session_id}

Interactions with Other APIs

Configuration Framework Service (CFS)

If enable_cfs is true in a Session Template, then BOS will invoke CFS to configure the target nodes during boot, reboot, or configure operations. The configure operation is only available in BOS v1 Sessions; if desiring to only perform a CFS configuration on a set of nodes, it is recommended to use CFS directly.

Hardware State Manager (HSM)

In some situations BOS checks HSM to determine if a node has been disabled.

Image Management Service (IMS)

BOS works in concert with IMS to access boot images. All boot images specified via the Session Template must be available via IMS.

Base URLs:

Authentication

  • HTTP Authentication, scheme: bearer

version

get__

Code samples

GET https://api-gw-service-nmn.local/apis/bos/ HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/ \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /

Get API versions

Return list of versions currently running.

Example responses

200 Response

[
  {
    "major": "string",
    "minor": "string",
    "patch": "string",
    "links": [
      {
        "href": "string",
        "rel": "string"
      }
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK A collection of Versions Inline

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [Version] false none [Version data]
» major string false none none
» minor string false none none
» patch string false none none
» links [Link] false none List of links to other resources
»» href string false none none
»» rel string false none none
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

v1_get

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1 HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1 \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1

Get API version

Return the API version

Example responses

200 Response

{
  "major": "string",
  "minor": "string",
  "patch": "string",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Get version details
The versioning system uses semver.
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

v1_get_version

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/version HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/version \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/version', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/version", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/version

Get API version

Return the API version

Example responses

200 Response

{
  "major": "string",
  "minor": "string",
  "patch": "string",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Get version details
The versioning system uses semver.
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

healthz

v1_get_healthz

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/healthz HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/healthz \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/healthz', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/healthz", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/healthz

Get service health details

Get BOS health details.

Example responses

200 Response

{
  "dbStatus": "string",
  "apiStatus": "string"
}

Responses

Status Meaning Description Schema
200 OK Service Health information Healthz
500 Internal Server Error Bad Request ProblemDetails
503 Service Unavailable Service Unavailable ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

sessiontemplate

create_v1_sessiontemplate

Code samples

POST https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X POST https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /v1/sessiontemplate

Create Session Template

Create a new Session Template.

The created template will be modified if necessary to follow the BOS v2 session template format.

Body parameter

{
  "name": "cle-1.0.0",
  "description": "string",
  "cfs_url": "string",
  "cfs_branch": "string",
  "enable_cfs": true,
  "cfs": {
    "clone_url": "string",
    "branch": "string",
    "commit": "string",
    "playbook": "string",
    "configuration": "compute-23.4.0"
  },
  "partition": "string",
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0",
      "network": "string",
      "boot_ordinal": 0,
      "shutdown_ordinal": 0
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0",
      "network": "string",
      "boot_ordinal": 0,
      "shutdown_ordinal": 0
    }
  }
}

Parameters

Name In Type Required Description
body body V1SessionTemplate true A JSON object for creating a Session Template
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

201 Response

"cle-1.0.0"

Responses

Status Meaning Description Schema
201 Created Session Template name SessionTemplateName
400 Bad Request Multi-tenancy is not supported for this BOS v1 request.
If no tenant was specified, then the request was bad for another reason. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_sessiontemplates

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/sessiontemplate

List Session Templates

List all Session Templates.

Parameters

Name In Type Required Description
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

[
  {
    "name": "cle-1.0.0",
    "tenant": "string",
    "description": "string",
    "enable_cfs": true,
    "cfs": {
      "configuration": "compute-23.4.0"
    },
    "boot_sets": {
      "property1": {
        "name": "compute",
        "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
        "cfs": {
          "configuration": "compute-23.4.0"
        },
        "type": "s3",
        "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "node_list": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "node_roles_groups": [
          "Compute",
          "Application"
        ],
        "node_groups": [
          "string"
        ],
        "arch": "X86",
        "rootfs_provider": "cpss3",
        "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
      },
      "property2": {
        "name": "compute",
        "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
        "cfs": {
          "configuration": "compute-23.4.0"
        },
        "type": "s3",
        "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "node_list": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "node_roles_groups": [
          "Compute",
          "Application"
        ],
        "node_groups": [
          "string"
        ],
        "arch": "X86",
        "rootfs_provider": "cpss3",
        "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
      }
    },
    "links": [
      {
        "href": "string",
        "rel": "string"
      }
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK Session Template details array V2SessionTemplateArray
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_sessiontemplate

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/sessiontemplate/{session_template_id}

Get Session Template by ID

Get Session Template by Session Template ID. The Session Template ID corresponds to the name of the Session Template.

Parameters

Name In Type Required Description
session_template_id path SessionTemplateName true Session Template name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "name": "cle-1.0.0",
  "tenant": "string",
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  },
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Session Template details V2SessionTemplate
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v1_sessiontemplate

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id} \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplate/{session_template_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v1/sessiontemplate/{session_template_id}

Delete a Session Template

Delete a Session Template.

Parameters

Name In Type Required Description
session_template_id path SessionTemplateName true Session Template name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

400 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_sessiontemplatetemplate

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplatetemplate HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplatetemplate \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplatetemplate', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/sessiontemplatetemplate", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/sessiontemplatetemplate

Get an example Session Template.

Returns a skeleton of a Session Template, which can be used as a starting point for users creating their own Session Templates.

Example responses

200 Response

{
  "name": "cle-1.0.0",
  "tenant": "string",
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  },
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Session Template details V2SessionTemplate
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

session

create_v1_session

Code samples

POST https://api-gw-service-nmn.local/apis/bos/v1/session HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X POST https://api-gw-service-nmn.local/apis/bos/v1/session \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api-gw-service-nmn.local/apis/bos/v1/session', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://api-gw-service-nmn.local/apis/bos/v1/session", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /v1/session

Create a Session

The creation of a Session performs the operation specified in the SessionCreateRequest on the Boot Sets defined in the Session Template.

Body parameter

{
  "operation": "boot",
  "templateUuid": "my-session-template",
  "templateName": "cle-1.0.0",
  "limit": "string"
}

Parameters

Name In Type Required Description
body body any true A JSON object for creating a Session
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

201 Response

{
  "operation": "boot",
  "templateName": "cle-1.0.0",
  "job": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "limit": "string",
  "links": [
    {
      "href": "string",
      "jobId": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
      "rel": "session",
      "type": "GET"
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created Session V1Session
400 Bad Request Multi-tenancy is not supported for this BOS v1 request.
If no tenant was specified, then the request was bad for another reason. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_sessions

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/session HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/session \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/session', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/session", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/session

List Session IDs

List IDs of all Sessions, including those in progress and those complete.

Parameters

Name In Type Required Description
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

[
  "8deb0746-b18c-427c-84a8-72ec6a28642c"
]

Responses

Status Meaning Description Schema
200 OK A collection of Session IDs Inline
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails

Response Schema

Status Code 200

Name Type Required Restrictions Description
anonymous [V1SessionId] false none [Unique BOS v1 Session identifier.]
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_session

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/session/{session_id}

Get Session details by ID

Get Session details by Session ID.

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "complete": true,
  "error_count": 0,
  "in_progress": false,
  "job": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "operation": "boot",
  "start_time": "2020-04-24T12:00",
  "status_link": "/v1/session/90730844-094d-45a5-9b90-d661d14d9444/status",
  "stop_time": "2020-04-24T12:00",
  "templateName": "cle-1.0.0"
}

Responses

Status Meaning Description Schema
200 OK Session details Inline
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails

Response Schema

To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v1_session

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id} \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v1/session/{session_id}

Delete Session by ID

Delete Session by Session ID.

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

400 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_session_status

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/session/{session_id}/status

A list of the statuses for the different Boot Sets.

A list of the statuses for the different Boot Sets.

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "boot_sets": [
    "compute"
  ],
  "id": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK A list of Boot Set Statuses and metadata V1SessionStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

create_v1_session_status

Code samples

POST https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X POST https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /v1/session/{session_id}/status

Create the initial Session status

Creates the initial Session status.

Body parameter

{
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "boot_sets": [
    "compute"
  ],
  "id": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Parameters

Name In Type Required Description
body body V1SessionStatus true A JSON object for creating the status for a Session
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "boot_sets": [
    "compute"
  ],
  "id": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK A list of Boot Set Statuses and metadata V1SessionStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request.
If no tenant was specified, then the request was bad for another reason. ProblemDetails
409 Conflict The resource to be created already exists ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

update_v1_session_status

Code samples

PATCH https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PATCH https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.patch('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PATCH /v1/session/{session_id}/status

Update the Session status

Update the Session status. You can update the start or stop times.

Body parameter

{
  "complete": true,
  "error_count": 0,
  "in_progress": false,
  "start_time": "2020-04-24T12:00",
  "stop_time": "2020-04-24T12:00"
}

Parameters

Name In Type Required Description
body body V1GenericMetadata true A JSON object for updating the status for a Session
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "boot_sets": [
    "compute"
  ],
  "id": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK A list of Boot Set Statuses and metadata V1SessionStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v1_session_status

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v1/session/{session_id}/status

Delete the Session status

Deletes an existing Session status

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

400 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
400 Bad Request Multi-tenancy is not supported for this BOS v1 request.
If no tenant was specified, then the request was bad for another reason. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_session_status_by_bootset

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/session/{session_id}/status/{boot_set_name}

Get the status for a Boot Set.

Get the status for a Boot Set.

Parameters

Name In Type Required Description
session_id path string true Session ID
boot_set_name path string true Boot Set name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "name": "compute",
  "session": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "phases": [
    {
      "name": "Boot",
      "metadata": {
        "complete": true,
        "error_count": 0,
        "in_progress": false,
        "start_time": "2020-04-24T12:00",
        "stop_time": "2020-04-24T12:00"
      },
      "categories": [
        {
          "name": "Succeeded",
          "node_list": [
            "x3000c0s19b1n0",
            "x3000c0s19b2n0"
          ]
        }
      ],
      "errors": {
        "property1": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "property2": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ]
      }
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Metadata and a list of the Phase Statuses for the Boot Set V1BootSetStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

create_v1_boot_set_status

Code samples

POST https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X POST https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /v1/session/{session_id}/status/{boot_set_name}

Create a Boot Set Status

Create a status for a Boot Set

Body parameter

{
  "name": "compute",
  "session": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "phases": [
    {
      "name": "Boot",
      "metadata": {
        "complete": true,
        "error_count": 0,
        "in_progress": false,
        "start_time": "2020-04-24T12:00",
        "stop_time": "2020-04-24T12:00"
      },
      "categories": [
        {
          "name": "Succeeded",
          "node_list": [
            "x3000c0s19b1n0",
            "x3000c0s19b2n0"
          ]
        }
      ],
      "errors": {
        "property1": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "property2": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ]
      }
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Parameters

Name In Type Required Description
body body V1BootSetStatus true A JSON object for creating a status for a Boot Set
session_id path string true Session ID
boot_set_name path string true Boot Set name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

201 Response

{
  "name": "compute",
  "session": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "phases": [
    {
      "name": "Boot",
      "metadata": {
        "complete": true,
        "error_count": 0,
        "in_progress": false,
        "start_time": "2020-04-24T12:00",
        "stop_time": "2020-04-24T12:00"
      },
      "categories": [
        {
          "name": "Succeeded",
          "node_list": [
            "x3000c0s19b1n0",
            "x3000c0s19b2n0"
          ]
        }
      ],
      "errors": {
        "property1": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "property2": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ]
      }
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
201 Created The created Boot Set status V1BootSetStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
409 Conflict The resource to be created already exists ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

update_v1_session_status_by_bootset

Code samples

PATCH https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PATCH https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.patch('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PATCH /v1/session/{session_id}/status/{boot_set_name}

Update the status.

This will change the status for one or more nodes within the Boot Set.

Body parameter

[
  {
    "update_type": "NodeChangeList",
    "phase": "Boot",
    "data": {
      "phase": "Boot",
      "source": "Succeeded",
      "destination": "Succeeded",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ]
    }
  }
]

Parameters

Name In Type Required Description
body body V1UpdateRequestList true A JSON object for updating the status for a Session
session_id path string true Session ID
boot_set_name path string true Boot Set name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "name": "compute",
  "session": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "phases": [
    {
      "name": "Boot",
      "metadata": {
        "complete": true,
        "error_count": 0,
        "in_progress": false,
        "start_time": "2020-04-24T12:00",
        "stop_time": "2020-04-24T12:00"
      },
      "categories": [
        {
          "name": "Succeeded",
          "node_list": [
            "x3000c0s19b1n0",
            "x3000c0s19b2n0"
          ]
        }
      ],
      "errors": {
        "property1": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "property2": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ]
      }
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK A list of Boot Set Statuses and metadata V1BootSetStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v1_boot_set_status

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name} \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v1/session/{session_id}/status/{boot_set_name}

Delete the Boot Set status

Deletes an existing Boot Set status

Parameters

Name In Type Required Description
session_id path string true Session ID
boot_set_name path string true Boot Set name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

400 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
400 Bad Request Multi-tenancy is not supported for this BOS v1 request.
If no tenant was specified, then the request was bad for another reason. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_session_status_by_bootset_and_phase

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/session/{session_id}/status/{boot_set_name}/{phase_name}

Get the status for a specific Boot Set and phase.

Get the status for a specific Boot Set and phase.

Parameters

Name In Type Required Description
session_id path string true Session ID
boot_set_name path string true Boot Set name
phase_name path string true The phase name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "name": "Boot",
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "categories": [
    {
      "name": "Succeeded",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ]
    }
  ],
  "errors": {
    "property1": [
      "x3000c0s19b1n0",
      "x3000c0s19b2n0"
    ],
    "property2": [
      "x3000c0s19b1n0",
      "x3000c0s19b2n0"
    ]
  }
}

Responses

Status Meaning Description Schema
200 OK A list of the nodes in the Phase and Category V1PhaseStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v1_session_status_by_bootset_and_phase_and_category

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name}/{category_name} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name}/{category_name} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name}/{category_name}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v1/session/{session_id}/status/{boot_set_name}/{phase_name}/{category_name}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v1/session/{session_id}/status/{boot_set_name}/{phase_name}/{category_name}

Get the status for a specific Boot Set, phase, and category.

Get the status for a specific Boot Set, phase, and category.

Parameters

Name In Type Required Description
session_id path string true Session ID
boot_set_name path string true Boot Set name
phase_name path string true The phase name
category_name path string true The category name
Cray-Tenant-Name header TenantName false Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints.

Detailed descriptions

Cray-Tenant-Name: Tenant name. Multi-tenancy is not supported for most BOS v1 endpoints. If this parameter is set to a non-empty string, the request will be rejected.

Example responses

200 Response

{
  "name": "Succeeded",
  "node_list": [
    "x3000c0s19b1n0",
    "x3000c0s19b2n0"
  ]
}

Responses

Status Meaning Description Schema
200 OK A list of the nodes in the Phase and Category V1PhaseCategoryStatus
400 Bad Request Multi-tenancy is not supported for this BOS v1 request. ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

v2

get_v2

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2 HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2 \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2

Get API version

Return the API version

Example responses

200 Response

{
  "major": "string",
  "minor": "string",
  "patch": "string",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Get version details
The versioning system uses semver.
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_healthz

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/healthz HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/healthz \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/healthz', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/healthz", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/healthz

Get service health details

Get BOS health details.

Example responses

200 Response

{
  "dbStatus": "string",
  "apiStatus": "string"
}

Responses

Status Meaning Description Schema
200 OK Service Health information Healthz
500 Internal Server Error Bad Request ProblemDetails
503 Service Unavailable Service Unavailable ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_sessiontemplates

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/sessiontemplates

List Session Templates

List all Session Templates.

Parameters

Name In Type Required Description
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

[
  {
    "name": "cle-1.0.0",
    "tenant": "string",
    "description": "string",
    "enable_cfs": true,
    "cfs": {
      "configuration": "compute-23.4.0"
    },
    "boot_sets": {
      "property1": {
        "name": "compute",
        "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
        "cfs": {
          "configuration": "compute-23.4.0"
        },
        "type": "s3",
        "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "node_list": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "node_roles_groups": [
          "Compute",
          "Application"
        ],
        "node_groups": [
          "string"
        ],
        "arch": "X86",
        "rootfs_provider": "cpss3",
        "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
      },
      "property2": {
        "name": "compute",
        "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
        "cfs": {
          "configuration": "compute-23.4.0"
        },
        "type": "s3",
        "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "node_list": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "node_roles_groups": [
          "Compute",
          "Application"
        ],
        "node_groups": [
          "string"
        ],
        "arch": "X86",
        "rootfs_provider": "cpss3",
        "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
      }
    },
    "links": [
      {
        "href": "string",
        "rel": "string"
      }
    ]
  }
]

Responses

Status Meaning Description Schema
200 OK Session Template details array V2SessionTemplateArray
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

validate_v2_sessiontemplate

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatesvalid/{session_template_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatesvalid/{session_template_id} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatesvalid/{session_template_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatesvalid/{session_template_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/sessiontemplatesvalid/{session_template_id}

Validate the Session Template by ID

Validate Session Template by Session Template ID. The Session Template ID corresponds to the name of the Session Template.

Parameters

Name In Type Required Description
session_template_id path SessionTemplateName true Session Template name
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

"string"

Responses

Status Meaning Description Schema
200 OK Session Template validity details V2SessionTemplateValidation
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_sessiontemplate

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/sessiontemplates/{session_template_id}

Get Session Template by ID

Get Session Template by Session Template ID. The Session Template ID corresponds to the name of the Session Template.

Parameters

Name In Type Required Description
session_template_id path SessionTemplateName true Session Template name
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "name": "cle-1.0.0",
  "tenant": "string",
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  },
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Session Template details V2SessionTemplate
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

put_v2_sessiontemplate

Code samples

PUT https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PUT https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.put('https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PUT", "https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PUT /v2/sessiontemplates/{session_template_id}

Create Session Template

Create a new Session Template.

Body parameter

{
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  }
}

Parameters

Name In Type Required Description
body body V2SessionTemplate true A JSON object for creating a Session Template
session_template_id path SessionTemplateName true Session Template name
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "name": "cle-1.0.0",
  "tenant": "string",
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  },
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Session Template details V2SessionTemplate
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

patch_v2_sessiontemplate

Code samples

PATCH https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PATCH https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.patch('https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PATCH /v2/sessiontemplates/{session_template_id}

Update a Session Template

Update an existing Session Template.

Body parameter

{
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  }
}

Parameters

Name In Type Required Description
body body V2SessionTemplate true A JSON object for updating a Session Template
session_template_id path SessionTemplateName true Session Template name
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "name": "cle-1.0.0",
  "tenant": "string",
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  },
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Session Template details V2SessionTemplate
400 Bad Request Bad Request ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v2_sessiontemplate

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id} \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplates/{session_template_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v2/sessiontemplates/{session_template_id}

Delete a Session Template

Delete a Session Template.

Parameters

Name In Type Required Description
session_template_id path SessionTemplateName true Session Template name
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

404 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_sessiontemplatetemplate

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatetemplate HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatetemplate \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatetemplate', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/sessiontemplatetemplate", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/sessiontemplatetemplate

Get an example Session Template.

Returns a skeleton of a Session Template, which can be used as a starting point for users creating their own Session Templates.

Example responses

200 Response

{
  "name": "cle-1.0.0",
  "tenant": "string",
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  },
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Session Template details V2SessionTemplate
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

post_v2_session

Code samples

POST https://api-gw-service-nmn.local/apis/bos/v2/sessions HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X POST https://api-gw-service-nmn.local/apis/bos/v2/sessions \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api-gw-service-nmn.local/apis/bos/v2/sessions', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://api-gw-service-nmn.local/apis/bos/v2/sessions", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /v2/sessions

Create a Session

The creation of a Session performs the operation specified in the SessionCreateRequest on the Boot Sets defined in the Session Template.

Body parameter

{
  "name": "session-20190728032600",
  "operation": "boot",
  "template_name": "cle-1.0.0",
  "limit": "string",
  "stage": false,
  "include_disabled": false
}

Parameters

Name In Type Required Description
body body V2SessionCreate true The information to create a Session
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

201 Response

{
  "name": "session-20190728032600",
  "tenant": "string",
  "operation": "boot",
  "template_name": "cle-1.0.0",
  "limit": "string",
  "stage": true,
  "components": "string",
  "include_disabled": true,
  "status": {
    "start_time": "string",
    "end_time": "string",
    "status": "pending",
    "error": "string"
  }
}

Responses

Status Meaning Description Schema
201 Created Session details V2Session
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_sessions

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/sessions HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/sessions \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/sessions', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/sessions", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/sessions

List Sessions

List all Sessions, including those in progress and those complete.

Parameters

Name In Type Required Description
min_age query AgeString false Only include Sessions older than the given age. Age is given in the format “1d” or “6h”
max_age query AgeString false Only include Sessions younger than the given age. Age is given in the format “1d” or “6h”
status query V2SessionStatusLabel false Only include Sessions with the given status.
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Enumerated Values

Parameter Value
status pending
status running
status complete

Example responses

200 Response

[
  {
    "name": "session-20190728032600",
    "tenant": "string",
    "operation": "boot",
    "template_name": "cle-1.0.0",
    "limit": "string",
    "stage": true,
    "components": "string",
    "include_disabled": true,
    "status": {
      "start_time": "string",
      "end_time": "string",
      "status": "pending",
      "error": "string"
    }
  }
]

Responses

Status Meaning Description Schema
200 OK Session details array V2SessionArray
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v2_sessions

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v2/sessions HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v2/sessions \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v2/sessions', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v2/sessions", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v2/sessions

Delete multiple Sessions.

Delete multiple Sessions. If filters are provided, only Sessions matching all filters will be deleted. By default only completed Sessions will be deleted.

Parameters

Name In Type Required Description
min_age query AgeString false Only include Sessions older than the given age. Age is given in the format “1d” or “6h”
max_age query AgeString false Only include Sessions younger than the given age. Age is given in the format “1d” or “6h”
status query V2SessionStatusLabel false Only include Sessions with the given status.
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Enumerated Values

Parameter Value
status pending
status running
status complete

Example responses

400 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_session

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/sessions/{session_id}

Get Session details by ID

Get Session details by Session ID.

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "name": "session-20190728032600",
  "tenant": "string",
  "operation": "boot",
  "template_name": "cle-1.0.0",
  "limit": "string",
  "stage": true,
  "components": "string",
  "include_disabled": true,
  "status": {
    "start_time": "string",
    "end_time": "string",
    "status": "pending",
    "error": "string"
  }
}

Responses

Status Meaning Description Schema
200 OK Session details V2Session
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

patch_v2_session

Code samples

PATCH https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id} HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PATCH https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.patch('https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PATCH /v2/sessions/{session_id}

Update status of a single Session

Update the state for a given Session in the BOS database. This is intended only for internal use by the BOS service.

Body parameter

{
  "components": "string",
  "status": {
    "start_time": "string",
    "end_time": "string",
    "status": "pending",
    "error": "string"
  }
}

Parameters

Name In Type Required Description
body body V2SessionUpdate true The state for a single Session
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "name": "session-20190728032600",
  "tenant": "string",
  "operation": "boot",
  "template_name": "cle-1.0.0",
  "limit": "string",
  "stage": true,
  "components": "string",
  "include_disabled": true,
  "status": {
    "start_time": "string",
    "end_time": "string",
    "status": "pending",
    "error": "string"
  }
}

Responses

Status Meaning Description Schema
200 OK Session details V2Session
400 Bad Request Bad Request ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v2_session

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id} \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v2/sessions/{session_id}

Delete Session by ID

Delete Session by Session ID.

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

404 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_session_status

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/sessions/{session_id}/status

Get Session extended status information by ID

Get Session extended status information by ID

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "status": "pending",
  "managed_components_count": 0,
  "phases": {
    "percent_complete": 0,
    "percent_powering_on": 0,
    "percent_powering_off": 0,
    "percent_configuring": 0
  },
  "percent_successful": 0,
  "percent_failed": 0,
  "percent_staged": 0,
  "error_summary": {},
  "timing": {
    "start_time": "string",
    "end_time": "string",
    "duration": "string"
  }
}

Responses

Status Meaning Description Schema
200 OK Session status details V2SessionExtendedStatus
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

save_v2_session_status

Code samples

POST https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X POST https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://api-gw-service-nmn.local/apis/bos/v2/sessions/{session_id}/status", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /v2/sessions/{session_id}/status

Saves the current Session to database

Saves the current Session to database. For use at Session completion.

Parameters

Name In Type Required Description
session_id path string true Session ID
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "name": "session-20190728032600",
  "tenant": "string",
  "operation": "boot",
  "template_name": "cle-1.0.0",
  "limit": "string",
  "stage": true,
  "components": "string",
  "include_disabled": true,
  "status": {
    "start_time": "string",
    "end_time": "string",
    "status": "pending",
    "error": "string"
  }
}

Responses

Status Meaning Description Schema
200 OK Session details V2Session
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_components

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/components HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/components \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/components', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/components", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/components

Retrieve the state of a collection of Components

Retrieve the full collection of Components in the form of a ComponentArray. Full results can also be filtered by query parameters. Only the first filter parameter of each type is used and the parameters are applied in an AND fashion. If the collection is empty or the filters have no match, an empty array is returned.

Parameters

Name In Type Required Description
ids query V2ComponentId false Retrieve the Components with the given ID
session query string false Retrieve the Components with the given Session ID.
staged_session query string false Retrieve the Components with the given staged Session ID.
enabled query boolean false Retrieve the Components with the “enabled” state.
phase query string false Retrieve the Components in the given phase.
status query string false Retrieve the Components with the given status.
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

ids: Retrieve the Components with the given ID (e.g. xname for hardware Components). Can be chained for selecting groups of Components.

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

[
  {
    "id": "string",
    "actual_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "desired_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "staged_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "session": "session-20190728032600",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "last_action": {
      "last_updated": "2019-07-28T03:26:00Z",
      "action": "string",
      "failed": true
    },
    "event_stats": {
      "power_on_attempts": 0,
      "power_off_graceful_attempts": 0,
      "power_off_forceful_attempts": 0
    },
    "status": {
      "phase": "string",
      "status": "string",
      "status_override": "string"
    },
    "enabled": true,
    "error": "string",
    "session": "session-20190728032600",
    "retry_policy": 1
  }
]

Responses

Status Meaning Description Schema
200 OK A collection of Component states V2ComponentArray
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

put_v2_components

Code samples

PUT https://api-gw-service-nmn.local/apis/bos/v2/components HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PUT https://api-gw-service-nmn.local/apis/bos/v2/components \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.put('https://api-gw-service-nmn.local/apis/bos/v2/components', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PUT", "https://api-gw-service-nmn.local/apis/bos/v2/components", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PUT /v2/components

Add or Replace a collection of Components

Update the state for a collection of Components in the BOS database

Body parameter

[
  {
    "id": "string",
    "actual_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "bss_token": "string"
    },
    "desired_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "bss_token": "string"
    },
    "staged_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "session": "session-20190728032600"
    },
    "last_action": {
      "action": "string",
      "failed": true
    },
    "event_stats": {
      "power_on_attempts": 0,
      "power_off_graceful_attempts": 0,
      "power_off_forceful_attempts": 0
    },
    "status": {
      "phase": "string",
      "status_override": "string"
    },
    "enabled": true,
    "error": "string",
    "session": "session-20190728032600",
    "retry_policy": 1
  }
]

Parameters

Name In Type Required Description
body body V2ComponentArray true The state for an array of Components
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

[
  {
    "id": "string",
    "actual_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "desired_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "staged_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "session": "session-20190728032600",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "last_action": {
      "last_updated": "2019-07-28T03:26:00Z",
      "action": "string",
      "failed": true
    },
    "event_stats": {
      "power_on_attempts": 0,
      "power_off_graceful_attempts": 0,
      "power_off_forceful_attempts": 0
    },
    "status": {
      "phase": "string",
      "status": "string",
      "status_override": "string"
    },
    "enabled": true,
    "error": "string",
    "session": "session-20190728032600",
    "retry_policy": 1
  }
]

Responses

Status Meaning Description Schema
200 OK A collection of Component states V2ComponentArray
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

patch_v2_components

Code samples

PATCH https://api-gw-service-nmn.local/apis/bos/v2/components HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PATCH https://api-gw-service-nmn.local/apis/bos/v2/components \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.patch('https://api-gw-service-nmn.local/apis/bos/v2/components', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "https://api-gw-service-nmn.local/apis/bos/v2/components", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PATCH /v2/components

Update a collection of Components

Update the state for a collection of Components in the BOS database

Body parameter

{
  "patch": {
    "id": "string",
    "actual_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "bss_token": "string"
    },
    "desired_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "bss_token": "string"
    },
    "staged_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "session": "session-20190728032600"
    },
    "last_action": {
      "action": "string",
      "failed": true
    },
    "event_stats": {
      "power_on_attempts": 0,
      "power_off_graceful_attempts": 0,
      "power_off_forceful_attempts": 0
    },
    "status": {
      "phase": "string",
      "status_override": "string"
    },
    "enabled": true,
    "error": "string",
    "session": "session-20190728032600",
    "retry_policy": 1
  },
  "filters": {
    "ids": "string",
    "session": ""
  }
}

Parameters

Name In Type Required Description
body body any true The state for an array of Components
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

[
  {
    "id": "string",
    "actual_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "desired_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "staged_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "session": "session-20190728032600",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "last_action": {
      "last_updated": "2019-07-28T03:26:00Z",
      "action": "string",
      "failed": true
    },
    "event_stats": {
      "power_on_attempts": 0,
      "power_off_graceful_attempts": 0,
      "power_off_forceful_attempts": 0
    },
    "status": {
      "phase": "string",
      "status": "string",
      "status_override": "string"
    },
    "enabled": true,
    "error": "string",
    "session": "session-20190728032600",
    "retry_policy": 1
  }
]

Responses

Status Meaning Description Schema
200 OK A collection of Component states V2ComponentArray
400 Bad Request Bad Request ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_v2_component

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/components/{component_id}

Retrieve the state of a single Component

Retrieve the current and desired state of a single Component

Parameters

Name In Type Required Description
component_id path V2ComponentId true Component ID. e.g. xname for hardware Components
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "id": "string",
  "actual_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "desired_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "staged_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "session": "session-20190728032600",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "last_action": {
    "last_updated": "2019-07-28T03:26:00Z",
    "action": "string",
    "failed": true
  },
  "event_stats": {
    "power_on_attempts": 0,
    "power_off_graceful_attempts": 0,
    "power_off_forceful_attempts": 0
  },
  "status": {
    "phase": "string",
    "status": "string",
    "status_override": "string"
  },
  "enabled": true,
  "error": "string",
  "session": "session-20190728032600",
  "retry_policy": 1
}

Responses

Status Meaning Description Schema
200 OK A single Component state V2Component
400 Bad Request Bad Request ProblemDetails
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

put_v2_component

Code samples

PUT https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PUT https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.put('https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PUT", "https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PUT /v2/components/{component_id}

Add or Replace a single Component

Update the state for a given Component in the BOS database

Body parameter

{
  "id": "string",
  "actual_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "bss_token": "string"
  },
  "desired_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "bss_token": "string"
  },
  "staged_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "session": "session-20190728032600"
  },
  "last_action": {
    "action": "string",
    "failed": true
  },
  "event_stats": {
    "power_on_attempts": 0,
    "power_off_graceful_attempts": 0,
    "power_off_forceful_attempts": 0
  },
  "status": {
    "phase": "string",
    "status_override": "string"
  },
  "enabled": true,
  "error": "string",
  "session": "session-20190728032600",
  "retry_policy": 1
}

Parameters

Name In Type Required Description
body body V2Component true The state for a single Component
component_id path V2ComponentId true Component ID. e.g. xname for hardware Components
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "id": "string",
  "actual_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "desired_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "staged_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "session": "session-20190728032600",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "last_action": {
    "last_updated": "2019-07-28T03:26:00Z",
    "action": "string",
    "failed": true
  },
  "event_stats": {
    "power_on_attempts": 0,
    "power_off_graceful_attempts": 0,
    "power_off_forceful_attempts": 0
  },
  "status": {
    "phase": "string",
    "status": "string",
    "status_override": "string"
  },
  "enabled": true,
  "error": "string",
  "session": "session-20190728032600",
  "retry_policy": 1
}

Responses

Status Meaning Description Schema
200 OK A single Component state V2Component
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

patch_v2_component

Code samples

PATCH https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X PATCH https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.patch('https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PATCH /v2/components/{component_id}

Update a single Component

Update the state for a given Component in the BOS database

Body parameter

{
  "id": "string",
  "actual_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "bss_token": "string"
  },
  "desired_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "bss_token": "string"
  },
  "staged_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "session": "session-20190728032600"
  },
  "last_action": {
    "action": "string",
    "failed": true
  },
  "event_stats": {
    "power_on_attempts": 0,
    "power_off_graceful_attempts": 0,
    "power_off_forceful_attempts": 0
  },
  "status": {
    "phase": "string",
    "status_override": "string"
  },
  "enabled": true,
  "error": "string",
  "session": "session-20190728032600",
  "retry_policy": 1
}

Parameters

Name In Type Required Description
body body V2Component true The state for a single Component
component_id path V2ComponentId true Component ID. e.g. xname for hardware Components
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "id": "string",
  "actual_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "desired_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "staged_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "session": "session-20190728032600",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "last_action": {
    "last_updated": "2019-07-28T03:26:00Z",
    "action": "string",
    "failed": true
  },
  "event_stats": {
    "power_on_attempts": 0,
    "power_off_graceful_attempts": 0,
    "power_off_forceful_attempts": 0
  },
  "status": {
    "phase": "string",
    "status": "string",
    "status_override": "string"
  },
  "enabled": true,
  "error": "string",
  "session": "session-20190728032600",
  "retry_policy": 1
}

Responses

Status Meaning Description Schema
200 OK A single Component state V2Component
400 Bad Request Bad Request ProblemDetails
404 Not Found The resource was not found. ProblemDetails
409 Conflict The update was not allowed due to a conflict. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

delete_v2_component

Code samples

DELETE https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/problem+json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X DELETE https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id} \
  -H 'Accept: application/problem+json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/problem+json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.delete('https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/problem+json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("DELETE", "https://api-gw-service-nmn.local/apis/bos/v2/components/{component_id}", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

DELETE /v2/components/{component_id}

Delete a single Component

Delete the given Component

Parameters

Name In Type Required Description
component_id path V2ComponentId true Component ID. e.g. xname for hardware Components
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

404 Response

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

Responses

Status Meaning Description Schema
204 No Content The resource was deleted. None
404 Not Found The resource was not found. ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

post_v2_apply_staged

Code samples

POST https://api-gw-service-nmn.local/apis/bos/v2/applystaged HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json
Cray-Tenant-Name: vcluster-my-tenant1

# You can also use wget
curl -X POST https://api-gw-service-nmn.local/apis/bos/v2/applystaged \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Cray-Tenant-Name: vcluster-my-tenant1' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Cray-Tenant-Name': 'vcluster-my-tenant1',
  'Authorization': 'Bearer {access-token}'
}

r = requests.post('https://api-gw-service-nmn.local/apis/bos/v2/applystaged', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Cray-Tenant-Name": []string{"vcluster-my-tenant1"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("POST", "https://api-gw-service-nmn.local/apis/bos/v2/applystaged", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

POST /v2/applystaged

Start a staged Session for the specified Components

Given a list of xnames, this will trigger the start of any Sessions staged for those Components. Components without a staged Session will be ignored, and a list all Components that are acted on will be returned in the response.

Body parameter

{
  "xnames": [
    "string"
  ]
}

Parameters

Name In Type Required Description
body body V2ApplyStagedComponents true A list of xnames that should have their staged Session applied.
Cray-Tenant-Name header TenantName false Tenant name.

Detailed descriptions

Cray-Tenant-Name: Tenant name.

Requests with a non-empty tenant name will restict the context of the operation to Session Templates owned by that tenant.

Requests with an empty tenant name, or that omit this parameter, will have no such context restrictions.

Example responses

200 Response

{
  "succeeded": [
    "string"
  ],
  "failed": [
    "string"
  ],
  "ignored": [
    "string"
  ]
}

Responses

Status Meaning Description Schema
200 OK A list of xnames that should have their staged Session applied. V2ApplyStagedStatus
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

patch_v2_options

Code samples

PATCH https://api-gw-service-nmn.local/apis/bos/v2/options HTTP/1.1
Host: api-gw-service-nmn.local
Content-Type: application/json
Accept: application/json

# You can also use wget
curl -X PATCH https://api-gw-service-nmn.local/apis/bos/v2/options \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.patch('https://api-gw-service-nmn.local/apis/bos/v2/options', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Content-Type": []string{"application/json"},
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("PATCH", "https://api-gw-service-nmn.local/apis/bos/v2/options", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

PATCH /v2/options

Update BOS service options

Update one or more of the BOS service options.

Body parameter

{
  "cleanup_completed_session_ttl": "3d",
  "clear_stage": true,
  "component_actual_state_ttl": "6h",
  "disable_components_on_completion": true,
  "discovery_frequency": 33554432,
  "logging_level": "string",
  "max_boot_wait_time": 1048576,
  "max_power_on_wait_time": 1048576,
  "max_power_off_wait_time": 1048576,
  "polling_frequency": 1048576,
  "default_retry_policy": 1
}

Parameters

Name In Type Required Description
body body V2Options true Service-wide options

Example responses

200 Response

{
  "cleanup_completed_session_ttl": "3d",
  "clear_stage": true,
  "component_actual_state_ttl": "6h",
  "disable_components_on_completion": true,
  "discovery_frequency": 33554432,
  "logging_level": "string",
  "max_boot_wait_time": 1048576,
  "max_power_on_wait_time": 1048576,
  "max_power_off_wait_time": 1048576,
  "polling_frequency": 1048576,
  "default_retry_policy": 1
}

Responses

Status Meaning Description Schema
200 OK A collection of service-wide options V2Options
400 Bad Request Bad Request ProblemDetails
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

get_version_v2

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/version HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/version \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/version', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/version", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/version

Get API version

Return the API version

Example responses

200 Response

{
  "major": "string",
  "minor": "string",
  "patch": "string",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Responses

Status Meaning Description Schema
200 OK Get version details
The versioning system uses semver.
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

options

get_v2_options

Code samples

GET https://api-gw-service-nmn.local/apis/bos/v2/options HTTP/1.1
Host: api-gw-service-nmn.local
Accept: application/json

# You can also use wget
curl -X GET https://api-gw-service-nmn.local/apis/bos/v2/options \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

import requests
headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}'
}

r = requests.get('https://api-gw-service-nmn.local/apis/bos/v2/options', headers = headers)

print(r.json())

package main

import (
       "bytes"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    data := bytes.NewBuffer([]byte{jsonReq})
    req, err := http.NewRequest("GET", "https://api-gw-service-nmn.local/apis/bos/v2/options", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

GET /v2/options

Retrieve the BOS service options

Retrieve the list of BOS service options.

Example responses

200 Response

{
  "cleanup_completed_session_ttl": "3d",
  "clear_stage": true,
  "component_actual_state_ttl": "6h",
  "disable_components_on_completion": true,
  "discovery_frequency": 33554432,
  "logging_level": "string",
  "max_boot_wait_time": 1048576,
  "max_power_on_wait_time": 1048576,
  "max_power_off_wait_time": 1048576,
  "polling_frequency": 1048576,
  "default_retry_policy": 1
}

Responses

Status Meaning Description Schema
200 OK A collection of service-wide options V2Options
To perform this operation, you must be authenticated by means of one of the following methods: bearerAuth

Schemas

AgeString

"3d"

Age in minutes (e.g. “3m”), hours (e.g. “5h”), days (e.g. “10d”), or weeks (e.g. “2w”).

Properties

Name Type Required Restrictions Description
anonymous string false none Age in minutes (e.g. “3m”), hours (e.g. “5h”), days (e.g. “10d”), or weeks (e.g. “2w”).

BootInitrdPath

"s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"

A path to the initrd to use for booting.

It is recommended that this should be no more than 4095 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none A path to the initrd to use for booting.

It is recommended that this should be no more than 4095 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

BootKernelPath

"s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel"

A path to the kernel to use for booting.

It is recommended that this should be no more than 4095 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none A path to the kernel to use for booting.

It is recommended that this should be no more than 4095 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

BootManifestPath

"s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json"

A path identifying the metadata describing the components of the boot image. This could be a URI, URL, etc, depending on the type of the Boot Set.

It is recommended that this should be 1-4095 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none A path identifying the metadata describing the components of the boot image.
This could be a URI, URL, etc, depending on the type of the Boot Set.

It is recommended that this should be 1-4095 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

BootKernelParameters

"console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}"

The kernel parameters to use to boot the nodes.

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none The kernel parameters to use to boot the nodes.

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

BootSetEtag

"1cc4eef4f407bd8a62d7d66ee4b9e9c8"

This is the ’entity tag’. It helps verify the version of metadata describing the components of the boot image we are working with.

ETags are defined as being 1-65536 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none This is the ’entity tag’. It helps verify the version of metadata describing the components of the boot image we are working with.

ETags are defined as being 1-65536 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

BootSetName

"compute"

The Boot Set name.

It is recommended that:

  • Boot Set names should be 1-127 characters in length.
  • Boot Set names should use only letters, digits, periods (.), dashes (-), and underscores (_).
  • Boot Set names should begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none The Boot Set name.

It is recommended that:
* Boot Set names should be 1-127 characters in length.
* Boot Set names should use only letters, digits, periods (.), dashes (-), and underscores (_).
* Boot Set names should begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.

BootSetRootfsProvider

"cpss3"

The root file system provider.

It is recommended that this should be 1-511 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none The root file system provider.

It is recommended that this should be 1-511 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

BootSetRootfsProviderPassthrough

"dvs:api-gw-service-nmn.local:300:nmn0"

The root file system provider passthrough. These are additional kernel parameters that will be appended to the ‘rootfs=’ kernel parameter

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none The root file system provider passthrough.
These are additional kernel parameters that will be appended to
the ‘rootfs=’ kernel parameter

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

BootSetType

"s3"

The MIME type of the metadata describing the components of the boot image. This type controls how BOS processes the path attribute.

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none The MIME type of the metadata describing the components of the boot image. This type controls how BOS processes the path attribute.

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

CfsConfiguration

"compute-23.4.0"

The name of configuration to be applied.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none The name of configuration to be applied.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

EmptyString

""

An empty string value.

Properties

Name Type Required Restrictions Description
anonymous string false none An empty string value.

Enumerated Values

Property Value
anonymous

EmptyStringNullable

""

An empty string value.

Properties

Name Type Required Restrictions Description
anonymous string false none An empty string value.

Enumerated Values

Property Value
anonymous

EnableCfs

true

Whether to enable the Configuration Framework Service (CFS).

Properties

Name Type Required Restrictions Description
anonymous boolean false none Whether to enable the Configuration Framework Service (CFS).

HardwareComponentName

"x3001c0s39b0n0"

Hardware component name (xname).

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none Hardware component name (xname).

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

Healthz

{
  "dbStatus": "string",
  "apiStatus": "string"
}

Service health status

Properties

Name Type Required Restrictions Description
dbStatus string false none none
apiStatus string false none none 
{
  "href": "string",
  "rel": "string"
}

Link to other resources

Properties

Name Type Required Restrictions Description
href string false none none
rel string false none none 
[
  {
    "href": "string",
    "rel": "string"
  }
]

List of links to other resources

Properties

Name Type Required Restrictions Description
anonymous [Link] false none List of links to other resources

LinkListReadOnly

[
  {
    "href": "string",
    "rel": "string"
  }
]

List of links to other resources

Properties

Name Type Required Restrictions Description
anonymous [Link] false read-only List of links to other resources

NodeList

[
  "x3000c0s19b1n0",
  "x3000c0s19b2n0"
]

A node list that is required to have at least one node.

It is recommended that this list should be 1-65535 items in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous [HardwareComponentName] false none A node list that is required to have at least one node.

It is recommended that this list should be 1-65535 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

NodeListEmptyOk

[
  "x3000c0s19b1n0",
  "x3000c0s19b2n0"
]

A node list that is allowed to be empty.

It is recommended that this list should be no more than 65535 items in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous [HardwareComponentName] false none A node list that is allowed to be empty.

It is recommended that this list should be no more than 65535 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

NodeGroupList

[
  "string"
]

Node group list. Allows actions against associated nodes by logical groupings.

It is recommended that this list should be 1-4095 items in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

None

NodeRoleList

[
  "Compute",
  "Application"
]

Node role list. Allows actions against nodes with associated roles.

It is recommended that this list should be 1-1023 items in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

None

ProblemDetails

{
  "type": "about:blank",
  "title": "string",
  "status": 400,
  "instance": "http://example.com",
  "detail": "string"
}

An error response for RFC 7807 problem details.

Properties

Name Type Required Restrictions Description
type string(uri) false none Relative URI reference to the type of problem which includes human
readable documentation.
title string false none Short, human-readable summary of the problem, should not change by
occurrence.
status integer false none HTTP status code
instance string(uri) false none A relative URI reference that identifies the specific occurrence of
the problem
detail string false none A human-readable explanation specific to this occurrence of the
problem. Focus on helping correct the problem, rather than giving
debugging information.

SessionLimit

"string"

A comma-separated list of nodes, groups, or roles to which the Session will be limited. Components are treated as OR operations unless preceded by “&” for AND or “!” for NOT.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none A comma-separated list of nodes, groups, or roles to which the Session
will be limited. Components are treated as OR operations unless
preceded by “&” for AND or “!” for NOT.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

SessionTemplateDescription

"string"

An optional description for the Session Template.

It is recommended that this should be 1-1023 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none An optional description for the Session Template.

It is recommended that this should be 1-1023 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

SessionTemplateName

"cle-1.0.0"

Name of the Session Template.

It is recommended to use names which meet the following restrictions:

  • Maximum length of 127 characters.
  • Use only letters, digits, periods (.), dashes (-), and underscores (_).
  • Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.

TenantName

"vcluster-my-tenant1"

Name of a tenant. Used for multi-tenancy. An empty string means no tenant.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none Name of a tenant. Used for multi-tenancy. An empty string means no tenant.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

Version

{
  "major": "string",
  "minor": "string",
  "patch": "string",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

Version data

Properties

Name Type Required Restrictions Description
major string false none none
minor string false none none
patch string false none none
links LinkList false none List of links to other resources

V1CfsBranch

"string"

The name of the branch containing the configuration that you want to apply to the nodes. Mutually exclusive with commit. (DEPRECATED)

It is recommended that this should be 1-1023 characters in length.

When upgrading to this version of BOS, all existing V1 session templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is automatically removed from it before storing it in BOS.

Properties

Name Type Required Restrictions Description
anonymous string false none The name of the branch containing the configuration that you want to
apply to the nodes. Mutually exclusive with commit. (DEPRECATED)

It is recommended that this should be 1-1023 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.

V1CfsUrl

"string"

The clone URL for the repository providing the configuration. (DEPRECATED)

It is recommended that this should be 1-4096 characters in length.

When upgrading to this version of BOS, all existing V1 session templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is automatically removed from it before storing it in BOS.

Properties

Name Type Required Restrictions Description
anonymous string false none The clone URL for the repository providing the configuration. (DEPRECATED)

It is recommended that this should be 1-4096 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.

V1CfsParameters

{
  "clone_url": "string",
  "branch": "string",
  "commit": "string",
  "playbook": "string",
  "configuration": "compute-23.4.0"
}

This is the collection of parameters that are passed to the Configuration Framework Service when configuration is enabled.

Properties

Name Type Required Restrictions Description
clone_url V1CfsUrl false none The clone URL for the repository providing the configuration. (DEPRECATED)

It is recommended that this should be 1-4096 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
branch V1CfsBranch false none The name of the branch containing the configuration that you want to
apply to the nodes. Mutually exclusive with commit. (DEPRECATED)

It is recommended that this should be 1-1023 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
commit string false none The commit ID of the configuration that you want to
apply to the nodes. Mutually exclusive with branch. (DEPRECATED)

git commit hashes are hexadecimal strings with a length of 40 characters (although
fewer characters may be sufficient to uniquely identify a commit in some cases).

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
playbook string false none The name of the playbook to run for configuration. The file path must be specified
relative to the base directory of the config repository. (DEPRECATED)

It is recommended that this should be 1-255 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
configuration CfsConfiguration false none The name of configuration to be applied.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

V1CompleteMetadata

true

Is the object’s status complete

Properties

Name Type Required Restrictions Description
anonymous boolean false none Is the object’s status complete

V1ErrorCountMetadata

0

How many errors were encountered

Properties

Name Type Required Restrictions Description
anonymous integer false none How many errors were encountered

V1InProgressMetadata

false

Is the object still doing something

Properties

Name Type Required Restrictions Description
anonymous boolean false none Is the object still doing something

V1StartTimeMetadata

"2020-04-24T12:00"

The start time

Properties

Name Type Required Restrictions Description
anonymous string false none The start time

V1StopTimeMetadata

"2020-04-24T12:00"

The stop time. In some contexts, the value may be null before the operation finishes.

Properties

Name Type Required Restrictions Description
anonymous string¦null false none The stop time. In some contexts, the value may be null before the operation finishes.

V1GenericMetadata

{
  "complete": true,
  "error_count": 0,
  "in_progress": false,
  "start_time": "2020-04-24T12:00",
  "stop_time": "2020-04-24T12:00"
}

The status metadata

Properties

Name Type Required Restrictions Description
complete V1CompleteMetadata false none Is the object’s status complete
error_count V1ErrorCountMetadata false none How many errors were encountered
in_progress V1InProgressMetadata false none Is the object still doing something
start_time V1StartTimeMetadata false none The start time
stop_time V1StopTimeMetadata false none The stop time. In some contexts, the value may be null before the operation finishes.

V1PhaseCategoryName

"Succeeded"

Name of the Phase Category not_started, in_progress, succeeded, failed, or excluded

Properties

Name Type Required Restrictions Description
anonymous string false none Name of the Phase Category
not_started, in_progress, succeeded, failed, or excluded

V1PhaseCategoryStatus

{
  "name": "Succeeded",
  "node_list": [
    "x3000c0s19b1n0",
    "x3000c0s19b2n0"
  ]
}

A list of the nodes in a given category within a Phase.

  • self : The phase category status object

Properties

Name Type Required Restrictions Description
name V1PhaseCategoryName false none Name of the Phase Category
not_started, in_progress, succeeded, failed, or excluded
node_list NodeListEmptyOk false none A node list that is allowed to be empty.

It is recommended that this list should be no more than 65535 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

V1PhaseStatus

{
  "name": "Boot",
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "categories": [
    {
      "name": "Succeeded",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ]
    }
  ],
  "errors": {
    "property1": [
      "x3000c0s19b1n0",
      "x3000c0s19b2n0"
    ],
    "property2": [
      "x3000c0s19b1n0",
      "x3000c0s19b2n0"
    ]
  }
}

The phase’s status. It is a list of all of the nodes in the phase and what category those nodes fall into within the phase.

  • self : The phase status object

Properties

Name Type Required Restrictions Description
name string false none Name of the Phase
boot, configure, or shutdown
metadata V1GenericMetadata false none The status metadata
categories [V1PhaseCategoryStatus] false none [A list of the nodes in a given category within a Phase.

## Link Relationships

* self : The phase category status object
]
errors V1NodeErrorsList false none Categorizing nodes into failures by the type of error they have.
This is an additive characterization. Nodes will be added to existing errors.
This does not overwrite previously existing errors.

V1SessionId

"8deb0746-b18c-427c-84a8-72ec6a28642c"

Unique BOS v1 Session identifier.

Properties

Name Type Required Restrictions Description
anonymous string(uuid) false none Unique BOS v1 Session identifier.

V1BootSetStatus

{
  "name": "compute",
  "session": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "phases": [
    {
      "name": "Boot",
      "metadata": {
        "complete": true,
        "error_count": 0,
        "in_progress": false,
        "start_time": "2020-04-24T12:00",
        "stop_time": "2020-04-24T12:00"
      },
      "categories": [
        {
          "name": "Succeeded",
          "node_list": [
            "x3000c0s19b1n0",
            "x3000c0s19b2n0"
          ]
        }
      ],
      "errors": {
        "property1": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "property2": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ]
      }
    }
  ],
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

The status for a Boot Set. It as a list of the phase statuses for the Boot Set.

  • self : The Boot Set Status object
  • phase : A phase of the Boot Set

Properties

Name Type Required Restrictions Description
name BootSetName false none The Boot Set name.

It is recommended that:
* Boot Set names should be 1-127 characters in length.
* Boot Set names should use only letters, digits, periods (.), dashes (-), and underscores (_).
* Boot Set names should begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
session V1SessionId false none Unique BOS v1 Session identifier.
metadata V1GenericMetadata false none The status metadata
phases [V1PhaseStatus] false none [The phase’s status. It is a list of all of the nodes in the phase and
what category those nodes fall into within the phase.

## Link Relationships

* self : The phase status object
]
links LinkList false none List of links to other resources

V1SessionStatus

{
  "metadata": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  },
  "boot_sets": [
    "compute"
  ],
  "id": "8deb0746-b18c-427c-84a8-72ec6a28642c",
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

The status for a Session. It is a list of all of the Boot Set Statuses in the Session.

  • self : The Session status object
  • boot sets: URL to access the Boot Set status

Properties

Name Type Required Restrictions Description
metadata V1GenericMetadata false none The status metadata
boot_sets [BootSetName] false none The Boot Sets in the Session
id V1SessionId false none Unique BOS v1 Session identifier.
links LinkList false none List of links to other resources

V1BootSet

{
  "name": "compute",
  "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
  "type": "s3",
  "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
  "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
  "node_list": [
    "x3000c0s19b1n0",
    "x3000c0s19b2n0"
  ],
  "node_roles_groups": [
    "Compute",
    "Application"
  ],
  "node_groups": [
    "string"
  ],
  "rootfs_provider": "cpss3",
  "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0",
  "network": "string",
  "boot_ordinal": 0,
  "shutdown_ordinal": 0
}

A Boot Set defines a collection of nodes and the information about the boot artifacts and parameters to be sent to each node over the specified network to enable these nodes to boot. When multiple Boot Sets are used in a Session Template, the boot_ordinal and shutdown_ordinal indicate the order in which Boot Sets need to be acted upon. Boot Sets sharing the same ordinal number will be addressed at the same time.

Properties

Name Type Required Restrictions Description
name BootSetName false none The Boot Set name.

It is recommended that:
* Boot Set names should be 1-127 characters in length.
* Boot Set names should use only letters, digits, periods (.), dashes (-), and underscores (_).
* Boot Set names should begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
path BootManifestPath true none A path identifying the metadata describing the components of the boot image.
This could be a URI, URL, etc, depending on the type of the Boot Set.

It is recommended that this should be 1-4095 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
type BootSetType true none The MIME type of the metadata describing the components of the boot image. This type controls how BOS processes the path attribute.

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
etag BootSetEtag false none This is the ’entity tag’. It helps verify the version of metadata describing the components of the boot image we are working with.

ETags are defined as being 1-65536 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
kernel_parameters BootKernelParameters false none The kernel parameters to use to boot the nodes.

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
node_list NodeList false none A node list that is required to have at least one node.

It is recommended that this list should be 1-65535 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
node_roles_groups NodeRoleList false none Node role list. Allows actions against nodes with associated roles.

It is recommended that this list should be 1-1023 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
node_groups NodeGroupList false none Node group list. Allows actions against associated nodes by logical groupings.

It is recommended that this list should be 1-4095 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
rootfs_provider BootSetRootfsProvider false none The root file system provider.

It is recommended that this should be 1-511 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
rootfs_provider_passthrough BootSetRootfsProviderPassthrough false none The root file system provider passthrough.
These are additional kernel parameters that will be appended to
the ‘rootfs=’ kernel parameter

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
network string false none The network over which the node will boot.
Choices: NMN – Node Management Network

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
boot_ordinal integer false none The boot ordinal. This will establish the order for Boot Set operations.
Boot Sets boot in order from the lowest to highest boot_ordinal.

It is recommended that this should have a maximum value of 65535.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
shutdown_ordinal integer false none The shutdown ordinal. This will establish the order for Boot Set
shutdown operations. Sets shutdown from low to high shutdown_ordinal.

It is recommended that this should have a maximum value of 65535.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.

V1SessionTemplateUuid

"my-session-template"

DEPRECATED - use templateName. This field is ignored if templateName is also set.

Name of the Session Template.

It is recommended to use names which meet the following restrictions:

  • 1-127 characters in length.
  • Use only letters, digits, periods (.), dashes (-), and underscores (_).
  • Begin and end with a letter or digit.

Properties

Name Type Required Restrictions Description
anonymous string false none DEPRECATED - use templateName. This field is ignored if templateName is also set.

Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* 1-127 characters in length.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

V1SessionTemplate

{
  "name": "cle-1.0.0",
  "description": "string",
  "cfs_url": "string",
  "cfs_branch": "string",
  "enable_cfs": true,
  "cfs": {
    "clone_url": "string",
    "branch": "string",
    "commit": "string",
    "playbook": "string",
    "configuration": "compute-23.4.0"
  },
  "partition": "string",
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0",
      "network": "string",
      "boot_ordinal": 0,
      "shutdown_ordinal": 0
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0",
      "network": "string",
      "boot_ordinal": 0,
      "shutdown_ordinal": 0
    }
  }
}

A Session Template object represents a collection of resources and metadata. A Session Template is used to create a Session which when combined with an action (i.e. boot, configure, reboot, shutdown) will create a Kubernetes BOA job to complete the required tasks for the operation.

When upgrading to this version of BOS, all existing V1 session templates will automatically have all deprecated fields removed from them.

When a V1 session template is created, all deprecated fields are automatically removed from it before storing it in BOS.

  • self : The Session Template object

Properties

Name Type Required Restrictions Description
name SessionTemplateName true none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
description SessionTemplateDescription false none An optional description for the Session Template.

It is recommended that this should be 1-1023 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
cfs_url V1CfsUrl false none The clone URL for the repository providing the configuration. (DEPRECATED)

It is recommended that this should be 1-4096 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
cfs_branch V1CfsBranch false none The name of the branch containing the configuration that you want to
apply to the nodes. Mutually exclusive with commit. (DEPRECATED)

It is recommended that this should be 1-1023 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
enable_cfs EnableCfs false none Whether to enable the Configuration Framework Service (CFS).
cfs V1CfsParameters false none This is the collection of parameters that are passed to the Configuration
Framework Service when configuration is enabled.
partition string false none The machine partition to operate on.

It is recommended that this should be 1-255 characters in length.

When upgrading to this version of BOS, all existing V1 session
templates will automatically have this deprecated field removed from them.

When a V1 session template is created, this deprecated field is
automatically removed from it before storing it in BOS.
boot_sets object false none Mapping from Boot Set names to Boot Sets.

It is recommended that:
* At least one Boot Set should be defined, because a Session Template with no
Boot Sets is not functional.
* Boot Set names should be 1-127 characters in length.
* Boot Set names should use only letters, digits, periods (.), dashes (-), and underscores (_).
* Boot Set names should begin and end with a letter or digit.
» additionalProperties V1BootSet false none A Boot Set defines a collection of nodes and the information about the
boot artifacts and parameters to be sent to each node over the specified
network to enable these nodes to boot. When multiple Boot Sets are used
in a Session Template, the boot_ordinal and shutdown_ordinal indicate
the order in which Boot Sets need to be acted upon. Boot Sets sharing
the same ordinal number will be addressed at the same time.

V1BoaKubernetesJob

"boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0"

The identity of the Kubernetes job that is created to handle the Session.

Properties

Name Type Required Restrictions Description
anonymous string false read-only The identity of the Kubernetes job that is created to handle the Session.

V1Operation

"boot"

A Session represents an operation on a Session Template. The creation of a Session effectively results in the creation of a Kubernetes Boot Orchestration Agent (BOA) job to perform the duties required to complete the operation.

Operation – An operation to perform on nodes in this Session.

Boot         Boot nodes that are off.

Configure    Reconfigure the nodes using the Configuration Framework
             Service (CFS).

Reboot       Gracefully power down nodes that are on and then power
             them back up.

Shutdown     Gracefully power down nodes that are on.

Properties

Name Type Required Restrictions Description
anonymous string false none A Session represents an operation on a Session Template.
The creation of a Session effectively results in the creation
of a Kubernetes Boot Orchestration Agent (BOA) job to perform the
duties required to complete the operation.

Operation – An operation to perform on nodes in this Session.

Boot Boot nodes that are off.

Configure Reconfigure the nodes using the Configuration Framework
Service (CFS).

Reboot Gracefully power down nodes that are on and then power
them back up.

Shutdown Gracefully power down nodes that are on.		 
{
  "href": "string",
  "jobId": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "rel": "session",
  "type": "GET"
}

Link to other resources

Properties

Name Type Required Restrictions Description
href string false none none
jobId V1BoaKubernetesJob false none The identity of the Kubernetes job that is created to handle the Session.
rel string false none none
type string false none none

Enumerated Values

Property Value
rel session
rel status
type GET

V1SessionStatusUri

"/v1/session/90730844-094d-45a5-9b90-d661d14d9444/status"

URI to the status for this Session

Properties

Name Type Required Restrictions Description
anonymous string(uri) false none URI to the status for this Session

V1SessionDetails

{
  "complete": true,
  "error_count": 0,
  "in_progress": false,
  "job": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "operation": "boot",
  "start_time": "2020-04-24T12:00",
  "status_link": "/v1/session/90730844-094d-45a5-9b90-d661d14d9444/status",
  "stop_time": "2020-04-24T12:00",
  "templateName": "cle-1.0.0"
}

Details about a Session.

Properties

Name Type Required Restrictions Description
complete V1CompleteMetadata false none Is the object’s status complete
error_count V1ErrorCountMetadata false none How many errors were encountered
in_progress V1InProgressMetadata false none Is the object still doing something
job V1BoaKubernetesJob false none The identity of the Kubernetes job that is created to handle the Session.
operation V1Operation false none A Session represents an operation on a Session Template.
The creation of a Session effectively results in the creation
of a Kubernetes Boot Orchestration Agent (BOA) job to perform the
duties required to complete the operation.

Operation – An operation to perform on nodes in this Session.

Boot Boot nodes that are off.

Configure Reconfigure the nodes using the Configuration Framework
Service (CFS).

Reboot Gracefully power down nodes that are on and then power
them back up.

Shutdown Gracefully power down nodes that are on.
start_time V1StartTimeMetadata false none The start time
status_link V1SessionStatusUri false none URI to the status for this Session
stop_time V1StopTimeMetadata false none The stop time. In some contexts, the value may be null before the operation finishes.
templateName SessionTemplateName false none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.

V1SessionDetailsByTemplateUuid

{
  "complete": true,
  "error_count": 0,
  "in_progress": false,
  "job": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "operation": "boot",
  "start_time": "2020-04-24T12:00",
  "status_link": "/v1/session/90730844-094d-45a5-9b90-d661d14d9444/status",
  "stop_time": "2020-04-24T12:00",
  "templateName": "cle-1.0.0"
}

Details about a Session using templateUuid instead of templateName. DEPRECATED – these will only exist from Sessions created before templateUuid was deprecated.

Properties

Name Type Required Restrictions Description
complete V1CompleteMetadata false none Is the object’s status complete
error_count V1ErrorCountMetadata false none How many errors were encountered
in_progress V1InProgressMetadata false none Is the object still doing something
job V1BoaKubernetesJob false none The identity of the Kubernetes job that is created to handle the Session.
operation V1Operation false none A Session represents an operation on a Session Template.
The creation of a Session effectively results in the creation
of a Kubernetes Boot Orchestration Agent (BOA) job to perform the
duties required to complete the operation.

Operation – An operation to perform on nodes in this Session.

Boot Boot nodes that are off.

Configure Reconfigure the nodes using the Configuration Framework
Service (CFS).

Reboot Gracefully power down nodes that are on and then power
them back up.

Shutdown Gracefully power down nodes that are on.
start_time V1StartTimeMetadata false none The start time
status_link V1SessionStatusUri false none URI to the status for this Session
stop_time V1StopTimeMetadata false none The stop time. In some contexts, the value may be null before the operation finishes.
templateName SessionTemplateName false none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.		 
[
  {
    "href": "string",
    "jobId": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
    "rel": "session",
    "type": "GET"
  }
]

Properties

Name Type Required Restrictions Description
anonymous [V1SessionLink] false read-only [Link to other resources]

V1Session

{
  "operation": "boot",
  "templateName": "cle-1.0.0",
  "job": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "limit": "string",
  "links": [
    {
      "href": "string",
      "jobId": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
      "rel": "session",
      "type": "GET"
    }
  ]
}

A Session object

  • self : The Session object

Properties

Name Type Required Restrictions Description
operation V1Operation true none A Session represents an operation on a Session Template.
The creation of a Session effectively results in the creation
of a Kubernetes Boot Orchestration Agent (BOA) job to perform the
duties required to complete the operation.

Operation – An operation to perform on nodes in this Session.

Boot Boot nodes that are off.

Configure Reconfigure the nodes using the Configuration Framework
Service (CFS).

Reboot Gracefully power down nodes that are on and then power
them back up.

Shutdown Gracefully power down nodes that are on.
templateName SessionTemplateName true none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
job V1BoaKubernetesJob false none The identity of the Kubernetes job that is created to handle the Session.
limit SessionLimit false none A comma-separated list of nodes, groups, or roles to which the Session
will be limited. Components are treated as OR operations unless
preceded by “&” for AND or “!” for NOT.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
links V1SessionLinkList false none none

V1SessionByTemplateName

{
  "operation": "boot",
  "templateUuid": "my-session-template",
  "templateName": "cle-1.0.0",
  "job": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "limit": "string",
  "links": [
    {
      "href": "string",
      "jobId": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
      "rel": "session",
      "type": "GET"
    }
  ]
}

A Session object specified by templateName

  • self : The Session object

Properties

Name Type Required Restrictions Description
operation V1Operation true none A Session represents an operation on a Session Template.
The creation of a Session effectively results in the creation
of a Kubernetes Boot Orchestration Agent (BOA) job to perform the
duties required to complete the operation.

Operation – An operation to perform on nodes in this Session.

Boot Boot nodes that are off.

Configure Reconfigure the nodes using the Configuration Framework
Service (CFS).

Reboot Gracefully power down nodes that are on and then power
them back up.

Shutdown Gracefully power down nodes that are on.
templateUuid V1SessionTemplateUuid false none DEPRECATED - use templateName. This field is ignored if templateName is also set.

Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* 1-127 characters in length.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.
templateName SessionTemplateName true none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
job V1BoaKubernetesJob false none The identity of the Kubernetes job that is created to handle the Session.
limit SessionLimit false none A comma-separated list of nodes, groups, or roles to which the Session
will be limited. Components are treated as OR operations unless
preceded by “&” for AND or “!” for NOT.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
links V1SessionLinkList false none none

V1SessionByTemplateUuid

{
  "operation": "boot",
  "templateUuid": "my-session-template",
  "job": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
  "limit": "string",
  "links": [
    {
      "href": "string",
      "jobId": "boa-07877de1-09bb-4ca8-a4e5-943b1262dbf0",
      "rel": "session",
      "type": "GET"
    }
  ]
}

A Session object specified by templateUuid (DEPRECATED – use templateName)

  • self : The Session object

Properties

Name Type Required Restrictions Description
operation V1Operation true none A Session represents an operation on a Session Template.
The creation of a Session effectively results in the creation
of a Kubernetes Boot Orchestration Agent (BOA) job to perform the
duties required to complete the operation.

Operation – An operation to perform on nodes in this Session.

Boot Boot nodes that are off.

Configure Reconfigure the nodes using the Configuration Framework
Service (CFS).

Reboot Gracefully power down nodes that are on and then power
them back up.

Shutdown Gracefully power down nodes that are on.
templateUuid V1SessionTemplateUuid true none DEPRECATED - use templateName. This field is ignored if templateName is also set.

Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* 1-127 characters in length.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.
job V1BoaKubernetesJob false none The identity of the Kubernetes job that is created to handle the Session.
limit SessionLimit false none A comma-separated list of nodes, groups, or roles to which the Session
will be limited. Components are treated as OR operations unless
preceded by “&” for AND or “!” for NOT.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
links V1SessionLinkList false none none

V1PhaseName

"Boot"

The phase that this data belongs to (boot, shutdown, or configure). Or it can be set to “boot_set” to indicate that it belongs to the Boot Set itself.

Properties

Name Type Required Restrictions Description
anonymous string false none The phase that this data belongs to (boot, shutdown, or configure). Or it can
be set to “boot_set” to indicate that it belongs to the Boot Set itself.

V1NodeChangeList

{
  "phase": "Boot",
  "source": "Succeeded",
  "destination": "Succeeded",
  "node_list": [
    "x3000c0s19b1n0",
    "x3000c0s19b2n0"
  ]
}

The information used to update the status of a node list. It moves nodes from one category to another within a phase.

Properties

Name Type Required Restrictions Description
phase V1PhaseName true none The phase that this data belongs to (boot, shutdown, or configure). Or it can
be set to “boot_set” to indicate that it belongs to the Boot Set itself.
source V1PhaseCategoryName true none Name of the Phase Category
not_started, in_progress, succeeded, failed, or excluded
destination V1PhaseCategoryName true none Name of the Phase Category
not_started, in_progress, succeeded, failed, or excluded
node_list NodeListEmptyOk true none A node list that is allowed to be empty.

It is recommended that this list should be no more than 65535 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

V1NodeErrorsList

{
  "property1": [
    "x3000c0s19b1n0",
    "x3000c0s19b2n0"
  ],
  "property2": [
    "x3000c0s19b1n0",
    "x3000c0s19b2n0"
  ]
}

Categorizing nodes into failures by the type of error they have. This is an additive characterization. Nodes will be added to existing errors. This does not overwrite previously existing errors.

Properties

Name Type Required Restrictions Description
additionalProperties NodeListEmptyOk false none A node list that is allowed to be empty.

It is recommended that this list should be no more than 65535 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

V1UpdateRequestNodeChange

{
  "update_type": "NodeChangeList",
  "phase": "Boot",
  "data": {
    "phase": "Boot",
    "source": "Succeeded",
    "destination": "Succeeded",
    "node_list": [
      "x3000c0s19b1n0",
      "x3000c0s19b2n0"
    ]
  }
}

This is an element of the payload sent during an update request. It contains updates to which categories nodes are in.

Properties

Name Type Required Restrictions Description
update_type string true none The type of update data
phase V1PhaseName true none The phase that this data belongs to (boot, shutdown, or configure). Or it can
be set to “boot_set” to indicate that it belongs to the Boot Set itself.
data V1NodeChangeList true none The information used to update the status of a node list. It moves nodes from
one category to another within a phase.

Enumerated Values

Property Value
update_type NodeChangeList

V1UpdateRequestNodeErrors

{
  "update_type": "NodeErrorsList",
  "phase": "Boot",
  "data": {
    "property1": [
      "x3000c0s19b1n0",
      "x3000c0s19b2n0"
    ],
    "property2": [
      "x3000c0s19b1n0",
      "x3000c0s19b2n0"
    ]
  }
}

This is an element of the payload sent during an update request. It contains updates to which errors have occurred and which nodes encountered those errors

Properties

Name Type Required Restrictions Description
update_type string true none The type of update data
phase V1PhaseName true none The phase that this data belongs to (boot, shutdown, or configure). Or it can
be set to “boot_set” to indicate that it belongs to the Boot Set itself.
data V1NodeErrorsList true none Categorizing nodes into failures by the type of error they have.
This is an additive characterization. Nodes will be added to existing errors.
This does not overwrite previously existing errors.

Enumerated Values

Property Value
update_type NodeErrorsList

V1UpdateRequestGenericMetadata

{
  "update_type": "GenericMetadata",
  "phase": "Boot",
  "data": {
    "complete": true,
    "error_count": 0,
    "in_progress": false,
    "start_time": "2020-04-24T12:00",
    "stop_time": "2020-04-24T12:00"
  }
}

This is an element of the payload sent during an update request. It contains updates to metadata, specifically start and stop times

Properties

Name Type Required Restrictions Description
update_type string true none The type of update data
phase V1PhaseName true none The phase that this data belongs to (boot, shutdown, or configure). Or it can
be set to “boot_set” to indicate that it belongs to the Boot Set itself.
data V1GenericMetadata true none The status metadata

Enumerated Values

Property Value
update_type GenericMetadata

V1UpdateRequestList

[
  {
    "update_type": "NodeChangeList",
    "phase": "Boot",
    "data": {
      "phase": "Boot",
      "source": "Succeeded",
      "destination": "Succeeded",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ]
    }
  }
]

This is the payload sent during an update request. It contains a list of updates.

Properties

oneOf

Name Type Required Restrictions Description
anonymous V1UpdateRequestNodeChange false none This is an element of the payload sent during an update request. It contains
updates to which categories nodes are in.

xor

Name Type Required Restrictions Description
anonymous V1UpdateRequestNodeErrors false none This is an element of the payload sent during an update request. It contains
updates to which errors have occurred and which nodes encountered those errors

xor

Name Type Required Restrictions Description
anonymous V1UpdateRequestGenericMetadata false none This is an element of the payload sent during an update request. It contains
updates to metadata, specifically start and stop times

V2TenantName

"string"

Name of the tenant that owns this resource. Only used in environments with multi-tenancy enabled. An empty string or null value means the resource is not owned by a tenant. The absence of this field from a resource indicates the same.

Properties

Name Type Required Restrictions Description
anonymous string¦null false read-only Name of the tenant that owns this resource. Only used in environments
with multi-tenancy enabled. An empty string or null value means the resource
is not owned by a tenant. The absence of this field from a resource indicates
the same.

V2CfsParameters

{
  "configuration": "compute-23.4.0"
}

This is the collection of parameters that are passed to the Configuration Framework Service when configuration is enabled. Can be set as the global value for a Session Template, or individually within a Boot Set.

Properties

Name Type Required Restrictions Description
configuration CfsConfiguration false none The name of configuration to be applied.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

V2SessionTemplate

{
  "name": "cle-1.0.0",
  "tenant": "string",
  "description": "string",
  "enable_cfs": true,
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "boot_sets": {
    "property1": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    },
    "property2": {
      "name": "compute",
      "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
      "cfs": {
        "configuration": "compute-23.4.0"
      },
      "type": "s3",
      "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "node_list": [
        "x3000c0s19b1n0",
        "x3000c0s19b2n0"
      ],
      "node_roles_groups": [
        "Compute",
        "Application"
      ],
      "node_groups": [
        "string"
      ],
      "arch": "X86",
      "rootfs_provider": "cpss3",
      "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
    }
  },
  "links": [
    {
      "href": "string",
      "rel": "string"
    }
  ]
}

A Session Template object represents a collection of resources and metadata. A Session Template is used to create a Session which applies the data to group of Components.

  • self : The Session Template object

Properties

Name Type Required Restrictions Description
name string false read-only Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
tenant V2TenantName false none Name of the tenant that owns this resource. Only used in environments
with multi-tenancy enabled. An empty string or null value means the resource
is not owned by a tenant. The absence of this field from a resource indicates
the same.
description SessionTemplateDescription false none An optional description for the Session Template.

It is recommended that this should be 1-1023 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
enable_cfs EnableCfs false none Whether to enable the Configuration Framework Service (CFS).
cfs V2CfsParameters false none This is the collection of parameters that are passed to the Configuration
Framework Service when configuration is enabled. Can be set as the global value for
a Session Template, or individually within a Boot Set.
boot_sets object false none Mapping from Boot Set names to Boot Sets.

It is recommended that:
* At least one Boot Set should be defined, because a Session Template with no
Boot Sets is not functional.
* Boot Set names should be 1-127 characters in length.
* Boot Set names should use only letters, digits, periods (.), dashes (-), and underscores (_).
* Boot Set names should begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
» additionalProperties V2BootSet false none A Boot Set is a collection of nodes defined by an explicit list, their functional
role, and their logical groupings. This collection of nodes is associated with one
set of boot artifacts and optional additional records for configuration and root
filesystem provisioning.
links LinkListReadOnly false none List of links to other resources

V2SessionTemplateValidation

"string"

Message describing errors or incompleteness in a Session Template.

Properties

Name Type Required Restrictions Description
anonymous string false none Message describing errors or incompleteness in a Session Template.

V2SessionName

"session-20190728032600"

Name of the Session.

Properties

Name Type Required Restrictions Description
anonymous string false none Name of the Session.

V2SessionOperation

"boot"

A Session represents a desired state that is being applied to a group of Components. Sessions run until all Components it manages have either been disabled due to completion, or until all Components are managed by other newer Sessions.

Operation – An operation to perform on Components in this Session. Boot Applies the Template to the Components and boots/reboots if necessary. Reboot Applies the Template to the Components; guarantees a reboot. Shutdown Power down Components that are on.

Properties

Name Type Required Restrictions Description
anonymous string false none A Session represents a desired state that is being applied to a group
of Components. Sessions run until all Components it manages have
either been disabled due to completion, or until all Components are
managed by other newer Sessions.

Operation – An operation to perform on Components in this Session.
Boot Applies the Template to the Components and boots/reboots if necessary.
Reboot Applies the Template to the Components; guarantees a reboot.
Shutdown Power down Components that are on.

Enumerated Values

Property Value
anonymous boot
anonymous reboot
anonymous shutdown

V2SessionCreate

{
  "name": "session-20190728032600",
  "operation": "boot",
  "template_name": "cle-1.0.0",
  "limit": "string",
  "stage": false,
  "include_disabled": false
}

A Session Creation object. A UUID name is generated if a name is not provided.

Properties

Name Type Required Restrictions Description
name V2SessionName false none Name of the Session.
operation V2SessionOperation true none A Session represents a desired state that is being applied to a group
of Components. Sessions run until all Components it manages have
either been disabled due to completion, or until all Components are
managed by other newer Sessions.

Operation – An operation to perform on Components in this Session.
Boot Applies the Template to the Components and boots/reboots if necessary.
Reboot Applies the Template to the Components; guarantees a reboot.
Shutdown Power down Components that are on.
template_name SessionTemplateName true none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
limit SessionLimit false none A comma-separated list of nodes, groups, or roles to which the Session
will be limited. Components are treated as OR operations unless
preceded by “&” for AND or “!” for NOT.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
stage boolean false none Set to stage a Session which will not immediately change the state of any Components.
The “applystaged” endpoint can be called at a later time to trigger the start of this Session.
include_disabled boolean false none Set to include nodes that have been disabled as indicated in the Hardware State Manager (HSM).

V2SessionStatusLabel

"pending"

The status of a Session.

Properties

Name Type Required Restrictions Description
anonymous string false none The status of a Session.

Enumerated Values

Property Value
anonymous pending
anonymous running
anonymous complete

V2SessionStartTime

"string"

When the Session was created.

Properties

Name Type Required Restrictions Description
anonymous string false none When the Session was created.

V2SessionEndTime

"string"

When the Session was completed. A null value means the Session has not ended.

Properties

Name Type Required Restrictions Description
anonymous string¦null false none When the Session was completed. A null value means the Session has not ended.

V2SessionStatus

{
  "start_time": "string",
  "end_time": "string",
  "status": "pending",
  "error": "string"
}

Information on the status of a Session.

Properties

Name Type Required Restrictions Description
start_time V2SessionStartTime false none When the Session was created.
end_time V2SessionEndTime false none When the Session was completed. A null value means the Session has not ended.
status V2SessionStatusLabel false none The status of a Session.
error string¦null false none Error which prevented the Session from running.
A null value means the Session has not encountered an error.

V2BootSet

{
  "name": "compute",
  "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
  "cfs": {
    "configuration": "compute-23.4.0"
  },
  "type": "s3",
  "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
  "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
  "node_list": [
    "x3000c0s19b1n0",
    "x3000c0s19b2n0"
  ],
  "node_roles_groups": [
    "Compute",
    "Application"
  ],
  "node_groups": [
    "string"
  ],
  "arch": "X86",
  "rootfs_provider": "cpss3",
  "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
}

A Boot Set is a collection of nodes defined by an explicit list, their functional role, and their logical groupings. This collection of nodes is associated with one set of boot artifacts and optional additional records for configuration and root filesystem provisioning.

Properties

Name Type Required Restrictions Description
name BootSetName false none The Boot Set name.

It is recommended that:
* Boot Set names should be 1-127 characters in length.
* Boot Set names should use only letters, digits, periods (.), dashes (-), and underscores (_).
* Boot Set names should begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
path BootManifestPath true none A path identifying the metadata describing the components of the boot image.
This could be a URI, URL, etc, depending on the type of the Boot Set.

It is recommended that this should be 1-4095 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
cfs V2CfsParameters false none This is the collection of parameters that are passed to the Configuration
Framework Service when configuration is enabled. Can be set as the global value for
a Session Template, or individually within a Boot Set.
type BootSetType true none The MIME type of the metadata describing the components of the boot image. This type controls how BOS processes the path attribute.

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
etag BootSetEtag false none This is the ’entity tag’. It helps verify the version of metadata describing the components of the boot image we are working with.

ETags are defined as being 1-65536 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
kernel_parameters BootKernelParameters false none The kernel parameters to use to boot the nodes.

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
node_list NodeList false none A node list that is required to have at least one node.

It is recommended that this list should be 1-65535 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
node_roles_groups NodeRoleList false none Node role list. Allows actions against nodes with associated roles.

It is recommended that this list should be 1-1023 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
node_groups NodeGroupList false none Node group list. Allows actions against associated nodes by logical groupings.

It is recommended that this list should be 1-4095 items in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
arch string false none The node architecture to target. Filters nodes that are not part of matching architecture from being targeted by boot actions. This value should correspond to HSM component ‘Arch’ field exactly. For reasons of backwards compatibility, all HSM nodes that are of type Unknown are treated as being of type X86.
rootfs_provider BootSetRootfsProvider false none The root file system provider.

It is recommended that this should be 1-511 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
rootfs_provider_passthrough BootSetRootfsProviderPassthrough false none The root file system provider passthrough.
These are additional kernel parameters that will be appended to
the ‘rootfs=’ kernel parameter

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

Enumerated Values

Property Value
arch X86
arch ARM
arch Other
arch Unknown

V2SessionTemplateArray

[
  {
    "name": "cle-1.0.0",
    "tenant": "string",
    "description": "string",
    "enable_cfs": true,
    "cfs": {
      "configuration": "compute-23.4.0"
    },
    "boot_sets": {
      "property1": {
        "name": "compute",
        "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
        "cfs": {
          "configuration": "compute-23.4.0"
        },
        "type": "s3",
        "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "node_list": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "node_roles_groups": [
          "Compute",
          "Application"
        ],
        "node_groups": [
          "string"
        ],
        "arch": "X86",
        "rootfs_provider": "cpss3",
        "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
      },
      "property2": {
        "name": "compute",
        "path": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/manifest.json",
        "cfs": {
          "configuration": "compute-23.4.0"
        },
        "type": "s3",
        "etag": "1cc4eef4f407bd8a62d7d66ee4b9e9c8",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "node_list": [
          "x3000c0s19b1n0",
          "x3000c0s19b2n0"
        ],
        "node_roles_groups": [
          "Compute",
          "Application"
        ],
        "node_groups": [
          "string"
        ],
        "arch": "X86",
        "rootfs_provider": "cpss3",
        "rootfs_provider_passthrough": "dvs:api-gw-service-nmn.local:300:nmn0"
      }
    },
    "links": [
      {
        "href": "string",
        "rel": "string"
      }
    ]
  }
]

An array of Session Templates.

Properties

Name Type Required Restrictions Description
anonymous [V2SessionTemplate] false none An array of Session Templates.

V2Session

{
  "name": "session-20190728032600",
  "tenant": "string",
  "operation": "boot",
  "template_name": "cle-1.0.0",
  "limit": "string",
  "stage": true,
  "components": "string",
  "include_disabled": true,
  "status": {
    "start_time": "string",
    "end_time": "string",
    "status": "pending",
    "error": "string"
  }
}

A Session object

  • self : The Session object

Properties

Name Type Required Restrictions Description
name V2SessionName false none Name of the Session.
tenant V2TenantName false none Name of the tenant that owns this resource. Only used in environments
with multi-tenancy enabled. An empty string or null value means the resource
is not owned by a tenant. The absence of this field from a resource indicates
the same.
operation V2SessionOperation false none A Session represents a desired state that is being applied to a group
of Components. Sessions run until all Components it manages have
either been disabled due to completion, or until all Components are
managed by other newer Sessions.

Operation – An operation to perform on Components in this Session.
Boot Applies the Template to the Components and boots/reboots if necessary.
Reboot Applies the Template to the Components; guarantees a reboot.
Shutdown Power down Components that are on.
template_name SessionTemplateName false none Name of the Session Template.

It is recommended to use names which meet the following restrictions:
* Maximum length of 127 characters.
* Use only letters, digits, periods (.), dashes (-), and underscores (_).
* Begin and end with a letter or digit.

These restrictions are not enforced in this version of BOS, but they are
targeted to start being enforced in an upcoming BOS version.
limit SessionLimit false none A comma-separated list of nodes, groups, or roles to which the Session
will be limited. Components are treated as OR operations unless
preceded by “&” for AND or “!” for NOT.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
stage boolean false none Set to stage a Session which will not immediately change the state of any Components.
The “applystaged” endpoint can be called at a later time to trigger the start of this Session.
components string false none A comma-separated list of nodes, representing the initial list of nodes
the Session should operate against. The list will remain even if
other Sessions have taken over management of the nodes.
include_disabled boolean false none Set to include nodes that have been disabled as indicated in the Hardware State Manager (HSM).
status V2SessionStatus false none Information on the status of a Session.

V2SessionUpdate

{
  "components": "string",
  "status": {
    "start_time": "string",
    "end_time": "string",
    "status": "pending",
    "error": "string"
  }
}

A Session update object

  • self : The Session object

Properties

Name Type Required Restrictions Description
components string false none A comma-separated list of nodes, representing the initial list of nodes
the Session should operate against. The list will remain even if
other Sessions have taken over management of the nodes.
status V2SessionStatus false none Information on the status of a Session.

V2SessionArray

[
  {
    "name": "session-20190728032600",
    "tenant": "string",
    "operation": "boot",
    "template_name": "cle-1.0.0",
    "limit": "string",
    "stage": true,
    "components": "string",
    "include_disabled": true,
    "status": {
      "start_time": "string",
      "end_time": "string",
      "status": "pending",
      "error": "string"
    }
  }
]

An array of Sessions.

Properties

Name Type Required Restrictions Description
anonymous [V2Session] false none An array of Sessions.

V2SessionExtendedStatusPhases

{
  "percent_complete": 0,
  "percent_powering_on": 0,
  "percent_powering_off": 0,
  "percent_configuring": 0
}

Detailed information on the phases of a Session.

Properties

Name Type Required Restrictions Description
percent_complete number false none The percent of Components currently in a completed/stable state
percent_powering_on number false none The percent of Components currently in the powering-on phase
percent_powering_off number false none The percent of Components currently in the powering-off phase
percent_configuring number false none The percent of Components currently in the configuring phase

V2SessionExtendedStatusTiming

{
  "start_time": "string",
  "end_time": "string",
  "duration": "string"
}

Detailed information on the timing of a Session.

Properties

Name Type Required Restrictions Description
start_time V2SessionStartTime false none When the Session was created.
end_time V2SessionEndTime false none When the Session was completed. A null value means the Session has not ended.
duration string false none The current duration of the ongoing Session or final duration of the completed Session.

V2SessionExtendedStatus

{
  "status": "pending",
  "managed_components_count": 0,
  "phases": {
    "percent_complete": 0,
    "percent_powering_on": 0,
    "percent_powering_off": 0,
    "percent_configuring": 0
  },
  "percent_successful": 0,
  "percent_failed": 0,
  "percent_staged": 0,
  "error_summary": {},
  "timing": {
    "start_time": "string",
    "end_time": "string",
    "duration": "string"
  }
}

Detailed information on the status of a Session.

Properties

Name Type Required Restrictions Description
status V2SessionStatusLabel false none The status of a Session.
managed_components_count integer false none The count of Components currently managed by this Session
phases V2SessionExtendedStatusPhases false none Detailed information on the phases of a Session.
percent_successful number false none The percent of Components currently in a successful state
percent_failed number false none The percent of Components currently in a failed state
percent_staged number false none The percent of Components currently still staged for this Session
error_summary object false none A summary of the errors currently listed by all Components
timing V2SessionExtendedStatusTiming false none Detailed information on the timing of a Session.

V2BootArtifacts

{
  "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
  "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
  "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
}

A collection of boot artifacts.

Properties

Name Type Required Restrictions Description
kernel BootKernelPath false none A path to the kernel to use for booting.

It is recommended that this should be no more than 4095 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
kernel_parameters BootKernelParameters false none The kernel parameters to use to boot the nodes.

Linux kernel parameters may never exceed 4096 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
initrd BootInitrdPath false none A path to the initrd to use for booting.

It is recommended that this should be no more than 4095 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

V2ComponentBssToken

"string"

A token received from the node identifying the boot artifacts. For BOS use-only, users should not set this field. It will be overwritten.

Properties

Name Type Required Restrictions Description
anonymous string false none A token received from the node identifying the boot artifacts.
For BOS use-only, users should not set this field. It will be overwritten.

V2ComponentId

"string"

The Component’s ID. (e.g. xname for hardware Components)

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is targeted to start being enforced in an upcoming BOS version.

Properties

Name Type Required Restrictions Description
anonymous string false none The Component’s ID. (e.g. xname for hardware Components)

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.

V2ComponentIdList

[
  "string"
]

A list of Component IDs (xnames)

Properties

Name Type Required Restrictions Description
anonymous [V2ComponentId] false none A list of Component IDs (xnames)

V2ComponentLastUpdated

"2019-07-28T03:26:00Z"

The date/time when the state was last updated in RFC 3339 format.

Properties

Name Type Required Restrictions Description
anonymous string(date-time) false read-only The date/time when the state was last updated in RFC 3339 format.

V2ComponentActualState

{
  "boot_artifacts": {
    "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
    "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
    "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
  },
  "bss_token": "string",
  "last_updated": "2019-07-28T03:26:00Z"
}

The actual boot artifacts and configuration for a Component

Properties

Name Type Required Restrictions Description
boot_artifacts V2BootArtifacts false none A collection of boot artifacts.
bss_token V2ComponentBssToken false none A token received from the node identifying the boot artifacts.
For BOS use-only, users should not set this field. It will be overwritten.
last_updated V2ComponentLastUpdated false none The date/time when the state was last updated in RFC 3339 format.

V2ComponentDesiredState

{
  "boot_artifacts": {
    "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
    "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
    "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
  },
  "configuration": "compute-23.4.0",
  "bss_token": "string",
  "last_updated": "2019-07-28T03:26:00Z"
}

The desired boot artifacts and configuration for a Component

Properties

Name Type Required Restrictions Description
boot_artifacts V2BootArtifacts false none A collection of boot artifacts.
configuration CfsConfiguration false none The name of configuration to be applied.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
bss_token V2ComponentBssToken false none A token received from the node identifying the boot artifacts.
For BOS use-only, users should not set this field. It will be overwritten.
last_updated V2ComponentLastUpdated false none The date/time when the state was last updated in RFC 3339 format.

V2ComponentStagedState

{
  "boot_artifacts": {
    "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
    "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
    "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
  },
  "configuration": "compute-23.4.0",
  "session": "session-20190728032600",
  "last_updated": "2019-07-28T03:26:00Z"
}

The staged boot artifacts and configuration for a Component. Optionally, a Session may be set which can be triggered at a later time against this Component.

Properties

Name Type Required Restrictions Description
boot_artifacts V2BootArtifacts false none A collection of boot artifacts.
configuration CfsConfiguration false none The name of configuration to be applied.

It is recommended that this should be no more than 127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
session any false none none

oneOf

Name Type Required Restrictions Description
» anonymous V2SessionName false none Name of the Session.

xor

Name Type Required Restrictions Description
» anonymous EmptyString false none An empty string value.

continued

Name Type Required Restrictions Description
last_updated V2ComponentLastUpdated false none The date/time when the state was last updated in RFC 3339 format.

V2ComponentLastAction

{
  "last_updated": "2019-07-28T03:26:00Z",
  "action": "string",
  "failed": true
}

Information on the most recent action taken against the node.

Properties

Name Type Required Restrictions Description
last_updated V2ComponentLastUpdated false none The date/time when the state was last updated in RFC 3339 format.
action string false none A description of the most recent operator/action to impact the Component.
failed boolean false none Denotes if the last action failed to accomplish its task

V2ComponentEventStats

{
  "power_on_attempts": 0,
  "power_off_graceful_attempts": 0,
  "power_off_forceful_attempts": 0
}

Information on the most recent attempt to return the node to its desired state.

Properties

Name Type Required Restrictions Description
power_on_attempts integer false none How many attempts have been made to power-on since the last time the node was in the desired state.
power_off_graceful_attempts integer false none How many attempts have been made to power-off gracefully since the last time the node was in the desired state.
power_off_forceful_attempts integer false none How many attempts have been made to power-off forcefully since the last time the node was in the desired state.

V2ComponentStatus

{
  "phase": "string",
  "status": "string",
  "status_override": "string"
}

Status information for the Component

Properties

Name Type Required Restrictions Description
phase string false none The current phase of the Component in the boot process.
status string false read-only The current status of the Component. More detailed than phase.
status_override string false none If set, this will override the status value.

V2Component

{
  "id": "string",
  "actual_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "desired_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "bss_token": "string",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "staged_state": {
    "boot_artifacts": {
      "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
      "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
      "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
    },
    "configuration": "compute-23.4.0",
    "session": "session-20190728032600",
    "last_updated": "2019-07-28T03:26:00Z"
  },
  "last_action": {
    "last_updated": "2019-07-28T03:26:00Z",
    "action": "string",
    "failed": true
  },
  "event_stats": {
    "power_on_attempts": 0,
    "power_off_graceful_attempts": 0,
    "power_off_forceful_attempts": 0
  },
  "status": {
    "phase": "string",
    "status": "string",
    "status_override": "string"
  },
  "enabled": true,
  "error": "string",
  "session": "session-20190728032600",
  "retry_policy": 1
}

The current and desired artifacts state for a Component, and the Session responsible for the Component’s current state.

Properties

Name Type Required Restrictions Description
id V2ComponentId false none The Component’s ID. (e.g. xname for hardware Components)

It is recommended that this should be 1-127 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
actual_state V2ComponentActualState false none The actual boot artifacts and configuration for a Component
desired_state V2ComponentDesiredState false none The desired boot artifacts and configuration for a Component
staged_state V2ComponentStagedState false none The staged boot artifacts and configuration for a Component. Optionally, a Session
may be set which can be triggered at a later time against this Component.
last_action V2ComponentLastAction false none Information on the most recent action taken against the node.
event_stats V2ComponentEventStats false none Information on the most recent attempt to return the node to its desired state.
status V2ComponentStatus false none Status information for the Component
enabled boolean false none A flag indicating if actions should be taken for this Component.
error string false none A description of the most recent error to impact the Component.
session any false none none

oneOf

Name Type Required Restrictions Description
» anonymous V2SessionName false none Name of the Session.

xor

Name Type Required Restrictions Description
» anonymous EmptyString false none An empty string value.

continued

Name Type Required Restrictions Description
retry_policy integer false none The maximum number attempts per action when actions fail.
Defaults to the global default_retry_policy if not set

V2ComponentArray

[
  {
    "id": "string",
    "actual_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "desired_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "staged_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "session": "session-20190728032600",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "last_action": {
      "last_updated": "2019-07-28T03:26:00Z",
      "action": "string",
      "failed": true
    },
    "event_stats": {
      "power_on_attempts": 0,
      "power_off_graceful_attempts": 0,
      "power_off_forceful_attempts": 0
    },
    "status": {
      "phase": "string",
      "status": "string",
      "status_override": "string"
    },
    "enabled": true,
    "error": "string",
    "session": "session-20190728032600",
    "retry_policy": 1
  }
]

An array of Component states.

Properties

Name Type Required Restrictions Description
anonymous [V2Component] false none An array of Component states.

V2ComponentsFilterByIds

{
  "ids": "string",
  "session": ""
}

Information for patching multiple Components by listing their IDs.

Properties

Name Type Required Restrictions Description
ids string true none A comma-separated list of Component IDs.

It is recommended that this should be 1-65535 characters in length.

This restriction is not enforced in this version of BOS, but it is
targeted to start being enforced in an upcoming BOS version.
session EmptyStringNullable false none An empty string value.

V2ComponentsFilterBySession

{
  "ids": "",
  "session": "session-20190728032600"
}

Information for patching multiple Components by Session name. All Components part of this Session will be patched.

Properties

Name Type Required Restrictions Description
ids EmptyStringNullable false none An empty string value.
session V2SessionName true none Name of the Session.

V2ComponentsUpdate

{
  "patch": {
    "id": "string",
    "actual_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "desired_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "bss_token": "string",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "staged_state": {
      "boot_artifacts": {
        "kernel": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/kernel",
        "kernel_parameters": "console=ttyS0,115200 bad_page=panic crashkernel=340M hugepagelist=2m-2g intel_iommu=off intel_pstate=disable iommu=pt ip=dhcp numa_interleave_omit=headless numa_zonelist_order=node oops=panic pageblock_order=14 pcie_ports=native printk.synchronous=y rd.neednet=1 rd.retry=10 rd.shell turbo_boost_limit=999 spire_join_token=${SPIRE_JOIN_TOKEN}",
        "initrd": "s3://boot-images/9e3c75e1-ac42-42c7-873c-e758048897d6/initrd"
      },
      "configuration": "compute-23.4.0",
      "session": "session-20190728032600",
      "last_updated": "2019-07-28T03:26:00Z"
    },
    "last_action": {
      "last_updated": "2019-07-28T03:26:00Z",
      "action": "string",
      "failed": true
    },
    "event_stats": {
      "power_on_attempts": 0,
      "power_off_graceful_attempts": 0,
      "power_off_forceful_attempts": 0
    },
    "status": {
      "phase": "string",
      "status": "string",
      "status_override": "string"
    },
    "enabled": true,
    "error": "string",
    "session": "session-20190728032600",
    "retry_policy": 1
  },
  "filters": {
    "ids": "string",
    "session": ""
  }
}

Information for patching multiple Components.

Properties

Name Type Required Restrictions Description
patch V2Component true none The current and desired artifacts state for a Component, and
the Session responsible for the Component’s current state.
filters any true none none

oneOf

Name Type Required Restrictions Description
» anonymous V2ComponentsFilterByIds false none Information for patching multiple Components by listing their IDs.

xor

Name Type Required Restrictions Description
» anonymous V2ComponentsFilterBySession false none Information for patching multiple Components by Session name.
All Components part of this Session will be patched.

V2ApplyStagedComponents

{
  "xnames": [
    "string"
  ]
}

A list of Components that should have their staged Session applied.

Properties

Name Type Required Restrictions Description
xnames V2ComponentIdList false none A list of Component IDs (xnames)

V2ApplyStagedStatus

{
  "succeeded": [
    "string"
  ],
  "failed": [
    "string"
  ],
  "ignored": [
    "string"
  ]
}

Mapping from Component staged Session statuses to Components with that status.

Properties

Name Type Required Restrictions Description
succeeded V2ComponentIdList false none A list of Component IDs (xnames)
failed V2ComponentIdList false none A list of Component IDs (xnames)
ignored V2ComponentIdList false none A list of Component IDs (xnames)

V2Options

{
  "cleanup_completed_session_ttl": "3d",
  "clear_stage": true,
  "component_actual_state_ttl": "6h",
  "disable_components_on_completion": true,
  "discovery_frequency": 33554432,
  "logging_level": "string",
  "max_boot_wait_time": 1048576,
  "max_power_on_wait_time": 1048576,
  "max_power_off_wait_time": 1048576,
  "polling_frequency": 1048576,
  "default_retry_policy": 1
}

Options for the Boot Orchestration Service.

Properties

Name Type Required Restrictions Description
cleanup_completed_session_ttl string false none Delete complete Sessions that are older than cleanup_completed_session_ttl (in minutes, hours, days, or weeks).
0 disables cleanup behavior.
clear_stage boolean false none Allows a Component’s staged information to be cleared when the requested staging action has been started. Defaults to false.
component_actual_state_ttl string false none The maximum amount of time a Component’s actual state is considered valid (in minutes, hours, days, or weeks).
0 disables cleanup behavior for newly booted nodes and instructs bos-state-reporter to report once instead of periodically.
disable_components_on_completion boolean false none If true, when a Session has brought a Component to its desired state, that Component will be marked as disabled in BOS.
If false, BOS will continue to maintain the state of the nodes declaratively, even after a Session finishes.
discovery_frequency integer false none How frequently the BOS discovery agent syncs new Components from HSM. (in seconds)
logging_level string false none The logging level for all BOS services
max_boot_wait_time integer false none How long BOS will wait for a node to boot into a usable state before rebooting it again (in seconds)
max_power_on_wait_time integer false none How long BOS will wait for a node to power on before calling power on again (in seconds)
max_power_off_wait_time integer false none How long BOS will wait for a node to power off before forcefully powering off (in seconds)
polling_frequency integer false none How frequently the BOS operators check Component state for needed actions. (in seconds)
default_retry_policy integer false none The default maximum number attempts per node for failed actions.