# 立即开始扫描应用于指定资源的策略 - StartResourceScan #### 功能介绍 立即开始扫描应用于指定资源的策略。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=StartResourceScan)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-iam5/iam_02_1126.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | AccessAnalyzer:analyzer:scan | Write | analyzer \* | g:ResourceTag/\ | - | - | #### URI POST /v5/analyzers/{analyzer_id}/scan 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | analyzer_id | 是 | String | **参数解释**： 分析器的唯一标识符。 您可以调用 [ListAnalyzers](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=ListAnalyzers) API来获取分析器ID。该API的响应参数中会返回一个分析器列表，其中每个分析器对象的 id 字段即为分析器ID。 **取值范围** ： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）及中划线（-）。 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | resource_id | 否 | String | **参数解释**： 资源的唯一标识符。 **约束限制**： 不涉及。 **取值范围**： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）及中划线（-）。 **默认取值**： 不涉及。 | | resource_owner_account | 是 | String | **参数解释**： 需要扫描资源的账号ID。 您可以调用 [ListFindings](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=ListFindings) API来检索指定分析器生成的分析结果列表。该API的响应中会包含一个分析结果列表，其中resource_owner_account字段即为需要扫描资源的账号ID。 **约束限制** ： 不涉及。 **取值范围** ： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）及中划线（-）。 **默认取值** ： 不涉及。 | | resource_project_id | 否 | String | **参数解释**： 资源所属的项目标识符。 **约束限制**： 不涉及。 **取值范围**： 最大长度为36。仅支持包含字母、数字、下划线（_）及中划线（-）。 **默认取值**： 不涉及。 | | resource_urn | 是 | String | **参数解释**： 资源的唯一资源标识符。 **约束限制**： 不涉及。 **取值范围**： 最大长度为1500。 **默认取值**： 不涉及。 | | 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：为委托授予高风险系统身份策略 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 无 #### 请求示例 立即开始扫描应用于指定资源的策略。 ``` POST https://{hostname}/v5/analyzers/{analyzer_id}/scan { "resource_owner_account" : "{domain_id}", "resource_urn" : "iam::{domain_id}:agency:{agency_name}", "resource_id" : "{agency_id}" } ``` #### 响应示例 无 #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。