可以获取主机组列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
GET /organization/{organizationId}/hostGroups
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| organizationId | string | 是 | 企业标识，也称企业 id，字符串形式，可在云效访问链接中获取，如 https:// devops.aliyun.com/organization/【OrgId】 | 5ebbc0228123212b59xxxxx |
| ids | string | 否 | 主机组 id，多个逗号分割 | 121,1212121232 |
| createStartTime | long | 否 | 主机组创建时间 | 1586863220000 |
| createEndTime | long | 否 | 主机组结束时间 | 1586863220000 |
| name | string | 否 | 主机组名称 | 主机组 |
| creatorAccountIds | string | 否 | 创建阿里云账号 id，多个逗号分割 | 1112122121,3223332 |
| nextToken | string | 否 | 分页 token | 221212221 |
| maxResults | long | 否 | 结果返回个数 | 30 |
| pageSort | string | 否 | 排序条件 ID | ID |
| pageOrder | string | 否 | 排序顺序 DESC 降序 ASC 升序 | DESC |
返回参数
示例
正常返回示例
JSON格式
{
"requestId": "ASSDS-ASSASX-XSAXSA-XSAXSAXS",
"errorMessage": "\"\"",
"errorCode": "\"\"",
"success": true,
"hostGroups": [
{
"creatorAccountId": "2222222222222",
"updateTime": 1586863220000,
"hostNum": 3,
"modifierAccountId": "211111111",
"description": "主机组",
"type": "ECS",
"createTime": 1586863220000,
"ecsType": "ECS_ALIYUN",
"aliyunRegion": "cn-beijing",
"ecsLabelKey": "ecs",
"name": "部署组",
"id": 0,
"serviceConnectionId": 1212122,
"ecsLabelValue": "value"
}
],
"totalCount": 50,
"nextToken": "asassasassa"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParam.ParamNotPresent | The parameter is invalid. | 参数有误，请检查参数 |
| 400 | InvalidUser.NotFound | The user that is invoking the API service is not a registered user. | 调用 API 的用户，未注册为云效用户 |
| 403 | Forbidden.UserNotInCurrentOrganization | The user is not in the organization and is not authorized to perform the operation. | 当前用户不在该企业中，无权进行操作。 |
| 404 | InvalidOrganization.NotFound | The organization is not found. | 企业不存在，请检查企业ID是否正确 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|
暂无变更历史