Updated on 2023-08-08 GMT+08:00

Obtaining All Specifications

Description

This API is used to obtain all specifications.

URI

GET /v1/{project_id}/node-provider/networks/{network_id}/flavor

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

Minimum length: 32 characters

Maximum length: 32 characters

network_id

Yes

String

Network ID.

Minimum length: 36 characters

Maximum length: 36 characters

Table 2 Query parameters

Parameter

Mandatory

Type

Description

node_type

No

String

Node type, which can be Full node (default) or Full node (Staking supported).

Minimum length: 0 characters

Maximum length: 36 characters

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

Minimum length: 1 character

Maximum length: 65,535 characters

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

flavors

Array of CreateNodeMachineFlavor objects

All specifications.

count

Integer

Number of records.

Minimum value: 0

Maximum value: 1000

Table 5 CreateNodeMachineFlavor

Parameter

Type

Description

cpu

Integer

Number of CPU cores.

Minimum value: 1

Maximum value: 1024

ram

Integer

Memory.

Minimum value: 1

Maximum value: 1,048,576

description

String

Description, which can be Test, Preferred, Stable, or Powerful.

Minimum length: 1 character

Maximum length: 50 characters

avail_node_mode

Array of strings

Availability mode of the node.

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

code

String

Status code.

Minimum length: 3 characters

Maximum length: 3 characters

error_code

String

Error code.

Minimum length: 12 characters

Maximum length: 12 characters

error_msg

String

Error message.

Minimum length: 1 character

Maximum length: 65,535 characters

message

String

Error details.

Minimum length: 0 characters

Maximum length: 65,535 characters

Status code: 401

Table 7 Response body parameters

Parameter

Type

Description

code

String

Status code.

Minimum length: 3 characters

Maximum length: 3 characters

error_code

String

Error code.

Minimum length: 12 characters

Maximum length: 12 characters

error_msg

String

Error message.

Minimum length: 1 character

Maximum length: 65,535 characters

message

String

Error details.

Minimum length: 0 characters

Maximum length: 65,535 characters

Status code: 500

Table 8 Response body parameters

Parameter

Type

Description

code

String

Status code.

Minimum length: 3 characters

Maximum length: 3 characters

error_code

String

Error code.

Minimum length: 12 characters

Maximum length: 12 characters

error_msg

String

Error message.

Minimum length: 1 character

Maximum length: 65,535 characters

message

String

Error details.

Minimum length: 0 characters

Maximum length: 65,535 characters

Example Request

None

Example Response

Status code: 200

Request successful.

{
  "flavors" : [ {
    "cpu" : 2,
    "ram" : 8192,
    "description" : "Preferred",
    "avail_node_mode" : [ "single", "HA" ]
  } ],
  "count" : 1
}

Status code: 400

Request failed.

{
  "code" : 400,
  "error_code" : "BCS.03400001",
  "error_msg" : "Invalid request.",
  "message" : "unmarshal request data error"
}

Status code: 401

Authentication failed.

{
  "code" : 401,
  "error_code" : "BCS.03401001",
  "error_msg" : "Authorization failed.",
  "message" : "request token is not valid"
}

Status code: 500

Internal service error.

{
  "code" : 500,
  "error_code" : "BCS.03500001",
  "error_msg" : "Internal error.",
  "message" : "project [xxx] node [xxx] get service bearer user token error"
}

Status Code

Status Code

Description

200

Request successful.

400

Request failed.

401

Authentication failed.

500

Internal service error.

Error Code

For details, see Error Codes.