翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # UpdateDashboard でダッシュボードを更新します。AWSアカウント. **注記** ダッシュボードを更新すると、新しいダッシュボードバージョンが作成されますが、新しいバージョンはすぐには公開されません。ダッシュボードの発行済みバージョンを更新するには、` [UpdateDashboardPublishedVersion](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardPublishedVersion.html) `API オペレーション。 ## リクエストの構文 ``` PUT /accounts/AwsAccountId/dashboards/DashboardId HTTP/1.1 Content-type: application/json { "DashboardPublishOptions": { "AdHocFilteringOption": { "AvailabilityStatus": "string" }, "ExportToCSVOption": { "AvailabilityStatus": "string" }, "SheetControlsOption": { "VisibilityState": "string" } }, "Name": "string", "Parameters": { "DateTimeParameters": [ { "Name": "string", "Values": [ number ] } ], "DecimalParameters": [ { "Name": "string", "Values": [ number ] } ], "IntegerParameters": [ { "Name": "string", "Values": [ number ] } ], "StringParameters": [ { "Name": "string", "Values": [ "string" ] } ] }, "SourceEntity": { "SourceTemplate": { "Arn": "string", "DataSetReferences": [ { "DataSetArn": "string", "DataSetPlaceholder": "string" } ] } }, "ThemeArn": "string", "VersionDescription": "string" } ``` ## URI リクエストパラメータ リクエストでは、次の URI パラメータを使用します。 ** [AwsAccountId](#API_UpdateDashboard_RequestSyntax) ** の IDAWS更新するダッシュボードを含むアカウント。 長さの制約: 固定長は 12 です。 パターン: `^[0-9]{12}$` : はい ** [DashboardId](#API_UpdateDashboard_RequestSyntax) ** ダッシュボードの ID。 長さの制約: 最小長は 1 です｡ 最大長は 2,048 です。 パターン: `[\w\-]+` : はい ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [Name](#API_UpdateDashboard_RequestSyntax) ** ダッシュボードの表示名。 Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 2,048 です。 : はい ** [SourceEntity](#API_UpdateDashboard_RequestSyntax) ** ダッシュボードを更新するときにソースとして使用しているエンティティ。In (イン)`SourceEntity`では、ソースとして使用しているオブジェクトのタイプを指定します。ダッシュボードはテンプレートからしか更新できないため、`SourceTemplate`エンティティ。分析からダッシュボードを更新する必要がある場合は、まず、` [CreateTemplate](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplate.html) `API オペレーション。`SourceTemplate` を使用する場合、ソーステンプレートの Amazon リソースネーム (ARN) を指定します。-`SourceTemplate`ARN には任意のものを含めることができますAWSアカウントと任意の Amazon QuickSight-サポートAWS リージョン。 `SourceTemplate` 内の `DataSetReferences` エンティティを使用して、オリジナルに一覧表示されているプレースホルダーの代替データセットを一覧表示します。各データセットのスキーマは、そのプレースホルダーと一致する必要があります。 型: [DashboardSourceEntity](API_DashboardSourceEntity.md) オブジェクト : はい ** [DashboardPublishOptions](#API_UpdateDashboard_RequestSyntax) ** ダッシュボードの作成時にダッシュボードを公開するためのオプション: + `AdHocFilteringOption` の `AvailabilityStatus` - このステータスは、`ENABLED` または `DISABLED` になります。これを、に設定した場合`DISABLED`、アマゾン QuickSight で公開ダッシュボードの左側のフィルターペインが無効になります。このペインは、アドホック (ワンタイム) フィルタリングに使用できます。このオプションはデフォルトで `ENABLED` に設定されています。 + `ExportToCSVOption` の `AvailabilityStatus` - このステータスは、`ENABLED` または `DISABLED` になります。これを `DISABLED` に設定すると、データを .CSV 形式にエクスポートするビジュアルオプションは有効になりません。このオプションはデフォルトで `ENABLED` に設定されています。 + `VisibilityState` の `SheetControlsOption` - この可視性の状態は、`COLLAPSED` または `EXPANDED` になります。このオプションはデフォルトで `COLLAPSED` に設定されています。 型: [DashboardPublishOptions](API_DashboardPublishOptions.md) オブジェクト : いいえ ** [Parameters](#API_UpdateDashboard_RequestSyntax) ** ダッシュボードのパラメータを含む構造体。これらは、ダッシュボードのパラメータオーバーライドです。ダッシュボードには任意のパラメータタイプを指定でき、パラメータによっては複数の値を受け入れることができます。 型: [Parameters](API_Parameters.md) オブジェクト : いいえ ** [ThemeArn](#API_UpdateDashboard_RequestSyntax) ** このダッシュボードで使用されているテーマの Amazon リソースネーム (ARN)。このフィールドに値を追加すると、エンティティに元々関連付けられていた値が上書きされます。テーマ ARN は、ダッシュボードを作成する AWS アカウントと同じアカウントに存在する必要があります。 Type: 文字列 : いいえ ** [VersionDescription](#API_UpdateDashboard_RequestSyntax) ** 作成されるダッシュボードの最初のバージョンの説明。 Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 512 です。 : いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "Arn": "string", "CreationStatus": "string", "DashboardId": "string", "RequestId": "string", "Status": number, "VersionArn": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [Arn](#API_UpdateDashboard_ResponseSyntax) ** リソースの Amazon リソースネーム (ARN)。 Type: 文字列 ** [CreationStatus](#API_UpdateDashboard_ResponseSyntax) ** リクエストの作成ステータス。 Type: 文字列 有効な値: ` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` ** [DashboardId](#API_UpdateDashboard_ResponseSyntax) ** ダッシュボードの ID。 Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 2,048 です。 パターン: `[\w\-]+` ** [RequestId](#API_UpdateDashboard_ResponseSyntax) ** -AWSこの処理のリクエスト ID。 Type: 文字列 ** [Status](#API_UpdateDashboard_ResponseSyntax) ** リクエストの HTTP ステータス。 Type: 整数 ** [VersionArn](#API_UpdateDashboard_ResponseSyntax) ** バージョン番号を含むダッシュボードの ARN。 Type: 文字列 ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** ConflictException ** リソースを更新または削除すると、一貫性のない状態が発生する可能性があります。 HTTP ステータスコード: 409 ** InternalFailureException ** 内部エラーが発生しました。 HTTP ステータスコード: 500 ** InvalidParameterValueException ** 1 つ以上のパラメータに無効な値があります。 HTTP ステータスコード: 400 ** LimitExceededException ** 制限を超過しています。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** 1 つ以上のリソースが見つかりません。 HTTP ステータスコード: 404 ** ThrottlingException ** アクセスが調整済みです。 HTTP ステータスコード: 429 ** UnsupportedUserEditionException ** このエラーは、Amazon でオペレーションを呼び出していることを示します。 QuickSightエディションにその操作のサポートが含まれていないサブスクリプション。アマゾンアマゾン QuickSight には現在、Standard Edition があります。すべてのオペレーションと機能がすべてのエディションで利用できるわけではありません。​ HTTP ステータスコード: 403 ## 以下の資料も参照してください。 言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/UpdateDashboard) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateDashboard) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateDashboard) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateDashboard) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateDashboard) + [AWS向け SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateDashboard) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateDashboard) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateDashboard) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateDashboard)