All Products
Search

This Product

    Cloud Phone:DescribeSpec

    Document Center

    Cloud Phone:DescribeSpec

    Last Updated:Dec 12, 2025

    Queries the available specifications for cloud phones. You can call this operation to retrieve all specification information, which is required to create an instance. For matrix creation, this operation also returns the maximum and minimum instance count for a single matrix.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request parameters

    Parameter

    Type

    Required

    Description

    Example

    BizRegionId

    string

    No

    The region ID.

    cn-hangzhou

    SpecIds

    array

    No

    A list of specification IDs.

    string

    No

    The specification ID.

    Valid values:

    • acp.perf.large :

      Compute-optimized

    • acp.basic.small :

      Lightweight

    • acp.std.small :

      General-purpose

    • acp.std.large :

      Standard

    • acp.perf.small :

      Enhanced

    acp.basic.small

    SpecType

    string

    No

    The specification type.

    Valid values:

    • CPU :

      CPU specifications

    • GPU :

      GPU specifications

    CPU

    SpecStatus

    string

    No

    The status of the specification.

    Valid values:

    • Unsupported :

      The specification is not supported.

    • Available :

      The specification is available.

    Available

    SaleMode

    string

    No

    The purchase mode of the cloud phones.

    Valid values:

    • Instance :

      Instance group mode (default)

    • Node :

      Cloud phone matrix mode (whitelist feature)

    Instance

    MaxResults

    integer

    No

    The maximum number of entries to return on each page. Valid values: 1 to 100. Default value: 100.

    20

    NextToken

    string

    No

    The token that specifies the position from which to start the query. Leave this parameter empty to start the query from the beginning.

    AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uONHqPtDLM2U8s****

    MatrixSpec

    string

    No

    The cloud phone matrix specification.

    Valid values:

    • cpm.gn6.gx1 :

      cpm.gn6.gx1

    cpm.gx7.10xlarge

    Response elements

    Element

    Type

    Description

    Example

    object

    The response parameters.

    RequestId

    string

    The request ID.

    D9888DAD-331E-5FBC-B5A0-F2445115****

    TotalCount

    integer

    The total number of entries.

    4

    NextToken

    string

    The token to use for the next request to retrieve a new page of results. If this parameter is empty, all results have been returned.

    AAAAAV3MpHK1AP0pfERHZN5pu6kw9dGL5jves2FS9RLq****

    SpecInfoModel

    array<object>

    The specification information.

    object

    SpecId

    string

    The specification ID.

    acp.basic.small

    Core

    integer

    The number of CPU cores.

    8

    Memory

    integer

    The memory size. Unit: GB.

    16

    SystemDiskSize

    integer

    The size of the system disk. Unit: GB.

    32

    SpecType

    string

    The specification type.

    ARM

    SpecStatus

    string

    The status of the specification.

    Available

    PhoneCount

    string

    The number of cloud phone instances.

    2

    Resolution

    string

    The resolution of the cloud phone instance.

    1920*1080

    MaxPhoneCount

    string

    The maximum number of instances.

    40

    MinPhoneCount

    string

    The minimum number of instances.

    4

    Examples

    Success response

    JSON format

    {
  "RequestId": "D9888DAD-331E-5FBC-B5A0-F2445115****",
  "TotalCount": 4,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kw9dGL5jves2FS9RLq****",
  "SpecInfoModel": [
    {
      "SpecId": "acp.basic.small",
      "Core": 8,
      "Memory": 16,
      "SystemDiskSize": 32,
      "SpecType": "ARM",
      "SpecStatus": "Available",
      "PhoneCount": "2",
      "Resolution": "1920*1080",
      "MaxPhoneCount": "40",
      "MinPhoneCount": "4"
    }
  ]
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.