Modifying Host Information

Function

This API is used to modify the host information of a connected datasource. Only full overwriting is supported.

URI

URI format
PUT /v2.0/{project_id}/datasource/enhanced-connections/{connection_id}

Parameter description

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which is used for resource isolation. For details about how to obtain its value, see Obtaining a Project ID.
connection_id	Yes	String	Connection ID. Identifies the UUID of a datasource connection.

Request

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
hosts	Yes	Array of objects	The user-defined host information. A maximum of 20,000 records are supported. For details, see hosts request parameters. If this parameter is left blank, all configured host information will be deleted.

**Table 3** hosts request parameters
Parameter	Mandatory	Type	Description
name	No	String	The user-defined host name. The value can consist of 128 characters, including digits, letters, underscores (_), hyphens (-), and periods (.). It must start with a letter.
ip	No	String	The IPv4 address of the host.

Response

**Table 4** Response parameters
Parameter	Type	Description
is_success	Boolean	Indicates whether the request is successfully executed. Value true indicates that the request is successfully executed.
message	String	System prompt. If execution succeeds, the message may be left blank.

Example Request

Modify the host information of an enhanced datasource connection.

{
  "hosts": [
    {
      "ip":"192.168.0.1",
      "name":"ecs-97f8-0001"
    },
    {
      "ip":"192.168.0.2", 
      "name":"ecs-97f8-0002"
    }
  ]
}

Example Response

{
  "is_success": true,
  "message": ""
}

Status Codes

Table 5 describes the status code.

**Table 5** Status codes
Status Code	Description
200	The modification operations are successful.
400	Request error.
500	Internal service error.

Error Codes

If an error occurs when this API is invoked, the system does not return the result similar to the preceding example, but returns the error code and error information. For details, see Error Codes.

Parent topic: APIs Related to Enhanced Datasource Connections

Previous topic: Unbinding a Queue

Next topic: Querying Authorization of an Enhanced Datasource Connection