UpdateAnalysis - Amazon QuickSight

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

UpdateAnalysis

Amazon で分析を更新します。 QuickSight

リクエストの構文

PUT /accounts/AwsAccountId/analyses/AnalysisId HTTP/1.1 Content-type: application/json { "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" }

URI リクエストパラメータ

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

AnalysisId

更新中の分析の ID。この ID は、分析の URL に表示されます。

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

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

必須。はい

AwsAccountId

の ID は、その ID。AWS更新中の分析を含むアカウントです。

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

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

必須。はい

リクエストボディ

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

Name

更新中の分析のわかりやすい名前。この名前は、Amazon で分析に表示されます。 QuickSight console.

Type: 文字列

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

必須。はい

SourceEntity

更新中の分析に使用するソースエンティティ。このメタデータ構造体には、ソーステンプレートと 1 つ以上のデータセットを記述する詳細が含まれています。

型: AnalysisSourceEntity オブジェクト

必須。はい

Parameters

使用するパラメータ名とオーバーライド値。分析には任意のパラメータタイプを指定でき、パラメータによっては複数の値を受け入れることができます。

型: Parameters オブジェクト

必須。いいえ

ThemeArn

作成する分析に適用するテーマの Amazon リソースネーム (ARN)。Amazon でテーマを表示するには、Amazon でテーマを表示するには、Amazon QuickSight コンソールでアクセス許可があることを確認します。

Type: 文字列

必須。いいえ

レスポンスの構文

HTTP/1.1 Status Content-type: application/json { "AnalysisId": "string", "Arn": "string", "RequestId": "string", "UpdateStatus": "string" }

レスポンス要素

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

Status

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

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

AnalysisId

分析の ID。

Type: 文字列

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

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

Arn

更新中の分析の ARN。

Type: 文字列

RequestId

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

Type: 文字列

UpdateStatus

分析で最後に行われた更新の更新ステータスです。

Type: 文字列

有効な値: CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED

エラー

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

ConflictException

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

HTTP ステータスコード: 409

InternalFailureException

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

HTTP ステータスコード: 500

InvalidParameterValueException

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

HTTP ステータスコード: 400

ResourceExistsException

指定されたリソースは既に存在します。

HTTP ステータスコード: 409

ResourceNotFoundException

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

HTTP ステータスコード: 404

ThrottlingException

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

HTTP ステータスコード: 429

UnsupportedUserEditionException

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

HTTP ステータスコード: 403

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

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