UpdateIAMPolicyAssignment - Amazon QuickSight

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

UpdateIAMPolicyAssignment

更新现有 IAM 策略分配。此操作仅更新请求中指定的一个或多个可选参数。这会覆盖包含在中的所有用户Identities.

请求语法

PUT /accounts/AwsAccountId/namespaces/Namespace/iam-policy-assignments/AssignmentName HTTP/1.1 Content-type: application/json { "AssignmentStatus": "string", "Identities": { "string" : [ "string" ] }, "PolicyArn": "string" }

URI 请求参数

请求使用以下 URI 参数。

AssignmentName

分配的名称,也称为规则。此名称在中必须唯一AWSaccount.

长度约束:最小长度为 1。

模式:(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$

必需:是

AwsAccountId

的 IDAWS包含 IAM 策略分配的账户。

长度约束:固定长度为 12。

模式:^[0-9]{12}$

必需:是

Namespace

赋值的命名空间。

长度约束:最大长度为 64。

模式:^[a-zA-Z0-9._-]*$

必需:是

请求正文

请求接受采用 JSON 格式的以下数据。

AssignmentStatus

分配的状态。可能值如下所示:

  • ENABLED-创建数据源时将使用此分配中指定的任何内容。

  • DISABLED-创建数据源时不使用此分配。

  • DRAFT-此作业是未完成的草稿,在创建数据源时不使用。

类型: 字符串

有效值: ENABLED | DRAFT | DISABLED

必需:否

Identities

Amazon QuickSight 要向其分配策略的用户、组或两者。

类型: 字符串到字符串数组映射

长度约束:最小长度为 1。

模式:[\u0020-\u00FF]+

必需:否

PolicyArn

要应用于亚马逊的 IAM 策略的 ARN QuickSight 在此分配中指定的用户和组。

类型: 字符串

必需:否

响应语法

HTTP/1.1 Status Content-type: application/json { "AssignmentId": "string", "AssignmentName": "string", "AssignmentStatus": "string", "Identities": { "string" : [ "string" ] }, "PolicyArn": "string", "RequestId": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 响应。

Status

请求的 HTTP 状态。

服务以 JSON 格式返回的以下数据。

AssignmentId

作业的 ID。

类型: 字符串

AssignmentName

分配或规则的名称。

类型: 字符串

长度约束:最小长度为 1。

模式:(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$

AssignmentStatus

分配的状态。可能值如下所示:

  • ENABLED-创建数据源时将使用此分配中指定的任何内容。

  • DISABLED-创建数据源时不使用此分配。

  • DRAFT-此作业是未完成的草稿,在创建数据源时不使用。

类型: 字符串

有效值: ENABLED | DRAFT | DISABLED

Identities

Amazon QuickSight IAM 策略分配到的用户、组或两者。

类型: 字符串到字符串数组映射

长度约束:最小长度为 1。

模式:[\u0020-\u00FF]+

PolicyArn

应用于亚马逊的 IAM 策略的 ARN QuickSight 在此分配中指定的用户和组。

类型: 字符串

RequestId

这些区域有:AWS用于此操作的请求 ID。

类型: 字符串

错误

有关所有操作常见错误的信息,请参阅常见错误.

AccessDeniedException

您无权访问此项目。无法验证提供的凭证。您可能无权执行请求。确保您的账户已获得使用亚马逊的授权 QuickSight 服务,您的策略具有正确的权限,并且您使用的是正确的访问密钥。

HTTP 状态代码:401

ConcurrentUpdatingException

资源已处于一种状态,表明正在执行某项操作,必须先完成该操作,然后才能应用新的更新。

HTTP 状态代码:500

InternalFailureException

出现内部故障。

HTTP 状态代码:500

InvalidParameterValueException

一个或多个参数的值无效。

HTTP 状态代码:400

ResourceExistsException

已存在指定的资源。

HTTP 状态代码:409

ResourceNotFoundException

无法找到一个或多个资源。

HTTP 状态代码:404

ThrottlingException

访问受限。

HTTP 状态代码:429

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: