section> Computing
  • Auto Scaling
  • Bare Metal Server
  • Dedicated Host
  • Elastic Cloud Server
  • FunctionGraph
  • Image Management Service
Network
  • Direct Connect
  • Domain Name Service
  • Elastic IP
  • Elastic Load Balancing
  • Enterprise Router
  • NAT Gateway
  • Private Link Access Service
  • Secure Mail Gateway
  • Virtual Private Cloud
  • Virtual Private Network
  • VPC Endpoint
Storage
  • Cloud Backup and Recovery
  • Cloud Server Backup Service
  • Elastic Volume Service
  • Object Storage Service
  • Scalable File Service
  • Storage Disaster Recovery Service
  • Volume Backup Service
Application
  • API Gateway (APIG)
  • Application Operations Management
  • Application Performance Management
  • Distributed Message Service (for Kafka)
  • Simple Message Notification
Data Analysis
  • Cloud Search Service
  • Data Lake Insight
  • Data Warehouse Service
  • DataArts Studio
  • MapReduce Service
  • ModelArts
  • Optical Character Recognition
Container
  • Application Service Mesh
  • Cloud Container Engine
  • Cloud Container Instance
  • Software Repository for Containers
Databases
  • Data Replication Service
  • Distributed Cache Service
  • Distributed Database Middleware
  • Document Database Service
  • GeminiDB
  • Relational Database Service
  • TaurusDB
Management & Deployment
  • Cloud Create
  • Cloud Eye
  • Cloud Trace Service
  • Config
  • Log Tank Service
  • Resource Formation Service
  • Tag Management Service
Security Services
  • Anti-DDoS
  • Cloud Firewall
  • Database Security Service
  • Dedicated Web Application Firewall
  • Host Security Service
  • Identity and Access Management
  • Key Management Service
  • Web Application Firewall
Other
  • Enterprise Dashboard
  • Marketplace
  • Price Calculator
  • Status Dashboard
APIs
  • REST API
  • API Usage Guidelines
  • Endpoints
Development and Automation
  • SDKs
  • Drivers and Tools
  • Terraform
  • Ansible
  • Cloud Create
Architecture Center
  • Best Practices
  • Blueprints
IaaSComputingAuto ScalingBare Metal ServerDedicated HostElastic Cloud ServerFunctionGraphImage Management ServiceNetworkDirect ConnectDomain Name ServiceElastic IPElastic Load BalancingEnterprise RouterNAT GatewayPrivate Link Access ServiceSecure Mail GatewayVirtual Private CloudVirtual Private NetworkVPC EndpointStorageCloud Backup and RecoveryCloud Server Backup ServiceElastic Volume ServiceObject Storage ServiceScalable File ServiceStorage Disaster Recovery ServiceVolume Backup ServicePaaSApplicationAPI Gateway (APIG)Application Operations ManagementApplication Performance ManagementDistributed Message Service (for Kafka)Simple Message NotificationData AnalysisCloud Search ServiceData Lake InsightData Warehouse ServiceDataArts StudioMapReduce ServiceModelArtsOptical Character RecognitionContainerApplication Service MeshCloud Container EngineCloud Container InstanceSoftware Repository for ContainersDatabasesData Replication ServiceDistributed Cache ServiceDistributed Database MiddlewareDocument Database ServiceGeminiDBRelational Database ServiceTaurusDBManagementManagement & DeploymentCloud CreateCloud EyeCloud Trace ServiceConfigLog Tank ServiceResource Formation ServiceTag Management ServiceSecuritySecurity ServicesAnti-DDoSCloud FirewallDatabase Security ServiceDedicated Web Application FirewallHost Security ServiceIdentity and Access ManagementKey Management ServiceWeb Application FirewallOtherOtherEnterprise DashboardMarketplacePrice CalculatorStatus Dashboard

DataArts Studio

  • Before You Start
  • API Overview
  • Calling APIs
  • Application Cases
  • DataArts Migration APIs
    • Cluster Management
    • Job Management
    • Link Management
      • Creating a Link
      • Querying a Link
      • Deleting a Link
      • Modifying a Link
    • Public Data Structures
  • DataArts Factory APIs
  • Appendix
  • API Reference
  • DataArts Migration APIs
  • Link Management
  • Querying a Link

Querying a Link¶

Function¶

This API is used to query a link.

URI¶

GET /v1.1/{project_id}/clusters/{cluster_id}/cdm/link/{link_name}

Table 1 Path Parameters¶

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

cluster_id

Yes

String

Cluster ID

link_name

Yes

String

Link name

