文档中心

ListAccessControlPolicies

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

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

获取指定实例的访问控制策略列表，可根据策略名称关键字查询云堡垒机的访问控制策略列表，并且能够按字段进行排序。

请求说明

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

请求参数

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

PolicyFilter

参数	类型	是否必选	示例值	描述
Keyword	String	否	policy	策略名关键字，会进行模糊查询

OrderBy

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

参数

类型

是否必选

示例值

描述

Key

String

否

Name

排序字段

Desc

Boolean

否

true

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

true：降序
false：升序

请求示例

POST https://open.volcengineapi.com/?Action=ListAccessControlPolicies&Version=2021-06-01
Content-Type: application/json
{
    "PageNumber": 1,
    "PageSize": 2,
    "Filter": {
        "Keyword": "policy"
    },
    "InstanceId": "vbh-14****0042-bhjml9w7",
    "OrderBy": {
        "Key": "Name",
        "Desc": true
    }
}

返回参数

参数	类型	示例值	描述
Items	Array of AccessControlPolicy		策略信息列表。
TotalCount	Long	2	返回数据列表的总量。
PageNumber	Integer	1	当前页数。
PageSize	Integer	10	每页显示的数量。

AccessControlPolicy

参数	类型	示例值	描述
Id	String	7f**fc-c0b7-11ec-b792-e***1bf10a	策略 ID。
CreatedAt	String	2023-09-12 10:34:30	策略创建时间。
UpdatedAt	String	2023-09-12 10:34:30	策略修改时间。
Name	String	policy	策略名称。
Description	String	This is a policy	策略描述。
Priority	String	1	策略优先级。取值范围 1~100，取值越低，优先级越高。同一个优先级只能有一个策略。
Kind	Integer	1	IP 限制类型，取值： 1：黑名单。 2：白名单。
Ips	Array of String	["192.168.3.123"]	IP 地址，仅支持 IPv4。支持单个 IP 地址或地址段，支持子网掩码。注意如果是白名单，则这个字段必填。
FileManager	Array of String	["READ"]	SFTP 文件管理权限列表，取值： DOWNLOAD：允许文件下载。 UPLOAD：允许文件上传。 RENAME：允许重命名文件。 DELETE：允许删除文件。 READ：需求查看文件。 WRITE：允许编辑文件。 WRITE_DIRECTORY：允许创建或删除文件夹。
RdpFlag	Array of String	["COPY"]	RDP 控制策略，取值： DOWNLOAD：允许文件下载。 UPLOAD：允许文件上传。 PASTE：允许剪贴板上传。 COPY：允许剪贴板下载。
TimeRange	Array of String	[[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false]]	登录时间段限制。是一个横轴为时间（24小时，从左到右取值 0~23），纵轴为周天（从上到下周一至周天）组成的二维数组。每个方格的取值： true：表示在一周内的该天的该时刻允许登录。 false：表示在一周内改天的该时刻不允许登录。
UserCount	Integer	2	关联用户数量。
UserGroupCount	Integer	2	关联用户组数量。
InstanceId	String	vbh-14**0042-wdk***z	关联堡垒机实例ID。

返回示例

HTTP/1.1 200 OK
Content-Type:application/json
{
    "ResponseMetadata": {
        "RequestId": "202211302208****",
        "Action": "ListAccessControlPolicies",
        "Version": "2021-06-01",
        "Service": "vbh",
        "Region": "cn-beijing"
    },
    "Result": {
        "Items": [
            {
                "Id": "7f****fc-c0b7-11ec-b792-e*****1bf10a",
                "CreatedAt": "2023-09-12 10:34:30",
                "UpdatedAt": "2023-09-12 10:34:30",
                "Name": "policy-mlt",
                "Description": "This is a description",
                "Priority": ,
                "Kind": 1,
                "Ips": ["192.168.3.123"],
                "FileManager": ,
                "RdpFlag": ,
                "TimeRange": [[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false],[true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,false]],
                "UserCount": 2,
                "UserGroupCount": 2,
                "InstanceId": "vbh-14****0042-wdk****z"
            }
        ],
        "TotalCount": 2,
        "PageNumber": 1,
        "PageSize": 10
    }
}

错误码

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