AI 助理
文档备案控制台
官方文档
首页 办公安全平台 开发参考 API参考 API目录 审批报备 ListApprovals - 批量查询审批实例列表

ListApprovals - 批量查询审批实例列表

更新时间：
复制 MD 格式
产品详情
我的收藏

查询当前阿里云账号下审批实例列表。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

csas:ListApprovals

list

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
CurrentPage

integer

是

分页查询时显示的当前页的页码。取值：1~10000。

1
PageSize

integer

是

分页查询时设置的每页数量。取值：1~500。

10
ApprovalIds

array

否

审批实例 ID 集合。

string

否

审批实例 ID。取值来源：

approval-872b5e911b35****
Statuses

array

否

审批实例状态集合。

string

否

审批实例状态。取值：

  • Pending：待审批。

  • Approved：已通过。

  • Rejected：已拒绝。

  • Revoked：已撤回。

  • Expired：已过期。

枚举值：

  • Revoked :

    已撤回

  • Approved :

    已通过

  • Expired :

    已过期

  • Rejected :

    已拒绝

  • Pending :

    待审批

Pending
ReportTypes

array

否

报备类型列表，使用 Flat 序列化格式，不能重复。取值：

  • ApprovalReport：审批报备。

  • BackendReport：后台报备。 不传时默认仅查询 ApprovalReport。

string

否

报备类型列表。未传时仅查询 ApprovalReport

["BackendReport"]
EffectStatuses

array

否

报备生效状态列表，使用 Flat 序列化格式，不能重复。仅匹配审批状态为 Approved 的记录。取值：

  • Enabled：有效。

  • Expired：已失效或已到期。

string

否

报备生效状态列表。

["Enabled"]
SchemaId

string

否

关联审批模板 ID。

approval-schema-090134f1ebff****
ProcessId

string

否

关联审批流程 ID

approval-process-fcc351b8a95b****
PolicyType

string

否

适配策略类型。取值：

  • DomainBlacklist：域名黑名单。

  • DomainWhitelist：域名白名单。

  • SoftwareBlock：软件禁用。

  • AppUninstall：终端卸载。

  • DlpSend：文件外发。

  • PeripheralBlock：外设管控。

枚举值：

  • AppUninstall :

    终端卸载

  • DlpSend :

    文件外发

  • DomainWhitelist :

    域名白名单

  • DomainBlacklist :

    域名黑名单

  • SoftwareBlock :

    软件禁用

  • PeripheralBlock :

    外设管控

DlpSend
CreatorUserId

string

否

审批实例创建人 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****
CreatorDevTag

string

否

审批实例创建终端设备 ID。

36efa42d-2c32-c4dc-e3fc-8541e33a****
OperatorUserId

string

否

审批实例操作人 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****
OperatorUsername

string

否

审批实例操作人用户名。

李小姐
CreatorUsername

string

否

审批实例创建人用户名。

王先生
CreatorDepartment

string

否

审批实例创建人部门。

测试部
CreateStartTime

integer

否

审批实例创建起始时刻，秒级时间戳。

1730000000
CreateEndTime

integer

否

审批实例创建结束时刻，秒级时间戳。

1736750500
ProcessName

string

否

关联审批流程名称。

测试
SchemaName

string

否

关联审批模板名称。

test

返回参数

名称

类型

描述

示例值

object

Schema of Response。

RequestId

string

本次请求的 ID。

6965F5BA-53B6-5650-A708-51F090F843BB
TotalNum

string

审批实例总数。

1
Approvals

array<object>

审批实例列表。

array<object>

审批实例。

ApprovalId

string

审批实例 ID。

approval-872b5e911b35****
ApprovalProgresses

array<object>

审批实例进展节点列表。

array<object>

审批实例进展节点。

Operators

array<object>

审批进展节点操作人列表。

object

审批进展节点操作人。

SaseUserId

string

审批进展节点操作人 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****
Username

string

审批进展节点操作人用户名。

王先生
Status

string

审批进展节点状态。取值：

  • Pending：待审批。

  • Approved：已通过。

  • Rejected：已拒绝。

  • Revoked：已撤回。

枚举值：

  • Revoked :

    已撤回

  • Approved :

    已通过

  • Rejected :

    已拒绝

  • Pending :

    待审批

Approved
Executor

string

审批进展节点执行人 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****
Action

string

审批进展节点执行操作。取值：

  • Approve：通过。

  • Reject：拒绝。

  • Revoke：撤回。

  • Comment：评论。

枚举值：

  • Reject :

    拒绝

  • Comment :

    评论

  • Revoke :

    撤回

  • Approve :

    通过

Approve
Comment

string

审批进展节点执行评论。

审核通过
Timestamp

integer

审批进展节点执行时刻，秒级时间戳。

1736752000
EndTimestamp

integer

报备截止时间，Unix 时间戳，单位为秒。ValidityType 为 Permanent 时返回 0。

1757952000
ValidityType

string

生效时长类型。取值：FixedTime、Permanent。

Permanent
ApprovalDetail

string

审批实例详情。

