All Products
Search

This Product

    PolarDB:CreateApplication

    Document Center

    PolarDB:CreateApplication

    Last Updated:Jun 10, 2026

    Membuat aplikasi yang terpasang pada Instans PolarDB Basis Data Relasional Cloud-Native.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    polardb:CreateApplication

    get

    *全部资源

    *

    		 None None

    Sintaks permintaan

    POST  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Description

    string

    No

    Deskripsi aplikasi.

    myapp
    Parameters

    array<object>

    No

    Daftar parameter.

    object

    No

    A list of parameters.

    ParameterName

    string

    No

    The name of the parameter.

    secret.gateway.auth.token
    ParameterValue

    string

    No

    The value of the parameter.

    TK***
    ApplicationType

    string

    Yes

    Tipe aplikasi. Nilai valid:

    • supabase: Membuat aplikasi Supabase terkelola.

    • raycluster: Membuat aplikasi Ray Kluster terkelola.

    • polarclaw: Membuat aplikasi PolarClaw terkelola.

    supabase
    DBClusterId

    string

    No

    ID Instans PolarDB Basis Data Relasional Cloud-Native yang menjadi dependensi aplikasi.

    pc-**************
    RegionId

    string

    No

    Wilayah. Nilai default adalah Wilayah Instans.

    cn-beijing
    ZoneId

    string

    No

    Zona. Nilai default adalah zona utama Instans.

    cn-beijing-k
    VSwitchId

    string

    No

    vSwitch. Nilai default adalah vSwitch saat ini di zona utama Instans.

    vsw-*********************
    Architecture

    string

    Yes

    Arsitektur CPU. Nilai valid:

    • x86.

    x86
    SecurityIPList

    string

    No

    Daftar putih alamat IP. Jika Anda tidak menentukan parameter ini, nilai default 127.0.0.1 digunakan.

    127.0.0.1,172.17.0.0/24
    SecurityIPType

    string

    No

    Tipe alamat IP.

    ipv4
    SecurityIPArrayName

    string

    No

    Nama kelompok daftar putih alamat IP. Nilai default adalah default.

    default
    Endpoints

    array<object>

    No

    Daftar Titik akhir sisi server kustom. Secara default, VPC Endpoint dibuat.

    object

    No

    The server-side endpoint.

    Description

    string

    No

    The description of the server-side endpoint.

    my_endpoint
    EndpointType

    string

    No

    The type of the server-side endpoint. This value is fixed to Primary.

    Primary
    Components

    array<object>

    No

    Daftar Komponen anak kustom untuk aplikasi.

    object

    No

    The child component of the application.

    ComponentType

    string

    No

    The type of the child component.

    For supabase, valid values are:

    • gateway

    • backend

    For raycluster, valid values are:

    • head

    • worker

    • gpuworker

    gateway
    ComponentClass

    string

    No

    The specifications of the child component.

    polar.app.g2.medium
    ComponentReplica

    integer

    No

    The number of replicas for the child component. The default value is 1.

    1
    SecurityIPList

    string

    No

    The IP address whitelist for the child component. Separate multiple IP addresses with commas (,).

    127.0.0.1
    SecurityIPType

    string

    No

    The type of the IP address in the whitelist for the child component. The default value is ipv4.

    ipv4
    SecurityIPArrayName

    string

    No

    The name of the IP address whitelist group for the child component. The default value is default.

    default
    SecurityGroups

    string

    No

    The security groups for the child component. Separate multiple security group IDs with commas (,).

    sg-********************
    ComponentMaxReplica

    integer

    No

    The maximum number of child components with the same specifications. The default value is the value of ComponentReplica.

    • This parameter is supported only for raycluster.

    1
    ScaleMin

    string

    No

    The minimum number of component replicas for scaling.

    1
    ScaleMax

    string

    No

    The maximum number of component replicas for scaling.

    16
    PayType

    string

    No

    Metode penagihan.

    Postpaid
    AutoRenew

    boolean

    No

    Apakah akan mengaktifkan perpanjangan otomatis.

    true
    Period

    string

    No

    Tipe periode langganan.

    Year
    UsedTime

    string

    No

    Durasi langganan.

    1
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-********************
    DryRun

    boolean

    No

    Nilai default adalah false. Jika Anda mengatur parameter ini ke true, sistem hanya memeriksa parameter dan Sumber daya tanpa membuat Sumber daya aktual.

    false
    PolarFSInstanceId

    string

    No

    ID Instans penyimpanan dingin atau performa tinggi PolarFileSystem (PolarFS). Parameter ini kosong secara default. Jika Anda menentukan parameter ini, penyimpanan yang sesuai dipasang ke aplikasi.

    Fitur ini saat ini hanya didukung oleh aplikasi berikut:

    • supabase

    • raycluster.

    pcs-********************
    VpcId

    string

    No

    ID Virtual Private Cloud (VPC).

    vpc-********************
    AutoCreatePolarFs

    boolean

    No

    Apakah akan secara otomatis membuat Instans penyimpanan dingin PolarFS. Nilai valid:

    • false (default): Tidak secara otomatis membuat Instans.

    • true: Secara otomatis membuat Instans.

    false
    AutoUseCoupon

    boolean

    No

    Apakah akan secara otomatis menggunakan kupon. Nilai valid:

    • true (default): Menggunakan kupon.

    • false: Tidak menggunakan kupon.

    true
    PromotionCode

    string

    No

    Kode kupon. Jika Anda tidak menentukan parameter ini, kupon default digunakan.

    727xxxxxx934
    SecurityGroupId

    string

    No

    ID grup keamanan.

    sg-********************

    MemApplicationSpec

    object

    No

    Parameter ini diperlukan untuk aplikasi mem0.

    LlmModel

    string

    No

    This parameter is required for mem0 applications. It specifies the name of the large language model (LLM), such as qwen3-max.

    qwen3-max
    EmbedderModel

    string

    No

    This parameter is required for mem0 applications. It specifies the name of the embedder model, such as text-embedding-v4.

    text-embedding-v4
    RerankerModel

    string

    No

    This parameter is required for mem0 applications. It specifies the name of the reranker model, such as qwen3-rerank.

    qwen3-rerank
    ProjectName

    string

    No

    The project name. This corresponds to the schema in the database where project data is stored.

    test-project-name
    DbName

    string

    No

    The name of the database.

    test-database-name
    DbUser

    string

    No

    The username.

    test-user
    DbPassword

    string

    No

    The password.

    test-user-password
    GraphLlmModel

    string

    No

    The graph LLM.

    qwen-plus
    EmbedderModelDimension

    integer

    No

    The vector dimensions.

    1024
    Shard

    integer

    No

    The number of sharded tables.

    1
    KnowledgeApplicationSpec

    object

    No

    Parameter ini diperlukan untuk aplikasi knowledge.

    LlmModel

    string

    No

    This parameter is required for knowledge applications. It specifies the name of the LLM, such as qwen3-max.

    DbPassword

    string

    No

    The password.

    DashboardPassword

    string

    No

    The password for the dashboard.

    ModelFrom

    string

    No

    Sumber model. Nilai valid:

    • bailian: Model Studio Model Alibaba Cloud.

    • custom: Model kustom.

    • maas: Operator model PolarDB Basis Data Relasional Cloud-Native.

    bailian
    AIDBClusterId

    string

    No

    ID Instans Operator model yang sudah ada untuk diasosiasikan. Parameter ini hanya berlaku ketika ApplicationType diatur ke polarclaw.

    pm-xxxxxx
    ModelApiKey

    string

    No

    Kunci API untuk model. Parameter ini hanya berlaku ketika ApplicationType diatur ke polarclaw.

    sk-xxxxxx
    ModelBaseUrl

    string

    No

    URL model. Parameter ini hanya berlaku ketika ApplicationType diatur ke polarclaw.

    https://dashscope.aliyuncs.com/compatible-mode/v1
    ModelApi

    string

    No

    API model. Parameter ini hanya berlaku ketika ApplicationType diatur ke polarclaw.

    openai-completions
    ModelName

    string

    No

    Nama model. Parameter ini hanya berlaku ketika ApplicationType diatur ke polarclaw.

    qwen3-max
    AutoAllocatePublicEip

    boolean

    No

    Apakah akan secara otomatis membuat dan mengikat Elastic IP Address (EIP).

    qwen3-max
    Tag

    array<object>

    No

    Tag.

    object

    No

    The tag.

    Key

    string

    No

    The key of the tag.

    testKey
    Value

    string

    No

    The value of the tag.

    testValue
    TargetVersion

    string

    No

    Versi target.

    latest
    AuthProvider

    string

    No

    Penyedia layanan otentikasi.

    feishu
    AuthProviderConfig

    string

    No

    Konfigurasi penyedia otentikasi.

    xxx
    SkillTemplateId

    string

    No

    ID Templat skill.

    xxx

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Schema of Response

    ResourceAvailable

    boolean

    Indicates whether the resources are sufficient. This parameter is returned only when DryRun is set to true.

    true
    ApplicationId

    string

    The ID of the application.

    pa-********************
    Description

    string

    The description of the application.

    myapp
    Components

    array<object>

    A list of child components.

    object

    The child component.

    ComponentId

    string

    The ID of the child component.

    pac-********************
    OrderId

    string

    The ID of the generated order.

    2148126708*****
    RequestId

    string

    The ID of the request.

    3E5CD764-FCCA-5C9C-838E-20E0DE84B2AF
    ResourceGroupId

    string

    The ID of the resource group.

    rg-********************

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.