すべてのプロダクト
Search

このプロダクト

    PolarDB:CreateApplication

    ドキュメントセンター

    PolarDB:CreateApplication

    最終更新日:Oct 12, 2026

    PolarDB インスタンスにアタッチされたアプリケーションを作成します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    polardb:CreateApplication

    get

    *All resources.

    *

    		 なし なし

    リクエスト構文

    POST  HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Description

    string

    任意

    アプリケーションの説明または備考。

    myapp
    Parameters

    array<object>

    任意

    パラメーターのリスト。

    object

    任意

    パラメーターのリスト。

    ParameterName

    string

    任意

    パラメーター名。

    secret.gateway.auth.token
    ParameterValue

    string

    任意

    パラメーターの値。

    TK***
    AgenticDBBranchSpec

    object

    任意

    AgenticDB ブランチの仕様。

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

    string

    任意

    AgenticDB ブランチの ID。

    br-9054b3b7649e4c0d977bd0df37
    DBClusterId

    string

    任意

    AgenticDB クラスターの ID。

    pagc-2zea920mcvd5o87
    ForkFromApplicationId

    string

    任意

    ソースアプリケーションの ID。

    pa-source
    ForkFromBranch

    boolean

    任意

    指定された AgenticDB ブランチに基づいてアプリケーションを作成するかどうかを指定します。

    true
    ProjectId

    string

    任意

    AgenticDB プロジェクトの ID。

    proj-d7849d0050664c758af795d468
    TenantId

    string

    任意

    AgenticDB テナントの ID。

    t-cfc2d7df0e59439681f0087f51
    Storages

    array<object>

    任意

    アプリケーションのストレージリソースのリスト。

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

    object

    任意

    ContainerMountPath

    string

    任意

    コンテナ内のマウントパス。

    /data/container
    EndpointId

    string

    任意

    ストレージエンドポイントの ID。

    pe-xxxx
    MountPath

    string

    任意

    ストレージのマウントパス。

    /data/source
    StorageCapacity

    string

    任意

    ストレージ容量。

    100
    StorageEndpoint

    string

    任意

    ストレージのアクセスエンドポイント。

    polarfs.example.com
    StorageInstanceId

    string

    任意

    ストレージインスタンスの ID。

    pfs-xxxx
    StoragePerformanceLevel

    string

    任意

    ストレージパフォーマンスレベル。

    PL1
    StorageType

    string

    任意

    ストレージのタイプ。

    oss
    ApplicationType

    string

    必須

    アプリケーションタイプ。有効な値:

    • supabase: マネージド Supabase アプリケーションを作成するには、この値を指定します。

    • raycluster: マネージド Ray クラスターアプリケーションを作成するには、この値を指定します。

    • polarclaw: マネージド PolarClaw アプリケーションを作成するには、この値を指定します。

    supabase
    DBClusterId

    string

    任意

    アプリケーションが依存する PolarDB インスタンスの ID。

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

    string

    任意

    リージョン ID。デフォルト値: インスタンスのリージョン。

    cn-beijing
    ZoneId

    string

    任意

    ゾーン ID。デフォルト値: インスタンスのプライマリゾーン。

    cn-beijing-k
    VSwitchId

    string

    任意

    vSwitch ID。デフォルト値: インスタンスのプライマリゾーン内の現在の vSwitch。

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

    string

    必須

    CPU アーキテクチャ。有効な値:

    • x86

    x86
    SecurityIPList

    string

    任意

    IP アドレスのホワイトリスト。このパラメーターを指定しない場合、デフォルト値 127.0.0.1 が使用されます。

    127.0.0.1,172.17.0.0/24
    SecurityIPType

    string

    任意

    IP アドレスのタイプ。

    ipv4
    SecurityIPArrayName

    string

    任意

    IP アドレスホワイトリストグループの名前。デフォルト値: default。

    default
    Endpoints

    array<object>

    任意

    カスタムサービスエンドポイントのリスト。デフォルトでは、VPC エンドポイントが作成されます。

    object

    任意

    サービスエンドポイント。

    Description

    string

    任意

    サービスエンドポイントの説明。

    my_endpoint
    EndpointType

    string

    任意

    サービスエンドポイントのタイプ。値を Primary に設定します。

    Primary
    Components

    array<object>

    任意

    カスタムアプリケーションサブコンポーネントのリスト。

    object

    任意

    アプリケーションサブコンポーネント。

    ComponentClass

    string

    任意

    アプリケーションサブコンポーネントの仕様。

    polar.app.g2.medium
    ComponentMaxReplica

    integer

    任意

    同じ仕様のアプリケーションサブコンポーネントの最大値。デフォルト値: ComponentReplica の値。

    • このパラメーターは Ray クラスターに対してのみサポートされています。

    1
    ComponentReplica

    integer

    任意

    アプリケーションサブコンポーネントのレプリカ数。デフォルト値: 1。

    1
    ComponentType

    string

    任意

    アプリケーションサブコンポーネントのタイプ。supabase の有効な値:

    • ゲートウェイ

    • バックエンド Ray クラスターの有効な値:

    • head

    • worker

    • gpuworker

    gateway
    ScaleMax

    string

    任意

    コンポーネントスケーリングの上限。

    16
    ScaleMin

    string

    任意

    コンポーネントスケーリングの下限。

    1
    SecurityGroups

    string

    任意

    アプリケーションサブコンポーネントのセキュリティグループのリスト。複数のセキュリティグループ ID はコンマ (,) で区切ります。

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

    string

    任意

    アプリケーションサブコンポーネントの IP アドレスホワイトリストグループの名前。デフォルト値: default。

    default
    SecurityIPList

    string

    任意

    アプリケーションサブコンポーネントのホワイトリスト内の IP アドレス。複数の IP アドレスはコンマ (,) で区切ります。

    127.0.0.1
    SecurityIPType

    string

    任意

    アプリケーションサブコンポーネントのホワイトリスト内の IP アドレスのタイプ。デフォルト値: ipv4。

    ipv4
    PayType

    string

    任意

    課金メソッド。

    Postpaid
    AutoRenew

    boolean

    任意

    自動更新を有効にするかどうかを指定します。

    true
    Period

    string

    任意

    サブスクリプション期間の単位。

    Year
    UsedTime

    string

    任意

    サブスクリプション持続時間。

    1
    ResourceGroupId

    string

    任意

    リソースグループの ID。

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

    boolean

    任意

    ドライランを実行するかどうかを指定します。デフォルト値: false。このパラメーターを true に設定すると、システムはリソースを実際に作成せずに、パラメーターとリソースのチェックのみを行います。

    false
    PolarFSInstanceId

    string

    任意

    Polarlakebase コールドストレージまたは高パフォーマンスクラスターの ID。デフォルト値: 空。このパラメーターを指定すると、対応するストレージがアプリケーションにマウントされます。このパラメーターは、以下のアプリケーションに対してのみサポートされています。

    • supabase

    • raycluster

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

    string

    任意

    仮想非公開クラウド (VPC) の ID。

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

    boolean

    任意

    Polarlakebase コールドストレージインスタンスを自動作成するかどうかを指定します。有効な値:

    • false: インスタンスを自動作成しません。これがデフォルト値です。

    • true: インスタンスを自動作成します。

    false
    AutoUseCoupon

    boolean

    任意

    クーポンを自動的に使用するかどうかを指定します。有効な値:

    • true: クーポンを使用します。これがデフォルト値です。

    • false: クーポンを使用しません。

    true
    PromotionCode

    string

    任意

    クーポンコード。このパラメーターを指定しない場合、デフォルトのクーポンが使用されます。

    727xxxxxx934
    SecurityGroupId

    string

    任意

    セキュリティグループの ID。

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

    MemApplicationSpec

    object

    任意

    mem0 アプリケーションに必須です。

    DbName

    string

    任意

    データベース名。

    test-database-name
    DbPassword

    string

    任意

    パスワード。

    test-user-password
    DbUser

    string

    任意

    ユーザー名。

    test-user
    EmbedderModel

    string

    任意

    mem0 アプリケーションに必須です。text-embedding-v4 などの埋め込みモデルの名前。

    text-embedding-v4
    EmbedderModelDimension

    integer

    任意

    ベクトル次元。

    1024
    GraphLlmModel

    string

    任意

    グラフ LLM モデル。

    qwen-plus
    LlmModel

    string

    任意

    mem0 アプリケーションに必須です。qwen3-max などの LLM モデルの名前。

    qwen3-max
    ProjectName

    string

    任意

    プロジェクト名。プロジェクトデータを保存するデータベーススキーマに対応します。

    test-project-name
    RerankerModel

    string

    任意

    mem0 アプリケーションに必須です。qwen3-rerank などのリランキングモデルの名前。

    qwen3-rerank
    Shard

    integer

    任意

    シャード数。

    1
    KnowledgeApplicationSpec

    object

    任意

    ナレッジアプリケーションに必須です。

    DashboardPassword

    string

    任意

    ダッシュボードのパスワード。

    DbPassword

    string

    任意

    パスワード。

    LlmModel

    string

    任意

    ナレッジアプリケーションに必須です。qwen3-max などの LLM モデルの名前。

    qwen3-max
    ModelFrom

    string

    任意

    モデルソース。有効な値:

    • bailian: Model Studio モデル。

    • custom: カスタムモデル。

    • maas: PolarDB モデル演算子。

    bailian
    AIDBClusterId

    string

    任意

    関連付ける既存のモデル演算子インスタンスの ID。このパラメーターは、ApplicationType が polarclaw にセットされている場合にのみ効果を発揮します。

    pm-xxxxxx
    ModelApiKey

    string

    任意

    モデルの API キー。このパラメーターは、ApplicationType が polarclaw にセットされている場合にのみ効果を発揮します。

    sk-xxxxxx
    ModelBaseUrl

    string

    任意

    モデルのベース URL。このパラメーターは、ApplicationType が polarclaw にセットされている場合にのみ効果を発揮します。

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

    string

    任意

    モデル API。このパラメーターは、ApplicationType が polarclaw にセットされている場合にのみ効果を発揮します。

    openai-completions
    ModelName

    string

    任意

    モデル名。このパラメーターは、ApplicationType が polarclaw にセットされている場合にのみ効果を発揮します。

    qwen3-max
    AutoAllocatePublicEip

    boolean

    任意

    自動作成が有効であり、インスタンスが EIP をアタッチおよび関連付けるかどうかを指定します。

    qwen3-max
    Tag

    array<object>

    任意

    タグ。

    object

    任意

    タグ。

    Key

    string

    任意

    タグキー。

    testKey
    Value

    string

    任意

    タグ値。

    testValue
    TargetVersion

    string

    任意

    ターゲットバージョン。

    latest
    AuthProvider

    string

    任意

    認証プロバイダー。

    feishu
    AuthProviderConfig

    string

    任意

    認証プロバイダーの構成。

    xxx
    SkillTemplateId

    string

    任意

    スキルテンプレートの ID。

    xxx
    VpcNatGatewayId

    string

    任意

    NAT マッピング: ユーザーが作成した VPC NAT ゲートウェイの ID。このパラメーターを指定すると、インスタンスの作成時に NAT マッピングが有効になります。NAT ゲートウェイはアプリケーションと同じ VPC に存在し、プライベートネットワーク (イントラネット) タイプであり、アクティブな状態である必要があります。

    ngw-xxx
    DnatIpAddress

    string

    任意

    DNAT 用に割り当てられた専用の NAT IP アドレス。SNAT IP アドレスとは別です。IP アドレスは NAT Gateway に属し、利用可能な状態である必要があり、ゲートウェイが存在する vSwitch はオフィスネットワークから到達可能なプライマリ CIDR ブロックに属している必要があります。このパラメーターは VpcNatGatewayId と一緒に指定する必要があります。前提条件: アプリケーションが存在する vSwitch に SNAT エントリが関連付けられていること。

    10.64.0.10
    DnatEntries

    array<object>

    任意

    NAT マッピング用の DNAT エントリの予期されるリスト。このパラメーターは VpcNatGatewayId と一緒に指定する必要があります。空のままにすることもでき、その場合は DNAT エントリが作成されないことを示します。

    object

    任意

    DNAT エントリ。

    FrontPort

    integer

    任意

    フロントエンドポート。このパラメーターは任意です。デフォルトでは、コントロールシステムがゲートウェイによってすでに占有されているポートを回避してポートを自動的に割り当てます。割り当て結果は、DescribeApplicationAttribute 操作を呼び出すことでクエリできます。

    10001
    PortName

    string

    任意

    ポート名。有効な値: webui、hermesagent、ダッシュボード、ssh。

    webui
    AgenticDBClusterId

    string

    任意

    AgenticDB クラスターの ID。

    pagc-xxx

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ。

    ApplicationId

    string

    アプリケーションの ID。

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

    array<object>

    サブコンポーネントのリスト。

    object

    サブコンポーネント。

    ComponentId

    string

    サブコンポーネントの ID。

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

    string

    アプリケーションの説明。

    myapp
    OrderId

    string

    生成された注文の ID。

    2148126708*****
    RequestId

    string

    リクエストの ID。

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

    boolean

    リソースが十分かどうかを示します。このパラメーターは、DryRun が true に設定されている場合にのみ返されます。

    true
    ResourceGroupId

    string

    リソースグループの ID。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。