Consulta as fontes de dados adicionadas a um workspace do DataWorks.
Depuração
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | ListDataSources |
Operação a ser executada. Defina o valor como ListDataSources. |
| ProjectId | Long | Sim | 1 |
ID do workspace do DataWorks ao qual as fontes de dados pertencem. Chame a operação ListProjects para obter esse ID. |
| Name | String | Não | test |
Nome da fonte de dados a ser consultada. |
| DataSourceType | String | Não | rds |
Tipo da fonte de dados. Valores válidos:
|
| SubType | String | Não | mysql |
Subtipo da fonte de dados. Este parâmetro só tem efeito se DataSourceType estiver definido como rds. Se DataSourceType for rds, este parâmetro poderá ser definido como mysql, sqlserver ou postgresql. |
| Status | String | Não | ENABLED |
Status da fonte de dados. Valores válidos:
|
| EnvType | Integer | Não | 1 |
Ambiente de uso da fonte de dados. Valores válidos: 0 e 1. O valor 0 indica o ambiente de desenvolvimento; o valor 1 indica o ambiente de produção. |
| PageSize | Integer | Não | 10 |
Número de entradas por página. Valor máximo: 100. Valor padrão: 10. |
| PageNumber | Integer | Não | 1 |
Número da página. O valor deve ser um número inteiro maior ou igual a 1. |
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| HttpStatusCode | Integer | 200 |
Código de status HTTP retornado. |
| RequestId | String | 0bc14115159376359**** |
ID da solicitação. |
| Success | Boolean | true |
Indica se a solicitação foi bem-sucedida. |
| Data | Object |
Resultado da consulta retornado. |
|
| PageNumber | Integer | 1 |
Número da página. |
| PageSize | Integer | 20 |
Número de entradas por página. Valor máximo: 100. Valor padrão: 10. |
| TotalCount | Integer | 233 |
Número total de fontes de dados. |
| DataSources | Array of DataSources |
Fontes de dados. |
|
| Status | Integer | 1 |
Status da fonte de dados. Valores válidos:
|
| ProjectId | Integer | 123 |
ID do workspace ao qual a fonte de dados pertence. |
| SubType | String | mysql |
Subtipo da fonte de dados. Este parâmetro só tem efeito se o valor de DataSourceType for rds. Se o valor de DataSourceType for rds, o valor deste parâmetro poderá ser mysql, sqlserver ou postgresql. |
| GmtModified | String | Mar 17, 2021 4:09:32 PM |
Hora da última modificação da fonte de dados. Exemplo: Mar 17, 2021 4:09:32 PM. |
| EnvType | Integer | 1 |
Ambiente de uso da fonte de dados. Valores válidos:
|
| ConnectStatus | Integer | 1 |
Status da fonte de dados. Valores válidos:
|
| Sequence | Integer | 300 |
Número de sequência da fonte de dados. As fontes de dados são classificadas em ordem decrescente com base neste valor. |
| Description | String | a connection |
Descrição da fonte de dados. |
| DataSourceType | String | rds |
Tipo da fonte de dados. Valores válidos:
|
| GmtCreate | String | Mar 17, 2021 4:09:32 PM |
Hora de criação da fonte de dados. Exemplo: Mar 17, 2021 4:09:32 PM. |
| DefaultEngine | Boolean | false |
Indica se a instância do mecanismo de computação associada à fonte de dados é o mecanismo padrão usado por fontes de dados do mesmo tipo. |
| Shared | Boolean | false |
Indica se a fonte de dados é compartilhada. |
| Operator | String | 193543050**** |
ID da conta Alibaba Cloud que modificou a fonte de dados pela última vez. |
| Name | String | abc |
Nome da fonte de dados. |
| Content | String | {"pubEndpoint":"http://service.cn.maxcompute.aliyun.com/api","accessId":"TMP.3KecGjvzy3i8MYfn2BGHgF7EHGyBFZcHm7GgngrABVRyvvKQrfF5kskR36xP361C3dqwbGo7SGYptAeGyiTwHXqLaBUvYC","securityToken":null,"endpoint":"http://service.cn.maxcompute.aliyun-inc.com/api","accessKey":"***","name":"PRE_PROJECT_A_engine","project":"PRE_PROJECT_A","vpcEndpoint":"http://service.cn.maxcompute.aliyun-inc.com/api","region":"cn-shanghai","authType":"2"} |
String de conexão de dados. O valor deste parâmetro está no formato JSON. Exemplos de strings de conexão para fontes de dados comuns:
|
| Id | Long | 1 |
ID da fonte de dados. |
| BindingCalcEngineId | Long | 123 |
ID da instância do mecanismo de computação associada à fonte de dados. |
| TenantId | Long | 1234567 |
ID do locatário. |
Exemplos
Solicitações de exemplo
http(s)://[Endpoint]/?Action=ListDataSources
&Name=test
&ProjectId=1
&RegionId=cn-shanghai
&<Common request parameters>
Respostas de sucesso de exemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<RequestId>0bc14115159376359****</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Data>
<TotalCount>233</TotalCount>
<PageSize>20</PageSize>
<PageNumber>1</PageNumber>
<DataSources>
<Status>1</Status>
<Operator>193543050****</Operator>
<ConnectStatus>1</ConnectStatus>
<SubType>mysql</SubType>
<Description>a connection</Description>
<BindingCalcEngineId>123</BindingCalcEngineId>
<ProjectId>123</ProjectId>
<GmtModified>Mar 17, 2021 4:09:32 PM</GmtModified>
<Sequence>300</Sequence>
<Shared>false</Shared>
<EnvType>1</EnvType>
<Name>abc</Name>
<DefaultEngine>false</DefaultEngine>
<TenantId>1234567</TenantId>
<GmtCreate>Mar 17, 2021 4:09:32 PM</GmtCreate>
<Content>{"pubEndpoint":"http://service.cn.maxcompute.aliyun.com/api","accessId":"TMP.3KecGjvzy3i8MYfn2BGHgF7EHGyBFZcHm7GgngrABVRyvvKQrfF5kskR36xP361C3dqwbGo7SGYptAeGyiTwHXqLaBUvYC","securityToken":null,"endpoint":"http://service.cn.maxcompute.aliyun-inc.com/api","accessKey":"***","name":"PRE_PROJECT_A_engine","project":"PRE_PROJECT_A","vpcEndpoint":"http://service.cn.maxcompute.aliyun-inc.com/api","region":"cn-shanghai","authType":"2"}</Content>
<DataSourceType>rds</DataSourceType>
<Id>1</Id>
</DataSources>
</Data>
<Success>true</Success>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "0bc14115159376359****",
"HttpStatusCode" : 200,
"Data" : {
"TotalCount" : 233,
"PageSize" : 20,
"PageNumber" : 1,
"DataSources" : {
"Status" : 1,
"Operator" : "193543050****",
"ConnectStatus" : 1,
"SubType" : "mysql",
"Description" : "a connection",
"BindingCalcEngineId" : 123,
"ProjectId" : 123,
"GmtModified" : "Mar 17, 2021 4:09:32 PM",
"Sequence" : 300,
"Shared" : false,
"EnvType" : 1,
"Name" : "abc",
"DefaultEngine" : false,
"TenantId" : 1234567,
"GmtCreate" : "Mar 17, 2021 4:09:32 PM",
"Content" : "{\"pubEndpoint\":\"http://service.cn.maxcompute.aliyun.com/api\",\"accessId\":\"TMP.3KecGjvzy3i8MYfn2BGHgF7EHGyBFZcHm7GgngrABVRyvvKQrfF5kskR36xP361C3dqwbGo7SGYptAeGyiTwHXqLaBUvYC\",\"securityToken\":null,\"endpoint\":\"http://service.cn.maxcompute.aliyun-inc.com/api\",\"accessKey\":\"***\",\"name\":\"PRE_PROJECT_A_engine\",\"project\":\"PRE_PROJECT_A\",\"vpcEndpoint\":\"http://service.cn.maxcompute.aliyun-inc.com/api\",\"region\":\"cn-shanghai\",\"authType\":\"2\"}",
"DataSourceType" : "rds",
"Id" : 1
}
},
"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. |
Erro retornado porque a fonte de dados especificada não existe. |
|
400 |
Invalid.Tenant.ProjectNotExists |
The project does not exist. |
Erro retornado porque o workspace especificado não existe. |
|
400 |
Invalid.Tenant.UserNotInProject |
The user is not in the project. |
Erro retornado porque o usuário não foi adicionado ao workspace. |
|
403 |
Invalid.Tenant.UserIsNotProjectOwnerOrAdmin |
The user is not a project administrator or owner. |
Erro retornado porque o usuário não é proprietário nem administrador do workspace. |
|
403 |
Invalid.Tenant.UserNotInTenant |
The user is not in tenant. |
Erro retornado porque o usuário não pertence ao locatário. |
Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.