更新时间:2026-05-08 GMT+08:00
分享

检索有关指定结果的信息 - ShowFinding

功能介绍

检索有关指定结果的信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

AccessAnalyzer:analyzer:getFinding

Read

analyzer *

g:ResourceTag/<tag-key>

-

-

URI

GET /v5/analyzers/{analyzer_id}/findings/{finding_id}

表1 路径参数

参数

是否必选

参数类型

描述

analyzer_id

String

参数解释

分析器的唯一标识符。

您可以调用 ListAnalyzers API来获取分析器ID。该API的响应参数中会返回一个分析器列表,其中每个分析器对象的 id 字段即为分析器ID。

取值范围

最小长度为1,最大长度为36。仅支持包含字母、数字、下划线(_)及中划线(-)。

finding_id

String

参数解释

访问分析结果的唯一标识符。

您可以调用 ListFindings API来检索指定分析器生成的分析结果列表。该API的响应中会包含一个分析结果列表,列表中的每个分析结果对象都包含其唯一的id字段,这就是分析结果ID。

取值范围

最小长度为1,最大长度为36。仅支持包含字母、数字、下划线(_)和中划线(-)。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

finding

Finding object

参数解释

访问分析结果。

取值范围

不涉及。

表3 Finding

参数

参数类型

描述

action

Array of strings

参数解释

允许外部主体使用的操作。

取值范围

不涉及。

analyzed_at

String

参数解释

分析资源的时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

condition

Array of FindingCondition objects

参数解释

分析的策略语句中导致访问分析结果的条件。

取值范围

不涉及。

created_at

String

参数解释

生成访问分析结果的时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

finding_details

Array of FindingDetails objects

参数解释

访问分析结果的详细信息。

取值范围

不涉及。

finding_type

String

参数解释

访问分析结果类型。

取值范围

  • external_access:外部访问

  • privilege_escalation:提权访问

  • unused_iam_user_access_key:未使用访问密钥

  • unused_iam_user_password:未使用密码

  • unused_permission:未使用权限

  • unused_iam_agency:未使用委托

  • iam_bp_root_user_has_access_key:为根用户绑定AK/SK

  • iam_bp_access_api_with_password:使用密码访问API

  • iam_bp_login_protection_disabled:未开启登录保护

  • iam_bp_mfa_unconfigured:未绑定MFA

  • iam_bp_assign_high_risk_sys_policy_or_role_to_user:为用户授予高风险系统策略或角色

  • iam_bp_attach_high_risk_sys_identity_policy_to_user:为用户授予高风险系统身份策略

  • iam_bp_assign_high_risk_sys_policy_or_role_to_agency:为委托授予高风险系统策略或角色

  • iam_bp_attach_high_risk_sys_identity_policy_to_agency:为委托授予高风险系统身份策略

id

String

参数解释

访问分析结果的唯一标识符。

取值范围

最小长度为1,最大长度为36。仅支持包含字母、数字、下划线(_)和中划线(-)。

is_public

Boolean

参数解释

表示生成访问分析结果的策略是否允许公共访问资源。

取值范围

不涉及。

principal

FindingPrincipal object

参数解释

访问信任区域内资源的外部主体。

取值范围

不涉及。

resource

String

参数解释

资源的唯一资源标识符。

取值范围

不涉及。

resource_id

String

参数解释

资源的唯一标识符。

取值范围

最小长度为1,最大长度为36。仅支持包含字母、数字、下划线(_)和中划线(-)。

resource_owner_account

String

参数解释

拥有资源的账号ID。

取值范围

最小长度为1,最大长度为36。仅支持包含字母、数字、下划线(_)及中划线(-)。

resource_project_id

String

参数解释

资源所属的项目标识符。

取值范围

最大长度为36。仅支持包含字母、数字、下划线(_)和中划线(-)。

resource_type

String

参数解释

资源的类型。

取值范围

  • iam:agency:IAM委托

  • iam:user:IAM用户

  • kms:cmk:DEW密钥

  • obs:bucket:OBS桶

  • swr:repo:SWR镜像仓库

  • cbr:backup:CBR备份

  • ims:image:IMS镜像

sources

Array of strings

参数解释

访问分析结果的来源,这指示如何授予生成访问分析结果的访问权限。

取值范围

  • bucket_acl: 桶ACL

  • bucket_policy: 桶策略

status

String

参数解释

访问分析结果当前状态。

取值范围

  • active:活跃

  • archived:已归档

  • resolved:已解决

updated_at

String

参数解释

更新访问分析结果的时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表4 FindingDetails

参数

参数类型

描述

external_access_details

ExternalAccessDetails object

参数解释

外部访问分析详细结果。

取值范围

不涉及。

privilege_escalation_details

PrivilegeEscalationDetails object

参数解释

提权访问分析详细结果。

取值范围

不涉及。

unused_iam_user_access_key_details

UnusedIamUserAccessKeyDetails object

参数解释

