Todos os produtos
Search
Central de documentação

:AtualizeDataSource

Última atualização: Jun 27, 2026

Atualiza uma fonte de dados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

UpdateDataSource

Operação a ser executada. Defina o valor como UpdateDataSource.

Description

String

Não

xxx

Descrição da fonte de dados.

EnvType

Integer

Sim

1

Ambiente da fonte de dados. Valores válidos:

  • 0: ambiente de desenvolvimento

  • 1: ambiente de produção

Content

String

Sim

{"accessId":"xssssss","accessKey":"xsaxsaxsa","authType":2,"endpoint":"http://service.odps.aliyun.com/api","project":"xsaxsax","tag":"public"}

Detalhes da fonte de dados a ser atualizada.

Não é permitido alterar o tipo da fonte de dados. Por exemplo, você não pode mudar o tipo de MaxCompute para MySQL.

Exemplos de detalhes para fontes de dados comuns:

  • odps


{
  "accessId": "xssssss",
  "accessKey": "xsaxsaxsa",
  "authType": 2,
  "endpoint": "http://service.odps.aliyun.com/api",
  "project": "xsaxsax",
  "tag": "public"
}
  • mysql


{
  "database": "xsaxsa",
  "instanceName": "rm-xsaxsa",
  "password": "xsaxsa",
  "rdsOwnerId": "xasxsa",
  "regionId": "cn-shanghai",
  "tag": "rds",
  "username": "xsaxsa"
}
  • rds


{
  "configType": 1,
  "tag": "rds",
  "database": "xsaxsa",
  "username": "xsaxsa",
  "password": "xssaxsa$32050",
  "instanceName": "rm-xsaxs",
  "rdsOwnerId": "11111111"
}
  • oss


{
  "accessId": "sssssxx",
  "accessKey": "xsaxaxsaxs",
  "bucket": "xsa-xs-xs",
  "endpoint": "http://oss-cn-shanghai.aliyuncs.com",
  "tag": "public"
}
  • sqlserver


{
  "jdbcUrl": "jdbc:sqlserver://xsaxsa-xsaxsa.database.xxx.cn:123;DatabaseName=xsxs-xsxs",
  "password": "sdasda$fs",
  "tag": "public",
  "username": "sxaxacdacdd"
}
  • polardb


{
  "clusterId": "pc-sdadsadsa",
  "database": "dsadsadsa",
  "ownerId": "121212122",
  "password": "sdasdafssa",
  "region": "cn-shanghai",
  "tag": "polardb",
  "username": "asdadsads"
}
  • oracle


{
  "jdbcUrl": "jdbc:oracle:saaa:@xxxxx:1521:PROD",
  "password": "sxasaxsa",
  "tag": "public",
  "username": "sasfadfa"
}
  • mongodb


{
  "address": "[\"xsaxxsa.mongodb.rds.aliyuncs.com:3717\"]",
  "database": "admin",
  "password": "sadsda@",
  "tag": "public",
  "username": "dsadsadas"
}
  • emr


{
  "accessId": "xsaxsa",
  "emrClusterId": "C-dsads",
  "emrResourceQueueName": "default",
  "emrEndpoint": "emr.aliyuncs.com",
  "accessKey": "dsadsad",
  "emrUserId": "224833315798889783",
  "name": "sasdsadsa",
  "emrAccessMode": "simple",
  "region": "cn-shanghai",
  "authType": "2",
  "emrProjectId": "FP-sdadsad"
}
  • postgresql


{
  "jdbcUrl": "jdbc:postgresql://xxxx:1921/ssss",
  "password": "sdadsads",
  "tag": "public",
  "username": "sdsasda"
}
  • analyticdb_for_mysql


{
  "instanceId": "am-sadsada",
  "database": "xsxsx",
  "username": "xsxsa",
  "password": "asdadsa",
  "connectionString": "am-xssxsxs.ads.aliyuncs.com:3306"
}
  • hybriddb_for_postgresql


