UpdateThemePermissions - Amazon QuickSight

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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 を使用する方法の詳細については、以下を参照してください。