调用InsertDeployGroup来创建应用部署分组。

调试

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

请求头

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

请求语法

POST /pop/v5/deploy_group HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
AppId String 3616cdca-4f92-4413-***********

应用ID

GroupName String test

分组名称,支持的最大长度为64字符。

InitPackageVersionId String 441beb18-da42-44dc-****-****

部署分组关联的初始化部署包版本ID,请调用接口ListHistoryDeployVersion获取,详情请参见ListHistoryDeployVersion

返回数据

名称 类型 示例值 描述
Code Integer 200

接口状态或POP错误码

DeployGroupEntity Struct

创建的分组信息

AppId String 3616cdca-4f92-4413-***********

分组ID

AppVersionId String ****f4c50-16ee-a02b-667*****

应用部署版本ID。

  • 如果应用部署过,则返回一串随机数。
  • 如果应用未部署,则返回值为空。
ClusterId String 0d247b93-8d62-4e34***********

集群ID

CreateTime Long 1573627695779

创建时间

GroupName String test

分组名称

GroupType Integer 1

分组类型:

  • 0:默认分组
  • 1:流量管理没有启用灰度
  • 2:流程管理启用灰度
Id String 577f4c50-16ee-43d8-a02b-667*********

分组ID

PackageVersionId String ****7b93-8d62-4e34***********

该分组部署包的版本ID。

  • 如果应用在该部署分组部署过,则返回一串随机数。
  • 如果应用未在该部署分组部署过,则返回值为空。
UpdateTime Long 1573627695779

更新时间

Message String success

附加信息

RequestId String 3RD9-D3FRE****************

请求ID

示例

请求示例

POST /pop/v5/deploy_group HTTP/1.1
公共请求头
{
  "AppId": ""
  "GroupName": ""
}

正常返回示例

XML 格式

<Message>success</Message>
<DeployGroupEntity>
    <GroupType>1</GroupType>
    <GroupName>test</GroupName>
    <ClusterId>0d247b93-8d62-4e34***************</ClusterId>
    <PackageVersionId/>
    <CreateTime>1573627695779</CreateTime>
    <AppId>3616cdca-4f92-4413-***********</AppId>
    <UpdateTime>1573627695779</UpdateTime>
    <Id>577f4c50-16ee-43d8-a02b-667*********</Id>
    <AppVersionId/>
</DeployGroupEntity>
<Code>200</Code>

JSON 格式

{
	"Message": "success",
	"DeployGroupEntity": {
		"GroupType": 1,
		"GroupName": "test",
		"ClusterId": "0d247b93-8d62-4e34***************",
		"PackageVersionId": "",
		"CreateTime": 1573627695779,
		"AppId": "3616cdca-4f92-4413-***********",
		"UpdateTime": 1573627695779,
		"Id": "577f4c50-16ee-43d8-a02b-667*********",
		"AppVersionId": ""
	},
	"Code": 200
}

错误码

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