All Products
Search

This Product

    PolarDB:CreateApplication

    Document Center

    PolarDB:CreateApplication

    Last Updated:Sep 21, 2026

    Membuat aplikasi yang terkait dengan 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

    *Semua sumber daya.

    *

    		 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

    Daftar parameter.

    ParameterName

    string

    No

    Nama parameter.

    secret.gerbang.auth.token
    ParameterValue

    string

    No

    Nilai parameter.

    TK***
    AgenticDBBranchSpec

    object

    No

    Spesifikasi branch AgenticDB.

    {"DBClusterId":"pagc-2zea920mcvd5o87","TenantId":"t-cfc2d7df0e59439681f0087f51","ProjectId":"proj-d7849d0050664c758af795d468","BranchId":"br-9054b3b7649e4c0d977bd0df37","ForkFromBranch":true,"ForkFromApplicationId":"pa-source"}
    BranchId

    string

    No

    ID branch AgenticDB.

    br-9054b3b7649e4c0d977bd0df37
    DBClusterId

    string

    No

    ID kluster AgenticDB.

    pagc-2zea920mcvd5o87
    ForkFromApplicationId

    string

    No

    ID aplikasi sumber.

    pa-source
    ForkFromBranch

    boolean

    No

    Apakah akan membuat aplikasi berdasarkan branch AgenticDB tertentu.

    true
    ProjectId

    string

    No

    ID proyek AgenticDB.

    proj-d7849d0050664c758af795d468
    TenantId

    string

    No

    ID penyewa AgenticDB.

    t-cfc2d7df0e59439681f0087f51
    Storages

    array<object>

    No

    Daftar penyimpanan aplikasi.

    [{"StorageType":"oss","StorageInstanceId":"pfs-xxxx","EndpointId":"pe-xxxx"}]

    object

    No

    ContainerMountPath

    string

    No

    Jalur memasang di dalam kontainer.

    /data/Kontainer
    EndpointId

    string

    No

    ID titik akhir penyimpanan.

    pe-xxxx
    MountPath

    string

    No

    Jalur memasang penyimpanan.

    /data/source
    StorageCapacity

    string

    No

    Kapasitas penyimpanan.

    100
    StorageEndpoint

    string

    No

    Alamat akses penyimpanan.

    polarfs.example.com
    StorageInstanceId

    string

    No

    ID instans penyimpanan.

    pfs-xxxx
    StoragePerformanceLevel

    string

    No

    Tingkat kinerja penyimpanan.

    PL1
    StorageType

    string

    No

    Tipe penyimpanan.

    oss
    ApplicationType

    string

    Yes

    Tipe aplikasi. Nilai valid:

    • supabase: Tetapkan nilai ini untuk membuat aplikasi Supabase terkelola.

    • raycluster: Tetapkan nilai ini untuk membuat aplikasi Ray Kluster terkelola.

    • polarclaw: Tetapkan nilai ini untuk 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: wilayah instans.

    cn-beijing
    ZoneId

    string

    No

    Zona. Nilai default: zona utama instans.

    cn-beijing-k
    VSwitchId

    string

    No

    vSwitch. Nilai default: vSwitch di zona utama instans.

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

    string

    Yes

    Arsitektur CPU. Nilai valid:

    • x86

    x86
    SecurityIPList

    string

    No

    Daftar putih IP. Jika parameter ini tidak ditentukan, nilai default 127.0.0.1 akan digunakan.

    127.0.0.1,172.17.0.0/24
    SecurityIPType

    string

    No

    Tipe alamat IP.

    ipv4
    SecurityIPArrayName

    string

    No

    Nama kelompok daftar putih IP. Nilai default: default.

    default
    Endpoints

    array<object>

    No

    Daftar titik akhir layanan yang ditentukan pengguna. Secara default, titik akhir VPC akan dibuat.

    object

    No

    Titik akhir layanan.

    Description

    string

    No

    Deskripsi titik akhir layanan.

    my_Titik akhir
    EndpointType

    string

    No

    Tipe titik akhir layanan. Nilai ditetapkan sebagai Primary.

    Primary
    Components

    array<object>

    No

    Daftar subkomponen aplikasi yang ditentukan pengguna.

    object

    No

    Subkomponen aplikasi.

    ComponentClass

    string

    No

    Spesifikasi subkomponen aplikasi.

    polar.app.g2.medium
    ComponentMaxReplica

    integer

    No

    Jumlah maksimum subkomponen aplikasi dengan spesifikasi yang sama. Nilai default: nilai ComponentReplica.

    • Hanya raykluster yang mendukung parameter ini.

    1
    ComponentReplica

    integer

    No

    Jumlah replika untuk subkomponen aplikasi. Nilai default: 1.

    1
    ComponentType

    string

    No

    Tipe subkomponen aplikasi.

    Untuk supabase, nilai valid:

    • gerbang

    • backend

    Untuk raykluster, nilai valid:

    • head

    • worker

    • gpuworker

    gerbang
    ScaleMax

    string

    No

    Batas atas untuk penskalaan komponen.

    16
    ScaleMin

    string

    No

    Batas bawah untuk penskalaan komponen.

    1
    SecurityGroups

    string

    No

    Daftar grup keamanan untuk subkomponen aplikasi. Pisahkan beberapa grup keamanan dengan koma (,).

    sg-********************
    SecurityIPArrayName

    string

    No

    Nama kelompok daftar putih IP untuk subkomponen aplikasi. Nilai default: default.

    default
    SecurityIPList

    string

    No

    Alamat IP yang masuk daftar putih untuk subkomponen aplikasi. Pisahkan beberapa alamat IP dengan koma (,).

    127.0.0.1
    SecurityIPType

    string

    No

    Tipe alamat IP yang masuk daftar putih untuk subkomponen aplikasi. Nilai default: ipv4.

    ipv4
    PayType

    string

    No

    Tipe penagihan.

    Postpaid
    AutoRenew

    boolean

    No

    Apakah akan mengaktifkan perpanjangan otomatis.

    true
    Period

    string

    No

    Tipe langganan (tahunan atau bulanan).

    Year
    UsedTime

    string

    No

    Durasi langganan.

    1
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

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

    boolean

    No

    Nilai default: false. Jika parameter ini diatur ke true, hanya validasi parameter dan Sumber daya yang dilakukan tanpa benar-benar membuat Sumber daya.

    false
    PolarFSInstanceId

    string

    No

    ID instans penyimpanan dingin atau edisi berkinerja tinggi Polarlakebase. Nilai default: kosong. Jika ditentukan, sistem akan memasang penyimpanan yang sesuai ke aplikasi.

    Saat ini, hanya aplikasi berikut yang mendukung parameter ini:

    • supabase

    • raykluster

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

    string

    No

    ID VPC.

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

    boolean

    No

    Apakah akan mengaktifkan pembuatan otomatis penyimpanan dingin Polarlakebase. Nilai valid:

    • false (default): Pembuatan otomatis dinonaktifkan.

    • true: Pembuatan otomatis diaktifkan.

    false
    AutoUseCoupon

    boolean

    No

    Apakah akan menggunakan kupon secara otomatis. Nilai valid:

    • true (default): Menggunakan kupon.

    • false: Tidak menggunakan kupon.

    true
    PromotionCode

    string

    No

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

    727xxxxxx934
    SecurityGroupId

    string

    No

    ID grup keamanan.

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

    MemApplicationSpec

    object

    No

    Diperlukan untuk aplikasi mem0.

    DbName

    string

    No

    Nama database.

    test-database-name
    DbPassword

    string

    No

    Kata sandi.

    test-user-password
    DbUser

    string

    No

    Nama pengguna.

    test-user
    EmbedderModel

    string

    No

    Nama model penyematan. Parameter ini diperlukan untuk aplikasi mem0, seperti text-penyematan-v4.

    text-penyematan-v4
    EmbedderModelDimension

    integer

    No

    Dimensi vektor.

    1024
    GraphLlmModel

    string

    No

    Model LLM graf.

    qwen-plus
    LlmModel

    string

    No

    Nama model LLM. Parameter ini diperlukan untuk aplikasi mem0, seperti qwen3-max.

    qwen3-max
    ProjectName

    string

    No

    Nama proyek, yang sesuai dengan skema di database tempat data proyek disimpan.

    test-proyek-name
    RerankerModel

    string

    No

    Nama model reranker. Parameter ini diperlukan untuk aplikasi mem0, seperti qwen3-rerank.

    qwen3-rerank
    Shard

    integer

    No

    Jumlah shard tabel.

    1
    KnowledgeApplicationSpec

    object

    No

    Diperlukan untuk aplikasi knowledge.

    DashboardPassword

    string

    No

    Kata sandi dasbor.

    DbPassword

    string

    No

    Kata sandi.

    LlmModel

    string

    No

    Nama model LLM. Parameter ini diperlukan untuk aplikasi knowledge, seperti qwen3-max.

    ModelFrom

    string

    No

    Sumber model. Nilai valid:

    • bailian: Model Bailian.

    • custom: Model kustom.

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

    bailian
    AIDBClusterId

    string

    No

    ID instans operator model yang ada untuk diasosiasikan. Parameter ini hanya berlaku ketika ApplicationType diatur ke polarclaw.

    pm-xxxxxx
    ModelApiKey

    string

    No

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

    sk-xxxxxx
    ModelBaseUrl

    string

    No

    URL dasar 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 membuat elastic IP address (EIP) secara otomatis dan mengasosiasikannya dengan instans.

    qwen3-max
    Tag

    array<object>

    No

    Tag.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag.

    testKey
    Value

    string

    No

    Nilai 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 keterampilan.

    xxx
    VpcNatGatewayId

    string

    No

    ID gerbang NAT VPC untuk pemetaan NAT. Jika ditentukan, pemetaan NAT diaktifkan saat instans dibuat. Gerbang NAT harus berada di VPC yang sama dengan aplikasi, menggunakan jenis jaringan pribadi (intranet), dan berada dalam status aktif.

    ngw-xxx
    DnatIpAddress

    string

    No

    Alamat IP NAT khusus DNAT yang dialokasikan oleh pelanggan, yang harus terpisah dari alamat IP SNAT. Alamat IP harus milik gerbang yang ditentukan dan berada dalam status tersedia. vSwitch tempat gerbang berada harus berada dalam blok CIDR utama yang dapat dijangkau dari jaringan kantor. Tentukan parameter ini bersama dengan VpcNatGatewayId. Prasyarat: Pelanggan telah mengikat entri SNAT ke vSwitch tempat aplikasi berada.

    10.64.0.10
    DnatEntries

    array<object>

    No

    Daftar entri DNAT yang diharapkan untuk pemetaan NAT. Tentukan parameter ini bersama dengan VpcNatGatewayId. Parameter ini dapat dikosongkan, yang menunjukkan bahwa tidak ada entri DNAT yang dibuat.

    object

    No

    Entri DNAT.

    FrontPort

    integer

    No

    Port antarmuka depan. Parameter ini bersifat opsional. Jika tidak ditentukan, lapisan kontrol secara otomatis menetapkan port yang tidak bertentangan dengan port yang sudah digunakan pada gerbang. Anda dapat mengkueri hasil penetapan dengan memanggil operasi DescribeApplicationAttribute.

    10001
    PortName

    string

    No

    Nama port. Nilai valid: webui | hermesagent | Dasbor | ssh.

    webui

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    ApplicationId

    string

    ID aplikasi.

    pa-********************
    Components

    array<object>

    Daftar komponen turunan.

    object

    Komponen turunan.

    ComponentId

    string

    ID komponen turunan.

    pac-********************
    Description

    string

    Deskripsi aplikasi.

    myapp
    OrderId

    string

    ID pesanan yang dihasilkan.

    2148126708*****
    RequestId

    string

    ID permintaan.

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

    boolean

    Apakah sumber daya mencukupi. Parameter ini hanya dikembalikan ketika DryRun diatur ke true.

    true
    ResourceGroupId

    string

    ID kelompok sumber daya.

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

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.