CreateApplication - PolarDB - Centro de documentación de Alibaba Cloud

Crea una aplicación vinculada a una instancia de PolarDB.

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

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

polardb:CreateApplication

get

*All resources.

*

Ninguna

Sintaxis de la solicitud

POST  HTTP/1.1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Description	string	No	La descripción o comentario de la aplicación.	myapp
Parameters	array<object>	No	La lista de parámetros.
	object	No	La lista de parámetros.
ParameterName	string	No	El nombre del parámetro.	secret.gateway.auth.token
ParameterValue	string	No	El valor del parámetro.	TK***
AgenticDBBranchSpec	object	No	Las especificaciones de la rama de AgenticDB.	{"DBClusterId":"pagc-2zea920mcvd5o87","TenantId":"t-cfc2d7df0e59439681f0087f51","ProjectId":"proj-d7849d0050664c758af795d468","BranchId":"br-9054b3b7649e4c0d977bd0df37","ForkFromBranch":true,"ForkFromApplicationId":"pa-source"}
BranchId	string	No	El ID de la rama de AgenticDB.	br-9054b3b7649e4c0d977bd0df37
DBClusterId	string	No	El ID del clúster de AgenticDB.	pagc-2zea920mcvd5o87
ForkFromApplicationId	string	No	El ID de la aplicación de origen.	pa-source
ForkFromBranch	boolean	No	Especifica si se debe crear la aplicación a partir de una rama de AgenticDB especificada.	true
ProjectId	string	No	El ID del proyecto de AgenticDB.	proj-d7849d0050664c758af795d468
TenantId	string	No	El ID del inquilino de AgenticDB.	t-cfc2d7df0e59439681f0087f51
Storages	array<object>	No	La lista de recursos de almacenamiento para la aplicación.	[{"StorageType":"oss","StorageInstanceId":"pfs-xxxx","EndpointId":"pe-xxxx"}]
	object	No
ContainerMountPath	string	No	La ruta de montaje en el contenedor.	/data/container
EndpointId	string	No	El ID del endpoint de almacenamiento.	pe-xxxx
MountPath	string	No	La ruta de montaje del almacenamiento.	/data/source
StorageCapacity	string	No	La capacidad de almacenamiento.	100
StorageEndpoint	string	No	El endpoint de acceso del almacenamiento.	polarfs.example.com
StorageInstanceId	string	No	El ID de la instancia de almacenamiento.	pfs-xxxx
StoragePerformanceLevel	string	No	El nivel de rendimiento del almacenamiento.	PL1
StorageType	string	No	El tipo de almacenamiento.	oss
ApplicationType	string	Sí	El tipo de aplicación. Valores válidos: supabase: Especifique este valor para crear una aplicación Supabase administrada. raycluster: Especifique este valor para crear una aplicación Ray Cluster administrada. polarclaw: Especifique este valor para crear una aplicación PolarClaw administrada.	supabase
DBClusterId	string	No	El ID de la instancia de PolarDB de la que depende la aplicación.	pc-**************
RegionId	string	No	El ID de la región. Valor predeterminado: la región de la instancia.	cn-beijing
ZoneId	string	No	El ID de la zona. Valor predeterminado: la zona principal de la instancia.	cn-beijing-k
VSwitchId	string	No	El ID del vSwitch. Valor predeterminado: el vSwitch actual en la zona principal de la instancia.	vsw-*********************
Architecture	string	Sí	La arquitectura de CPU. Valores válidos: x86	x86
SecurityIPList	string	No	La lista blanca de direcciones IP. Si no especifica este parámetro, se utiliza el valor predeterminado `127.0.0.1`.	127.0.0.1,172.17.0.0/24
SecurityIPType	string	No	El tipo de dirección IP.	ipv4
SecurityIPArrayName	string	No	El nombre del grupo de lista blanca de direcciones IP. Valor predeterminado: `default`.	default
Endpoints	array<object>	No	La lista de endpoints de servicio personalizados. De forma predeterminada, se crea un endpoint de VPC.
	object	No	El endpoint de servicio.
Description	string	No	La descripción del endpoint de servicio.	my_endpoint
EndpointType	string	No	El tipo de endpoint de servicio. Establezca el valor en Primary.	Primary
Components	array<object>	No	La lista de subcomponentes de aplicación personalizados.
	object	No	El subcomponente de la aplicación.
