# 获取相关访问预览的信息 - ShowAccessPreview #### 功能介绍 获取相关访问预览的信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=ShowAccessPreview)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-iam5/iam_02_1126.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | AccessAnalyzer:analyzer:getPreview | Read | analyzer \* | g:ResourceTag/\ | - | - | #### URI GET /v5/analyzers/{analyzer_id}/access-previews/{access_preview_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | analyzer_id | 是 | String | **参数解释**： 分析器的唯一标识符。 您可以调用 [ListAnalyzers](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=ListAnalyzers) API来获取分析器ID。该API的响应参数中会返回一个分析器列表，其中每个分析器对象的 id 字段即为分析器ID。 **取值范围** ： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）及中划线（-）。 | | access_preview_id | 是 | String | **参数解释**： 访问预览的唯一标识符。 您可以调用 [ListAccessPreviews](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=ListAccessPreviews) API来检索为指定分析器创建的所有访问预览列表。该API的响应中会包含一个访问预览列表，列表中的每个访问预览摘要对象都包含其唯一的access_preview_id字段，这就是预览访问分析ID。 **取值范围** ： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）和中划线（-）。 **约束限制** ： 不涉及。 **默认取值** ： 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | access_preview | [AccessPreview] object | **参数解释**： 访问预览。 **取值范围**： 不涉及。 | 表3AccessPreview | 参数 | 参数类型 | 描述 | |:---|:---|:---| | access_preview_id | String | **参数解释**： 访问预览的唯一标识符。 **取值范围**： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）和中划线（-）。 | | analyzer_id | String | **参数解释**： 分析器的唯一标识符。 **取值范围**： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）及中划线（-）。 | | configurations | [Configuration] object | **参数解释**： 访问预览配置。 **取值范围**： 不涉及。 | | created_at | String | **参数解释**： 访问预览创建时间。使用UTC +0时间格式，格式为yyyy-MM-ddTHH:mm:ss.SSSZ。例如：2023-09-07T07:51:10.502Z。 **取值范围**： 不涉及。 | | status | String | **参数解释**： 访问预览的状态。 **取值范围**： - creating：创建中 - completed：创建成功 - failed：创建失败 | | status_reason | [PreviewStatusReason] object | **参数解释**： 提供有关访问预览当前状态的更多详细信息。 **取值范围**： 不涉及 | 表4Configuration | 参数 | 参数类型 | 描述 | |:---|:---|:---| | iam_agency | [IAMAgency] object | **参数解释**： IAM信任委托。 **取值范围**： 不涉及。 | | obs_bucket | [OBSBucket] object | **参数解释**： OBS桶。 **取值范围**： 不涉及。 | | kms_cmk | [KMSCmk] object | **参数解释**： KMS密钥。 **取值范围**： 不涉及。 | 表5IAMAgency | 参数 | 参数类型 | 描述 | |:---|:---|:---| | trust_policy | String | **参数解释**： 策略的JSON格式文档内容，用于校验策略语法的正确性。 **取值范围**： 最小长度为1，最大长度为131072。 | 表6OBSBucket | 参数 | 参数类型 | 描述 | |:---|:---|:---| | bucket_acl | String | **参数解释**： 桶ACL xml文件的string格式。 **取值范围**： 不涉及。 | | bucket_policy | String | **参数解释**： 策略的JSON格式文档内容，用于校验策略语法的正确性。 **取值范围**： 最小长度为1，最大长度为131072。 | 表7KMSCmk | 参数 | 参数类型 | 描述 | |:---|:---|:---| | grants | String | **参数解释**： 用于加密密钥的授权。 **取值范围**： 不涉及。 | 表8PreviewStatusReason | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释**： 访问预览当前状态的原因。 **取值范围**： - internal_error: 内部错误 - invalid_configuration: 配置无效 | #### 请求示例 获取相关访问预览的信息。 ``` GET https://{hostname}/v5/analyzers/{analyzer_id}/access-previews/{access_preview_id} ``` #### 响应示例 **状态码：200** ``` { "access_preview" : { "analyzer_id" : "{analyzer_id}", "configurations" : { "iam_agency" : { "trust_policy" : "{\"Version\":\"5.0\",\"Statement\":[{\"Condition\":{\"StringMatch\":{\"g:PrincipalOrgId\":[\"org_id\"]}},\"Action\":[\"sts:agencies:assume\",\"sts::tagSession\",\"sts::setSourceIdentity\"],\"Effect\":\"Allow\",\"Principal\":{\"IAM\":[\"dd...\"]}}]}" } }, "created_at" : "2023-09-07T07:26:23.440Z", "access_preview_id" : "{access_preview_id}", "status" : "completed" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。