# 创建访问预览 - CreateAccessPreview
#### 功能介绍
创建访问预览。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=CreateAccessPreview)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-iam5/iam_02_1126.html)。
| 授权项                                   | 访问级别  | 资源类型（\*为必须） | 条件键                       | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| AccessAnalyzer:analyzer:createPreview | Write | analyzer \* | g:ResourceTag/\<tag-key\> | -  | -      |
   
#### URI
POST /v5/analyzers/{analyzer_id}/access-previews
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| analyzer_id | 是    | String | **参数解释**： 分析器的唯一标识符。 您可以调用 [ListAnalyzers](https://console.huaweicloud.com/apiexplorer/#/openapi/IAMAccessAnalyzer/doc?api=ListAnalyzers) API来获取分析器ID。该API的响应参数中会返回一个分析器列表，其中每个分析器对象的 id 字段即为分析器ID。 **取值范围** ： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）及中划线（-）。 |
   
#### 请求参数
表2请求Body参数 
| 参数             | 是否必选 | 参数类型                                                                | 描述                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| configurations | 是    | [Configuration] object | **参数解释**： 访问预览配置。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。           |
| resource_urn   | 是    | String                                                              | **参数解释**： 资源的唯一资源标识符。 **约束限制**： 不涉及。 **取值范围**： 最大长度为1500。 **默认取值**： 不涉及。 |
   
 表3Configuration 
| 参数         | 是否必选 | 参数类型                                                        | 描述                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| iam_agency | 否    | [IAMAgency] object | **参数解释**： IAM信任委托。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
| obs_bucket | 否    | [OBSBucket] object | **参数解释**： OBS桶。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。    |
| kms_cmk    | 否    | [KMSCmk] object       | **参数解释**： KMS密钥。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。   |
   
 表4IAMAgency 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| trust_policy | 是    | String | **参数解释**： 策略的JSON格式文档内容，用于校验策略语法的正确性。 **约束限制**： 不涉及。 **取值范围**： 最小长度为1，最大长度为131072。 **默认取值**： 不涉及。 |
   
 表5OBSBucket 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| bucket_acl    | 否    | String | **参数解释**： 桶ACL xml文件的string格式。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                       |
| bucket_policy | 否    | String | **参数解释**： 策略的JSON格式文档内容，用于校验策略语法的正确性。 **约束限制**： 不涉及。 **取值范围**： 最小长度为1，最大长度为131072。 **默认取值**： 不涉及。 |
   
 表6KMSCmk 
| 参数     | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| grants | 是    | String | **参数解释**： 用于加密密钥的授权。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
#### 响应参数
**状态码：201**
表7响应Body参数 
| 参数                | 参数类型   | 描述                                                                                                                                                                                            |
|:---|:---|:---|
| access_preview_id | String | **参数解释**： 访问预览的唯一标识符。 **取值范围**： 最小长度为1，最大长度为36。仅支持包含字母、数字、下划线（_）和中划线（-）。 |
   
#### 请求示例
创建访问预览。
```
POST https://{hostname}/v5/analyzers/{analyzer_id}/access-previews
{
  "resource_urn" : "iam::{domain_id}:agency:{agency_name}",
  "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...\"]}}]}"
    }
  }
}
```
#### 响应示例
**状态码：201**
```
{
  "access_preview_id" : "{access_preview_id}"
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 201 | Created |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。