doc-exports/docs/rds/api-ref/rds_08_0035.html

Adding Host Addresses for MSDTC

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.

• 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.

Parent topic: DB Instance Management