可以获取主机组列表。
调试
您可以在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是否正确 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|
暂无变更历史