创建服务。

调试

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

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

POST /services/save HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
Object Body 否

A short description of struct
serviceDescription String Body 否 服务描述

服务描述
serviceName String Body 是 服务名字

服务名字
clientToken String Body 否 C4BE3837-1A13-413B-A225-2C88188E8A43

幂等号

返回数据

名称 类型 示例值 描述
requestId String C4BE3837-1A13-413B-A225-2C88188E8A43

Id of the request
data Object

服务ID
serviceId Long 1

服务ID

示例

请求示例

POST /services/save HTTP/1.1
Host:gemp.cn-shanghai.aliyuncs.com
Content-Type:application/json

{
  "serviceDescription" : "服务描述",
  "serviceName" : "服务名字",
  "clientToken" : "C4BE3837-1A13-413B-A225-2C88188E8A43"
}

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateServiceResponse>
    <requestId>C4BE3837-1A13-413B-A225-2C88188E8A43</requestId>
    <data>
        <serviceId>1</serviceId>
    </data>
</CreateServiceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "requestId" : "C4BE3837-1A13-413B-A225-2C88188E8A43",
  "data" : {
    "serviceId" : 1
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 AddServiceFail Failed to add the service. 添加服务失败
400 ServiceNameAlreadyExisted The service name is already in use. 服务名字已经被使用

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

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