未使用密钥分析详细结果。

取值范围

不涉及。

unused_iam_user_password_details

UnusedIamUserPasswordDetails object

参数解释

未使用用户密码分析详细结果。

取值范围

不涉及。

unused_permission_details

UnusedPermissionDetails object

参数解释

未使用权限分析详细结果。

取值范围

不涉及。

unused_iam_agency_details

UnusedIamAgencyDetails object

参数解释

未使用委托分析详细结果。

取值范围

不涉及。

iam_bp_root_user_has_access_key_details

IamBpRootUserHasAccessKeyDetails object

参数解释

账号根用户有访问密钥分析详细结果。

取值范围

不涉及。

iam_bp_access_api_with_password_details

IamBpAccessApiWithPasswordDetails object

参数解释

使用密码访问API分析详细结果。

取值范围

不涉及。

iam_bp_login_protection_disabled_details

IamBpLoginProtectionDisabledDetails object

参数解释

登录保护未开启分析详细结果。

取值范围

不涉及。

iam_bp_mfa_unconfigured_details

IamBpMfaUnconfiguredDetails object

参数解释

未绑定MFA分析详细结果。

取值范围

不涉及。

iam_bp_assign_high_risk_sys_policy_or_role_to_user_details

IamBpAssignHighRiskSysPolicyOrRoleToUserDetails object

参数解释

为IAM用户授予高风险系统策略或角色分析详细结果。

取值范围

不涉及。

iam_bp_attach_high_risk_sys_identity_policy_to_user_details

IamBpAttachHighRiskSysIdentityPolicyToUserDetails object

参数解释

为IAM用户授予高风险系统身份策略分析详细结果。

取值范围

不涉及。

iam_bp_assign_high_risk_sys_policy_or_role_to_agency_details

IamBpAssignHighRiskSysPolicyOrRoleToAgencyDetails object

参数解释

为IAM委托授予高风险系统权限或角色分析详细结果。

取值范围

不涉及。

iam_bp_attach_high_risk_sys_identity_policy_to_agency_details

IamBpAttachHighRiskSysIdentityPolicyToAgencyDetails object

参数解释

为IAM委托授予高风险系统身份策略分析详细结果。

取值范围

不涉及。

表5 ExternalAccessDetails

参数

参数类型

描述

action

Array of strings

参数解释

允许外部主体使用的操作。

取值范围

不涉及。

condition

Array of FindingCondition objects

参数解释

分析的策略语句中导致访问分析结果的条件。

取值范围

不涉及。

is_public

Boolean

参数解释

表示生成访问分析结果的策略是否允许公共访问资源。

取值范围

不涉及。

principal

FindingPrincipal object

参数解释

访问信任区域内资源的外部主体。

取值范围

不涉及。

sources

Array of strings

参数解释

访问分析结果的来源,这指示如何授予生成访问分析结果的访问权限。

取值范围

  • bucket_acl: 桶ACL

  • bucket_policy: 桶策略

表6 FindingCondition

参数

参数类型

描述

key

String

参数解释

条件“键”的标识符或名称。

取值范围

不涉及。

value

String

参数解释

条件“键”对应的“值”。

取值范围

不涉及。

表7 PrivilegeEscalationDetails

参数

参数类型

描述

actions

Array of strings

参数解释

指定的待分析操作集合。

取值范围

不涉及。

resource

String

参数解释

资源的唯一资源标识符。

取值范围

不涉及。

principal

FindingPrincipal object

参数解释

访问信任区域内资源的外部主体。

取值范围

不涉及。

active_action

String

参数解释

能够通过提权访问路径触发的操作代表。

取值范围

不涉及。

path

Array of PrivilegeEscalationStep objects

参数解释

提权访问分析路径的某个步骤。

取值范围

不涉及。

表8 PrivilegeEscalationStep

参数

参数类型

描述

principal

FindingPrincipal object

参数解释

访问信任区域内资源的外部主体。

取值范围

不涉及。

resources

Array of strings

参数解释

本步骤涉及到的资源。

取值范围

不涉及。

action

String

参数解释

本步骤涉及到的操作。

取值范围

不涉及。

表9 UnusedIamUserAccessKeyDetails

参数

参数类型

描述

access_key_id

String

参数解释

用户访问密钥唯一标识符(ID)。

取值范围

不涉及。

last_accessed

String

参数解释

用户访问密钥的最后访问时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表10 UnusedIamUserPasswordDetails

参数

参数类型

描述

last_accessed

String

参数解释

用户密码的最后访问时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表11 UnusedPermissionDetails

参数

参数类型

描述

service

String

参数解释

权限对应的云服务名称。

取值范围

不涉及。

last_accessed

String

参数解释

用户使用云服务的最后访问时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

actions

Array of UnusedAction objects

参数解释

未使用的操作列表。

取值范围

不涉及。

表12 UnusedAction

参数

参数类型

描述

action

String

参数解释

授权项名称。

取值范围

不涉及。

