CreateApplication - PolarDB: Central de Documentação do Alibaba Cloud

Cria uma aplicação vinculada a uma instância do PolarDB.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:CreateApplication

get

*All Resource

*

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Description	string	Não	A descrição da aplicação.	myapp
Parameters	array<object>	Não	Uma lista de parâmetros.
	object	Não	Uma lista de parâmetros.
ParameterName	string	Não	O nome do parâmetro.	secret.gateway.auth.token
ParameterValue	string	Não	O valor do parâmetro.	TK***
ApplicationType	string	Sim	O tipo da aplicação. Valores válidos: supabase: Cria uma aplicação Supabase gerenciada. raycluster: Cria uma aplicação Ray Cluster gerenciada. polarclaw: Cria uma aplicação PolarClaw gerenciada.	supabase
DBClusterId	string	Não	O ID da instância do PolarDB da qual a aplicação depende.	pc-**************
RegionId	string	Não	A região. O valor padrão é a região da instância.	cn-beijing
ZoneId	string	Não	A zona. O valor padrão é a zona primária da instância.	cn-beijing-k
VSwitchId	string	Não	O vSwitch. O valor padrão é o vSwitch atual na zona primária da instância.	vsw-*********************
Architecture	string	Sim	A arquitetura da CPU. Valor válido: x86	x86
SecurityIPList	string	Não	A lista de permissões de endereços IP. Se você não especificar este parâmetro, o valor padrão 127.0.0.1 será usado.	127.0.0.1,172.17.0.0/24
SecurityIPType	string	Não	O tipo do endereço IP.	ipv4
SecurityIPArrayName	string	Não	O nome do grupo da lista de permissões de endereços IP. O valor padrão é default.	default
Endpoints	array<object>	Não	Uma lista de endpoints personalizados do lado do servidor. Por padrão, um VPC Endpoint é criado.
	object	Não	O endpoint do lado do servidor.
Description	string	Não	A descrição do endpoint do lado do servidor.	my_endpoint
EndpointType	string	Não	O tipo do endpoint do lado do servidor. Este valor é fixo como Primary.	Primary
Components	array<object>	Não	Uma lista de componentes filho personalizados para a aplicação.
	object	Não	O componente filho da aplicação.
