Modifier un hôte

PUT /v2/hosts/{id}

S’il existe, remplace les informations de l’hôte demandé par celles données dans la requête. Les nouvelles informations seront renvoyées dans la réponse, ainsi que leur URI d’accès.

Example request:

PUT /v2/hosts/{id} HTTP/1.1
Host: example.com
Content-Type: application/json

{
    "name": "server1",
    "address": "127.0.0.1",
    "port": 8080,
    "password": "password",
    "isSSL": false,
    "isAdmin": false,
    "isClient": false,
    "isActive": true,
    "isProxy": false
}

Status Codes

• 202 Accepted –

  L’hôte a été mis à jour avec succès.

  Example response:

  HTTP/1.1 202 Accepted
  Content-Type: application/json
  
  {
      "name": "server1",
      "address": "127.0.0.1",
      "port": 8080,
      "password": "password",
      "isSSL": false,
      "isAdmin": false,
      "isClient": false,
      "isActive": true,
      "isProxy": false
  }
  

• 400 Bad Request –

  La requête est invalide, soit à cause de paramètres de requête erronés, soit à cause d’un corps de requête invalide.

  Les causes de l’échec de la requête sont données dans le corps de la réponse sour forme d’un tableau JSON.

  Example response:

  HTTP/1.1 400 Bad Request
  Content-Type: application/json
  
  {
      "errors": [
          {
              "message": "Query parameter 'startTrans' : illegal value 'not_a_date'.",
              "errorCode": 4
          },
          {
              "message": "Query parameter 'status' : illegal value 'not_a_status'.",
              "errorCode": 4
          }
      ]
  }
  

• 404 Not Found – Dans le cas d’une requête sur une collection, cela signifie que l’identifiant donné n’existe pas dans la base de données.

• 415 Unsupported Media Type – Le type de contenu de la requête n’est pas valide pour cette requête.

Response Headers

• host-uri – Le chemin d’accès de l’hôte modifié. Si le nom d’hôte n’a pas été changé, cet URI sera identique à celui ayant été utilisé pour la requête.