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