Ajouter un hôte¶

POST /v2/hosts¶

Ajoute un nouvel hôte à la base de données avec les attribut de l’objet passé dans le corps de la requête. La nouvelle entrée créée est renvoyée dans la réponse, ainsi que l’URI pour la consulter.

Example request:

POST /v2/hosts 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

201 Created –

Le nouvel hôte a été ajouté avec succès.

Example response:

HTTP/1.1 201 Created
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
        }
    ]
}

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

Response Headers

hostURI – L’URI d’accès aux informations du nouvel hôte.