CreateService - 创建服务

更新时间: 2023-09-27 13:46:01

创建新的服务。

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
computenestsupplier:CreateServiceWrite
  • Service
    acs:computenestsupplier:{#regionId}:{#accountId}:service/*

请求参数

名称类型必填描述示例值
RegionIdstring

地域ID。

cn-hangzhou
ClientTokenstring

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

10CM943JP0EN9D51H
ServiceIdstring

服务ID。

service-0e6fca6a51a544xxxxxx
DeployTypestring

部署类型。可能值:

  • ros:通过ROS部署。

  • terraform:通过Terraform部署。

  • ack:通过ACK部署。

  • spi:调用SPI部署。

  • operation:代运维服务部署。

ros
DeployMetadatastring

存储服务部署配置的信息。存储的信息与部署类型有关,不同的部署类型存储的数据格式不一样,因此使用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}}]}]}
ServiceTypestring

服务类型。可能的值:

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

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

  • operation:代运维服务实例

  • poc:试用服务实例。

private
ServiceInfoobject []

服务详情。

Localestring

服务语言。可能的值:

  • zh-CN:中文。

  • en-US:英文。

zh-CN
ShortDescriptionstring

服务概述。

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

服务图标地址。

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

服务名称。

TiDB Database
LongDescriptionUrlstring

服务详细描述

http://description.tidb.oss.url
IsSupportOperatedboolean

是否代运维,默认为:false。可能的值:

  • true:开启。

  • false:关闭。

说明 ServiceTypeprivate时需要填入该值。
false
PolicyNamesstring

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

policyName1, policyName2
Durationlong

代运维时间。单位:秒。

0
AlarmMetadatastring

服务报警配置。

说明 PolicyNames中配置了报警权限策略后,该配置才会生效。
{ "TemplateUrl": "http://template.file.url", // 应用分组级别告警元数据 "ApplicationGroups": [ { "Name": "applicationGroup1", "TemplateUrl": "url1" }, { "Name": "applicationGroup2", "TemplateUrl": "url2" } ] }
ShareTypestring

共享类型。可能的值:

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

  • Restricted:受限的,正式部署和试用部署都受限。

  • OnlyFormalRestricted:仅正式部署受限。

  • OnlyTrailRestricted:仅试用部署受限。

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

Public
ApprovalTypestring

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

  • Manual:收到审批。

  • AutoPass:自动通过。

Manual
VersionNamestring

版本名称。

Draft
UpgradeMetadatastring

升级元数据。

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

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

7
Tagobject []

用户自定义标签。

Keystring

标签键。

Usage
Valuestring

标签值。

Web
TenantTypestring

租户类型。可能的值:

  • SingleTenant:单租户。

  • MultiTenant:多租户。

SingleTenant
LicenseMetadatastring

许可证元数据。

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

代运维配置。

{\"PrometheusConfigMap\":{\"New_Vpc_Ack_And_Jumpserver\":{}}}
ResourceGroupIdstring

资源组ID。

rg-aek25refu7r3opq
LogMetadatastring

应用日志配置。

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

返回参数

名称类型描述示例值
object
Statusstring

服务状态。

Created
RequestIdstring

请求ID。

4DB0F536-B3BE-4F0D-BD29-E83FB56D550C
Versionstring

服务版本。

draft
ServiceIdstring

服务ID。

service-0e6fca6a51a544xxxxxx

示例

正常返回示例

JSON格式

{
  "Status": "Created",
  "RequestId": "4DB0F536-B3BE-4F0D-BD29-E83FB56D550C",
  "Version": "draft",
  "ServiceId": "service-0e6fca6a51a544xxxxxx"
}

错误码

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

变更历史

变更时间变更内容概要操作
2023-09-15OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:Resellable
2023-08-11OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:SourceServiceId
    新增入参:SourceServiceVersion
2023-08-03OpenAPI 描述信息更新,OpenAPI 入参发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
入参OpenAPI 入参发生变更
    新增入参:LogMetadata
2023-05-25API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2023-05-08OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:ResourceGroupId
2022-07-27OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:TenantType
2022-07-22新增 OpenAPI看变更集
2021-12-15OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:ShareType
2021-09-22OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:RequestTags
阿里云首页 计算巢服务 相关技术圈