本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateAccessPreview
创建访问预览，允许您在部署资源权限之前预览资源的 IAM Access Analyzer 调查结果。
请求语法
PUT /access-preview HTTP/1.1
Content-type: application/json
{
"analyzerArn": "string",
"clientToken": "string",
"configurations": {
"string" : { ... }
}
}URI 请求参数
该请求不使用任何 URI 参数。
请求体
请求接受采用 JSON 格式的以下数据。
- analyzerArn
-
用于生成访问预览的账户分析器的 ARN。您只能为具有
Account类型和Active状态的分析器创建访问预览。类型：字符串
模式：
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}必需：是
- clientToken
-
客户令牌。
类型：字符串
必需：否
- configurations
-
用于生成访问预览的资源的访问控制配置。访问预览包括使用建议的访问控制配置允许外部访问资源的调查结果。该配置必须只包含一个元素。
类型：字符串到 Configuration 对象的映射
必需：是
响应语法
HTTP/1.1 200
Content-type: application/json
{
"id": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- id
-
访问预览的唯一 ID。
类型：字符串
模式：
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}
错误
有关所有操作返回的常见错误的信息，请参阅常见错误。
- AccessDeniedException
-
您没有足够的访问权限，无法执行该操作。
HTTP 状态代码：403
- ConflictException
-
冲突异常错误。
HTTP 状态代码：409
- InternalServerException
-
内部服务器错误。
HTTP 状态代码：500
- ResourceNotFoundException
-
找不到指定资源。
HTTP 状态代码：404
- ServiceQuotaExceededException
-
服务报价遇到了错误。
HTTP 状态代码：402
- ThrottlingException
-
超过限制限制错误。
HTTP 状态代码：429
- ValidationException
-
验证异常错误。
HTTP 状态代码：400
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