ComponentClass	string	No	Las especificaciones del subcomponente de la aplicación.	polar.app.g2.medium
ComponentMaxReplica	integer	No	El número máximo de subcomponentes de la aplicación con las mismas especificaciones. Valor predeterminado: el valor de ComponentReplica. Este parámetro solo es compatible con raycluster.	1
ComponentReplica	integer	No	El número de réplicas para el subcomponente de la aplicación. Valor predeterminado: 1.	1
ComponentType	string	No	El tipo de subcomponente de la aplicación. Valores válidos para supabase: gateway backend Valores válidos para raycluster: head worker gpuworker	gateway
ScaleMax	string	No	El límite superior para el escalado de componentes.	16
ScaleMin	string	No	El límite inferior para el escalado de componentes.	1
SecurityGroups	string	No	La lista de grupos de seguridad para el subcomponente de la aplicación. Separe varios ID de grupos de seguridad con comas (,).	sg-********************
SecurityIPArrayName	string	No	El nombre del grupo de lista blanca de direcciones IP para el subcomponente de la aplicación. Valor predeterminado: default.	default
SecurityIPList	string	No	Las direcciones IP en la lista blanca para el subcomponente de la aplicación. Separe varias direcciones IP con comas (,).	127.0.0.1
SecurityIPType	string	No	El tipo de direcciones IP en la lista blanca para el subcomponente de la aplicación. Valor predeterminado: ipv4.	ipv4
PayType	string	No	El método de facturación.	Postpaid
AutoRenew	boolean	No	Especifica si se debe habilitar la renovación automática.	true
Period	string	No	La unidad del periodo de suscripción.	Year
UsedTime	string	No	La duración de la suscripción.	1
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-********************
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba. Valor predeterminado: `false`. Si establece este parámetro en `true`, el sistema solo comprueba los parámetros y los recursos sin crear realmente los recursos.	false
PolarFSInstanceId	string	No	El ID de la instancia de almacenamiento en frío o de alto rendimiento de Polarlakebase. Valor predeterminado: vacío. Si especifica este parámetro, el almacenamiento correspondiente se monta en la aplicación. Este parámetro solo es compatible con las siguientes aplicaciones: supabase raycluster	pcs-********************
VpcId	string	No	El ID de la nube privada virtual (VPC).	vpc-********************
AutoCreatePolarFs	boolean	No	Especifica si se debe crear automáticamente una instancia de almacenamiento en frío de Polarlakebase. Valores válidos: false: No crea la instancia automáticamente. Este es el valor predeterminado. true: Crea la instancia automáticamente.	false
AutoUseCoupon	boolean	No	Especifica si se deben usar cupones automáticamente. Valores válidos: true: Usa cupones. Este es el valor predeterminado. false: No usa cupones.	true
PromotionCode	string	No	El código de cupón. Si no especifica este parámetro, se utiliza el cupón predeterminado.	727xxxxxx934
SecurityGroupId	string	No	El ID del grupo de seguridad.	sg-********************
MemApplicationSpec	object	No	Requerido para las aplicaciones mem0.
DbName	string	No	El nombre de la base de datos.	test-database-name
DbPassword	string	No	La contraseña.	test-user-password
DbUser	string	No	El nombre de usuario.	test-user
EmbedderModel	string	No	Requerido para las aplicaciones mem0. El nombre del modelo de embeddings, como text-embedding-v4.	text-embedding-v4
EmbedderModelDimension	integer	No	Las dimensiones del vector.	1024
GraphLlmModel	string	No	El modelo LLM de grafos.	qwen-plus
LlmModel	string	No	Requerido para las aplicaciones mem0. El nombre del modelo LLM, como qwen3-max.	qwen3-max
ProjectName	string	No	El nombre del proyecto, que corresponde al esquema de base de datos que almacena los datos del proyecto.	test-project-name
RerankerModel	string	No	Requerido para las aplicaciones mem0. El nombre del modelo de reclasificación, como qwen3-rerank.	qwen3-rerank
Shard	integer	No	El número de fragmentos.	1
KnowledgeApplicationSpec	object	No	Requerido para las aplicaciones de conocimiento.
DashboardPassword	string	No	La contraseña del panel.
DbPassword	string	No	La contraseña.
LlmModel	string	No	Requerido para las aplicaciones de conocimiento. El nombre del modelo LLM, como qwen3-max.	qwen3-max
ModelFrom	string	No	El origen del modelo. Valores válidos: bailian: Modelos de Model Studio. custom: Modelos personalizados. maas: Operadores de modelos de PolarDB.	bailian
AIDBClusterId	string	No	El ID de la instancia existente del operador de modelos que se va a asociar. Este parámetro solo surte efecto cuando ApplicationType se establece en polarclaw.	pm-xxxxxx
ModelApiKey	string	No	La clave de API del modelo. Este parámetro solo surte efecto cuando ApplicationType se establece en polarclaw.	sk-xxxxxx
ModelBaseUrl	string	No	La URL base del modelo. Este parámetro solo surte efecto cuando ApplicationType se establece en polarclaw.	https://dashscope.aliyuncs.com/compatible-mode/v1
ModelApi	string	No	La API del modelo. Este parámetro solo surte efecto cuando ApplicationType se establece en polarclaw.	openai-completions
ModelName	string	No	El nombre del modelo. Este parámetro solo surte efecto cuando ApplicationType se establece en polarclaw.	qwen3-max
AutoAllocatePublicEip	boolean	No	Especifica si la creación automática está habilitada y si la instancia se vinculará y asociará con una EIP.	qwen3-max
Tag	array<object>	No	Las etiquetas.
	object	No	Las etiquetas.