{
  "connectionString": "gp-xsaxsaxa-master.gpdbmaster.rds.aliyuncs.com",
  "database": "xsaxsaxas",
  "password": "xsaxsaxsa@11",
  "instanceId": "gp-xsaxsaxsa",
  "port": "541132",
  "ownerId": "xsaxsaxsas",
  "username": "sadsad"
}
  • holo


{
  "accessId": "xsaxsaxs",
  "accessKey": "xsaxsaxsa",
  "database": "xsaxsaxsa",
  "instanceId": "xsaxa",
  "tag": "aliyun"
}
  • kafka


{
  "instanceId": "xsax-cn-xsaxsa",
  "regionId": "cn-shanghai",
  "tag": "aliyun",
  "ownerId": "1212121212112"
}

Status

String

Não

ENABLED

Status da fonte de dados. Este parâmetro foi descontinuado. Não o utilize.

DataSourceId

Long

Sim

1

ID da fonte de dados a ser atualizada. Chame a operação ListDataSources para obter o ID.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

HttpStatusCode

String

200

Código de status HTTP retornado.

Data

Boolean

true

Indica se a fonte de dados foi atualizada.

RequestId

String

0bc14115159376359****

ID da solicitação.

Success

Boolean

true

Indica se a solicitação foi bem-sucedida.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=UpdateDataSource
&Description=xxx
&EnvType=1
&Content={"accessId":"xssssss","accessKey":"xsaxsaxsa","authType":2,"endpoint":"http://service.odps.aliyun.com/api","project":"xsaxsax","tag":"public"}
&Status=ENABLED
&DataSourceId=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateDataSourceResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <Data>true</Data>
    <RequestId>0bc14115159376359****</RequestId>
    <Success>true</Success>
</UpdateDataSourceResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "HttpStatusCode" : 200,
  "Data" : true,
  "RequestId" : "0bc14115159376359****",
  "Success" : true
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

Invalid.Tenant.ConnectionNotExists

The connection does not exist.

A fonte de dados especificada não existe.

400

Invalid.Tenant.ProjectNotExists

The project does not exist.

O workspace especificado não existe.

400

Invalid.Tenant.UserNotInProject

The user is not in the project.

O usuário não foi adicionado ao workspace.

400

MissingParam.ConnectionStr.Property

You must specify property %s required by the data source connection string.

As propriedades obrigatórias da string de conexão da fonte de dados não foram especificadas.

400

DataSource.CheckRamRoleFailure

Failed to check the RAM role. AccountId %s. roleArn %s.

Falha ao verificar as permissões na fonte de dados.

400

DataSource.ConnectionStrProperty.PatternNotMatch

The pattern value %s is invalid. The correct pattern is %s.

As propriedades da string de conexão da fonte de dados não correspondem às regras especificadas.

400

DataSource.NotFound

The specified data source ID %s does not exist.

A fonte de dados especificada não existe.

400

Invalid.Connection.Empty

You must specify the connection parameter.

Os parâmetros da fonte de dados especificada não foram definidos.

400

Invalid.DataSource.DataSourceTypeNotExist

The data source type %s does not exist.

O tipo de fonte de dados especificado não existe.

400

Invalid.DataSource.DataSourceTypeNotSupport

The dataSourceType %s and subType %s are not supported.

O tipo de fonte de dados não é suportado.

400

Invalid.Operation

You cannot delete the bindingCalcEngine that is bound to the data source.

Não é possível excluir o mecanismo de computação associado à fonte de dados.

400

Required.Parameter.Empty

You must specify the parameter %s.

Um parâmetro obrigatório não foi especificado.

403

Invalid.Tenant.UserIsNotProjectOwnerOrAdmin

The user is not a project administrator or owner.

O usuário não é proprietário ou administrador do workspace.

403

Invalid.Tenant.UserNotInTenant

The user is not in tenant.

O usuário não pertence ao tenant.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.