翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
-
の IDAWSIAM ポリシー割り当てを含むアカウント。
長さの制約: 固定長は 12 です。
パターン:
^[0-9]{12}$
必須: はい
- Namespace
-
割り当ての名前空間。
長さの制約: 最大長は 64 文字です。
パターン:
^[a-zA-Z0-9._-]*$
必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- AssignmentStatus
-
割り当てのステータスです。可能な値は以下のとおりです。
-
ENABLED
-この割り当てで指定されたものはすべて、データソースの作成時に使用されます。 -
DISABLED
-この割り当ては、データソースの作成時には使用されません。 -
DRAFT
-この割り当ては未完成のドラフトであり、データソースの作成時には使用されません。
Type: 文字列
有効な値:
ENABLED | DRAFT | DISABLED
必須: いいえ
-
- Identities
-
ザ・アマゾン QuickSight ポリシーを割り当てるユーザー、グループ、またはその両方。
Type: 文字列から文字列の配列へのマッピング
長さの制約: 最小長は 1 です。
パターン:
[\u0020-\u00FF]+
必須: いいえ
- PolicyArn
-
Amazon に適用する IAM ポリシーの ARN QuickSight この割り当てで指定されたユーザーとグループ。
Type: 文字列
必須: いいえ
レスポンスの構文
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。
Type: 文字列
- AssignmentName
-
割り当てまたはルールの名前。
Type: 文字列
長さの制約: 最小長は 1 です。
パターン:
(?=^.{2,256}$)(?!.*\s)[0-9a-zA-Z-_.:=+@]*$
- AssignmentStatus
-
割り当てのステータスです。可能な値は以下のとおりです。
-
ENABLED
-この割り当てで指定されたものはすべて、データソースの作成時に使用されます。 -
DISABLED
-この割り当ては、データソースの作成時には使用されません。 -
DRAFT
-この割り当ては未完成のドラフトであり、データソースの作成時には使用されません。
Type: 文字列
有効な値:
ENABLED | DRAFT | DISABLED
-
- Identities
-
ザ・アマゾン QuickSight IAM ポリシーが割り当てられているユーザー、グループ、またはその両方。
Type: 文字列から文字列の配列へのマッピング
長さの制約: 最小長は 1 です。
パターン:
[\u0020-\u00FF]+
- PolicyArn
-
Amazon に適用される IAM ポリシーの ARN QuickSight この割り当てで指定されたユーザーとグループ。
Type: 文字列
- RequestId
-
-AWSこの処理のリクエスト ID。
Type: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
このアイテムにはアクセスできません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。あなたのアカウントがAmazonの使用を許可されていることを確認してください QuickSight ポリシーに正しいアクセス許可があること、正しいアクセスキーを使っていることを確認してください。
HTTP ステータスコード: 401
- ConcurrentUpdatingException
-
リソースは、新しい更新を適用する前に完了しなければならない操作が発生していることを示す状態に既にあります。
HTTP ステータスコード: 500
- InternalFailureException
-
内部エラーが発生しました。
HTTP ステータスコード: 500
- InvalidParameterValueException
-
1 つ以上のパラメータに無効な値があります。
HTTP ステータスコード: 400
- ResourceExistsException
-
指定されたリソースは既に存在します。
HTTP ステータスコード: 409
- ResourceNotFoundException
-
1 つ以上のリソースが見つかりません。
HTTP ステータスコード: 404
- ThrottlingException
-
アクセスが調整済みです。
HTTP ステータスコード: 429
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。