Updating the IP-Domain Mapping

Function

This API is used to update a specified IP-domain mapping.

URI

  • URI format

    PATCH /v1.0/{project_id}/reserved_cluster/{cluster_id}/hosts/{host_id}

  • Parameter description
    Table 1 URI parameter description

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

    cluster_id

    Yes

    Cluster ID.

    host_id

    Yes

    Domain name ID.

Request

  • Example request
    {
      "hosts_info": {
        "hostname": "test.cs.com",
        "ip": "10.113.27.139"
      }
    }
  • Parameter description
    Table 2 Request parameters

    Parameter

    Mandatory

    Type

    Description

    hosts_info

    Yes

    None

    Information about the new IP address and domain name.

    hostname

    Yes

    String

    New domain name.

    ip

    Yes

    String

    New IP address.

Response

  • Example response
    {
      "message_id":"CS.22019",
      "message":"Host information is updated successfully.",
      "current_time":1533686888000
    }
  • Parameter description
    Table 3 Response parameters

    Parameter

    Mandatory

    Type

    Description

    message_id

    No

    String

    Message type ID.

    message

    No

    String

    Message content.

    current_time

    No

    Int

    Current time, expressed by milliseconds.

Status Code

Table 4 describes the status code.

Table 4 Status Code

Status Code

Description

200

The IP-domain mapping is updated successfully.

400

The input parameters are invalid.

Error Code

For details, see Error Codes.