文档中心

ListHostAccounts

最近更新时间：2024.04.16 19:47:31

首次发布时间：2023.12.15 10:45:21

获取主机账号列表，可根据分页及账户名、主机账号 ID 列表、主机 ID 列表等筛选条件查询云堡垒机中的主机账号列表，并且能够按要求进行排序。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=ListHostAccounts&Version=2021-06-01

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	ListHostAccounts	接口名称。当前 API 的名称为 `ListHostAccounts`。
Version	String	是	2021-06-01	接口版本。当前 API 的版本为 `2021-06-01`。
PageNumber	Integer	否	1	分页查询时的起始页码，从 1 开始，默认为 1。
PageSize	Integer	否	10	分页查询时每页显示的记录数。最小值：1 最大值：100 默认值：10
Filter	Object of ListHostAccountsFilter	否		筛选条件。
OrderBy	Object of OrderBy	否		排序条件。
InstanceId	String	是	vbh-14****0042-bhjml9w7	云堡垒机 ID。

ListHostAccountsFilter

参数	类型	是否必选	示例值	描述
Keyword	String	否	root	账户名模糊搜索关键字。
HostAccountIds	Array of String	否	["a47aa7c9-438d-11-**-4ad9529a3e36"]	主机账号 ID 列表。
HostId	String	否	["a47aa7c9-438d-11-**-4ad9529a3e36"]	主机 ID 列表。

OrderBy

参数	类型	是否必选	示例值	描述
Key	String	否	Name	排序字段
Desc	Boolean	否	true	是否进行降序排列。取值: true：降序 false：升序

参数

类型

是否必选

示例值

描述

Key

String

否

Name

排序字段

Desc

Boolean

否

true

是否进行降序排列。取值:

true：降序
false：升序

请求示例

POST https://open.volcengineapi.com/?Action=ListHostAccounts&Version=2021-06-01
Content-Type: application/json
{
    "PageNumber": 1,
    "PageSize": 10,
    "Filter": {
        "Keyword": "root",
        "HostAccountIds": ["a47aa7c9-438d-11**-****-4ad9529a3e36"],
        "HostId": "["a47aa7c9-438d-11**-****-4ad9529a3e36"]"
    },
    "OrderBy": {
        "Key": "Name",
        "Desc": true
    },
    "InstanceId": "vbh-14****0042-bhjml9w7"
}

返回参数

参数	类型	示例值	描述
Items	Array of HostAccount		主机账户列表。
TotalCount	Long	2	返回数据列表的总量。
PageNumber	Integer	1	当前页数。
PageSize	Integer	10	每页显示的数量。

HostAccount

参数	类型	示例值	描述
CreateTime	String	2023-09-12 10:34:30	账户创建时间。
UpdateTime	String	2023-09-12 10:34:30	账户修改时间。
HostAccountName	String	root	账户名称。
AuthType	String	Password	用户身份验证方式。取值: Password：通过 Password 验证。 PrivateKey：通过 PrivateKey 验证。
Password	String	dsw******1	账户密码。
PrivateKey	String	-----BEGIN OPENSSH PRIVATE KEY-----	账户认证所需私钥。
EncryptedKey	String	vc21******	私钥的加密口令。
HostId	String	2e7d77da-af08-41-**-e44259701efb	主机 ID。
HostAccountId	String	a47aa7c9-438d-11-**-4ad9529a3e36	主机账户 ID。

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "202211302208****",
        "Action": "ListHostAccounts",
        "Version": "2021-06-01",
        "Service": "vbh",
        "Region": "cn-beijing"
    },
    "Result": {
        "Items": [
            {
                "CreateTime": "2023-09-12 10:34:30",
                "UpdateTime": "2023-09-12 10:34:30",
                "HostAccountName": "root",
                "AuthType": "Password",
                "Password": "dsw******1",
                "PrivateKey": "-----BEGIN OPENSSH PRIVATE KEY-----",
                "EncryptedKey": "vc21******",
                "HostId": "2e7d77da-af08-41**-****-e44259701efb",
                "HostAccountId": "a47aa7c9-438d-11**-****-4ad9529a3e36"
            }
        ],
        "TotalCount": 2,
        "PageNumber": 2,
        "PageSize": 2
    }
}

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。