Todos los productos
Search
Centro de documentos

Cloud Phone:CreateAndroidInstanceGroup

Última actualización: Oct 23, 2026

Crea un grupo de instancias de cloud phone de pago por uso o de suscripción. Un grupo de instancias puede administrar varias instancias. Las instancias con las mismas funciones se pueden agrupar en el mismo grupo de instancias para una administración unificada.

Descripción de la operación

Al crear un grupo de instancias de cloud phone, tenga en cuenta que esto implica la facturación de recursos. Se recomienda conocer previamente los métodos de facturación de los grupos de instancias de cloud phone.

  • Si el método de facturación del grupo de instancias es de suscripción (PrePaid), el valor predeterminado de AutoPay (pago automático) es false. Después de invocar la operación de API, debe ir a Gastos y costos para pagar manualmente el pedido.

  • Si desea habilitar el pago automático, cambie la configuración de AutoPay a true.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

BizRegionId

string

Sí

El ID de la región. Puede llamar a la operación DescribeRegions para consultar la lista de regiones donde los cloud phones están disponibles.

Valores válidos:

  • cn-shenzhen :

    Shenzhen.

  • cn-beijing :

    Beijing.

  • cn-shanghai :

    Shanghai.

  • cn-hongkong :

    China (Hong Kong)

  • ap-southeast-1 :

    Singapur.

  • cn-hangzhou :

    Hangzhou.

cn-hangzhou

InstanceGroupName

string

No

El nombre del grupo de instancias.

Nota

El nombre puede tener hasta 30 caracteres de longitud. Debe comenzar con una letra o un carácter chino, y no puede comenzar con http:// o https://. Solo puede contener caracteres chinos, letras, dígitos, dos puntos (:), guiones bajos (_), puntos (.) y guiones (-).

Cloud Phone A

NumberOfInstances

integer

No

El número de instancias en el grupo de instancias. Valor máximo: 100.

1

ChargeType

string

No

El método de facturación.

Valores válidos:

  • PostPaid :

    Pago por uso.

  • PrePaid :

    Suscripción.

PostPaid

Period

integer

No

La duración de la suscripción del recurso. La unidad se especifica mediante PeriodUnit.

1

PeriodUnit

string

No

La unidad de la duración de la suscripción.

Valores válidos:

  • Month :

    Mes.

  • Year :

    Año.

  • Hour :

    Hora. Válido solo para el método de facturación de pago por uso.

Month

InstanceGroupSpec

string

Sí

Las especificaciones del grupo de instancias. Puede llamar a la operación DescribeSpec para consultar las especificaciones disponibles para los cloud phones.

Valores válidos:

  • acp.perf.large :

    Rendimiento (8 vCPU, 16 GiB de memoria, 32 GiB de almacenamiento)

  • acp.basic.small :

    Ligero (2 vCPU, 4 GiB de memoria, 32 GiB de almacenamiento)

  • acp.std.large :

    Estándar (4 vCPU, 8 GiB de memoria, 32 GiB de almacenamiento)

acp.basic.small

AutoPay

boolean

No

Especifica si se debe habilitar el pago automático. Valor predeterminado: false.

Valores válidos:

  • true :

    Pago automático. Asegúrese de que su cuenta tenga saldo suficiente.

  • false :

    Pago manual.

false

AutoRenew

boolean

No

Especifica si se debe habilitar la renovación automática. Valor predeterminado: false.

Valores válidos:

  • true :

    Habilita la renovación automática después de que expire el recurso pagado por adelantado.

  • false :

    Se requiere renovación manual después de que expire el recurso de suscripción.

false

OfficeSiteId

string

No

El ID de la red.

  • Para crear una instancia de red compartida: El ID de red es opcional. Ingrese el ID de red del tipo Red compartida en la página Consola de Cloud Phone > Red. Si no hay ninguna red compartida disponible en la consola, puede dejar este parámetro vacío, y se activará la creación automática de una red compartida cuando se cree el grupo de instancias.

  • Para crear una instancia de red VPC: El ID de red es obligatorio. Ingrese el ID de red del tipo Red VPC en la página Consola de Cloud Phone > Red. Si no hay ninguna red VPC disponible en la consola, primero debe crear una red.

cn-hangzhou+dir-745976****

VSwitchId

string

No

El ID del vSwitch. Puede llamar a la operación DescribeVSwitches para consultar la lista de vSwitch.

  • Para crear una instancia de red compartida: Deje este parámetro vacío.

  • Para crear una instancia de red VPC: El ID del vSwitch es obligatorio. Este vSwitch se utiliza para crear la instancia.

vsw-uf61uvzhz8ejaw776****

PolicyGroupId

string

No

El ID de la política. Puede llamar a la operación ListPolicyGroups para consultar la lista de políticas.

pg-b7bxrrwxkijjh****

ImageId

string

Sí

El ID de la imagen. Puede llamar a la operación DescribeImageList para consultar la lista de imágenes para cloud phones.

imgc-06zyt9m93zwax****

Amount

integer

No

El número de grupos de instancias. Valor predeterminado: 1. Valor máximo: 100.

8

GpuAcceleration

boolean

No

Especifica si se debe habilitar la aceleración por GPU.