last_accessed

String

参数解释

用户使用授权项的最后访问时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

role_sources

Array of strings

参数解释

通过该操作访问的角色来源列表。

取值范围

最大项数为3。

identity_policy_sources

Array of strings

参数解释

通过该操作访问的身份策略来源列表。

取值范围

最大项数为3。

表13 UnusedIamAgencyDetails

参数

参数类型

描述

last_accessed

String

参数解释

用户使用委托的最后访问时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表14 IamBpRootUserHasAccessKeyDetails

参数

参数类型

描述

access_key_id

String

参数解释

用户访问密钥唯一标识符(ID)。

取值范围

最小长度为1,最大长度为40。

last_accessed

String

参数解释

用户访问密钥的最后访问时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

created_at

String

参数解释

用户访问密钥的创建时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表15 IamBpAccessApiWithPasswordDetails

参数

参数类型

描述

user_id

String

参数解释

用户的唯一标识符(ID)。仅支持包含字母、数字、下划线(_)和中划线(-)。

取值范围

最小长度为1,最大长度为36。

last_access_api_with_pwd_at

String

参数解释

用户使用密码访问API的最后时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

user_created_at

String

参数解释

用户的创建时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表16 IamBpLoginProtectionDisabledDetails

参数

参数类型

描述

user_id

String

参数解释

用户的唯一标识符(ID)。仅支持包含字母、数字、下划线(_)和中划线(-)。

取值范围

最小长度为1,最大长度为36。

user_created_at

String

参数解释

用户的创建时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表17 IamBpMfaUnconfiguredDetails

参数

参数类型

描述

user_id

String

参数解释

用户的唯一标识符(ID)。仅支持包含字母、数字、下划线(_)和中划线(-)。

取值范围

最小长度为1,最大长度为36。

user_created_at

String

参数解释

用户的创建时间。使用UTC +0时间格式,格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如:2023-09-07T07:51:10.502Z。

取值范围

不涉及。

表18 IamBpAssignHighRiskSysPolicyOrRoleToUserDetails

参数

参数类型

描述

user_id

String

参数解释

用户的唯一标识符(ID)。仅支持包含字母、数字、下划线(_)和中划线(-)。

取值范围

最小长度为1,最大长度为36。

permission_name

String

参数解释

权限名称。

取值范围

不涉及。

表19 IamBpAttachHighRiskSysIdentityPolicyToUserDetails

参数

参数类型

描述

user_id

String

参数解释

用户的唯一标识符(ID)。仅支持包含字母、数字、下划线(_)和中划线(-)。

取值范围

最小长度为1,最大长度为36。

policy_name

String

参数解释

策略名称。

取值范围

不涉及。

表20 IamBpAssignHighRiskSysPolicyOrRoleToAgencyDetails

参数

参数类型

描述

agency_id

String

参数解释

委托的唯一标识符(ID)。仅支持包含字母、数字、下划线(_)和中划线(-)。

取值范围

最小长度为1,最大长度为36。

permission_name

String

参数解释

权限名称。

取值范围

不涉及。

表21 IamBpAttachHighRiskSysIdentityPolicyToAgencyDetails

参数

参数类型

描述

agency_id

String

参数解释

委托的唯一标识符(ID)。仅支持包含字母、数字、下划线(_)和中划线(-)。

取值范围

最小长度为1,最大长度为36。

policy_name

String

参数解释

策略名称。

取值范围

不涉及。

表22 FindingPrincipal

参数

参数类型

描述

identifier

String

参数解释

外部主体身份的标识符。

取值范围

不涉及。

type

String

参数解释

外部主体身份的类型。

取值范围

  • all_principal:所有外部主体

  • account:账号

  • all_user_in_account: 账号下所有用户

  • all_agency_in_account: 账号下所有委托

  • all_identity_provider_in_account:账号下所有身份提供商

  • specific_user:特定用户

  • specific_agency:特定委托

  • specific_group:特定用户组

  • specific_identity_provider:特定身份提供商

请求示例

检索有关指定结果的信息。

GET https://{hostname}/v5/analyzers/{analyzer_id}/findings/{finding_id}

响应示例

状态码:200

OK

{
  "finding" : {
    "action" : [ "obs:bucket:listBucket" ],
    "analyzed_at" : "2023-09-07T08:04:41.698Z",
    "condition" : [ {
      "key" : "g:PrincipalOrgId",
      "value" : "org_id"
    } ],
    "created_at" : "2023-09-07T08:04:41.698Z",
    "id" : "{finding_id}",
    "is_public" : false,
    "principal" : {
      "identifier" : "{domain_id}",
      "type" : "account"
    },
    "resource" : "obs:{region_id}::bucket:{bucket_name}",
    "resource_owner_account" : "{domain_id}",
    "resource_type" : "obs:bucket",
    "sources" : [ "bucket_policy" ],
    "status" : "active",
    "updated_at" : "2023-09-07T08:04:41.698Z"
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档