Updated on 2024-06-14 GMT+08:00

Creating an Application

Function

An application is a service system with complete functions and consists of one or more components related to features.

This API is used to create an application.

URI

POST /v2/{project_id}/cas/applications

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

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

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Message body type or format.

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.

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

name

Yes

String

Application name.

The value contains 2 to 64 characters consisting of letters, digits, hyphens (-), and underscores (_). It starts with a letter and ends with a letter or digit.

description

No

String

Application description.

The value can contain up to 128 characters.

enterprise_project_id

No

String

Enterprise project ID.

Response

Table 4 Response parameters

Parameter

Type

Description

id

String

Application ID.

name

String

Application name.

description

String

Application description.

creator

String

Creator.

project_id

String

Project ID.

enterprise_project_id

String

Enterprise project ID.

create_time

Integer

Creation time.

update_time

Integer

Update time.

unified_model

String

Whether to enable the unified model. Default value: null.

Example Request

Create application app-xpmtii and add application description test.

{
	"name": "app-xpmtii",
	"description": "test"
}

Example Response

{
	"id": "e5213b62-0e3c-476f-9960-3e4108787350",
	"name": "app-xpmtii",
	"description": "test",
	"project_id": "e7d2e9c589e5445e808a8ff0d1235aca",
	"enterprise_project_id": "0",
	"creator": "ss-test",
	"create_time": 1610432385245,
	"update_time": 1610432385245,
	"unified_model": null
}

Status Code

Table 5 Status codes

HTTP 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.