CreateDedicatedHost_云数据库专属集群_API文档

2020-03-20

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

cddc:CreateDedicatedHost	Create	全部资源 *	无	无

请求参数

字段名称	字段详情
DedicatedHostGroupIdstring	目标集群 ID。通过云数据库专属集群控制台集群列表查看目标集群 ID。展开详情示例值:dhg-6w7q18iwt5jo****参考取值来源: CreateDedicatedHostGroup DescribeDedicatedHostGroups
HostClassstring	主机的规格。关于不同数据库类型支持的主机规格，详情请参见主机规格详情。示例值:rds.g6.4xlarge参考取值来源: DescribeDedicatedHosts
PayTypestring	主机的付费类型。取值为 prepaid（包年包月）。示例值:prepaid
Periodstring	指定主机的预付费类型。取值：展开详情示例值:Month
UsedTimestring	指定购买时长。取值：展开详情示例值:1
ClientTokenstring	客户端生成该参数值，用于保证请求的幂等性，防止重复提交请求。该参数值只能包含 ASCII 字符，且不超过 64 个 ASCII 字符。示例值:ETnLKlblzczshOTUbOCzSBZH8****
AutoRenewstring	是否开启自动续费功能。取值：展开详情示例值:false
ImageCategorystring	主机镜像。取值：展开详情示例值:AliLinux
OsPasswordstring	主机密码。仅集群类型为私有部署集群时，支持创建主机密码。密码需符合如下要求：展开详情示例值:Test123456
HostStorageTypestring	主机磁盘类型，仅针对 Tair 类型主机生效，当前只支持以下两种类型：展开详情示例值:cloud_essd0枚举值:cloud_essd0cloud_essd
HostStoragestring	主机磁盘大小，仅针对 Tair 类型主机生效，取值范围是（单位 GB）：展开详情示例值:512参考取值来源: DescribeDedicatedHosts
RegionIdstring	主机所在集群的地域 ID。示例值:cn-hangzhou参考取值来源: DescribeRegions
ZoneIdstring	可用区 ID。调用 DescribeRegions 接口查询可用区 ID。示例值:cn-hangzhou-i
VSwitchIdstring	虚拟交换机的 ID，可通过专有网络控制台查看目标虚拟机 ID。示例值:vsw-bp133c8ifzxd3iv6q****
ClusterTypestring	MyBase 开放版使用，创建开放版集群类型：onACK、onECS 示例值:onACK
ClusterAliasstring	MyBase 开放版使用，开放版集群别名示例值:test-on-ack-cluster
VpcIDstring	MyBase 开放版 onECS 集群指定 VPC ID 示例值:vpc-xxxxxx
ClusterServicesarray<string>	MyBase 开放版 onECS 实例关联的服务。
MyBaseEcsClassobject	MyBase 开放版 onECS 实例的参数。

返回参数

字段名称	字段详情
OrderIdinteger<int64>	订单 ID。注意请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。示例值:102565235
RequestIdstring	请求 ID。示例值:C860658E-68A6-46C1-AF6E-3AE7C4D32375
ClusterNamestring	集群名称。示例值:ca-2ze0x527ovq3y****
DedicateHostListobject

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidParameter	The parameter is invalid.	诊断
400	COMMODITY.INVALID_COMPONENT	Invalid component.	诊断
400	InvalidAccountPassword.Format	The account password format is invalid.	诊断
400	InsufficientResourceCapacity	No host is available for the requested instance.	诊断

变更历史

	变更时间	变更内容概要	操作
	2022-07-07	删除请求参数HostName
	2022-01-12	变更请求参数RegionId
	2021-12-13	变更错误码400 变更请求参数RegionId 变更请求参数HostName 变更请求参数Period 变更请求参数UsedTime 变更请求参数AutoRenew 变更请求参数ImageCategory
	2021-11-30	变更错误码400

相关示例