Help Center/ ServiceStage/ API Reference/ Application Management V3 APIs/ Lane/ Obtaining All Lanes in a Lane Group
Updated on 2024-10-16 GMT+08:00

Obtaining All Lanes in a Lane Group

Function

This API is used to obtain all lanes in a lane group.

URI

GET /v3/{project_id}/cas/swimlane-group/{lane_group_id}/swimlane

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant's project ID. See Obtaining a Project ID.

lane_group_id

Yes

String

Lane group ID. See Obtaining All Lane Groups.

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type (format). Default value: application/json;charset=utf8.

X-Auth-Token

Yes

String

API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain a token, see Obtaining a User Token.

Response

Table 3 Response parameters

Parameter

Type

Description

swimlanes

Array of objects

List of lanes. See Table 4.

count

Integer

Number of lane lists.

Table 4 swimlanes

Parameter

Type

Description

id

String

Lane ID.

name

String

Lane name.

swimlane_group_id

String

Lane group ID.

type

String

Lane type.

  • BASE: baseline lane.
  • GRAY: dark launch lane.

tag

String

Lane tag, which is used to control traffic routing.

route_status

String

Route status.

  • ENABLE
  • DISABLED

rule_match_mode

String

Mode of matching routing rules.

This parameter is valid when gray_release_type is set to CONTENT.

  • ALL: matches all rules.
  • ANY: matches any rule.

rules

Array of objects

Routing rules. This parameter is valid when gray_release_type is set to CONTENT. See Table 5.

weight

Integer

Lane traffic weight. Value range: 0–100.

This parameter is valid when gray_release_type is set to WEIGHT.

project_id

String

Project ID.

create_time

Integer

Creation time.

update_time

Integer

Update time.

creator

String

Creator.

Table 5 rules

Parameter

Type

Description

type

String

Type of dark launch matching rule. Currently, only HEADER is supported, that is, matching by header.

key

String

Key.

value

String

Value.

condition

String

Match condition.

  • EXACT
  • PREFIX
  • REGEX

Example Request

None

Example Response

{
	"swimlanes" : [
		{
			"id" : "9974a8b3-cbd7-4084-bac9-194f7d5ba3da",
			"name" : "gray",
			"swimlane_group_id" : "b76dad96-66cf-4ae7-aa55-11b6d630e777",
			"type" : "GRAY",
			"tag" : "gray",
			"weight" : 0,
			"route_status" : "DISABLED",
			"rule_match_mode" : null,
			"project_id" : "4008a952b3f44b5a919c9a48d90811f3",
			"rules" : null,
			"creator" : "test_user",
			"create_time" : 1722928561358,
			"update_time" : 1722928561358
		}
	],
	"count" : 1
}

Status Code

Status Code

Description

200

OK

400

Bad Request

404

Not Found

500

Internal Server Error

Error Code

The error code format is SVCSTG.00100.[Error_ID], for example, SVCSTG.00100400. For details, see ServiceStage Error Codes.