本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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
-
指派的名稱，也稱為規則。此名稱在以下位置中必須是唯一的AWS帳戶。
長度限制：長度下限為 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
-
指派的識別碼。
類型：字串
- 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 狀態碼：HTTP 狀態碼：401
- ConcurrentUpdatingException
-
資源已處於狀態，表示正在進行的作業，必須先完成才能套用新更新。
HTTP 狀態碼：HTTP 狀態碼：500
- InternalFailureException
-
發生內部故障。
HTTP 狀態碼：HTTP 狀態碼：500
- InvalidParameterValueException
-
一或多個參數的值無效。
HTTP 狀態碼：HTTP 狀態碼：400
- ResourceExistsException
-
指定的資源已存在。
HTTP 狀態碼：HTTP 狀態碼：409
- ResourceNotFoundException
-
無法找到一個或多個資源。
HTTP 狀態碼：HTTP 狀態碼：404
- ThrottlingException
-
存取已調節。
HTTP 狀態碼：HTTP 狀態碼：429
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
