すべてのプロダクト
Search

このプロダクト

    PolarDB:CreatePolarFs

    ドキュメントセンター

    PolarDB:CreatePolarFs

    最終更新日:Sep 24, 2026

    PolarFS サポートを有効にします。

    今すぐお試しください

    この 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:CreatePolarFs

    create

    *LakeCache。

    acs:polardb:{#regionId}:{#accountId}:lakecache/*

    		 なし なし

    リクエスト構文

    POST  HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    リージョン ID。

    説明

    DescribeRegions 操作を呼び出し、リージョン ID をクエリできます。

    cn-beijing
    StorageType

    string

    任意

    高性能ストレージタイプの有効な値:

    • ESSDPL0

    • ESSDPL1

    Basic Edition ストレージタイプの有効な値:

    • city_redundancy (ゾーン冗長)

    コールドストレージエディションのストレージタイプの有効な値:

    • city_redundancy (ゾーン冗長)

    • local_redundancy (ローカル冗長)

    列挙値:

    • ESSDPL0 :

      ESSDPL0

    • ESSDPL1 :

      ESSDPL1

    • city_redundancy :

      ゾーン冗長。

    • local_redundancy :

      ローカル冗長。

    local_redundancy
    AuthorizedUserIds

    string

    任意

    コールドストレージエディションインスタンスの認可済みアカウント ID のリスト。カンマ (,) で区切ります。

    128***********，198***********
    DBType

    string

    任意

    データベースエンジン。有効な値:

    • MySQL

    • PostgreSQL

    列挙値:

    • PostgreSQL :

      polardb_pg。

    • MySQL :

      polardb_mysql。

    MySQL
    VPCId

    string

    任意

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

    vpc-*******************
    VSwitchId

    string

    任意

    vSwitch の ID。

    vsw-*********************
    ZoneId

    string

    任意

    ゾーン ID。

    cn-beijing-i
    StorageSpace

    integer

    任意

    ストレージスペース。単位: GB。

    50
    DBClusterId

    string

    任意

    クラスター ID。

    pc-**************
    PayType

    string

    任意

    課金方法。有効な値:

    • Postpaid: 従量課金。

    • Prepaid: サブスクリプション。

    列挙値:

    • Prepaid :

      サブスクリプション。

    • Postpaid :

      従量課金。

    Postpaid
    Period

    string

    任意

    サブスクリプション期間の単位。PayType が Prepaid にセットされている場合、このパラメーターは必須です。サブスクリプションクラスターで年単位または月単位の課金サイクルを使用するかどうかを指定します。有効な値:

    • Year: サブスクリプション期間は年単位です。

    • Month: サブスクリプション期間は月単位です。

    列挙値:

    • Month :

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

    • Year :

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

    Month
    UsedTime

    string

    任意

    サブスクリプション期間。PayType が Prepaid にセットされている場合、このパラメーターは必須です。

    • Period が Month にセットされている場合、UsedTime の有効な値は [1-9] の有効値の整数です。

    • Period が Year にセットされている場合、UsedTime の有効な値は [1-3] の有効値の整数です。

    1
    AutoRenew

    boolean

    任意

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

    • true: 自動更新が有効になります。

    • false: 自動更新が無効になります。

    デフォルト値: false。

    説明

    このパラメーターは、PayType が Prepaid にセットされている場合にのみ効果があります。

    true
    AccelerateSwitch

    string

    任意

    アクセラレーションモード。有効な値:

    • ONLY: アクセラレーションのみを有効にします。

    • ON: コールドデータストレージとアクセラレーションを有効にします。

    ONLY
    AccelerateStorageSize

    integer

    任意

    アクセラレーションが有効な Basic Edition のアクセラレーションストレージスペース。単位: GB。

    500
    CreationCategory

    string

    任意

    エディション。有効な値:

    • basic: Basic Edition (デフォルト)。

    • cold: コールドストレージエディション。

    • high_performance: 高性能エディション。

    basic
    CustomBucketCount

    integer

    任意

    バケット数。

    説明

    このパラメーターは、アクセラレーション (ファイルシステムアクセラレーション) が有効な場合にのみ必須です。

    1
    CustomBucketPath

    string

    任意

    バケットパス。

    説明

    このパラメーターは、アクセラレーション (ファイルシステムアクセラレーション) が有効な場合にのみ必須です。

    /test
    CustomOssAk

    string

    任意

    カスタム AccessKey ID。

    xxx
    CustomOssSk

    string

    任意

    カスタム AccessKey Secret。

    xxx
    AutoUseCoupon

    boolean

    任意

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

    • true: クーポンが自動的に使用されます (デフォルト)。

    • false: クーポンは使用されません。

    true
    PromotionCode

    string

    任意

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

    727xxxxxx934
    AccelerateType

    string

    任意

    アクセラレーションタイプ。有効な値:

    • juice: ファイルシステムアクセラレーション。

    • alluxio: 透明なアクセラレーション。

    alluxio
    CustomBucketPathList

    array<object>

    任意

    バケットおよびパス情報。

    説明

    このパラメーターは、透明なアクセラレーションシナリオで必須です。

    object

    任意

    バケットおよびパス情報。

    Bucket

    string

    任意

    カスタムストレージバケット。

    pfs-xxx.oss-[regionId]-internal.aliyuncs.com
    Path

    string

    任意

    カスタムストレージパス。

    /data

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマ。

    RequestId

    string

    リクエスト ID。

    CED079B7-A408-41A1-BFF1-EC608E******
    PolarFsPath

    string

    PolarFS ファイルシステムパス。

    pfs-xxx*******
    PolarFsStatus

    string

    PolarFS インスタンスステータス。

    Creating
    OrderId

    string

    注文 ID。

    2035638*******
    PolarFsInstanceId

    string

    PolarFS インスタンス ID。

    pfs-2ze0i74ka607wck3

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "CED079B7-A408-41A1-BFF1-EC608E******",
  "PolarFsPath": "pfs-xxx*******",
  "PolarFsStatus": "Creating",
  "OrderId": "2035638*******",
  "PolarFsInstanceId": "pfs-2ze0i74ka607wck3"
}

    エラーコード

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

    変更履歴

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