GetApproval - 查询审批实例详情

更新时间:
复制 MD 格式

查询当前阿里云账号下审批实例详情。

调试

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

调试

授权信息

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

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

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

csas:GetApproval

get

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

ApprovalId

string

是

审批实例 ID。取值来源:

approval-872b5e911b35****

返回参数

名称

类型

描述

示例值

object

Schema of Response。

RequestId

string

本次请求的 ID。

D6707286-A50E-57B1-B2CF-EFAC59E8****

Approval

array<object>

审批详情列表,通常包含一条记录。

array<object>

审批实例。

ApprovalId

string

审批实例 ID。

approval-3564b140642f****

ApprovalProgresses

array<object>

审批进度列表。后台报备无审批节点,返回空数组。

array<object>

审批实例进展节点。

Operators

array<object>

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

object

审批进展节点操作人。

SaseUserId

string

审批进展节点操作人 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****

Username

string

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

user***

Status

string

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

  • Pending:待审批。

  • Approved:已通过。

  • Rejected:已拒绝。

  • Revoked:已撤回。

Approved

Executor

string

审批进展节点执行人 ID。

su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****

Action

string

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

  • Approve:通过。

  • Reject:拒绝。

  • Revoke:撤回。

  • Comment:评论。

Approve

Comment

string

审批进展节点执行评论。

审核通过

Timestamp

integer

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

1736752000

EndTimestamp

integer

审批实例有效截止时刻,秒级时间戳。

1757952000

ValidityType

string

生效时长类型。取值:

  • FixedTime:在指定时间失效。

  • Permanent:永久有效。

Permanent

ApprovalDetail

string

审批实例详情。

{"applicationId":"pa-application-eb75f0c80c28****","applicationName":"后***","associatedPolicyName":"内网访***"}

Status

string

审批实例状态。取值:

  • Pending:待审批。

  • Approved:已通过。

  • Rejected:已拒绝。

  • Revoked:已撤回。

  • Expired:已过期。

  • Deleted:审批已删除。

Pending

ProcessId

string

审批实例关联流程 ID。

approval-process-fcc351b8a95b****

ProcessName

string

审批实例关联流程名称。

审批***

PolicyType

string

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

  • DomainBlacklist:域名黑名单。

  • DomainWhitelist:域名白名单。

  • SoftwareBlock:软件禁用。

  • DeviceRegistration:超额注册。

  • AppUninstall:终端卸载。

  • DlpSend:文件外发。

  • PeripheralBlock:外设管控。

  • EndpointHardening:终端加固。

  • oftwareHardening:软件加固。

  • AiAgentBlock:AI Agent 管控。

  • PrivateAccessBlock:内网访问。

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

创建时间,格式为 yyyy-MM-dd HH:mm:ss。

2026-08-18 17:48:44

CreateTimeUnix

integer

创建时间,Unix 时间戳,单位为秒。

1787046524

Reason

string

审批实例创建原因。

项目临时访问。

CreatorUsername

string

审批实例创建人用户名。

user***

CreatorDepartment

string

报备发起人的部门路径。

CN=cn***,OU=ou***

ApprovalType

integer

审批类型。取值:

  • 0:内置审批。

  • 1:钉钉审批。

  • 2:企业微信审批。

  • 3:飞书审批。

0

ReportType

string

报备类型。取值:

  • ApprovalReport:审批报备。

  • BackendReport:后台报备。

BackendReport

EffectStatus

string

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

  • Enabled:有效。

  • Expired:已失效或已到期。

Enabled

BackendReportDetail

object

后台报备详情,仅 ReportType=BackendReport 时返回

AssociatedPolicyType

string

关联策略类型,与 PolicyType 一致。

PrivateAccessBlock

AssociatedPolicyName

string

string 关联策略名称。

内网访问***

TargetUser

object

后台报备的实际生效用户。

UserId

string

实际生效用户的 SASE 用户 ID。

su_70a1ed06a900d337527984de27568352fdfed1b19442a886d2a697c0327f****

Username

string

实际生效用户的用户名。

user***

ReportObject

any

报备对象,字段随 PolicyType 变化。对象内字段使用小驼峰命名。

{"applicationId":"pa-application-eb75f0c80c28****","applicationName":"后***"}

Remark

string

后台报备备注,与报备原因一致。

项目临时访问。

示例

正常返回示例

JSON格式

{
  "RequestId": "D6707286-A50E-57B1-B2CF-EFAC59E8****",
  "Approval": [
    {
      "ApprovalId": "approval-3564b140642f****",
      "ApprovalProgresses": [
        {
          "Operators": [
            {
              "SaseUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
              "Username": "user***"
            }
          ],
          "Status": "Approved",
          "Executor": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
          "Action": "Approve",
          "Comment": "审核通过",
          "Timestamp": 1736752000
        }
      ],
      "EndTimestamp": 1757952000,
      "ValidityType": "Permanent",
      "ApprovalDetail": "{\"applicationId\":\"pa-application-eb75f0c80c28****\",\"applicationName\":\"后***\",\"associatedPolicyName\":\"内网访***\"}",
      "Status": "Pending",
      "ProcessId": "approval-process-fcc351b8a95b****",
      "ProcessName": "审批***",
      "PolicyType": "DlpSend",
      "SchemaId": "approval-schema-090134f1ebff****",
      "SchemaName": "模板***\n",
      "SchemaContent": "{\"form\": {\"labelCol\": 6,\"wrapperCol\": 12}}",
      "CreatorUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
      "CreatorDevTag": "36efa42d-2c32-c4dc-e3fc-8541e33a****",
      "CreateTime": "2026-08-18 17:48:44",
      "CreateTimeUnix": 1787046524,
      "Reason": "项目临时访问。",
      "CreatorUsername": "user***",
      "CreatorDepartment": "CN=cn***,OU=ou***",
      "ApprovalType": 0,
      "ReportType": "BackendReport",
      "EffectStatus": "Enabled",
      "BackendReportDetail": {
        "AssociatedPolicyType": "PrivateAccessBlock",
        "AssociatedPolicyName": "内网访问***",
        "TargetUser": {
          "UserId": "su_70a1ed06a900d337527984de27568352fdfed1b19442a886d2a697c0327f****",
          "Username": "user***"
        },
        "ReportObject": "{\"applicationId\":\"pa-application-eb75f0c80c28****\",\"applicationName\":\"后***\"}",
        "Remark": "项目临时访问。"
      }
    }
  ]
}

错误码

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

变更历史

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