Help Center/ CodeArts Pipeline/ API Reference/ API/ Pipeline Management/ Querying the Expiration Information of the New Extended Package of the Current Tenant
Updated on 2025-12-04 GMT+08:00

Querying the Expiration Information of the New Extended Package of the Current Tenant

Function

This API is used to query the expiration information of the new extended package of the current tenant based on the tenant ID.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{tenant_id}/api/package-specs/count-down

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

tenant_id

Yes

String

Definition:

Tenant ID, that is, domain ID of a user.

Constraints:

N/A

Value range:

The value consists of 32 characters, including only digits and letters.

Default value:

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

project_id

No

String

Definition:

32-character UUID of a CodeArts project, which must be unique.

Constraints:

N/A

Value range:

The value contains 32 characters.

Default value:

N/A

is_main

No

String

Definition:

Whether to query the primary resources.

Constraints:

N/A

Value range:

  • true: Query the primary resources.

  • false: The primary resources are not queried.

Default value:

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

[items]

Array of SpecsCountDownInfo objects

Definition:

Expiration details of a tenant package and resource package.

Value range:

N/A

Table 4 SpecsCountDownInfo

Parameter

Type

Description

resource_id

String

Definition:

Resource ID.

Value range:

N/A

resource_name

String

Definition:

Resource name.

Value range:

N/A

service_type

String

Definition:

Service type.

Value range:

N/A

resource_type

String

Definition:

Resource type.

Value range:

N/A

resource_spec_code

String

Definition:

Package specification code.

Value range:

N/A

tips

tips object

Definition:

Expiration information.

Value range:

N/A

Table 5 tips

Parameter

Type

Description

status

Integer

Definition:

Current status of resources.

Range:

  • 1: not effective (The resource is being enabled and has not been used.)

  • 2: taking effect (The resource has not expired and can be used normally.)

  • 3: deleted (The resource has been deleted.)

  • 4: in the retention period (Yearly/monthly resources enter the retention period and is frozen and cannot be used.)

  • 5: in the grace period (Yearly/monthly resources have expired and enter the grace period. The resources can still be used.)

  • 99: frozen (violation): frozen due to violation against regulations, or public security reasons.

next_action

Integer

Definition:

Processing policy of the next operation.

Value range:

N/A

next_action_remain_day

Integer

Definition:

Remaining days from the current status to the next operation.

Value range:

N/A

next_action_url

String

Definition:

Renewal link.

Value range:

N/A

Example Requests

GET https://{endpoint}/v5/{tenant_id}/api/package-specs/count-down?project_id=4fca5a98a2814d3e982ca09bd8b43180&is_main=true&_=1763887110995

Example Responses

Status code: 200

OK

[ {
  "resource_id" : "967f95a0d7124caeb9b8b93caaea9a4c",
  "resource_name" : "CodeArts Combo",
  "service_type" : "hws.service.type.devcloud",
  "resource_type" : "hws.resource.type.codearts.combo",
  "resource_spec_code" : "codearts.china.free",
  "tips" : null
} ]

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.