Updated on 2024-06-07 GMT+08:00

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"
       } ]
     }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.