翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateThemePermissions
テーマのリソースに対するアクセス許可を更新します。アクセス許可を付与または取り消しの試行には、アクセス許可を付与または取り消しの試行に適用されます。"quicksight:DescribeTheme"
。
テーマの権限はグループ化に適用されます。有効なグループには、ユーザー、所有者、または権限なしの 3 つの権限レベルに対する次のものがあります。
-
ユーザー
-
"quicksight:DescribeTheme"
-
"quicksight:DescribeThemeAlias"
-
"quicksight:ListThemeAliases"
-
"quicksight:ListThemeVersions"
-
-
所有者
-
"quicksight:DescribeTheme"
-
"quicksight:DescribeThemeAlias"
-
"quicksight:ListThemeAliases"
-
"quicksight:ListThemeVersions"
-
"quicksight:DeleteTheme"
-
"quicksight:UpdateTheme"
-
"quicksight:CreateThemeAlias"
-
"quicksight:DeleteThemeAlias"
-
"quicksight:UpdateThemeAlias"
-
"quicksight:UpdateThemePermissions"
-
"quicksight:DescribeThemePermissions"
-
-
アクセス許可を指定しない場合は、アクセス許可リストを省略します。
リクエストの構文
PUT /accounts/AwsAccountId
/themes/ThemeId
/permissions HTTP/1.1
Content-type: application/json
{
"GrantPermissions": [
{
"Actions": [ "string
" ],
"Principal": "string
"
}
],
"RevokePermissions": [
{
"Actions": [ "string
" ],
"Principal": "string
"
}
]
}
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- AwsAccountId
-
の IDAWSテーマを含むアカウント。
長さの制約: 固定長は 12 です。
パターン:
^[0-9]{12}$
必須: はい
- ThemeId
-
テーマの ID。
長さの制約: 最小長は 1 です。 最大長は 2,048 です。
パターン:
[\w\-]+
必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- GrantPermissions
-
テーマに付与されるリソース権限のリスト。
Type: 配列:ResourcePermissionオブジェクト
配列メンバー: 最大数は 100 項目です。
必須: いいえ
- RevokePermissions
-
テーマから取り消されるリソース権限のリスト。
Type: 配列:ResourcePermissionオブジェクト
配列メンバー: 最大数は 100 項目です。
必須: いいえ
レスポンスの構文
HTTP/1.1 Status
Content-type: application/json
{
"Permissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
],
"RequestId": "string",
"ThemeArn": "string",
"ThemeId": "string"
}
レスポンス要素
アクションが成功すると、以下の HTTP レスポンスが返されます。
- Status
-
リクエストの HTTP ステータス。
サービスから以下のデータが JSON 形式で返されます。
- Permissions
-
テーマのリソースパーミッションの結果リスト。
Type: 配列:ResourcePermissionオブジェクト
配列メンバー: 最小数は 1 項目です。最大数は 64 項目です。
- RequestId
-
-AWSこの処理のリクエスト ID。
Type: 文字列
- ThemeArn
-
テーマの Amazon リソースネーム(ARN)。
Type: 文字列
- ThemeId
-
テーマの ID。
Type: 文字列
長さの制約: 最小長は 1 です。 最大長は 2,048 です。
パターン:
[\w\-]+
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
この項目へのアクセス権限がありません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。あなたのアカウントがAmazonの使用を許可されていることを確認してください QuickSight サービスの利用を許可に正しいアクセス許可があること、正しいアクセスキーを使っていることを確認してください。
HTTP ステータスコード:コード: 401
- InternalFailureException
-
内部エラーが発生しました。
HTTP ステータスコード:コード: 500
- InvalidParameterValueException
-
1 つ以上のパラメータに無効な値があります。
HTTP ステータスコード:コード: 400
- ResourceNotFoundException
-
1 つ以上のリソースが見つかりません。
HTTP ステータスコード:コード: 404
- ThrottlingException
-
アクセスが調整済みです。
HTTP ステータスコード:コード: 429
- UnsupportedUserEditionException
-
このエラーは、Amazon でオペレーションを呼び出していることを示します。 QuickSightエディションにその操作のサポートが含まれていないサブスクリプション。アマゾンアマゾン QuickSight 現在、Standard Edition と Enterprise E すべてのオペレーションと機能がすべてのエディションで利用できるわけではありません。
HTTP ステータスコード:コード: 403
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。