调用CreateServiceInstance创建并部署服务实例_计算巢服务(Compute Nest)-阿里云帮助中心

通过配置地域ID、服务实例名称、服务 ID等参数，在计算巢中创建并部署服务实例。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
computenest:CreateServiceInstance	create	ServiceInstance `acs:computenest:{#regionId}:{#accountId}:serviceinstance/`	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。可能的值： cn-hangzhou：华东 1（杭州）。 ap-southeast-1：新加坡。	cn-hangzhou
Name	string	否	服务实例名称。格式要求如下：长度不超过 64 个字符。必须以数字或英文字母开头，可包含数字、英文字母、短划线（-）和下划线（_）。	TestName
ServiceId	string	是	服务 ID。	service-0e6fca6a51a54420****
ServiceVersion	string	否	服务版本。	1
Parameters	object	否	用户实例部署的参数。说明若服务实例包含部署地域信息，需在部署参数中填写。	{ "RegionId": "cn-hangzhou" "NodeCount": 3, "SystemDiskSize": 40, "InstancePassword": "******" }
ClientToken	string	否	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符，且不能超过 64 个字符。	123e4567-e89b-12d3-a456-426655440000
EnableInstanceOps	boolean	否	服务实例是否有代运维功能。取值范围： true：服务实例有代运维功能。 false：服务实例没有代运维功能。	true
TemplateName	string	否	模板名称，服务支持多模板时需要指定模板名称。	模板1
OperationMetadata	object	否	代运维配置。
StartTime	string	否	运维开始时间，只在纯代运维模式下有效。	2021-12-29T06:48:56Z
EndTime	string	否	运维结束时间，只在纯代运维模式下有效。	2022-01-28T06:48:56Z
Resources	string	否	导入的资源列表。	{ "RegionId": "cn-hangzhou", "Type": "ResourceIds", "ResourceIds": { "ALIYUN::ECS::INSTANCE": ["i-xxx", "i-yyy"], "ALIYUN::RDS::INSTANCE": ["rm-xxx", "rm-yyy"], "ALIYUN::VPC::VPC": ["vpc-xxx", "vpc-yyy"], "ALIYUN::SLB::INSTANCE": ["lb-xxx", "lb-yyy"] } }
ServiceInstanceId	string	否	导入的服务实例 ID。	si-d6ab3a63ccbb4b17****
ExtraInfo	string	否	代运维服务附加信息。	```json { "vncInfo": [ { "instanceId": "i-001", "username": "admin", "password": "****", "vncPassword": "****" } ] } ```
ResourceGroupId	string	否	资源组 ID。	rg-bp67acfmxazb4p****
ContactGroup	string	否	接收告警的云监控联系人组。	云账号报警联系人
TrialType	string	否	当前服务实例的类型。可选值： Trial：支持试用。 NotTrial：不支持试用。	Trial
Tag	array<object>	否	用户自定义标签。
	object	否	用户自定义标签。
Key	string	否	标签键。	key1
Value	string	否	标签值。	value1
SpecificationName	string	否	套餐规格名称。	套餐一
DryRun	boolean	否	是否对此次创建请求执行预检，包括权限、实例状态校验等。可能的值： true：发送请求，不创建服务实例。 false：发送请求，检查通过后创建服务实例。	false
SpecificationCode	string	否	商品规格码。	yuncode5425200001
EnableUserPrometheus	boolean	否	是否启用 Prometheus 监控，可能的值： true：启用。 false：不启用。	true
Commodity	object	否	云市场购买订单信息，服务未上云市场或按量计费不必传。
PayPeriodUnit	string	否	购买时间单位，取值： Year：年。 Month：月。 Day：日。	Year
PayPeriod	long	否	购买时间长度。	1
AutoRenew	boolean	否	是否开启自动续费，取值： true：开启。 false：不开启。	false
AutoPay	boolean	否	订单是否自动支付。取值： true：自动支付。 false：不自动支付。	false
CouponId	string	否	优惠券 ID。	302070970220
ResourceAutoPay	boolean	否	资源是否自动从余额中扣款支付。取值： true：自动支付。 false：不自动支付。	true

返回参数

名称	类型	描述	示例值
	object
Status	string	服务实例状态。取值： Created：已创建。 Deploying：部署中。 DeployedFailed：部署失败。 Deployed：已部署。 Upgrading：升级中。 Deleting：删除中。 Deleted：已删除。 DeletedFailed：删除失败。	Created
RequestId	string	请求 ID。	4DB0F536-B3BE-4F0D-BD29-E83FB56D****
ServiceInstanceId	string	服务实例 ID。	si-d6ab3a63ccbb4b17****
MarketInstanceId	string	云市场实例 ID。	786***45
OrderId	string	订单 ID。	2306175xxxxxxxx

示例

正常返回示例

JSON格式

{
  "Status": "Created",
  "RequestId": "4DB0F536-B3BE-4F0D-BD29-E83FB56D****",
  "ServiceInstanceId": "si-d6ab3a63ccbb4b17****",
  "MarketInstanceId": "786***45",
  "OrderId": "2306175xxxxxxxx"
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-07-25	API 内部配置变更，不影响调用	查看变更详情
2024-07-01	OpenAPI 入参发生变更	查看变更详情
2024-03-19	OpenAPI 入参发生变更	查看变更详情
2024-02-23	OpenAPI 入参发生变更、OpenAPI 返回结构发生变更	查看变更详情
2024-02-02	OpenAPI 入参发生变更	查看变更详情
2024-02-01	OpenAPI 入参发生变更	查看变更详情
2023-06-06	OpenAPI 入参发生变更	查看变更详情
2023-03-24	OpenAPI 入参发生变更、OpenAPI 返回结构发生变更	查看变更详情
2022-07-21	OpenAPI 入参发生变更	查看变更详情
2021-09-22	OpenAPI 入参发生变更	查看变更详情