As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
UpdateDataSource
Atualiza uma fonte de dados.
Sintaxe da solicitação
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"
}
}Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AwsAccountId
-
O ID da conta da AWS.
Restrições de tamanho: Comprimento fixo de 12.
Padrão:
^[0-9]{12}$Obrigatório: Sim
- DataSourceId
-
O ID da fonte de dados. Esse ID é único porRegião da AWSpara cadaAWSconta.
Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- Name
-
Um nome de exibição para a fonte de dados.
Type: String
Restrições de tamanho: Tamanho mínimo de 1. Tamanho máximo de 128.
Obrigatório: Sim
- Credentials
-
As credenciais que a Amazon QuickSight que usa para se conectar à sua origem subjacente. Atualmente, somente credenciais baseadas em nome de usuário e senha são suportadas.
Tipo: objeto DataSourceCredentials
Obrigatório: Não
- DataSourceParameters
-
Os parâmetros que a Amazon QuickSight usa para se conectar à sua origem subjacente.
Tipo: objeto DataSourceParameters
Obrigatório: Não
- SslProperties
-
Propriedades SSL (Secure Socket Layer) que se aplicam quando a Amazon QuickSight conecta-se à sua fonte subjacente.
Tipo: objeto SslProperties
Obrigatório: Não
- VpcConnectionProperties
-
Use esse parâmetro somente quando quiser a Amazon QuickSight para usar uma conexão de VPC ao se conectar à sua origem subjacente.
Tipo: objeto VpcConnectionProperties
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"DataSourceId": "string",
"RequestId": "string",
"UpdateStatus": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
- Status
-
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
- Arn
-
O nome de recurso da Amazon (ARN) da fonte de dados.
Type: String
- DataSourceId
-
O ID da fonte de dados. Esse ID é único porRegião da AWSpara cadaAWSconta.
Type: String
- RequestId
-
OAWSID da solicitação para essa operação.
Type: String
- UpdateStatus
-
O status da atualização da última atualização da fonte de dados.
Type: String
Valores válidos:
CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulteErros comuns.
- AccessDeniedException
-
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight serviço do, se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.
Código de status HTTP: 401
- ConflictException
-
Atualizar ou excluir um recurso pode causar um estado inconsistente.
Código de status HTTP: 409
- InternalFailureException
-
Ocorreu um erro interno.
Código de status HTTP: 500
- InvalidParameterValueException
-
Um ou mais parâmetros têm um valor que não é válido.
Código de status HTTP: 400
- ResourceNotFoundException
-
Não foi possível encontrar um ou mais recursos.
Código de status HTTP: 404
- ThrottlingException
-
O acesso é limitado.
Código de status HTTP: 429
Exemplos
Exemplo
Este exemplo ilustra um uso de UpdateDataSource.
Exemplo de solicitação
PUT /accounts/{AwsAccountId}/data-sources/{DataSourceId} HTTP/1.1
Content-type: application/jsonConsulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
