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.

En-têtes de réponse:
  • 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.