All Products
Search

This Product

    Cloud Phone:DescribeSpec

    Document Center

    Cloud Phone:DescribeSpec

    Last Updated:May 09, 2026

    Queries the available specifications for cloud phones. This information is required to create an instance. For the cloud phone matrix mode, this operation also returns the minimum and maximum number of instances allowed per 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 specification status.

    Valid values:

    • Unsupported :

      Unsupported

    • Available :

      Available

    Available
    SaleMode

    string

    No

    The purchase mode of the cloud phone.

    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 per page. Valid values: 1 to 100. Default value: 100.

    20
    NextToken

    string

    No

    The position from which to start the query. Leave this parameter empty to 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 in GB.

    16
    SystemDiskSize

    integer

    The size of the system disk, in GB.

    32
    SpecType

    string

    The specification type.

    ARM
    SpecStatus

    string

    The specification status.

    Available
    PhoneCount

    string

    The number of 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.