UpdateDashboardPermissions - Amazon QuickSight

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

UpdateDashboardPermissions

ダッシュボードの読み取りと書き込みのアクセス許可を更新します。

リクエストの構文

PUT /accounts/AwsAccountId/dashboards/DashboardId/permissions HTTP/1.1 Content-type: application/json { "GrantLinkPermissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "GrantPermissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "RevokeLinkPermissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "RevokePermissions": [ { "Actions": [ "string" ], "Principal": "string" } ] }

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

AwsAccountId

の IDAWS権限を更新するダッシュボードを含むアカウント。

長さの制約: 固定長は 12 です。

パターン: ^[0-9]{12}$

必須: はい

DashboardId

ダッシュボードの ID。

長さの制約: 最小長は 1 です。 最大長は 2,048 です。

パターン: [\w\-]+

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

GrantLinkPermissions

定義されている名前空間のすべてのユーザーにリンクアクセス許可を付与します。

Type: 配列ResourcePermissionオブジェクト

配列メンバー: 最大数は 2 項目です。

必須: いいえ

GrantPermissions

このリソースに付与するアクセス許可です。

Type: 配列ResourcePermissionオブジェクト

配列メンバー: 最大数は 100 項目です。

必須: いいえ

RevokeLinkPermissions

定義された名前空間のすべてのユーザーのリンク権限を取り消します。

Type: 配列ResourcePermissionオブジェクト

配列メンバー: 最大数は 2 項目です。

必須: いいえ

RevokePermissions

このリソースから取り出していることを示します。

Type: 配列ResourcePermissionオブジェクト

配列メンバー: 最大数は 100 項目です。

必須: いいえ

レスポンスの構文

HTTP/1.1 Status Content-type: application/json { "DashboardArn": "string", "DashboardId": "string", "LinkSharingConfiguration": { "Permissions": [ { "Actions": [ "string" ], "Principal": "string" } ] }, "Permissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "RequestId": "string" }

レスポンス要素

アクションが成功すると、以下の HTTP レスポンスが返されます。

Status

リクエストの HTTP ステータス。

サービスから以下のデータが JSON 形式で返されます。

DashboardArn

ダッシュボードの Amazon リソースネーム (ARN)。

Type: 文字列

DashboardId

ダッシュボードの ID。

Type: 文字列

長さの制約: 最小長は 1 です。 最大長は 2,048 です。

パターン: [\w\-]+

LinkSharingConfiguration

Amazonへの共有リンクの権限を更新します QuickSight ダッシュボード。

型: LinkSharingConfiguration オブジェクト

Permissions

ダッシュボードの権限に関する情報。

Type: 配列ResourcePermissionオブジェクト

配列メンバー: 最小数は 1 項目です。最大数は 64 項目です。

RequestId

-AWSこの処理のリクエスト ID。

Type: 文字列

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

ConflictException

リソースを更新または削除すると、一貫性のない状態が発生する可能性があります。

HTTP ステータスコード: 409

InternalFailureException

内部エラーが発生しました。

HTTP ステータスコード: 500

InvalidParameterValueException

1 つ以上のパラメータに無効な値があります。

HTTP ステータスコード: 400

ResourceNotFoundException

1 つ以上のリソースが見つかりません。

HTTP ステータスコード: 404

ThrottlingException

アクセスが調整済みです。

HTTP ステータスコード: 429

UnsupportedUserEditionException

このエラーは、オペレーションを呼び出していることを示します。 QuickSightエディションにその操作のサポートが含まれていないサブスクリプション。アマゾンアマゾン QuickSight 現在、Standard。すべてのオペレーションと機能がすべてのエディションで利用できるわけではありません。​

HTTP ステータスコード: 403

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。