调用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
}

错误码

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