文档

GetPolicy - 获取指定控制策略详情

获取指定控制策略详情。

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
InstanceIdstring

指定要查询的控制策略所在堡垒机的实例 ID。

说明 您可以调用 DescribeInstances 接口获取该参数。
bastionhost-cn-zvp2d3syb0g
RegionIdstring

指定要查询的控制策略所在堡垒机的区域 ID。

说明 区域 ID 和区域名称的对应关系,请参见地域和可用区
cn-hangzhou
PolicyIdstring

指定要查询的控制策略 ID。

3

返回参数

名称类型描述示例值
object
Policyobject

控制策略详细信息。

AccessTimeRangeConfigobject

登录时段限制详情。

EffectiveTimeobject []

允许登录的时段详情。

Daysarray

允许登录的日期。

string

允许登录的星期日期。

  • 1:周一
  • 2:周二
  • 3:周三
  • 4:周四
  • 5:周五
  • 6:周六
  • 7:周日
[2]
Hoursarray

允许登录的时间。

string

每天允许登录的时间。取值:

  • 0:0:00 到 1:00。
  • 1:1:00 到 2:00。
  • 2:2:00 到 3:00。
  • 3:3:00 到 4:00。
  • 4:4:00 到 5:00。
  • 5:5:00 到 6:00。
  • 6:6:00 到 7:00。
  • 7:7:00 到 8:00。
  • 8:8:00 到 9:00。
  • 9:9:00 到 10:00。
  • 10:10:00 到 11:00。
  • 11:11:00 到 12:00。
  • 12:12:00 到 13:00。
  • 13:13:00 到 14:00。
  • 14:14:00 到 15:00。
  • 15:15:00 到 16:00。
  • 16:16:00 到 17:00。
  • 17:17:00 到 18:00。
  • 18:18:00 到 19:00。
  • 19:19:00 到 20:00。
  • 20:20:00 到 21:00。
  • 21:21:00 到 22:00。
  • 22:22:00 到 23:00。
  • 23:23:00 到 0:00。
[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]
CommandConfigobject

命令策略详情。

Approvalobject

命令审批配置详情。

Commandsarray

命令列表数组。

string

已配置需要审批的命令详情。

ls
Denyobject

命令控制配置详情。

AclTypestring

命令控制类型。取值:

  • white:白名单模式。
  • black:黑名单模式。
black
Commandsarray

命令列表数组。

string

命令详情。

ls
Commentstring

控制策略的备注。

comment
IPAclConfigobject

来源 IP 限制配置详情。

AclTypestring

来源 IP 限制模式。取值:

  • white:白名单模式。
  • black:黑名单模式。
black
IPsarray

限制登录的 IP 信息。

string

限制的 IP 列表。

[10.10.**.**]
PolicyNamestring

控制策略名称。

test
PolicyIdstring

控制策略 ID。

3
Prioritylong

控制策略的优先级,数字越小优先级越高。

1
ProtocolConfigobject

协议控制详情。

RDPobject

RDP 选项配置详情。

ClipboardDownloadstring

粘贴板下载配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
ClipboardUploadstring

粘贴板上传配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
DiskRedirectionstring

驱动器/打印机映射配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
RecordKeyboardstring

键盘记录配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SSHobject

SSH 和 SFTP 选项配置详情。

ExecCommandstring

远程执行命令配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SFTPChannelstring

SFTP 通道配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SFTPDownloadFilestring

SFTP 选项文件下载配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SFTPMkdirstring

SFTP 选项创建文件夹配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SFTPRemoveFilestring

SFTP 选项删除文件配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SFTPRenameFilestring

SFTP 选项文件重命名配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SFTPRmdirstring

SFTP 选项删除文件夹配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SFTPUploadFilestring

SFTP 选项文件上传配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
SSHChannelstring

SSH 通道配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
X11Forwardingstring

X11 转发配置。取值:

  • Enable:启用
  • Disable:禁用
Enable
ApprovalConfigobject

运维审批配置详情。

SwitchStatusstring

控制策略中的运维审批配置。取值:

  • On:开启运维审批
  • Off:关闭运维审批
Off
RequestIdstring

阿里云为该请求生成的唯一标识符。

0D29F2C0-8B4B-5861-9474-F3F23D25594B

示例

正常返回示例

JSON格式

{
  "Policy": {
    "AccessTimeRangeConfig": {
      "EffectiveTime": [
        {
          "Days": [
            "[2]"
          ],
          "Hours": [
            "[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23]"
          ]
        }
      ]
    },
    "CommandConfig": {
      "Approval": {
        "Commands": [
          "ls"
        ]
      },
      "Deny": {
        "AclType": "black",
        "Commands": [
          "ls"
        ]
      }
    },
    "Comment": "comment",
    "IPAclConfig": {
      "AclType": "black",
      "IPs": [
        "[10.10.**.**]"
      ]
    },
    "PolicyName": "test",
    "PolicyId": "3",
    "Priority": 1,
    "ProtocolConfig": {
      "RDP": {
        "ClipboardDownload": "Enable",
        "ClipboardUpload": "Enable",
        "DiskRedirection": "Enable",
        "RecordKeyboard": "Enable"
      },
      "SSH": {
        "ExecCommand": "Enable",
        "SFTPChannel": "Enable",
        "SFTPDownloadFile": "Enable",
        "SFTPMkdir": "Enable",
        "SFTPRemoveFile": "Enable",
        "SFTPRenameFile": "Enable",
        "SFTPRmdir": "Enable",
        "SFTPUploadFile": "Enable",
        "SSHChannel": "Enable",
        "X11Forwarding": "Enable"
      }
    },
    "ApprovalConfig": {
      "SwitchStatus": "Off"
    }
  },
  "RequestId": "0D29F2C0-8B4B-5861-9474-F3F23D25594B"
}

错误码

HTTP status code错误码错误信息描述
400InvalidParameterThe argument is invalid.参数错误
404PolicyNotFoundThe policy is not found.控制策略不存在
500InternalErrorAn unknown error occurred.未知错误

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

  • 本页导读 (1)
文档反馈