Help Center> Distributed Cache Service> API Reference> Other APIs> Querying the Free Trial Permissions of a Tenant (Unavailable Soon)
View PDF

Querying the Free Trial Permissions of a Tenant (Unavailable Soon)

Function

This API is used to query the free trials that a tenant can participate in.

This API is supported only in CN North-Beijing1, CN East-Shanghai2, and CN South-Guangzhou regions.

URI

GET /v1.0/{domain_id}/trials

Table 1 describes the parameter.
Table 1 Parameter description

Parameter

Type

Mandatory

Description

domain_id

String

Yes

Tenant ID.

Request

Request parameters

None

Example request

None

Response

Response parameters

Table 2 describes the response parameter.
Table 2 Parameter description

Parameter

Type

Description

domain_id

String

Tenant ID.

domain_name

String

Tenant name.

free_trials

JSON

Information about the free trial.

one_yuan_trials

JSON

Information about ¥1 trial.
Table 3 Parameter description of the free_trials and one_yuan_trials JSON strings

Parameter

Type

Description

engine

String

Engine type.

Options: Redis and Memcached.

version

String

Engine version.

support

Boolean

An indicator of whether a tenant is eligible for a trial.

cause_id

String

ID of a cause for which a tenant is ineligible for a trial.

message

String

Additional information.
Table 4 Value description of the cause_id parameter

cause_id

Description

111400129

No free trials are available.

111400125

The free trial quota has been reached, or the tenant is ineligible for the free trial currently.

Example response

{
	"domain_id": "xx",
	"domain_name": "xx",
	"free_trials": [{
		"engine": "redis",
		"support": true,
		"cause_id": "xxx",
		"message": "xx"
	}]
}

Status Code

Table 5 describes the status code of successful operations. For details about other status codes, see Table 1.

Table 5 Status code

Status Code

Description

200

Free trial permission of the tenant queried successfully.
Parent topic: Other APIs