すべてのプロダクト
Search
ドキュメントセンター

PolarDB:CreateApplication

最終更新日:Apr 18, 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 Resource

*

なし なし

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

Description

string

任意

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

myapp

Parameters

array<object>

任意

パラメーターのリスト。

object

任意

パラメーターのリスト。

ParameterName

string

任意

パラメーターの名前。

secret.gateway.auth.token

ParameterValue

string

任意

パラメーターの値。

TK***

ApplicationType

string

必須

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

  • supabase:マネージド Supabase アプリケーションを作成します。

  • raycluster:マネージド Ray Cluster アプリケーションを作成します。

  • polarclaw:マネージド PolarClaw アプリケーションを作成します。

supabase

DBClusterId

string

任意

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

pc-**************

RegionId

string

任意

リージョン。デフォルト値はインスタンスのリージョンです。

cn-beijing

ZoneId

string

任意

ゾーン。デフォルト値はインスタンスのプライマリゾーンです。

cn-beijing-k

VSwitchId

string

任意

vSwitch。デフォルト値はインスタンスのプライマリゾーンにある現在の 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

任意

アプリケーションの子コンポーネント。

ComponentType

string

任意

子コンポーネントのタイプ。

supabase の場合、有効な値は次のとおりです:

  • gateway

  • backend

raycluster の場合、有効な値は次のとおりです:

  • head

  • worker

  • gpuworker

gateway

ComponentClass

string

任意

子コンポーネントの仕様。

polar.app.g2.medium

ComponentReplica

integer

任意

子コンポーネントのレプリカ数。デフォルト値は 1 です。

1

SecurityIPList

string

任意

子コンポーネントの IP アドレスホワイトリスト。複数の IP アドレスはコンマ (,) で区切ります。

127.0.0.1

SecurityIPType

string

任意

子コンポーネントのホワイトリスト内の IP アドレスのタイプ。デフォルト値は ipv4 です。

ipv4

SecurityIPArrayName

string

任意

子コンポーネントの IP アドレスホワイトリストグループの名前。デフォルト値は default です。

default

SecurityGroups

string

任意

子コンポーネントのセキュリティグループ。複数のセキュリティグループ ID はコンマ (,) で区切ります。

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

ComponentMaxReplica

integer

任意

同じ仕様を持つ子コンポーネントの最大数。デフォルト値は ComponentReplica の値です。

  • このパラメーターは raycluster でのみサポートされています。

1

ScaleMin

string

任意

スケーリングのためのコンポーネントレプリカの最小数。

1

ScaleMax

string

任意

スケーリングのためのコンポーネントレプリカの最大数。

16

PayType

string

任意

課金方法。

Postpaid

AutoRenew

boolean

任意

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

true

Period

string

任意

サブスクリプション期間のタイプ。

Year

UsedTime

string

任意

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

1

ResourceGroupId

string

任意

リソースグループの ID。

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

DryRun

boolean

任意

デフォルト値は `false` です。このパラメーターを `true` に設定すると、システムは実際のリソースを作成せずに、パラメーターとリソースのみをチェックします。

false

PolarFSInstanceId

string

任意

PolarFileSystem (PolarFS) のコールドストレージまたは高性能インスタンスの ID。このパラメーターはデフォルトでは空です。このパラメーターを指定すると、対応するストレージがアプリケーションにマウントされます。

この機能は現在、次のアプリケーションでのみサポートされています:

  • supabase

  • raycluster

pcs-********************

VpcId

string

任意

Virtual Private Cloud (VPC) の ID。

vpc-********************

AutoCreatePolarFs

boolean

任意

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

  • false (デフォルト):インスタンスを自動的に作成しません。

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

false

AutoUseCoupon

boolean

任意

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

  • true (デフォルト):クーポンを使用します。

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

true

PromotionCode

string

任意

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

727xxxxxx934

SecurityGroupId

string

任意

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

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

MemApplicationSpec

object

任意

このパラメーターは mem0 アプリケーションに必要です。

LlmModel

string

任意

このパラメーターは mem0 アプリケーションに必要です。qwen3-max などの大規模言語モデル (LLM) の名前を指定します。

qwen3-max

EmbedderModel

string

任意

このパラメーターは mem0 アプリケーションに必要です。text-embedding-v4 などのエンベッダーモデルの名前を指定します。

text-embedding-v4

RerankerModel

string

任意

このパラメーターは mem0 アプリケーションに必要です。qwen3-rerank などのリランカーモデルの名前を指定します。

qwen3-rerank

ProjectName

string

任意

プロジェクト名。これは、プロジェクトデータが格納されるデータベース内のスキーマに対応します。

test-project-name

DbName

string

任意

データベースの名前。

test-database-name

DbUser

string

任意

ユーザー名。

test-user

DbPassword

string

任意

パスワード。

test-user-password

GraphLlmModel

string

任意

グラフ LLM。

qwen-plus

EmbedderModelDimension

integer

任意

ベクトル次元。

1024

Shard

integer

任意

シャードテーブルの数。

1

KnowledgeApplicationSpec

object

任意

このパラメーターはナレッジアプリケーションに必要です。

LlmModel

string

任意

このパラメーターはナレッジアプリケーションに必要です。qwen3-max などの LLM の名前を指定します。

DbPassword

string

任意

パスワード。

DashboardPassword

string

任意

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

ModelFrom

string

任意

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

  • bailian:Alibaba Cloud 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 (Elastic IP Address) を自動的に作成してバインドするかどうかを指定します。

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

レスポンスフィールド

フィールド

説明

object

応答のスキーマ

ResourceAvailable

boolean

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

true

ApplicationId

string

アプリケーションの ID。

pa-********************

Description

string

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

myapp

Components

array<object>

子コンポーネントのリスト。

object

子コンポーネント。

ComponentId

string

子コンポーネントの ID。

pac-********************

OrderId

string

生成された注文の ID。

2148126708*****

RequestId

string

リクエストの ID。

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

ResourceGroupId

string

リソースグループの ID。

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

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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