Querying MSDTC Hosts

Function

This API is used to query MSDTC hosts.

Before calling an API, you need to understand the API in Authentication.

URI

URI format
GET /v3/{project_id}/instances/{instance_id}/msdtc/hosts?offset={offset}&limit={limit}

Parameter description

**Table 1** Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.
offset	No	Integer	Pagination parameter. The minimum value is 0. Default value: 0
limit	No	Integer	Pagination parameter. The value ranges from 1 to 100. Default value: 10

Request

Request parameters
None

URI example
GET https://{endpoint}/v3/054b93101a00d3a02fe3c01fb31462ac/instances/8ef19e30cbf44c79b63c7e6b2168a400in04/msdtc/hosts

Response

Normal response

**Table 2** Parameters
Parameter	Type	Description
total_count	Integer	Total number of hosts.
hosts	Array of objects	Host list. For details, see Table 3.

**Table 3** hosts element structure description
Parameter	Type	Description
id	String	Host ID.
host	String	Host address.
host_name	String	Host name.

Example normal response

{
   "total_count" : 1,
   "hosts" : [ {
     "id" : "527dd9ca-cc2c-4bac-8707-f9b4f55343f4",
     "host" : "192.168.0.90",
     "host_name" : "MSSQL-00E5FB7A"
   } ]
 }