Help Center/ CodeArts Build/ API Reference/ APIs/ Build Task Management/ Querying the Status of Other Tenants in Cross-Tenant Scenarios
Updated on 2025-08-21 GMT+08:00

Querying the Status of Other Tenants in Cross-Tenant Scenarios

Function

This API is used to query the status of other tenants in cross-tenant scenarios.

Calling Method

For details, see Calling APIs.

URI

POST /v1/domain/domains-statuses

Request Parameters

Table 1 Request body parameters

Parameter

Mandatory

Type

Description

domain_ids

No

String

Definition

A collection of tenant IDs.

Constraints

N/A.

Range

N/A.

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

result

Array of DomainStatuses objects

Result.

error

String

Returned error message.

status

String

Returned status information.

Table 3 DomainStatuses

Parameter

Type

Description

service_name

String

Definition

Service name.

Constraints

N/A.

Range

Default value: CodeCI

domain_id

String

Definition

Tenant ID.

Constraints

N/A.

Range

N/A.

domain_name

String

Definition

Tenant name.

Constraints

N/A.

Range

N/A.

free_quota

Boolean

Definition

freeQuota.

Constraints

N/A.

Range

true or false

free_package_quota

Boolean

Definition

freePackageQuota.

Constraints

N/A.

Range

true or false

status

Integer

Definition

Status.

Constraints

N/A.

Range

N/A.

is_federation

Integer

Definition

isFederation.

Constraints

N/A.

Range

N/A.

is_whitelist

Integer

Definition

Whitelisted or not.

Constraints

N/A.

Range

N/A.

region

String

Definition

Region.

Constraints

N/A.

Range

N/A.

package_type

String

Definition

Package type.

Constraints

N/A.

Range

N/A.

domain_type

Integer

Definition

Tenant type.

Constraints

N/A.

Range

N/A.

domain_business_type

String

Definition

Tenant service type.

Constraints

N/A.

Range

N/A.

domain_malicious_docker_args

String

Definition

domainMaliciousDockerArgs.

Constraints

N/A.

Range

N/A.

allow_custom_env

Integer

Definition

Allowed number of custom environments.

Constraints

N/A.

Range

N/A.

spec_threshold

String

Definition

Default acceleration threshold injection.

Constraints

N/A.

Range

N/A.

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 401

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 403

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 404

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 500

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

POST https://{endpoint}/v1/domain/domains-statuses

Example Responses

Status code: 200

OK

{
  "result" : [ {
    "service_name" : "CodeCI",
    "domain_id" : "82a38fff58f84bb4a39566235f2c14a3",
    "domain_name" : "devcloud_codeci_02",
    "free_quota" : true,
    "free_package_quota" : false,
    "status" : 1,
    "is_federation" : 0,
    "is_whitelist" : 0,
    "region" : "{region}-7",
    "package_type" : "CODEARTS_FREE",
    "domain_type" : 1,
    "domain_business_type" : "NORMAL",
    "domain_malicious_docker_args" : null,
    "allow_custom_env" : 1,
    "spec_threshold" : "[{\"spec\":\"cbhost-X86-16U64G\",\"threshold\":1000}, {\"spec\":\"cbhost-ARM-16U64G\"}]"
  }, {
    "service_name" : "CodeCI",
    "domain_id" : "60021bab32fd450aa2cb89226f425e06",
    "domain_name" : "devcloud_codeci_01",
    "free_quota" : false,
    "free_package_quota" : false,
    "status" : 1,
    "is_federation" : 1,
    "is_whitelist" : 0,
    "region" : "{region}-7",
    "package_type" : "CODEARTS_BASIC",
    "domain_type" : 1,
    "domain_business_type" : "NORMAL",
    "domain_malicious_docker_args" : null,
    "allow_custom_env" : 1,
    "spec_threshold" : "[{\"spec\":\"cbhost-X86-16U64G\",\"threshold\":1000}, {\"spec\":\"cbhost-ARM-16U64G\"}]"
  } ],
  "error" : null,
  "status" : "success"
}

Status Codes

Status Code

Description

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

Error Codes

See Error Codes.