全部产品
Search

搜索本产品

    云原生数据库 PolarDB：CreatePolarFs - 创建PolarFs集群

    文档中心

    云原生数据库 PolarDB：CreatePolarFs - 创建PolarFs集群

    更新时间：Aug 05, 2026

    开启polarfs支持。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    当前API暂无授权信息透出。

    请求语法

    POST  HTTP/1.1

    请求参数

    名称

    类型

    必填

    描述

    示例值
    RegionId

    string

    是

    地域 ID。

    说明

    您可以通过接口 DescribeRegions 查看地域 ID 详情。

    cn-beijing
    StorageType

    string

    否

    高性能存储类型取值如下：

    • ESSDPL0

    • ESSDPL1

    基础版存储类型取值如下：

    • city_redundancy(同城冗余)

    冷存版存储类型取值如下：

    • city_redundancy(同城冗余)

    • local_redundancy (本地冗余)

    枚举值：

    • ESSDPL0 :

      ESSDPL0

    • ESSDPL1 :

      ESSDPL1

    • city_redundancy :

      city_redundancy

    • local_redundancy :

      local_redundancy

    local_redundancy
    AuthorizedUserIds

    string

    否

    冷存版实例授权账号列表，用,分隔

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

    string

    否

    所属数据库生态，取值范围如下：

    • MySQL

    • PostgreSQL

    枚举值：

    • PostgreSQL :

      polardb_pg

    • MySQL :

      polardb_mysql

    MySQL
    VPCId

    string

    否

    专有网络 ID。

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

    string

    否

    虚拟交换机 ID。

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

    string

    否

    可用区 id。

    cn-beijing-i
    StorageSpace

    integer

    否

    存储空间，单位 GB。

    50
    DBClusterId

    string

    否

    集群 ID。

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

    string

    否

    付费类型，取值范围如下：

    • Postpaid：按量付费

    • Prepaid：预付费（包年包月）

    Postpaid
    Period

    string

    否

    若付费类型为 Prepaid 时，该参数为必传参数。指定预付费集群为包年或包月类型。

    • Year：包年。即选择包年包月时，单位为年。

    • Month：包月。即选择包年包月时，单位为月。

    Month
    UsedTime

    string

    否

    若付费类型为 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

    否

    加速空间，基础班开启加速，单位 GB。

    500
    CreationCategory

    string

    否

    产品系列，取值范围如下：

    • basic：基础版（默认值）

    • cold：冷存版

    • high_performance：高性能版

    basic
    CustomBucketCount

    integer

    否

    Bucket 数量。

    说明

    仅开启加速（文件系统加速）场景必填

    1
    CustomBucketPath

    string

    否

    bucket 路径。

    说明

    仅开启加速（文件系统加速）场景必填

    /test
    CustomOssAk

    string

    否

    自定义 ak

    xxx
    CustomOssSk

    string

    否

    自定义 sk

    xxx
    AutoUseCoupon

    boolean

    否

    是否自动使用优惠券，取值范围如下：

    • true：使用优惠券（默认值）。

    • false：不使用优惠券。

    true
    PromotionCode

    string

    否

    优惠券编号，不填时使用默认优惠券

    727xxxxxx934
    AccelerateType

    string

    否

    加速类型，取值为范围如下：

    • juice：文件系统加速。

    • alluxio：透明加速。

    alluxio
    CustomBucketPathList

    array<object>

    否

    Bucket 及对应路径信息。

    说明

    透明加速场景必填

    object

    否

    bucket 及对应路径信息

    Bucket

    string

    否

    自定义存储 bucket

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

    string

    否

    自定义存储 path

    /data

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    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

    示例

    正常返回示例

    JSON格式

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

    错误码

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。