UpdateDataSource - Amazon QuickSight

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

UpdateDataSource

更新資料來源。

請求語法

PUT /accounts/AwsAccountId/data-sources/DataSourceId HTTP/1.1 Content-type: application/json { "Credentials": { "CopySourceArn": "string", "CredentialPair": { "AlternateDataSourceParameters": [ { "AmazonElasticsearchParameters": { "Domain": "string" }, "AmazonOpenSearchParameters": { "Domain": "string" }, "AthenaParameters": { "WorkGroup": "string" }, "AuroraParameters": { "Database": "string", "Host": "string", "Port": number }, "AuroraPostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "AwsIotAnalyticsParameters": { "DataSetName": "string" }, "ExasolParameters": { "Host": "string", "Port": number }, "JiraParameters": { "SiteBaseUrl": "string" }, "MariaDbParameters": { "Database": "string", "Host": "string", "Port": number }, "MySqlParameters": { "Database": "string", "Host": "string", "Port": number }, "OracleParameters": { "Database": "string", "Host": "string", "Port": number }, "PostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "PrestoParameters": { "Catalog": "string", "Host": "string", "Port": number }, "RdsParameters": { "Database": "string", "InstanceId": "string" }, "RedshiftParameters": { "ClusterId": "string", "Database": "string", "Host": "string", "Port": number }, "S3Parameters": { "ManifestFileLocation": { "Bucket": "string", "Key": "string" } }, "ServiceNowParameters": { "SiteBaseUrl": "string" }, "SnowflakeParameters": { "Database": "string", "Host": "string", "Warehouse": "string" }, "SparkParameters": { "Host": "string", "Port": number }, "SqlServerParameters": { "Database": "string", "Host": "string", "Port": number }, "TeradataParameters": { "Database": "string", "Host": "string", "Port": number }, "TwitterParameters": { "MaxRows": number, "Query": "string" } } ], "Password": "string", "Username": "string" } }, "DataSourceParameters": { "AmazonElasticsearchParameters": { "Domain": "string" }, "AmazonOpenSearchParameters": { "Domain": "string" }, "AthenaParameters": { "WorkGroup": "string" }, "AuroraParameters": { "Database": "string", "Host": "string", "Port": number }, "AuroraPostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "AwsIotAnalyticsParameters": { "DataSetName": "string" }, "ExasolParameters": { "Host": "string", "Port": number }, "JiraParameters": { "SiteBaseUrl": "string" }, "MariaDbParameters": { "Database": "string", "Host": "string", "Port": number }, "MySqlParameters": { "Database": "string", "Host": "string", "Port": number }, "OracleParameters": { "Database": "string", "Host": "string", "Port": number }, "PostgreSqlParameters": { "Database": "string", "Host": "string", "Port": number }, "PrestoParameters": { "Catalog": "string", "Host": "string", "Port": number }, "RdsParameters": { "Database": "string", "InstanceId": "string" }, "RedshiftParameters": { "ClusterId": "string", "Database": "string", "Host": "string", "Port": number }, "S3Parameters": { "ManifestFileLocation": { "Bucket": "string", "Key": "string" } }, "ServiceNowParameters": { "SiteBaseUrl": "string" }, "SnowflakeParameters": { "Database": "string", "Host": "string", "Warehouse": "string" }, "SparkParameters": { "Host": "string", "Port": number }, "SqlServerParameters": { "Database": "string", "Host": "string", "Port": number }, "TeradataParameters": { "Database": "string", "Host": "string", "Port": number }, "TwitterParameters": { "MaxRows": number, "Query": "string" } }, "Name": "string", "SslProperties": { "DisableSsl": boolean }, "VpcConnectionProperties": { "VpcConnectionArn": "string" } }

URI 請求參數

請求會使用下列 URI 參數。

AwsAccountId

AWS 帳戶 ID。

長度限制:12 的固定長度。

模式:^[0-9]{12}$

必要求:是

DataSourceId

資料來源的 ID。此 ID 是每個唯一的AWS 區域For EeachAWS帳戶。

必要求:是

請求主體

請求接受採用 JSON 格式的下列資料。

Name

資料來源的顯示名稱。

類型:字串

長度限制:長度下限為 1。長度上限為 128。

必要求:是

Credentials

亞馬遜的憑據 QuickSight 用來連接到基礎來源。目前僅支援以使用者名稱和密碼為基礎的認證。

類型:DataSourceCredentials 物件

必要求:否

DataSourceParameters

亞馬遜的參數 QuickSight 用來連線至您的基礎來源。

類型:DataSourceParameters 物件

必要求:否

SslProperties

Amazon 時套用的安全通訊端層 (SSL) 屬性 QuickSight 連接到您的基礎來源。

類型:SslProperties 物件

必要求:否

VpcConnectionProperties

只有當你想要使用此參數 QuickSight ,使用 VPC 連線至您的基礎來源時使用 VPC 連線。

類型:VpcConnectionProperties 物件

必要求:否

回應語法

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

回應元素

如果動作成功,則服務傳回下列 HTTP 回應。

Status

請求的 HTTP 狀態。

服務會傳回下列 JSON 格式的資料。

Arn

資料來源的 Amazon Resource Name (ARN)。

類型:字串

DataSourceId

資料來源的 ID。此 ID 是唯一的AWS 區域For EeachAWS帳戶。

類型:字串

RequestId

所以此AWS此操作的請求 ID。

類型:字串

UpdateStatus

資料來源上次更新的更新狀態。

類型:字串

有效值: CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED

錯誤

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

AccessDeniedException

您無法存取此物品。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶被授權使用亞馬遜 QuickSight 服務,您的政策有正確許可,以及您使用正確的存取金鑰。

HTTP 狀態態態態態態求:401

ConflictException

更新或刪除資源可能會導致不一致的狀態。

HTTP 狀態態態態態態求:409

InternalFailureException

發生內部故障。

HTTP 狀態態態態態態求:500

InvalidParameterValueException

一或多個參數的值無效。

HTTP 狀態態態態態態求:400

ResourceNotFoundException

無法找到一個或多個資源。

HTTP 狀態態態態態態求:404

ThrottlingException

存取已調節。

HTTP 狀態態態態態態求:429

範例

範例

這個例子說明了一個用法 UpdateDataSource。

請求範例

PUT /accounts/{AwsAccountId}/data-sources/{DataSourceId} HTTP/1.1 Content-type: application/json

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: