AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 计算巢服务 开发参考 服务商侧API参考 API目录 服务 CreateService - 创建服务

CreateService - 创建服务

更新时间：
产品详情
我的收藏

通过地域ID、部署类型、服务类型、服务名称等参数，创建新的服务

调试

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

调试

授权信息

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

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

computenestsupplier:CreateService

create

*Service

acs:computenestsupplier:{#regionId}:{#accountId}:service/*

 无 无

请求参数

名称

类型

必填

描述

示例值
RegionId

string

是

地域 ID。

cn-hangzhou
ClientToken

string

否

客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

10CM943JP0EN9D51H
ServiceId

string

否

服务 ID。

service-0e6fca6a51a544xxxxxx
DeployType

string

是

部署类型。可能值：

  • ros：通过 ROS 部署。

  • terraform：通过 Terraform 部署。

  • ack：通过 ACK 部署。

  • spi：调用 SPI 部署。

  • operation：代运维服务部署。

ros
DeployMetadata

string

否

存储服务部署配置的信息。存储的信息与部署类型有关，不同的部署类型存储的数据格式不一样，因此使用 JSON String 格式进行数据存储。

{\"TemplateConfigs\":[{\"Name\":\"模板1\",\"Url\":\"oss://computenest-test/template" + ".json?RegionId=cn-beijing\",\"PredefinedParameters\":[{\"Name\":\"低配版\"," + "\"Parameters\":{\"InstanceType\":\"ecs.g5.large\",\"DataDiskSize\":40}},{\"Name\":\"高配版\"," + "\"Parameters\":{\"InstanceType\":\"ecs.g5.large\",\"DataDiskSize\":200}}]}]}
ServiceType

string

否

服务类型。可能的值：

  • private：部署在用户账户下的服务实例。

  • managed：托管在服务商账户下的服务实例。

  • operation：代运维服务实例

  • poc：试用服务实例。

private
ServiceInfo

array<object>

否

服务详情。

array<object>

否

服务详情。

Locale

string

是

服务语言。可能的值：

  • zh-CN：中文。

  • en-US：英文。

zh-CN
ShortDescription

string

否

服务概述。

TiDB是A公司自主设计、研发的开源分布式关系型数据库。
Image

string

否

服务图标地址。

http://img.tidb.oss.url
Name

string

是

服务名称。

TiDB Database
LongDescriptionUrl

string

否

服务详细描述

http://description.tidb.oss.url

Agreements

array<object>

否

服务的协议文档信息。

object

否

服务的协议文档信息。

Name

string

否

协议名称。

Name
Url

string

否

协议链接。

https://aliyun.com/xxxxxxxx.html
Softwares

array<object>

否

服务中用到的软件信息。

object

否

服务中用到的软件信息。

Name

string

否

软件名称。

MySQL
Version

string

否

软件版本。

5.7
IsSupportOperated

boolean

否

是否代运维，默认为：false。可能的值：

  • true：开启。

  • false：关闭。

说明

当 ServiceType 为 private 时需要填入该值。

false
PolicyNames

string

否

策略名称。单个策略名称长度不超过 128 个字符，多个名称使用英文逗号（,）分隔。暂时只支持代运维相关参数策略。

policyName1, policyName2
Duration

integer

否

代运维时间。单位：秒。

0
AlarmMetadata

string

否

服务报警配置。

说明

当 PolicyNames 中配置了报警权限策略后，该配置才会生效。

{ "TemplateUrl": "http://template.file.url", // 应用分组级别告警元数据 "ApplicationGroups": [ { "Name": "applicationGroup1", "TemplateUrl": "url1" }, { "Name": "applicationGroup2", "TemplateUrl": "url2" } ] }
ShareType

string

否

共享类型。可能的值：

  • Public：公开的，正式部署和试用部署都不受限。

  • Restricted：受限的，正式部署和试用部署都受限。

  • OnlyFormalRestricted：仅正式部署受限。

  • OnlyTrailRestricted：仅试用部署受限。

  • Hidden：隐藏的，不可见且不可申请部署权限。

Public
ApprovalType

string

否

服务使用申请审批类型。可能的值：

  • Manual：收到审批。

  • AutoPass：自动通过。

Manual
VersionName

string

否

版本名称。

Draft
UpgradeMetadata

string

否

升级元数据。

{\"Description\":\"xxx\",\"SupportRollback\":true,\"SupportUpgradeFromVersions\":[],\"UpgradeComponents\":[\"Configuration\"]}
TrialDuration

integer

否

试用时长。单位：天。试用时长的最长天数不超过 30 天。

7
Tag

array<object>

否

用户自定义标签。

object

否

用户自定义标签。

Key

string

否

标签键。

Usage
Value

string

否

标签值。

Web
TenantType

string

否

租户类型。可能的值：

  • SingleTenant：单租户。

  • MultiTenant：多租户。

SingleTenant
LicenseMetadata

string

否

许可证元数据。

{\"PayType\":\"CustomFixTime\",\"DefaultLicenseDays\":7,\"CustomMetadata\":[{\"TemplateName\":\"模板1\",\"SpecificationName\":\"bandwith-0\",\"CustomData\":\"1\"}]}
OperationMetadata

string

否

代运维配置。

{\"PrometheusConfigMap\":{\"New_Vpc_Ack_And_Jumpserver\":{}}}
ResourceGroupId

string

否

资源组 ID。

rg-aek25refu7r3opq
LogMetadata

string

否

应用日志配置。

{ "Logstores": [ { "LogstoreName": "access-log", "LogPath": "/home/admin/app/logs", # 对容器不需要，在YAML中配置 "FilePattern": "access.log*" # 对容器不需要，在YAML中配置 } ] }
SourceServiceId

string

否

分销源服务 ID。

service-70a3b15bb62643xxxxxx
SourceServiceVersion

string

否

分销源服务版本。

1
Resellable

boolean

否

是否支持分销。可能的值：

  • false：不支持。

  • true：支持。

false
BuildParameters

string

否

构建服务参数。

{ "ServiceTemplateId": "st-xxxxx"}
DryRun

boolean

否

是否空跑检查。

true
ComplianceMetadata

object

否

合规检查元数据。

CompliancePacks

array

否

选择的合规包。

string

否

选择的合规包。可选值：

  • VpcDataRisk: vpc 内数据安全风险合规包

VpcDataRisk

返回参数

名称

类型

描述

示例值

object

Status

string

服务状态。

Created
RequestId

string

请求 ID。

4DB0F536-B3BE-4F0D-BD29-E83FB56D550C
Version

string

服务版本。

draft
ServiceId

string

服务 ID。

service-0e6fca6a51a544xxxxxx
DryRunResult

object

校验结果。

RolePolicy

object

部署角色的权限策略。

Policy

string

部署角色需要的权限策略。

{ "Statement": [{ "Action": ["oos:CancelExecutions", "oos:DeleteExecutions", "oos:GetTemplate", "oos:ListExecutions", "oos:ListTemplates", "oos:NotifyExecution", "oos:StartExecution"], "Effect": "Allow", "Resource": "*" }, { "Action": ["ram:PassRole"], "Effect": "Allow", "Resource": "*" }, { "Action": ["ros:CreateStack", "ros:GetStack", "ros:UpdateStack", "ros:ListStackEvents", "ros:ListStackResources", "ros:ListStackResources", "ros:DeleteStack", "ram:GetRole"], "Effect": "Allow", "Resource": "*" }], "Version": "1" }
MissingPolicy

array<object>

部署角色缺少的权限策略。

object

部署角色缺少的权限策略。

ServiceName

string

权限策略中的服务名称。

ecs
Resource

string

权限策略中的资源。

*
Action

array

权限策略中的操作。

string

权限策略中的操作。

CreateStack

示例

正常返回示例

JSON格式

{
  "Status": "Created",
  "RequestId": "4DB0F536-B3BE-4F0D-BD29-E83FB56D550C",
  "Version": "draft",
  "ServiceId": "service-0e6fca6a51a544xxxxxx",
  "DryRunResult": {
    "RolePolicy": {
      "Policy": "{\n\t\"Statement\": [{\n\t\t\"Action\": [\"oos:CancelExecutions\", \"oos:DeleteExecutions\", \"oos:GetTemplate\", \"oos:ListExecutions\", \"oos:ListTemplates\", \"oos:NotifyExecution\", \"oos:StartExecution\"],\n\t\t\"Effect\": \"Allow\",\n\t\t\"Resource\": \"*\"\n\t}, {\n\t\t\"Action\": [\"ram:PassRole\"],\n\t\t\"Effect\": \"Allow\",\n\t\t\"Resource\": \"*\"\n\t}, {\n\t\t\"Action\": [\"ros:CreateStack\", \"ros:GetStack\", \"ros:UpdateStack\", \"ros:ListStackEvents\", \"ros:ListStackResources\", \"ros:ListStackResources\", \"ros:DeleteStack\", \"ram:GetRole\"],\n\t\t\"Effect\": \"Allow\",\n\t\t\"Resource\": \"*\"\n\t}],\n\t\"Version\": \"1\"\n}",
      "MissingPolicy": [
        {
          "ServiceName": "ecs",
          "Resource": "*",
          "Action": [
            "CreateStack"
          ]
        }
      ]
    }
  }
}

错误码

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

变更历史

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

上一篇：服务下一篇：DeleteService - 删除服务