文档首页/统一身份认证服务 IAM_统一身份认证服务（新版）/API参考/API/访问分析/访问预览/获取相关访问预览的信息 - ShowAccessPreview
更新时间：2025-12-25 GMT+08:00
查看PDF
分享

获取相关访问预览的信息 - ShowAccessPreview

功能介绍

获取相关访问预览的信息。

授权信息

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

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

AccessAnalyzer:analyzer:getPreview

Read

analyzer *

g:ResourceTag/<tag-key>

-

-

URI

GET /v5/analyzers/{analyzer_id}/access-previews/{access_preview_id}

表1 路径参数

参数

是否必选

参数类型

描述

analyzer_id

是

String

分析器的唯一标识符。

最小长度：1

最大长度：36

access_preview_id

是

String

访问预览的唯一标识符。

最小长度：1

最大长度：36

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

access_preview

AccessPreview object

访问预览。

表3 AccessPreview

参数

参数类型

描述

access_preview_id

String

访问预览的唯一标识符。

analyzer_id

String

分析器的唯一标识符。

configurations

Configuration object

访问预览配置。

created_at

String

访问预览创建时间。

status

String

访问预览的状态。

  • creating：创建中

  • completed：创建成功

  • failed：创建失败

status_reason

PreviewStatusReason object

提供有关访问预览当前状态的更多详细信息。

表4 Configuration

参数

参数类型

描述

iam_agency

IAMAgency object

IAM信任委托。

obs_bucket

OBSBucket object

OBS桶。

kms_cmk

KMSCmk object

KMS密钥。

表5 IAMAgency

参数

参数类型

描述

trust_policy

String

该策略JSON格式策略文档。

表6 OBSBucket

参数

参数类型

描述

bucket_acl

String

桶ACL xml文件的string格式。

bucket_policy

String

该策略JSON格式策略文档。

表7 KMSCmk

参数

参数类型

描述

grants

String

用于加密密钥的授权。

表8 PreviewStatusReason

参数

参数类型

描述

code

String

访问预览当前状态的原因。

请求示例

获取相关访问预览的信息。

GET https://{hostname}/v5/analyzers/{analyzer_id}/access-previews/{access_preview_id}

响应示例

状态码：200

OK

{
  "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

错误码

请参见错误码。

父主题：访问预览

相关文档