Request Parameters¶

Table 2 Request header parameters¶

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Response Parameters¶

Status code: 200

Table 3 Response body parameters¶

Parameter

Type

Description

links

Array of links objects

Link list. For details, see the descriptions of links parameters.

fromTo-unMapping

String

Source and destination data sources not supported by table/file migration

batchFromTo-mapping

String

Source and destination data sources supported by entire DB migration

Table 4 links¶

Parameter

Type

Description

link-config-values

link-config-values object

Link parameters. For details, see the descriptions of link-config-values parameters.

creation-user

String

User who created the link

name

String

Link name

id

Integer

Link ID

creation-date

Long

Time when the link was created

connector-name

String

Connector name. The mappings between the connectors and links are as follows:

generic-jdbc-connector: link to a relational database obs-connector: OBS link hdfs-connector: HDFS link hbase-connector: HBase or CloudTable link hive-connector: Hive link ftp-connector/sftp-connector: link to an FTP or SFTP server mongodb-connector: MongoDB link redis-connector: Redis or DCS link kafka-connector: Kafka link dis-connector: DIS link elasticsearch-connector: Elasticsearch or CSS link dli-connector: DLI link http-connector: HTTP or HTTPS link. This type of link does not have parameters. dms-kafka-connector: DMS Kafka link

update-date

Long

Time when the link was updated

enabled

Boolean

Whether to activate the link. The default value is true.

update-user

String

User who updated the link

Table 5 link-config-values¶

Parameter

Type

Description

configs

Array of configs objects

Data structure of link parameters. For details, see the descriptions of configs parameters.

extended-configs

extended-configs object

Extended configuration. For details, see the descriptions of extended-configs parameters.

validators

Array of strings

Validator

Table 6 configs¶

Parameter

Type

Description

inputs

Array of Input objects

Input parameter list. Each element in the list is in name,value format. For details, see the descriptions of inputs parameters. In the from-config-values data structure, the value of this parameter varies with the source link type. For details, see section "Source Job Parameters" in the Cloud Data Migration User Guide. In the to-cofig-values data structure, the value of this parameter varies with the destination link type. For details, see section "Destination Job Parameters" in the Cloud Data Migration User Guide. For details about the inputs parameter in the driver-config-values data structure, see the job parameter descriptions.

name

String

Configuration name. The value is fromJobConfig for a source job, toJobConfig for a destination job, and linkConfig for a link.

id

Integer

Configuration ID

type

String

Configuration type

Table 7 Input¶

Parameter

Type

Description

name

String

Parameter name

value

String

Parameter value

type

String

Value type

Table 8 extended-configs¶

Parameter

Type

Description

name

String

Name

value

String

Value

Example Requests¶

GET /v1.1/1551c7f6c808414d8e9f3c514a170f2e/clusters/6ec9a0a4-76be-4262-8697-e7af1fac7920/cdm/link/sftplink

Example Responses¶

Status code: 200

OK

{
  "links" : [ {
    "link-config-values" : {
      "configs" : [ {
        "inputs" : [ {
          "name" : "linkConfig.server",
          "type" : "STRING",
          "value" : "100.94.8.163"
        }, {
          "name" : "linkConfig.port",
          "type" : "INTEGER",
          "value" : 22
        }, {
          "name" : "linkConfig.username",
          "type" : "STRING",
          "value" : "root"
        }, {
          "name" : "linkConfig.password",
          "type" : "STRING",
          "value" : "Add password here"
        } ],
        "name" : "linkConfig"
      } ]
    },
    "creation-user" : "cdm",
    "name" : "sftp_link",
    "creation-date" : 1516674482640,
    "connector-name" : "sftp-connector",
    "update-date" : 1516674476022,
    "enabled" : true,
    "update-user" : "cdm"
  } ]
}

Status Codes¶

Status Code

Description

200

OK

400

Request error.

401

Authentication failed.

403

You do not have required permissions to perform this operation.

404

The requested resource was not found.

500

An internal service error occurred. For details, see error codes.

503

Service unavailable.

Error Codes¶

See Error Codes.

  • Prev
  • Next
last updated: 2025-07-09 16:05 UTC - commit: 61336f3c2e25ce26cb038bce82678d028fe5d438
Edit pageReport Documentation Bug
Page Contents
  • Querying a Link
    • Function
    • URI
    • Request Parameters
    • Response Parameters
    • Example Requests
    • Example Responses
    • Status Codes
    • Error Codes
© T-Systems International GmbH
  • Contact
  • Data privacy
  • Disclaimer of Liabilities
  • Imprint