Key	string	No	La clave de la etiqueta.	testKey
Value	string	No	El valor de la etiqueta.	testValue
TargetVersion	string	No	La versión de destino.	latest
AuthProvider	string	No	El proveedor de autenticación.	feishu
AuthProviderConfig	string	No	La configuración del proveedor de autenticación.	xxx
SkillTemplateId	string	No	El ID de la plantilla de habilidades.	xxx
VpcNatGatewayId	string	No	Asignación NAT: el ID de la puerta de enlace NAT de VPC creada por el usuario. Si especifica este parámetro, la asignación NAT se habilita cuando se crea la instancia. La puerta de enlace NAT debe residir en la misma VPC que la aplicación, ser de tipo red privada (intranet) y estar en estado activo.	ngw-xxx
DnatIpAddress	string	No	La dirección IP NAT dedicada asignada para DNAT, que es independiente de la dirección IP SNAT. La dirección IP debe pertenecer a la puerta de enlace NAT, estar en estado disponible, y el vSwitch donde reside la puerta de enlace debe pertenecer al bloque CIDR principal accesible desde la red de la oficina. Este parámetro debe especificarse junto con VpcNatGatewayId. Requisito previo: una entrada SNAT está asociada con el vSwitch donde reside la aplicación.	10.64.0.10
DnatEntries	array<object>	No	La lista esperada de entradas DNAT para la asignación NAT. Este parámetro debe especificarse junto con VpcNatGatewayId. Puede dejarse vacío, lo que indica que no se crea ninguna entrada DNAT.
	object	No	La entrada DNAT.
FrontPort	integer	No	El puerto frontend. Este parámetro es opcional. De forma predeterminada, el sistema de control asigna automáticamente un puerto, evitando los puertos ya ocupados por la puerta de enlace. Puede consultar el resultado de la asignación llamando a la operación DescribeApplicationAttribute.	10001
PortName	string	No	El nombre del puerto. Valores válidos: webui, hermesagent, dashboard y ssh.	webui
AgenticDBClusterId	string	No	El ID del clúster de AgenticDB.	pagc-xxx

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
ApplicationId	string	El ID de la aplicación.	pa-********************
Components	array<object>	La lista de subcomponentes.
	object	El subcomponente.
ComponentId	string	El ID del subcomponente.	pac-********************
Description	string	La descripción de la aplicación.	myapp
OrderId	string	El ID de la orden generada.	2148126708*****
RequestId	string	El ID de la solicitud.	3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF
ResourceAvailable	boolean	Indica si los recursos son suficientes. Este parámetro se devuelve solo cuando DryRun se establece en true.	true
ResourceGroupId	string	El ID del grupo de recursos.	rg-********************

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ApplicationId": "pa-********************",
  "Components": [
    {
      "ComponentId": "pac-********************"
    }
  ],
  "Description": "myapp",
  "OrderId": "2148126708*****",
  "RequestId": "3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF",
  "ResourceAvailable": true,
  "ResourceGroupId": "rg-********************"
}

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.