ListRules - 获取指定堡垒机下授权规则列表_运维安全中心（堡垒机）(Bastionhost)-阿里云帮助中心

获取指定堡垒机下授权规则列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	堡垒机的实例 ID。说明您可以调用 DescribeInstances 接口获取该参数。	bastionhost-cn-5yd34ol020a
RegionId	string	否	堡垒机的区域 ID。说明 Region ID 和区域名称的对应关系，请参见地域和可用区。	cn-hangzhou
PageNumber	string	否	指定分页查询时，当前页的页码。默认值为 1。	1
PageSize	string	否	指定分页查询时，每页显示的数据最大条数。 PageSize 参数最大取值为 100。每页默认显示的数据条数为 20 条，PageSize 参数值为空时，将默认返回 20 条数据。说明建议 PageSize 取值不要为空。	20
RuleName	string	否	指定要查询的授权规则名称。仅支持精确查询。	rule
RuleState	string	否	指定要查询的授权规则状态 Enabled：正常 Disabled：已禁用	Enabled

返回参数

名称	类型	描述	示例值
	object
RequestId	string	阿里云为该请求生成的唯一标识符。	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
Rules	object []	查询到的授权规则列表。
Comment	string	授权规则的备注信息。	comment
EffectiveEndTime	long	授权规则有效期结束时间（秒，时间戳格式）	1709258400
EffectiveStartTime	long	授权规则有效期开始时间（秒，时间戳格式）	1685499134
RuleId	string	授权规则 ID。	13
RuleName	string	授权规则名称。	rule
RuleState	string	授权规则状态 Enabled：正常 Disabled：已禁用	Enabled
TotalCount	long	查询到的授权规则总数量。	1

示例

正常返回示例

JSON格式

{
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "Rules": [
    {
      "Comment": "comment",
      "EffectiveEndTime": 1709258400,
      "EffectiveStartTime": 1685499134,
      "RuleId": "13",
      "RuleName": "rule",
      "RuleState": "Enabled"
    }
  ],
  "TotalCount": 1
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter	The argument is invalid.	参数错误
500	InternalError	An unknown error occurred.	未知错误

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