调用CreateService创建服务-阿里云帮助中心

调试

您可以在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.	服务名字已经被使用

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