创建部署资源。 ## 请求说明为获得低延迟，建议您根据资源所在的地域选择对应的服务地址，详情参见 [服务地址](https://www.volcengine.com/docs/6461/1802289)。 * 请求方式：POST * 请求地址：https://cp.cn\-beijing.volcengineapi.com?Action=CreateDeployResource&Version=2023\-05\-01 ## 调试去调试 ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |CreateDeployResource |接口名称。当前 API 的名称为 `CreateDeployResource`。 | |Version |String |是 |2023\-05\-01 |接口版本。当前 API 的版本为 `2023-05-01`。 | |Name |String |是 |production\-cluster |部署资源的名称，用于标识和区分不同的部署资源。 | |Source |String |是 |VKE |部署资源的来源，取值：|\ | | | | ||\ | | | | |* `VKE`：火山引擎容器服务集群。|\ | | | | |* `K8S`：自建或第三方 Kubernetes 集群。 | |VkeClusterId |String |否 |cc5silumrsfekhkr\*\*\*\* |当部署资源来源为 `VKE` 时，需指定对应的火山引擎容器服务集群 ID。默认值为空字符串。 | |Kubeconfig |String |否 |YXBpVmVyc\*\*\*\*Tl2ZENKOS4= |当部署资源来源为 `K8S` 时，需指定部署资源的基于 base64 编码的 Kubeconfig 信息。 | |Region |String |否 |cn\-beijing |部署资源对应集群所属的地域。 | |Description |String |否 |Kubernetes cluster deployment resource for production environment |部署资源的描述信息，用于说明该资源的用途或特性。 | |OnlyForSpecifiedWorkspaces |Boolean |否 |false |标识该部署资源是否仅对指定的工作区开放。取值： |\ | | | | ||\ | | | | |* true：表示仅对指定的工作区开放，需配合 SpecifiedWorkspaceIds 参数指定允许访问的工作区 ID 列表。 |\ | | | | |* false：（默认值）表示对所有工作区开放。 | |SpecifiedWorkspaceIds |Array of String |否 |["18be9\*\*\*\*\*a1aca409f5e19c\*\*\*\*"] |当 `OnlyForSpecifiedWorkspaces` 为 `true` 时，需指定允许访问该部署资源的工作区 ID 列表。 | |Identifier |String |否 |deploy\-resource\-123 |部署资源的唯一标识符，用于在系统中唯一标识该资源。 | ## 请求示例 ```JSON POST https://cp.cn-beijing.volcengineapi.com?Action=CreateDeployResource&Version=2023-05-01 HTTP/1.1 Content-Type: application/json { "Name": "production-cluster", "Source": "VKE", "VkeClusterId": "cc5silumrsfekhkr****", "Kubeconfig": "YXBpVmVyc****Tl2ZENKOS4=", "Region": "cn-beijing", "Description": "Kubernetes cluster deployment resource for production environment", "OnlyForSpecifiedWorkspaces": true, "SpecifiedWorkspaceIds": [ "18be9*****a1aca409f5e19c****" ], "Identifier": "deploy-resource-123" } ``` ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Id |String |18be9\*\*\*\*\*a1aca409f5e19c\*\*\*\* |部署资源的唯一标识 ID，用于标识创建的部署资源。 | ## 返回示例 ```JSON HTTP/1.1 200 OK Content-Type: application/json { "ResponseMetadata": { "RequestId": "20230604110420****10023228002****", "Action": "CreateDeployResource", "Version": "2023-05-01", "Service": "cp", "Region": "cn-beijing" }, "Result": { "Id": "18be9*****a1aca409f5e19c****" } } ``` ## 错误码当前接口暂无独立错误码，若接口调用返回异常，可参考 [公共错误码](https://www.volcengine.com/docs/6461/1271177) 进行故障排查。

持续交付