{"initiatorName":"王先生","initiatorDept":"测试部","devType":"windows","deviceType":"usbStorage","deviceId":"FC216E9E3****","approvalEndTimestamp":1736524799,"approvalReason":"这是一个测试"}
Status

string

审批实例状态。取值：

  • Pending：待审批。

  • Approved：已通过。

  • Rejected：已拒绝。

  • Revoked：已撤回。

  • Expired：已过期。

  • Deleted：审批已删除。

枚举值：

  • Revoked :

    已撤回

  • Approved :

    已通过

  • Expired :

    已过期

  • Rejected :

    已拒绝

  • Deleted :

    已删除

  • Pending :

    待审批

Pending
ProcessId

string

审批实例关联流程 ID。

approval-process-fcc351b8a95b****
ProcessName

string

审批实例关联流程名称。

测试***
PolicyType

string

审批实例关联策略类型。取值：

  • DomainBlacklist：域名黑名单。

  • DomainWhitelist：域名白名单。

  • SoftwareBlock：软件禁用。

  • DeviceRegistration：超额注册。

  • AppUninstall：终端卸载。

  • DlpSend：文件外发。

  • PeripheralBlock：外设管控。

  • EndpointHardening：终端加固。

  • oftwareHardening：软件加固。

  • AiAgentBlock：AI Agent 管控。

  • PrivateAccessBlock：内网访问。

枚举值：

  • AiAgentBlock :

    AI Agent 管控

  • EndpointHardening :

    终端加固

  • AppUninstall :

    终端卸载

  • PrivateAccessBlock :

    内网访问

  • DlpSend :

    文件外发

  • DomainWhitelist :

    域名白名单

  • oftwareHardening :

    软件加固

  • DomainBlacklist :

    域名黑名单

  • SoftwareBlock :

    软件禁用

  • PeripheralBlock :

    外设管控

DlpSend
SchemaId

string

审批实例关联模板 ID。

approval-schema-090134f1ebff****
SchemaName

string

审批实例关联模板名称。

模板***
SchemaContent

string

审批实例关联模板内容。

{"form": {"labelCol": 6,"wrapperCol": 12}}
CreatorUserId

string

审批实例创建人 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****
CreatorDevTag

string

审批实例创建终端设备 ID。

36efa42d-2c32-c4dc-e3fc-8541e33a****
CreateTime

string

审批实例创建时间。

2022-11-15 22:11:55
Reason

string

审批实例创建原因。

项目临时访问。
CreatorUsername

string

审批实例创建人用户名。

王***
CreatorDepartment

string

审批实例创建人部门。

CN=cn***,OU=h***
ApprovalType

integer

审批类型。取值：

  • 0：内置审批。

  • 1：钉钉审批。

  • 2：企业微信审批。

  • 3：飞书审批。

0
ReportType

string

报备类型。取值：

  • ApprovalReport：审批报备。

  • BackendReport：后台报备。

BackendReport
EffectStatus

string

报备生效状态。审批状态不是 Approved 时为空字符串。取值：

  • Enabled：有效。

  • Expired：已失效或已到期。

Enabled

示例

正常返回示例

JSON格式

{
  "RequestId": "6965F5BA-53B6-5650-A708-51F090F843BB",
  "TotalNum": "1",
  "Approvals": [
    {
      "ApprovalId": "approval-872b5e911b35****",
      "ApprovalProgresses": [
        {
          "Operators": [
            {
              "SaseUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
              "Username": "王先生"
            }
          ],
          "Status": "Approved",
          "Executor": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
          "Action": "Approve",
          "Comment": "审核通过",
          "Timestamp": 1736752000
        }
      ],
      "EndTimestamp": 1757952000,
      "ValidityType": "Permanent",
      "ApprovalDetail": "{\"initiatorName\":\"王先生\",\"initiatorDept\":\"测试部\",\"devType\":\"windows\",\"deviceType\":\"usbStorage\",\"deviceId\":\"FC216E9E3****\",\"approvalEndTimestamp\":1736524799,\"approvalReason\":\"这是一个测试\"}",
      "Status": "Pending",
      "ProcessId": "approval-process-fcc351b8a95b****",
      "ProcessName": "测试***",
      "PolicyType": "DlpSend",
      "SchemaId": "approval-schema-090134f1ebff****",
      "SchemaName": "模板***",
      "SchemaContent": "{\"form\": {\"labelCol\": 6,\"wrapperCol\": 12}}",
      "CreatorUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
      "CreatorDevTag": "36efa42d-2c32-c4dc-e3fc-8541e33a****",
      "CreateTime": "2022-11-15 22:11:55",
      "Reason": "项目临时访问。",
      "CreatorUsername": "王***",
      "CreatorDepartment": "CN=cn***,OU=h***",
      "ApprovalType": 0,
      "ReportType": "BackendReport",
      "EffectStatus": "Enabled"
    }
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。

上一篇：UpdateApprovalProcess - 更新审批流程下一篇：ListApprovalSchemasForApprovalProcesses - 查询审批流程关联的模板