Querying Sales Status of Cloud Phone Server Flavors

Function

This API is used to query accessible AZs and sales status of cloud phone server flavors in the AZs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

GET /v1/{project_id}/server-model-offerings

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Specifies the project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
marker	No	String	Specifies the pagination marker. The query starts from the next data record specified by marker.
limit	No	Integer	Specifies the maximum number of returned records. The value ranges from 1 to 1000, and the default value is 100.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
request_id	String	Specifies the unique ID of a request.
count	Integer	Specifies the total number of flavors.
models	Array of models objects	Specifies the cloud phone server flavor details.
page_info	page_info object	Specifies the page marker.

**Table 5** models
Parameter	Type	Description
available_zone	String	Specifies the AZ.
model_name	String	Specifies the cloud phone server flavor name.
sell_status	String	Specifies the sales status of a cloud phone server flavor. sellout (sold out) available

**Table 6** page_info
Parameter	Type	Description
next_marker	String	Specifies the marker for next page query.

Example Requests

Querying accessible AZs and sales status of cloud phone server flavors in the AZs

GET https://{CPH Endpoint}/v1/{project_id}/server-model-offerings

Example Responses

Status code: 200

{
  "request_id" : "5aac6ab146ba76e5b12a3d00a03a9869",
  "models" : [ {
    "available_zone" : "cn-east-3a",
    "model_name" : "physical.rx1.xlarge.cg",
    "sell_status" : "available"
  } ],
  "page_info" : {
    "next_marker" : "cGh5c2ljYWwua2cxLjR4bGFyZ2UuY3AuZGVkaWNhdGVkI2NuLXNvdXRod2VzdC0yNDJi"
  }
}