Valores válidos:

  • true :

    Habilitado.

  • false :

    Deshabilitado [Valor predeterminado]

false

KeyPairId

string

No

El ID del par de claves. Al crear un grupo de instancias, si especifica un ID de par de claves válido, el par de claves se vincula a todas las instancias creadas correctamente, y no es necesario volver a llamar a la operación de API de vinculación.

Nota

No se admite la vinculación de pares de claves durante el escalado horizontal.

kp-7o9xywwfutc1l****

ClientToken

string

No

El token de cliente que se utiliza para garantizar la idempotencia de la solicitud y evitar solicitudes duplicadas. El token puede tener hasta 100 caracteres de longitud.

asadbuvwiabdbvchj****

EnableIpv6

boolean

No

Nota

Este parámetro no está disponible para el público.

null

Ipv6Bandwidth

integer

No

Nota

Este parámetro no está disponible para el público.

null

Tag

array<object>

No

Las etiquetas del recurso.

object

No

Las etiquetas del recurso.

Value

string

No

El valor de la etiqueta.

value

Key

string

No

La clave de la etiqueta.

key

NetworkInfo

object

No

Las configuraciones de red y del plan de ancho de banda del grupo de instancias.

BandwidthPackageName

string

No

El nombre del plan de ancho de banda.

inst-bandwidth-pkg-1

CidrBlock

string

No

El bloque CIDR privado.

10.10.13.0/24

LimitedBandwidth

integer

No

El límite de ancho de banda máximo del plan de ancho de banda, en Mbit/s. El ancho de banda total de todas las instancias que utilizan este plan de ancho de banda está sujeto a este límite.

200

InternetChargeType

string

No

Los métodos de facturación del plan de ancho de banda. Valores válidos:

- **PayByBandwidth** (predeterminado): pago por ancho de banda.

PayByBandwidth

IpRatio

integer

No

La proporción de direcciones IP respecto a las instancias.

128

Isp

string

No

El tipo de línea.

ChinaTelecom

PayType

string

No

El método de facturación.

PostPaid

Period

integer

No

La duración de la suscripción del recurso. La unidad se especifica mediante PeriodUnit.

1

PeriodUnit

string

No

La unidad de la duración de la suscripción.

Month

AutoPay

boolean

No

Especifica si se debe habilitar el pago automático. Valor predeterminado: false.

AutoRenew

boolean

No

Especifica si se debe habilitar la renovación automática. Valor predeterminado: false.

VisibleType

string

No

El ámbito de visibilidad.

CPS

PromotionId

string

No

El ID de la actividad promocional.

50003308011****

PaidCallbackUrl

string

No

La URL de redireccionamiento para la página de pago exitoso.

https://aim.console.alibabacloud.com/nodes

BandwidthPackageType

string

No

El tipo de ancho de banda.

cbwp_ecd

BandwidthPackageId

string

No

El ID del plan de ancho de banda.

np-791ncq8qcuoop9hta

NetworkType

string

No

El tipo de red de la instancia.

network_pro_ecd

PromotionId

string

No

El ID de la actividad promocional.

50003308011****

StreamMode

integer

No

El modo de transmisión de las instancias en el grupo de instancias. Si no se especifica este parámetro, el modo predeterminado es el modo preemptivo.

1

PaidCallBackUrl

string

No

La URL de redireccionamiento para la página de pago exitoso.

acp.console.alibabacloud.com/instanceGroup

SaleMode

string

No

El modo de venta.

Instance

InstanceVersion

string

No

La versión de la instancia. Un valor de basic indica una instancia de cloud phone Wuying, y un valor de EnterpriseAi indica una instancia de JVS Mobile.

EnterpriseAi

ChannelCookie

string

No

La cookie del canal, que se transmite al sistema de ventas cuando se realiza un pedido.

channel-cookie-ig

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Los elementos de la respuesta.

RequestId

string

El ID de la solicitud.

1A923337-44D9-5CAD-9A53-95084BD4****

InstanceGroupInfos

array<object>

La información del grupo de instancias.

object

InstanceGroupId

string

El ID del grupo de instancias.

ag-cuv4scs4obxch****

InstanceIds

array

La lista de ID de instancias.

string

El ID de la instancia.

acp-g40b9at5nhjo9****

OrderId

string

El ID del pedido.

22365781890****

InstanceGroupIds

array

La lista de ID de grupos de instancias.

string

El ID del grupo de instancias.

ag-cuv4scs4obxch****

NetworkPackageOrderModel

object

La información del pedido del plan de ancho de banda.

BandwidthPackageOrderId

string

El ID del pedido del plan de ancho de banda.

25954415983*****

BandwidthPackageId

string

El ID de Internet Shared Bandwidth.

cbwp-uf63gsv8j0ir53*****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "InstanceGroupInfos": [
    {
      "InstanceGroupId": "ag-cuv4scs4obxch****",
      "InstanceIds": [
        "acp-g40b9at5nhjo9****"
      ]
    }
  ],
  "OrderId": "22365781890****",
  "InstanceGroupIds": [
    "ag-cuv4scs4obxch****"
  ],
  "NetworkPackageOrderModel": {
    "BandwidthPackageOrderId": "25954415983*****",
    "BandwidthPackageId": "cbwp-uf63gsv8j0ir53*****"
  }
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.