Function

This API is used to add host addresses for Microsoft Distributed Transaction Coordinator (MSDTC).

Before calling an API, you need to understand the API in Authentication.
Before calling this API, obtain the required region and endpoint.

Constraints

This API is available only for RDS for SQL Server.

URI

URI format
POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/msdtc/host

Parameter description

**Table 1** URI Parameters
Name	Mandatory	Description
project_id	Yes	Specifies the 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	Specifies the DB instance ID.

Request

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	The content type. The default value is application/json.
X-Auth-Token	Yes	String	Specifies the user token. The user token is a response to the API used to obtain a user token.

**Table 3** Request body parameters
Name	Mandatory	Type	Description
hosts	Yes	Array of objects	Host information. For details on the element structure, see Table 4.

**Table 4** Hosts data structure description
Name	Mandatory	Type	Description
host_name	Yes	String	Host name.
ip	Yes	String	Host IP address.

Request example

Add host addresses for MSDTC.

POST https://rds.eu-de.otc.t-systems.com/v3/054b93101a00d3a02fe3c01fb31462ac/instances/463a6520abc345888850ea5bfb245e4fin04/msdtc/host

{
   "hosts" : [ {
     "host_name" : "pc1",
     "ip" : "127.0.0.1"
   } ]
 }

Response

Normal response
Table 5 Response body parameters
Name

Type

Description

job_id

String

Task ID.

**Table 5** Response body parameters
Name	Type	Description
job_id	String	Task ID.

Example normal response

{
   "job_id" : "603d87db-9a91-411e-b369-ca4d72007e27"
 }

Abnormal response
For details, see Abnormal Request Results.

Status Code

Normal
202
Abnormal
For details, see Status Codes.

Error Code

For details, see Error Codes.

Adding Host Addresses for MSDTC