All Products
Search
Document Center

AnalyticDB:DescribeApsDatasource

Last Updated:Nov 10, 2025

Queries the information about an AnalyticDB Pipeline Service (APS) data source.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID.

cn-beijing
DBClusterIdstringYes

The ID of the AnalyticDB for MySQL cluster.

am-*******
DatasourceIdlongYes

The data source ID.

1

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

******-**D8-5***-A***-****587
ApsDatasourceobject

The queried APS data source.

DatasourceNamestring

The name of the data source.

kafka-2024***
CreateTimestring

The time when the data source was created.

2024-04-12T15:03:38Z
DatasourceTypestring

The type of the data source.

KAFKA
DatasourceDescriptionstring

The description of the data source.

test
SlsInfoobject

The Simple Log Service (SLS) project.

SourceRegionIdstring

The region ID.

cn-hangzhou
Projectstring

The name of the SLS project.

***
Storestring

The name of the SLS Logstore.

***
Acrossboolean

Indicates whether the data source is a cross-account resource. Valid values:

  • true
  • false
false
AcrossUidstring

The cross-account UID.

123456
AcrossRolestring

The name of the cross-account role.

test
KafkaInfoobject

The information about the Kafka instance.

KafkaClusterIdstring

The ID of the Kafka instance.

-
KafkaTopicstring

The topic of the Kafka instance.

[{'value': 'hongxian_test'}]
HiveInfoobject

The information about the Hive data source.

MetaStoreUristring

The URL of the Hive Metastore.

-
Vswitchstring

The vSwitch ID.

vsw-******
SecurityGroupstring

The security group ID.

sg-******
EmrClusterIdstring

The ID of the E-MapReduce (EMR) cluster.

-
RdsMysqlInfoobject

The parameter is no longer supported.

UserNamestring

The parameter is no longer supported.

-
RegionIdstring

The parameter is no longer supported.

-
InstanceIdstring

The parameter is no longer supported.

-
ConnectUrlstring

The parameter is no longer supported.

-
SecurityGroupstring

The parameter is no longer supported.

-
PolarDBMysqlInfoobject

The parameter is no longer supported.

UserNamestring

The parameter is no longer supported.

-
RegionIdstring

The parameter is no longer supported.

-
InstanceIdstring

The parameter is no longer supported.

-
ConnectUrlstring

The parameter is no longer supported.

-
SecurityGroupstring

The parameter is no longer supported.

-
Acrossboolean

The parameter is no longer supported.

-
AcrossUidstring

The parameter is no longer supported.

-
AcrossRolestring

The parameter is no longer supported.

-
DBClusterIdstring

The cluster ID.

amv-******
DatabricksInfoobject

The information about Databricks.

accessTokenstring

The token that is used to access Databricks.

******
workspaceURLstring

The URL of the workspace.

-

Examples

Sample success responses

JSONformat

{
  "RequestId": "******-**D8-5***-A***-****587",
  "ApsDatasource": {
    "DatasourceName": "kafka-2024***",
    "CreateTime": "2024-04-12T15:03:38Z",
    "DatasourceType": "KAFKA",
    "DatasourceDescription": "test",
    "SlsInfo": {
      "SourceRegionId": "cn-hangzhou",
      "Project": "***",
      "Store": "***",
      "Across": false,
      "AcrossUid": 123456,
      "AcrossRole": "test"
    },
    "KafkaInfo": {
      "KafkaClusterId": "-",
      "KafkaTopic": "[{'value': 'hongxian_test'}]"
    },
    "HiveInfo": {
      "MetaStoreUri": "-",
      "Vswitch": "vsw-******",
      "SecurityGroup": "sg-******",
      "EmrClusterId": "-"
    },
    "RdsMysqlInfo": {
      "UserName": "-",
      "RegionId": "-",
      "InstanceId": "-",
      "ConnectUrl": "-",
      "SecurityGroup": "-"
    },
    "PolarDBMysqlInfo": {
      "UserName": "-",
      "RegionId": "-",
      "InstanceId": "-",
      "ConnectUrl": "-",
      "SecurityGroup": "-",
      "Across": true,
      "AcrossUid": "-",
      "AcrossRole": "-"
    },
    "DBClusterId": "amv-******",
    "DatabricksInfo": {
      "accessToken": "******",
      "workspaceURL": "-"
    }
  }
}

Error codes

HTTP status codeError codeError message
400InvalidInputThe specified parameter is invalid.

For a list of error codes, visit the Service error codes.