创建集群
该接口用于创建集群。
- 针对创建集群白名单中的用户。
请求结构
POST /v{version}/clusters HTTP/1.1
Host: kafka-api.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| name | String | 是 | Request Body参数 | 集群名称 |
| mode | String | 是 | Request Body参数 | 部署模式， HP、HA |
| type | String | 是 | Request Body参数 | 部署类型，PROVISIONED、SERVERLESS |
| provisioned | Provisioned | 是 | Request Body参数 | provisioned 集群类型的参数，参见Provisioned |
| tags | List<Tag> | 否 | Request Body参数 | 标签列表 |
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| clusterId | String | 集群ID |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 描述 |
|---|---|---|---|
| ERROR_PARAMS | 请求参数错误 | 400 | 请求参数错误 |
| CLUSTER_NOT_FOUND | 集群重名 | 400 | 集群重名 |
| IMAGE_NOT_FOUND | 未找到镜像 | 451 | 未找到镜像 |
| RESOURCE_FAILED | 资源达到上限 | 451 | 资源达到上限 |
| STOCK_FAILED | 库存不足 | 451 | 库存不足 |
| RESOURCE_NOT_FOUND | 资源已下架 | 451 | 资源已下架 |
| INTERNAL_ERROR | 服务内部错误 | 500 | 服务内部错误 |
请求示例
POSt http://kafka-api.bj.baidubce.com/v2/clusters
Authorization: bce-auth-v1/ALTAKaiKeDfBD880eMWBE5oIGE/2023-05-08T11:43:45Z/1800/host;x-bce-date/322f3f98ce57d296c0f5abc64e5554b640ea035c5cb462fcaeab54b9810a3c61
Host: kafka-api.bj.baidubce.com
{
"name": "demo",
"mode": "HP",
"type": "PROVISIONED",
"provisioned": {
"kafkaVersion": "2.7.2",
"nodeType": "kafka.g4.c2m8",
"configMeta": {
"configId": null,
"revisionId": null,
"context": {
"log.retention.hours":"24"
}
},
"numberOfBrokerNodes": 3,
"storageMeta": {
"storageType": "ENHANCED_SSD_PL1",
"storageSize": 100,
"numberOfDisk": 1
},
"storagePolicyEnabled": true,
"storagePolicy": {
"type": "AUTO_DELETE",
"autoDelete": {
"diskUsedThresholdPercent": 75,
"logMinRetentionMs": 3600000,
"logMinRetentionBytes": 2147483648
}
},
"deploySetEnabled": false,
"billing": {
"payment": "Prepaid",
"timeLength":1,
"timeUnit":"month",
"autoRenewEnabled": true,
"autoRenewTimeLength": 1,
"autoRenewTimeUnit": "month",
"couponIds":[
"xxxxx"
],
"isAutoPay": true,
},
"vpcId": "vpc-tf3xqatke54b",
"subnetIds": [
"sbn-12kruawmu30u"
],
"publicIpEnabled": false,
"publicIpBandwidth": 0,
"intranetIpEnabled": false,
"aclEnabled": true,
"authentications": [
{
"mode": "NONE"
}
]
},
"tags": [
{
"tagKey": "KAFKA-Cluster",
"tagValue": ""
}
]
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 97e6d4ad-6fca-4609-ad4d-9a27c4d1a362
Date: Mon, 08 May 2023 09:39:11 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"clusterId": "33a168bb70c0459787416077114ab233"
}