ComponentType	string	Não	O tipo do componente filho. Para supabase, os valores válidos são: gateway backend Para raycluster, os valores válidos são: head worker gpuworker	gateway
ComponentClass	string	Não	As especificações do componente filho.	polar.app.g2.medium
ComponentReplica	integer	Não	O número de réplicas para o componente filho. O valor padrão é 1.	1
SecurityIPList	string	Não	A lista de permissões de endereços IP para o componente filho. Separe vários endereços IP com vírgulas (,).	127.0.0.1
SecurityIPType	string	Não	O tipo do endereço IP na lista de permissões para o componente filho. O valor padrão é ipv4.	ipv4
SecurityIPArrayName	string	Não	O nome do grupo da lista de permissões de endereços IP para o componente filho. O valor padrão é default.	default
SecurityGroups	string	Não	Os grupos de segurança para o componente filho. Separe vários IDs de grupos de segurança com vírgulas (,).	sg-********************
ComponentMaxReplica	integer	Não	O número máximo de componentes filho com as mesmas especificações. O valor padrão é o valor de ComponentReplica. Este parâmetro é suportado apenas para raycluster.	1
ScaleMin	string	Não	O número mínimo de réplicas do componente para dimensionamento.	1
ScaleMax	string	Não	O número máximo de réplicas do componente para dimensionamento.	16
PayType	string	Não	O método de cobrança.	Postpaid
AutoRenew	boolean	Não	Especifica se a renovação automática deve ser ativada.	true
Period	string	Não	O tipo de período de assinatura.	Year
UsedTime	string	Não	A duração da assinatura.	1
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-********************
DryRun	boolean	Não	O valor padrão é false. Se você definir este parâmetro como true, o sistema apenas verifica os parâmetros e recursos sem criar os recursos reais.	false
PolarFSInstanceId	string	Não	O ID da instância de armazenamento frio ou de alto desempenho do PolarFileSystem (PolarFS). Este parâmetro está vazio por padrão. Se você especificar este parâmetro, o armazenamento correspondente será montado na aplicação. Este recurso é atualmente suportado apenas pelas seguintes aplicações: supabase raycluster	pcs-********************
VpcId	string	Não	O ID da Virtual Private Cloud (VPC).	vpc-********************
AutoCreatePolarFs	boolean	Não	Especifica se uma instância de armazenamento frio do PolarFS deve ser criada automaticamente. Valores válidos: false (padrão): Não cria a instância automaticamente. true: Cria a instância automaticamente.	false
AutoUseCoupon	boolean	Não	Especifica se um cupom deve ser usado automaticamente. Valores válidos: true (padrão): Usa um cupom. false: Não usa um cupom.	true
PromotionCode	string	Não	O código do cupom. Se você não especificar este parâmetro, o cupom padrão será usado.	727xxxxxx934
SecurityGroupId	string	Não	O ID do grupo de segurança.	sg-********************
MemApplicationSpec	object	Não	Este parâmetro é obrigatório para aplicações mem0.
LlmModel	string	Não	Este parâmetro é obrigatório para aplicações mem0. Especifica o nome do modelo de linguagem grande (LLM), como qwen3-max.	qwen3-max
EmbedderModel	string	Não	Este parâmetro é obrigatório para aplicações mem0. Especifica o nome do modelo embedder, como text-embedding-v4.	text-embedding-v4
RerankerModel	string	Não	Este parâmetro é obrigatório para aplicações mem0. Especifica o nome do modelo reranker, como qwen3-rerank.	qwen3-rerank
ProjectName	string	Não	O nome do projeto. Isso corresponde ao schema no banco de dados onde os dados do projeto são armazenados.	test-project-name
DbName	string	Não	O nome do banco de dados.	test-database-name
DbUser	string	Não	O nome de usuário.	test-user
DbPassword	string	Não	A senha.	test-user-password
GraphLlmModel	string	Não	O LLM de grafo.	qwen-plus
EmbedderModelDimension	integer	Não	As dimensões do vetor.	1024
Shard	integer	Não	O número de tabelas fragmentadas.	1
KnowledgeApplicationSpec	object	Não	Este parâmetro é obrigatório para aplicações de conhecimento.
LlmModel	string	Não	Este parâmetro é obrigatório para aplicações de conhecimento. Especifica o nome do LLM, como qwen3-max.
DbPassword	string	Não	A senha.
DashboardPassword	string	Não	A senha do painel.
ModelFrom	string	Não	A origem do modelo. Valores válidos: bailian: Modelo do Alibaba Cloud Model Studio. custom: Um modelo personalizado. maas: Operador de modelo do PolarDB.	bailian
AIDBClusterId	string	Não	O ID de uma instância existente do operador de modelo a ser associada. Este parâmetro é efetivo apenas quando ApplicationType está definido como polarclaw.	pm-xxxxxx
ModelApiKey	string	Não	A chave de API para o modelo. Este parâmetro é efetivo apenas quando ApplicationType está definido como polarclaw.	sk-xxxxxx
ModelBaseUrl	string	Não	A URL do modelo. Este parâmetro é efetivo apenas quando ApplicationType está definido como polarclaw.	https://dashscope.aliyuncs.com/compatible-mode/v1
ModelApi	string	Não	A API do modelo. Este parâmetro é efetivo apenas quando ApplicationType está definido como polarclaw.	openai-completions
ModelName	string	Não	O nome do modelo. Este parâmetro é efetivo apenas quando ApplicationType está definido como polarclaw.	qwen3-max
AutoAllocatePublicEip	boolean	Não	Especifica se um Elastic IP Address (EIP) deve ser criado e vinculado automaticamente.	qwen3-max
Tag	array<object>	Não	A tag.
	object	Não	A tag.
Key	string	Não	A chave da tag.	testKey
Value	string	Não	O valor da tag.	testValue
TargetVersion	string	Não	A versão de destino.	latest
AuthProvider	string	Não	O provedor de serviço de autenticação.	feishu
AuthProviderConfig	string	Não	A configuração do provedor de autenticação.	xxx
SkillTemplateId	string	Não	O ID do modelo de habilidade.	xxx

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Schema da resposta.
ResourceAvailable	boolean	Indica se os recursos são suficientes. Este parâmetro é retornado apenas quando DryRun está definido como true.	true
ApplicationId	string	O ID da aplicação.	pa-********************
Description	string	A descrição da aplicação.	myapp
Components	array<object>	Uma lista de componentes filho.
	object	O componente filho.
ComponentId	string	O ID do componente filho.	pac-********************
OrderId	string	O ID do pedido gerado.	2148126708*****
RequestId	string	O ID da solicitação.	3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF
ResourceGroupId	string	O ID do grupo de recursos.	rg-********************

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.