Accueil Documentation technique API Cloud Numergy

Retour à l'accueil

Rest API documentation

hello
  • Version

    La version actuelle de l’API Openstack est la V1.1. Compte tenu des différences philosophiques entre Openstack et l’infrastructure IasS le système de versioning sera dé-corrélé de celui d’Openstack, l’objectif est donc d’arriver à une V1.0.
    • VersionGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’une version en particulier.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      Response:
      Body:
      {
      "version": {
      "id": version, Identifiant de la version
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "media-types": [ Ensemble des médias supportés dans l’API (Actuellement uniquement JSON)
      {
      "base": string, Content Type du media
      "base": mimeType, format primitif du contenu
      "type": mimeType Optionalformat du contenu
      }
      ],
      "status": enumStatusVersion, Statut de la version
      "updated": datetime Date de dernière mise à jour de la version
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1 HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "version": { "id": "V0.1", "media-types": [ { "base": "application/json" } ], "status": "CURRENT", "updated": "2012-11-24T10:50:25+0200" } }
      Sample:
      Request:
      GET /V0.1 HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "version": { "id": "V0.1", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "media-types": [ { "base": "application/json", "type": "application/json" } ], "status": "CURRENT", "updated": "2012-11-24T10:50:25+0200" } }
    • VersionsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Liste les versions disponibles.
      Request:
      Resource:
      https://api2.numergy.com/versions https://api2.numergy.com/
      Response:
      Body:
      {
      "versions": [ Ensemble des versions disponibles dans l’API
      {
      "id": version, Identifiant de la version
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "media-types": [ Ensemble des médias supportés dans l’API (Actuellement uniquement JSON)
      {
      "base": string Content Type du media
      }
      ],
      "status": enumStatusVersion, Statut de la version
      "updated": datetime Date de dernière mise à jour de la version
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /versions HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "versions": [ { "id": "V0.1", "media-types": [ { "base": "application/json" } ], "status": "CURRENT", "updated": "2012-11-24T10:50:25+0200" }, { "id": "V0.1", "media-types": [ { "base": "application/json" } ], "status": "CURRENT", "updated": "2012-11-24T10:50:25+0200" } ] }
      Sample:
      Request:
      GET / HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "versions": [ { "id": "V0.1", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "status": "CURRENT", "updated": "2012-11-24T10:50:25+0200" }, { "id": "V0.1", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "status": "CURRENT", "updated": "2012-11-24T10:50:25+0200" } ] }
  • Authentification

    L’authentification des utilisateurs de l’API s’appuie sur un couple (clé publique ; clé privée) associé à chaque environnement. Ces données d’authentification sont accessibles au client sur le selfcare. Ces données sont utilisées pour, dans un premier temps, générer un jeton, qui dispose d’une durée de vie limitée et est révocable par l’utilisateur. Ce jeton est associé à l’environnement dont les données d’authentification ont été utilisées pour le générer. Seules les actions portant sur cet environnement seront autorisées. Le jeton permet également d’obtenir la liste des environnements dont le client est le même que celui de l’environnement auquel il est associé. Ce jeton est ensuite utilisé pour effectuer les appels à l’API, il est transmis dans un en-tête HTTP X-Auth-Token.
    • TokenRequest

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Obtention du jeton
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/tokens
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      Body:
      {
      "auth": {
      "apiAccessKeyCredentials": {
      "accessKey": string, Clé public de l’environnement
      "secretKey": string Clé privée de l’environnement
      },
      "api_access_key_credentials": {
      "access_key": string, Clé public de l’environnement
      "secret_key": string Clé privée de l’environnement
      },
      "tenantId": uuid, Identifiant de l’environnement pour lequel on souhaite avoir un jeton
      "tenant_id": uuid Identifiant de l’environnement pour lequel on souhaite avoir un jeton
      }
      }
      Response:
      Body:
      {
      "access": {
      "serviceCatalog": [ Catalogue de service accesible à l’utilisateur
      {
      "endpoints": [ Liste des points d’entrée du service
      {
      "internalURL": url, Lien interne du point d’entrée
      "publicURL": url, Lien public du point d’entrée
      "region": string, Localisation du service
      "tenantId": uuid, Identifiant de l’environnement sur le point d’entrée
      "versionId": version, Version du service
      "versionInfo": url, Lien vers la documentation de la version
      "versionList": url Lien ves la liste des version
      }
      ],
      "name": string, Nom du service
      "type": enumListServiceCatalogue Type de service
      }
      ],
      "token": { Jeton d’accès
      "expires": datetime, Date limite de validité
      "id": string, Identifiant unique du jeton
      "tenant": { Environnement associé
      "id": uuid, Identifiant de l’environnement
      "name": string Name de l’environnement
      }
      },
      "user": { Utilisateur lié au token
      "id": uuid, Identifiant de l’utilisateur
      "name": string, Nom et prénom de l’utilisateur
      "roles": [ Liste des rôles de l’utilisateur
      {
      "id": uuid, Identifiant du rôle
      "name": string, Nom du rôle
      "tenantId": uuid Identifiant de l’environnement auquel s’applique le rôle
      }
      ]
      }
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/tokens HTTP/1.1 Content-Type: application/json; charset=utf-8 { "auth": { "api_access_key_credentials": { "access_key": "my_access_key", "secret_key": "my_secret_key" }, "tenant_id": "01234567-89ab-cdef-0123-456789abcdef" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "access": { "token": { "expires": "2012-11-24T10:50:25+0200", "id": "1234567890abcdefghij", "tenant": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" } } } }
      Sample:
      Request:
      POST /V0.1/tokens HTTP/1.1 Content-Type: application/json; charset=utf-8 { "auth": { "apiAccessKeyCredentials": { "accessKey": "my_accessKey", "secretKey": "my_secretKey" }, "tenantId": "01234567-89ab-cdef-0123-456789abcdef" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "access": { "serviceCatalog": [ { "endpoints": [ { "internalURL": "http://www.api.com/documentation", "publicURL": "http://www.api.com/documentation", "region": "France", "tenantId": "01234567-89ab-cdef-0123-456789abcdef", "versionId": "V0.1", "versionInfo": "http://www.api.com/documentation", "versionList": "http://www.api.com/documentation" } ], "name": "my_name", "type": "compute" }, { "endpoints": [ { "internalURL": "http://www.api.com/documentation", "publicURL": "http://www.api.com/documentation", "region": "France", "tenantId": "01234567-89ab-cdef-0123-456789abcdef", "versionId": "V0.1", "versionInfo": "http://www.api.com/documentation", "versionList": "http://www.api.com/documentation" } ], "name": "my_name", "type": "compute" } ], "token": { "expires": "2012-11-24T10:50:25+0200", "id": "1234567890abcdefghij", "tenant": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" } }, "user": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "roles": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "tenantId": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "tenantId": "01234567-89ab-cdef-0123-456789abcdef" } ] } } }
    • TokenRevoke

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Révocation du jeton
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/tokens/{token_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      token_id string Identifiant du jeton
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      DELETE /V0.1/tokens/1234567890abcdefghij HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8
  • Error

    Le succès ou les échecs des appels fait vers l’API sont determinés par le code HTTP retourné dans la réponse. 200 pour une réponse normale. Autre chose lorsqu’il y a eu un problème.
    • Error400

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 400
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "badRequest": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 400 Bad Request Content-Type: application/json; charset=utf-8 { "badRequest": { "code": 400, "details": "http://{URL}/api/", "message": "La syntaxe de la requête est erronée" } }
    • Error401

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 401
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "unauthorized": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 401 Unauthorized Content-Type: application/json; charset=utf-8 { "unauthorized": { "code": 401, "details": "http://{URL}/api/", "message": "Unauthorized request" } }
    • Error403

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 403
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "forbidden": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 403 Forbidden Content-Type: application/json; charset=utf-8 { "forbidden": { "code": 403, "details": "http://{URL}/api/", "message": "L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite" } }
    • Error404

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 404
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "itemNotFound": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      404 Not Found Ressource non trouvée
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 404 Not Found Content-Type: application/json; charset=utf-8 { "itemNotFound": { "code": 404, "details": "http://{URL}/api/", "message": "Unauthorized request" } }
    • Error405

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 405
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "badMethod": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      405 Method Not Allowed Méthode de requête non autorisée
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 405 Method Not Allowed Content-Type: application/json; charset=utf-8 { "badMethod": { "code": 405, "details": "http://{URL}/api/", "message": "Méthode de requête non autorisée" } }
    • Error409

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 409
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "buildInProgress": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      409 Conflict La requête ne peut être traitée à l’état actuel
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 409 Conflict Content-Type: application/json; charset=utf-8 { "buildInProgress": { "code": 409, "details": "http://{URL}/api/", "message": "La requête ne peut être traitée à l’état actuel" } }
    • Error413

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 413
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "overLimit": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 413 Request Entity Too Large Content-Type: application/json; charset=utf-8 { "overLimit": { "code": 413, "details": "http://{URL}/api/", "message": "Traitement abandonné dû à une requête trop importante" } }
    • Error500

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 500
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "computeFault": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      500 Internal Server Error Erreur interne du serveur
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 500 Internal Server Error Content-Type: application/json; charset=utf-8 { "computeFault": { "code": 500, "details": "http://{URL}/api/", "message": "Erreur interne du serveur" } }
    • Error503

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 503
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "serviceUnavailable": {
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 503 Service Unavailable Content-Type: application/json; charset=utf-8 { "serviceUnavailable": { "code": 503, "details": "http://{URL}/api/", "message": "Service temporairement indisponible ou en maintenance" } }
    • Generic

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Exemple d’erreur 401
      Request:
      Resource:
      https://api2.numergy.com/sample/
      Response:
      Body:
      {
      "error": { Type d’erreur.
      "code": number, Code d’erreur
      "details": string, OptionalUrl de la documentation
      "message": string Message d’erreur
      }
      }
      Codes:
      Code Message Description
      200 OK Requête traitée avec succès
      300 Multiple Choices L’URI demandée se rapporte à plusieurs ressources
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      404 Not Found Ressource non trouvée
      405 Method Not Allowed Méthode de requête non autorisée
      409 Conflict La requête ne peut être traitée à l’état actuel
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /sample/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 401 Unauthorized Content-Type: application/json; charset=utf-8 { "error": { "code": 401, "details": "http://{URL}/api/", "message": "Unauthorized request" } }
  • Environment

    Informations relatives à l’environnements Authentifié.
    • BurstGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de récupérer la quantité de burst alloué à l’environnement
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/burst
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "burst": number Burst alloué exprimé en Mio
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/burst HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "burst": 123 }
    • BurstUpdate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de modifier la quantité de burst alloué à l’environnement
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/burst
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "burst": number Burst alloué exprimé en Mio
      }
      Response:
      Body:
      {
      "burst": number Burst alloué exprimé en Mio
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 Invalid burst amount Valeur du burst saisie invalide
      401 Burst limit reached Valeur du nouveau burst supérieure au maximum défini dans les limites de l’environnement
      401 Cannot reduce disk storage below used disk Valeur du nouveau burst insuffisante par rapport à l’espace de stockage utilisé
      Sample:
      Request:
      PUT /V0.1/01234567-89ab-cdef-0123-456789abcdef/burst HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "burst": 123 }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "burst": 123 }
    • LimitsStatus

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Renvoi les limites associées à un environnement. Ceci comprend à la fois les limites en termes de fréquences d’appels à l’API et en termes physiques, nombre de serveurs et stockage.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/limits
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "limits": { Ensemble des limites de l’environnement
      "absolute": { Ensemble des limites liées à l’environnement
      "max_bandwidth": number, Bande pasasnte maximum en Mbps
      "max_burst": number, Quantité maximum de burst pouvant être alloué en Mio
      "max_server": number, Nombre maximum de serveurs sur l’environnement
      "max_storage_size": number Espace de stockage maximum alloué en Mio
      },
      "rate": [ Fréquence des appels à l’API
      {
      "limit": [ Détails des limites de l’API
      {
      "next_available": datetime, Disponibilité du prochain appel
      "remaining": number, Nombre d’appels restant
      "unit": enumUnitTimeLimit, Unité de temps
      "value": number, Limite en nombre d’appels
      "verb": enumListVerb Méthode http
      }
      ],
      "regex": regexp Expression régulière qui indique les URIs sur lesquelles sera appliquée cette limite.
      }
      ]
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/limits HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "limits": { "absolute": { "max_bandwidth": 100, "max_burst": 500, "max_server": 25, "max_storage_size": 51200 }, "rate": [ { "limit": [ { "next_available": "2012-11-24T10:50:25+0200", "remaining": 123, "unit": "MINUTE", "value": 123, "verb": "GET" }, { "next_available": "2012-11-24T10:50:25+0200", "remaining": 123, "unit": "MINUTE", "value": 123, "verb": "GET" } ], "regex": "^http(s?)://" }, { "limit": [ { "next_available": "2012-11-24T10:50:25+0200", "remaining": 123, "unit": "MINUTE", "value": 123, "verb": "GET" }, { "next_available": "2012-11-24T10:50:25+0200", "remaining": 123, "unit": "MINUTE", "value": 123, "verb": "GET" } ], "regex": "^http(s?)://" } ] } }
    • TenantsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Liste les environnements associés au client.
      Liste les environnements associés au client, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/tenants
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "tenants": [ Liste des environnements
      {
      "id": uuid, Identifiant de l’environnement
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Name de l’environnement
      "offer": string, Nom de l’offre pour l’environnement
      "public": bool Environnement Public ou Privé
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/tenants HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "tenants": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "offer": "Start", "public": true }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "offer": "Start", "public": true } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/tenants HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "tenants": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" } ] }
    • TenantsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Liste les environnements associés au client, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/tenants/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "tenants": [ Liste des environnements
      {
      "id": uuid, Identifiant de l’environnement
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Name de l’environnement
      "offer": string, Nom de l’offre pour l’environnement
      "public": bool Environnement Public ou Privé
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/tenants/detail HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "tenants": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name", "offer": "Start", "public": true }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name", "offer": "Start", "public": true } ] }
  • Request

    Afin de pouvoir suivre l’état d’une requête un identitiant de requête "request Id" est fourni dans la réponse dans la plupart des appels POST, PUT, DELETE de l’API. L’objectif est de pouvoir suivre l’état des tâches asynchrone qui peuvent prendre du temps.
    • RequestGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’une requête en particulier.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/requests/{request_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      request_id uuid Identifiant du la requête
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request": {
      "completed": datetime, OptionalDate à laquelle la demande s’est terminée, sauf si « PENDING »
      "id": uuid, Identifiant de la requête
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "message": string, OptionalMessage envoyé par la requête
      "name": enumListNameRequest, Nom de la requête
      "owner": { OptionalUtilisateur ayant demandé la requête
      "id": uuid, Identifiant de l’utilisateur
      "name": string Nom et prénom de l’utilisateur
      },
      "ownerIPv4": ip, OptionalAdresse IP de l’utilisateur ayant demandé la requête
      "received": datetime, Date à laquelle la demande a été reçue
      "resources": [ List des ressources concernées par la requête
      {
      "id": uuid, Identifiant de la ressources
      "name": string, Nom de la ressource
      "type": enumListResourceRequest Type de ressource
      }
      ],
      "status": enumStatusRequest Statut de la requête
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 Monitoring is not allowed for reseller Les revendeurs ne peuvent pas utiliser les API de monitoring
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/requests/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request": { "completed": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "message": "Echec lors de la création du serveur.", "name": "CREATE_SERVER", "owner": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, "ownerIPv4": "127.0.0.1", "received": "2012-11-24T10:50:25+0200", "resources": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" } ], "status": "PENDING" } }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/requests/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request": { "completed": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "message": "Echec lors de la création du serveur.", "name": "CREATE_SERVER", "owner": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, "received": "2012-11-24T10:50:25+0200", "resources": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" } ], "status": "PENDING" } }
    • RequestsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les requêtes sur un environnement.
      Cet appel permet de lister les requêtes sur un environnement, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/requests
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      { Optional
      "query": {
      "filter": { OptionalFiltres sur les résultats remontés
      "end_date": datetime, OptionalFiltre sur lles requêtes commençant avant cette date
      "name": string, OptionalFiltre sur le nom de l’action
      "owner_id": uuid, OptionalFiltre sur l’utilisateur ayant effectué l’action
      "resource": { OptionalFiltre la ressource impactée par la requête
      "id": uuid, Identifiant de la ressources
      "type": enumListResourceRequest Type de ressource
      },
      "start_date": datetime, OptionalFiltre sur les requêtes commençant après cette date
      "status": enumStatusRequest OptionalFiltre sur le statut de l’action
      },
      "limit": { OptionalLimite le nombre de résultats remontés
      "elements": number, OptionalNombre d’éléments renvoyés, par défaut 100.
      "page": number OptionalNuméro de la page de résultats, par défaut la première. La numérotation commence à 1.
      },
      "sort": { OptionalLimite le nombre de résultats remontés
      "column": enumListColumnRequest, Colonne de tri
      "order": enumListDirectionSort OptionalASC ou DESC
      }
      }
      }
      Response:
      Body:
      {
      "requests": [ Ensemble des requêtes
      {
      "completed": datetime, OptionalDate à laquelle la demande s’est terminée, sauf si « PENDING »
      "id": uuid, Identifiant de la requête
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "message": string, OptionalMessage envoyé par la requête
      "name": enumListNameRequest, Nom de la requête
      "owner": { OptionalUtilisateur ayant demandé la requête
      "id": uuid, Identifiant de l’utilisateur
      "name": string Nom et prénom de l’utilisateur
      },
      "ownerIPv4": ip, OptionalAdresse IP de l’utilisateur ayant demandé la requête
      "received": datetime, Date à laquelle la demande a été reçue
      "resources": [ List des ressources concernées par la requête
      {
      "id": uuid, Identifiant de la ressources
      "name": string, Nom de la ressource
      "type": enumListResourceRequest Type de ressource
      }
      ],
      "status": enumStatusRequest Statut de la requête
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 Monitoring is not allowed for reseller Les revendeurs ne peuvent pas utiliser les API de monitoring
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/requests HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "query": { "filter": { "end_date": "2012-11-24T10:50:25+0200", "name": "my_name", "owner_id": "01234567-89ab-cdef-0123-456789abcdef", "resource": { "id": "01234567-89ab-cdef-0123-456789abcdef", "type": "SERVER" }, "start_date": "2012-11-24T10:50:25+0200", "status": "PENDING" }, "limit": { "elements": 123, "page": 123 }, "sort": { "column": "NAME", "order": "ASC" } } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "requests": [ { "completed": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "message": "Echec lors de la création du serveur.", "name": "CREATE_SERVER", "owner": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, "ownerIPv4": "127.0.0.1", "received": "2012-11-24T10:50:25+0200", "resources": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" } ], "status": "PENDING" }, { "completed": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "message": "Echec lors de la création du serveur.", "name": "CREATE_SERVER", "owner": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, "ownerIPv4": "127.0.0.1", "received": "2012-11-24T10:50:25+0200", "resources": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" } ], "status": "PENDING" } ] }
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/requests HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "query": { "filter": { "end_date": "2012-11-24T10:50:25+0200", "name": "my_name", "owner_id": "01234567-89ab-cdef-0123-456789abcdef", "resource": { "id": "01234567-89ab-cdef-0123-456789abcdef", "type": "SERVER" }, "start_date": "2012-11-24T10:50:25+0200", "status": "PENDING" }, "limit": { "elements": 123, "page": 123 }, "sort": { "column": "NAME", "order": "ASC" } } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "requests": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "CREATE_SERVER" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "CREATE_SERVER" } ] }
    • RequestsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les requêtes sur un environnement, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/requests/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      { Optional
      "query": {
      "filter": { OptionalFiltres sur les résultats remontés
      "end_date": datetime, OptionalFiltre sur lles requêtes commençant avant cette date
      "name": string, OptionalFiltre sur le nom de l’action
      "owner_id": uuid, OptionalFiltre sur l’utilisateur ayant effectué l’action
      "resource": { OptionalFiltre la ressource impactée par la requête
      "id": uuid, Identifiant de la ressources
      "type": enumListResourceRequest Type de ressource
      },
      "start_date": datetime, OptionalFiltre sur les requêtes commençant après cette date
      "status": enumStatusRequest OptionalFiltre sur le statut de l’action
      },
      "limit": { OptionalLimite le nombre de résultats remontés
      "elements": number, OptionalNombre d’éléments renvoyés, par défaut 100.
      "page": number OptionalNuméro de la page de résultats, par défaut la première. La numérotation commence à 1.
      },
      "sort": { OptionalLimite le nombre de résultats remontés
      "column": enumListColumnRequest, Colonne de tri
      "order": enumListDirectionSort OptionalASC ou DESC
      }
      }
      }
      Response:
      Body:
      {
      "requests": [ Ensemble des requêtes
      {
      "completed": datetime, OptionalDate à laquelle la demande s’est terminée, sauf si « PENDING »
      "id": uuid, Identifiant de la requête
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "message": string, OptionalMessage envoyé par la requête
      "name": enumListNameRequest, Nom de la requête
      "owner": { OptionalUtilisateur ayant demandé la requête
      "id": uuid, Identifiant de l’utilisateur
      "name": string Nom et prénom de l’utilisateur
      },
      "received": datetime, Date à laquelle la demande a été reçue
      "resources": [ List des ressources concernées par la requête
      {
      "id": uuid, Identifiant de la ressources
      "name": string, Nom de la ressource
      "type": enumListResourceRequest Type de ressource
      }
      ],
      "status": enumStatusRequest Statut de la requête
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 Monitoring is not allowed for reseller Les revendeurs ne peuvent pas utiliser les API de monitoring
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/requests/detail HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "query": { "filter": { "end_date": "2012-11-24T10:50:25+0200", "name": "my_name", "owner_id": "01234567-89ab-cdef-0123-456789abcdef", "resource": { "id": "01234567-89ab-cdef-0123-456789abcdef", "type": "SERVER" }, "start_date": "2012-11-24T10:50:25+0200", "status": "PENDING" }, "limit": { "elements": 123, "page": 123 }, "sort": { "column": "NAME", "order": "ASC" } } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "requests": [ { "completed": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "message": "Echec lors de la création du serveur.", "name": "CREATE_SERVER", "owner": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, "received": "2012-11-24T10:50:25+0200", "resources": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" } ], "status": "PENDING" }, { "completed": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "message": "Echec lors de la création du serveur.", "name": "CREATE_SERVER", "owner": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, "received": "2012-11-24T10:50:25+0200", "resources": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "type": "SERVER" } ], "status": "PENDING" } ] }
  • Backup

    La sauvegarde s’articule autour de deux fonctionnalités : les snapshots et la sauvegarde automatisée. • Le snapshot permet de créer une sauvegarde complète d’un serveur à un instant T. • La sauvegarde automatisée va inscrire le serveur dans une politique de sauvegarde. Dès qu’il est enregistré celui-ci est sauvegardé automatiquement toutes les nuits sur une durée de un mois.
    • SnapshotCreate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Demande la création d’une nouvelle sauvegarde
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/snapshots/servers/{server_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid, Identifiant de la requête
      "snapshot": { Information sur le snapshot
      "id": uuid, OptionalIdentifiant de la sauvegarde
      "policy": bool, Indique si le snapshot a été réalisée dans le cadre d’une politique de sauvegarde. Les sauvegardes de type INCREASE ne peuvent avoir été réalisées que dans le cadre d’une politique de sauvegarde.
      "server_id": uuid, Identifiant du serveur ayant servi à créer la sauvegarde
      "status": enumStatusSnapshot, État du snapshot
      "type": enumListSnapshot, Indique s’il s’agit de la sauvegarde incrémentale ou complète du serveur
      "user_id": uuid Identifiant de l’utilisateur ayant demandé la sauvegarde
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/servers/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef", "snapshot": { "id": "01234567-89ab-cdef-0123-456789abcdef", "policy": false, "server_id": "01234567-89ab-cdef-0123-456789abcdef", "status": "COMPLETED", "type": "COMPLETE", "user_id": "01234567-89ab-cdef-0123-456789abcdef" } }
    • SnapshotDelete

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Demande la suppression d’une sauvegarde.
      Attention, la suppression d’un snapshot faisant partie de la politique de sauvegarde du serveur supprime aussi tous les snapshots plus récents jusqu’au prochain snapshot complet. Donc si vous supprimez un snapshot complet vous supprimez tous les snapshots différentiels dont il est la référence jusqu’au prochain snapshot complet, soit jusqu’à six snapshots différentiels.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/snapshots/{snapshot_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      snapshot_id uuid Identifiant de la sauvegarde
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid Identifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 Snapshot already deleted La sauvegarde est déjà supprimée
      400 Snapshot not terminated La sauvegarde est en cours de réalisation
      503 Server backup is not available L’action backup n’est pas disponible.
      Sample:
      Request:
      DELETE /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • SnapshotGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’une sauvegarde en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/snapshots/{snapshot_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      snapshot_id uuid Identifiant de la sauvegarde
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "snapshot": { Sauvegarde demandée
      "created": datetime, OptionalDate à laquelle la sauvegarde a été créée, pas demandée
      "id": uuid, Identifiant de la sauvegarde
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "policy": bool, Indique si le snapshot a été réalisée dans le cadre d’une politique de sauvegarde. Les sauvegardes de type INCREASE ne peuvent avoir été réalisées que dans le cadre d’une politique de sauvegarde.
      "server_id": uuid, Identifiant du serveur ayant servi à créer la sauvegarde
      "size": number, Taille en Mio de la sauvegarde
      "status": enumStatusSnapshot, État du snapshot
      "type": enumListSnapshot, Indique s’il s’agit de la sauvegarde incrémentale ou complète du serveur
      "user_id": uuid OptionalIdentifiant de l’utilisateur ayant demandé la sauvegarde
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Server backup is not available L’action backup n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "snapshot": { "created": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "policy": false, "server_id": "01234567-89ab-cdef-0123-456789abcdef", "size": 123, "status": "COMPLETED", "type": "COMPLETE", "user_id": "01234567-89ab-cdef-0123-456789abcdef" } }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "snapshot": { "created": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "policy": false, "server_id": "01234567-89ab-cdef-0123-456789abcdef", "size": 123, "status": "COMPLETED", "type": "COMPLETE", "user_id": "01234567-89ab-cdef-0123-456789abcdef" } }
    • SnapshotRestore

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Il y a deux solutions pour restaurer un snapshot, soit on le restaure en écrasant le serveur d’origine, soit on crée un nouveau serveur à partir d’un serveur déjà existant.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/snapshots/{snapshot_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      snapshot_id uuid Identifiant de la sauvegarde
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "restore": {
      "address": ip, OptionalAdresse IP de la nouvelle machine. Doit être omise pour un environnement public. Si elle est omise pour un environnement privé, la première adresse IP disponible sera utilisée.
      "password_delivery": enumListPasswordDelivry, Mode de fonctionnement de l’envoie du mot de passe
      "type": enumListRestoreSnapshot Le type de restauration demandée
      }
      }
      Response:
      Body:
      {
      "request_id": uuid, Identifiant de la requête
      "server": {
      "created": datetime, Date à laquelle la demande de restauration a été effectuée
      "id": uuid, Identifiant du serveur
      "status": enumStatusRequest, État de la restauration
      "user_id": uuid Identifiant de l’utilisateur ayant demandé la sauvegarde
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 Bad IP address format L’environnement est privé et l’adresse IP spécifiée n’est pas une adresse IP valide.
      400 Private IP Address cannot be specified Un IP privé ne soit pas être spécifié sur un environnement public
      400 Private IP address can’t be specified in a Public Cloud L’environnement est public mais une adresse IP a été spécifiée.
      400 Snapshot is deleted La sauvegarde à restaurer a été supprimée.
      400 The server is deleted La machine à restaurer a été supprimée. La sauvegarde ne peut donc être restaurée par écrasement.
      401 IP Adress already used L’adresse IP spécifiée est déjà utilisée par un autre serveur.
      404 IP address not found L’adresse IP spécifiée n’existe pas.
      404 No more ips available Il n’y a plus d’adresses IP disponible pour créer de nouvelle machine.
      409 Job status is not completed La sauvegarde à restaurer n’est pas encore terminée. Il est impossible de restaurer une sauvegarde incomplète.
      413 Not enough disk space available Il n’y a plus assez d’espace disponible sur l’environnement pour effectuer la restauration demandée.
      500 Source Server Image is no longer usable Ce type de serveur n’est plus disponible. Cette sauvegarde ne peut donc pas être restaurée sur une nouvelle machine.
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "restore": { "address": "127.0.0.1", "password_delivery": "API", "type": "CREATE" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef", "server": { "created": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "status": "PENDING", "user_id": "01234567-89ab-cdef-0123-456789abcdef" } }
    • SnapshotsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les sauvegardes d’un serveur.
      Cet appel permet de lister les sauvegardes d’un serveur, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/snapshots/servers/{server_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      Query String Parameters:
      Parameter Type Optional Description
      policy bool Optional Ce paramètre permet de filtrer la requête pour n’obtenir que les snapshots appartenant à une politique de sauvegarde ou non.
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "snapshots": [ Ensemble des sauvegardes
      {
      "created": datetime, OptionalDate à laquelle la sauvegarde a été créée, pas demandée
      "id": uuid, Identifiant de la sauvegarde
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "policy": bool, Indique si le snapshot a été réalisée dans le cadre d’une politique de sauvegarde. Les sauvegardes de type INCREASE ne peuvent avoir été réalisées que dans le cadre d’une politique de sauvegarde.
      "server_id": uuid, Identifiant du serveur ayant servi à créer la sauvegarde
      "size": number, Taille en Mio de la sauvegarde
      "status": enumStatusSnapshot, État du snapshot
      "type": enumListSnapshot, Indique s’il s’agit de la sauvegarde incrémentale ou complète du serveur
      "user_id": uuid OptionalIdentifiant de l’utilisateur ayant demandé la sauvegarde
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Server backup is not available L’action backup n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/servers/01234567-89ab-cdef-0123-456789abcdef?policy=True HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "snapshots": [ { "created": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "policy": false, "server_id": "01234567-89ab-cdef-0123-456789abcdef", "size": 123, "status": "COMPLETED", "type": "COMPLETE", "user_id": "01234567-89ab-cdef-0123-456789abcdef" }, { "created": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "policy": false, "server_id": "01234567-89ab-cdef-0123-456789abcdef", "size": 123, "status": "COMPLETED", "type": "COMPLETE", "user_id": "01234567-89ab-cdef-0123-456789abcdef" } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/servers/01234567-89ab-cdef-0123-456789abcdef?policy=True HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "snapshots": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ] }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ] } ] }
    • SnapshotsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les sauvegardes d’un serveur, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/snapshots/servers/{server_id}/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      Query String Parameters:
      Parameter Type Optional Description
      policy bool Optional Ce paramètre permet de filtrer la requête pour n’obtenir que les snapshots appartenant à une politique de sauvegarde ou non.
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "snapshots": [ Ensemble des sauvegardes
      {
      "created": datetime, OptionalDate à laquelle la sauvegarde a été créée, pas demandée
      "id": uuid, Identifiant de la sauvegarde
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "policy": bool, Indique si le snapshot a été réalisée dans le cadre d’une politique de sauvegarde. Les sauvegardes de type INCREASE ne peuvent avoir été réalisées que dans le cadre d’une politique de sauvegarde.
      "server_id": uuid, Identifiant du serveur ayant servi à créer la sauvegarde
      "size": number, Taille en Mio de la sauvegarde
      "status": enumStatusSnapshot, État du snapshot
      "type": enumListSnapshot, Indique s’il s’agit de la sauvegarde incrémentale ou complète du serveur
      "user_id": uuid OptionalIdentifiant de l’utilisateur ayant demandé la sauvegarde
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Server backup is not available L’action backup n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/snapshots/servers/01234567-89ab-cdef-0123-456789abcdef/detail?policy=True HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "snapshots": [ { "created": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "policy": false, "server_id": "01234567-89ab-cdef-0123-456789abcdef", "size": 123, "status": "COMPLETED", "type": "COMPLETE", "user_id": "01234567-89ab-cdef-0123-456789abcdef" }, { "created": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "policy": false, "server_id": "01234567-89ab-cdef-0123-456789abcdef", "size": 123, "status": "COMPLETED", "type": "COMPLETE", "user_id": "01234567-89ab-cdef-0123-456789abcdef" } ] }
  • Export

    • ExportCreate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de demander l’export d’un serveur.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/servers/{server_id}/exports
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid Identifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 No disk exportable Le serveur ne contient pas de disque exportable
      400 Server deleted Le serveur est supprimé
      409 Server already has a pending action Une autre action est déjà en cours sur le serveur
      413 No more disk space available for the environment Il n’y a plus d’espace disponible pour votre environnement
      503 Server export is not available L’action d’export n’est pas disponible.
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/servers/01234567-89ab-cdef-0123-456789abcdef/exports HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • ExportDelete

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la suppression d’un export.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/servers/{server_id}/exports/{export_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      export_id uuid Identifiant du export
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid Identifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      404 Not Found Le serveur ou l’export n’existe pas
      503 Server export is not available L’action d’export n’est pas disponible.
      Sample:
      Request:
      DELETE /V0.1/01234567-89ab-cdef-0123-456789abcdef/servers/01234567-89ab-cdef-0123-456789abcdef/exports/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • ExportGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’un export en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/servers/{server_id}/exports/{export_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      export_id uuid Identifiant de l’export
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "export": { Export demandé
      "files": [ Liste des fichiers contenu dans l’export
      {
      "descriptor": bool, Determine si le fichier correspond au fichier descripteur du disque
      "id": string, Identifiant du fichier
      "link": url, Lien permetant de télécharger le fichier (spécifier le X-Auth-Token dans le header de la requête).
      "size": number Taille du fichier en Mio du fichier
      }
      ],
      "id": uuid, Identifiant de l’export
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ]
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Server export is not available L’action d’export n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/servers/01234567-89ab-cdef-0123-456789abcdef/exports/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "export": { "files": [ { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 }, { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 } ], "id": "01234567-89ab-cdef-0123-456789abcdef" } }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/servers/01234567-89ab-cdef-0123-456789abcdef/exports/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "export": { "files": [ { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 }, { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ] } }
    • ExportsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les exports d’un serveur.
      Cet appel permet de lister les exports d’un serveur, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/servers/{server_id}/exports
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "exports": [ Ensemble des exports
      {
      "files": [ Liste des fichiers contenu dans l’export
      {
      "descriptor": bool, Determine si le fichier correspond au fichier descripteur du disque
      "id": string, Identifiant du fichier
      "link": url, Lien permetant de télécharger le fichier (spécifier le X-Auth-Token dans le header de la requête).
      "size": number Taille du fichier en Mio du fichier
      }
      ],
      "id": uuid, Identifiant de l’export
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ]
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Server export is not available L’action d’export n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/servers/01234567-89ab-cdef-0123-456789abcdef/exports HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "exports": [ { "files": [ { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 }, { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 } ], "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "files": [ { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 }, { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 } ], "id": "01234567-89ab-cdef-0123-456789abcdef" } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/servers/01234567-89ab-cdef-0123-456789abcdef/exports HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "exports": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ] }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ] } ] }
    • ExportsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les exports d’un serveur, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/servers/{server_id}/exports/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "exports": [ Ensemble des exports
      {
      "files": [ Liste des fichiers contenu dans l’export
      {
      "descriptor": bool, Determine si le fichier correspond au fichier descripteur du disque
      "id": string, Identifiant du fichier
      "link": url, Lien permetant de télécharger le fichier (spécifier le X-Auth-Token dans le header de la requête).
      "size": number Taille du fichier en Mio du fichier
      }
      ],
      "id": uuid, Identifiant de l’export
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ]
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Server export is not available L’action d’export n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/servers/01234567-89ab-cdef-0123-456789abcdef/exports/detail HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "exports": [ { "files": [ { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 }, { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ] }, { "files": [ { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 }, { "descriptor": true, "id": "my_id", "link": "http://www.api.com/documentation", "size": 10240 } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ] } ] }
  • Extension

    • ExtensionGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Liste les extensions disponibles sur l’API
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/extensions/{alias}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      alias string Alias de l’extension
      Response:
      Body:
      {
      "extension": {
      "alias": string, Identifiant de l’extension
      "description": string, Description de l’extension
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Nom de l’extension
      "namespace": url, Espace de nom de l’extension
      "updated": datetime Date de mise à jours de l’extension
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/extensions/my_alias HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "extension": { "alias": "my_alias", "description": "my_description", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name", "namespace": "http://www.api.com/documentation", "updated": "2012-11-24T10:50:25+0200" } }
    • ExtensionsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Liste les extensions disponibles sur l’API
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/extensions/
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      Response:
      Body:
      {
      "extensions": [ Liste des extensions
      {
      "alias": string, Identifiant de l’extension
      "description": string, Description de l’extension
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Nom de l’extension
      "namespace": url, Espace de nom de l’extension
      "updated": datetime Date de mise à jours de l’extension
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/extensions/ HTTP/1.1 Content-Type: application/json; charset=utf-8
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "extensions": [ { "alias": "my_alias", "description": "my_description", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name", "namespace": "http://www.api.com/documentation", "updated": "2012-11-24T10:50:25+0200" }, { "alias": "my_alias", "description": "my_description", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name", "namespace": "http://www.api.com/documentation", "updated": "2012-11-24T10:50:25+0200" } ] }
  • Flavor-Image

    Methodes relatives aux Image et aux gabarits. On retrouve la notion de catalogue dans Openstack sous la forme d’Images, il s’agit de l’ensemble des images disponibles lors de la création d’une instance.
    • FlavorGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’un gabarit en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/flavors/{flavor_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      flavor_id uuid Optional Identifiant du gabarit
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "flavor": { Gabarit demandée
      "N-FWV:size": number, OptionalTaille du disque data a attacher à la VM en Mio
      "id": uuid, Identifiant du gabarit
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Nom du gabarit
      "ram": number, Taille de la ram en Mio
      "vcpus": number Nombre de VCPUs
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/flavors/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "flavor": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ram": 2048, "vcpus": 4 } }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/flavors/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "flavor": { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "N-FWV:size": 102400, "name": "my_name", "ram": 2048, "vcpus": 4 } }
    • FlavorsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne le détail des gabarits disponibles sur la plateforme.
      Donne le détail des gabarits disponibles sur la plateforme, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/flavors
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Query String Parameters:
      Parameter Type Optional Description
      min_ram number Optional Filtre les images ayant un minimum de RAM (en Mio)
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "flavors": [ Liste des gabarits disponibles
      {
      "id": uuid, Identifiant du gabarit
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Nom du gabarit
      "ram": number, Taille de la ram en Mio
      "vcpus": number Nombre de VCPUs
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/flavors HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ram": 2048, "vcpus": 4 }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ram": 2048, "vcpus": 4 } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/flavors?min_ram=2048 HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" } ] }
    • FlavorsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne le détail des gabarits disponibles sur la plateforme, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/flavors/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Query String Parameters:
      Parameter Type Optional Description
      min_ram number Optional Filtre les images ayant un minimum de RAM (en Mio)
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "flavors": [ Liste des gabarits disponibles
      {
      "N-FWV:size": number, OptionalTaille du disque data a attacher à la VM en Mio
      "id": uuid, Identifiant du gabarit
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Nom du gabarit
      "ram": number, Taille de la ram en Mio
      "vcpus": number Nombre de VCPUs
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 The minRam argument must be a number Le format du paramèter min_ram n’est pas valide
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/flavors/detail?min_ram=2048 HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "N-FWV:size": 102400, "name": "my_name", "ram": 2048, "vcpus": 4 }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "N-FWV:size": 102400, "name": "my_name", "ram": 2048, "vcpus": 4 } ] }
    • ImageGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’une image en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/images/{image_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      image_id uuid Optional Identifiant de l’image
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "image": { Image demandée
      "activated": bool, Booléen indiquant si l’image est active ou non
      "created": datetime, Date de création de l’image
      "flavors": [ Liste des gabarits autorisés pour l’image
      {
      "id": uuid, Identifiant du gabarit
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string Nom du gabarit
      }
      ],
      "id": uuid, Identifiant de l’image
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "metadata": {
      string:
      },
      "name": string, Nom de l’image
      "progress": percent, Pourcentage de progression de mise en place de l’image
      "public": bool, Booléen indiquant si l’image fait partie du catalogue privé ou public
      "status": enumStatusImage, Status de l’image
      "updated": datetime Date de dernière mise à jour de l’image
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/images/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "image": { "activated": true, "created": "2012-11-24T10:50:25+0200", "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "public": true, "updated": "2012-11-24T10:50:25+0200" } }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/images/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "image": { "created": "2012-11-24T10:50:25+0200", "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "metadata": { "architecture": "x86_64", "os": "Linux" }, "name": "my_name", "progress": 10, "public": true, "status": "ACTIVE", "updated": "2012-11-24T10:50:25+0200" } }
    • ImagesList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Liste les images disponibles.
      Liste les images disponibles, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/images
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Query String Parameters:
      Parameter Type Optional Description
      name regexp Optional Expression régulière sur le nom des images pour filtrer les images à remonter
      server_id uuid Optional Filtre les images associées à un serveur
      status enumStatusImage Optional Filtre les images à remonter
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "images": [ Ensemble des images présentes au catalogue de l’environnement
      {
      "activated": bool, Booléen indiquant si l’image est active ou non
      "created": datetime, Date de création de l’image
      "flavors": [ Liste des gabarits autorisés pour l’image
      {
      "id": uuid Identifiant du gabarit
      }
      ],
      "id": uuid, Identifiant de l’image
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string, Nom de l’image
      "public": bool, Booléen indiquant si l’image fait partie du catalogue privé ou public
      "updated": datetime Date de dernière mise à jour de l’image
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/images?name=(LAMP|WAMP) HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "images": [ { "activated": true, "created": "2012-11-24T10:50:25+0200", "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "public": true, "updated": "2012-11-24T10:50:25+0200" }, { "activated": true, "created": "2012-11-24T10:50:25+0200", "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "public": true, "updated": "2012-11-24T10:50:25+0200" } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/images?status=ACTIVE&amps;server_id=01234567-89ab-cdef-0123-456789abcdef&amps;name=(LAMP|WAMP) HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "images": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" } ] }
    • ImagesListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Liste les images disponibles, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/images/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Query String Parameters:
      Parameter Type Optional Description
      name regexp Optional Expression régulière sur le nom des images pour filtrer les images à remonter
      server_id uuid Optional Filtre les images associées à un serveur
      status enumStatusImage Optional Filtre les images à remonter
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "images": [ Ensemble des images présentes au catalogue de l’environnement
      {
      "created": datetime, Date de création de l’image
      "flavors": [ Liste des gabarits autorisés pour l’image
      {
      "id": uuid, Identifiant du gabarit
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "name": string Nom du gabarit
      }
      ],
      "id": uuid, Identifiant de l’image
      "links": [ Liste des liens pour accéder à la ressource
      {
      "href": url, Url du lien
      "rel": enumListLinkRel, Type de lien
      "type": mimeType OptionalFormat du contenu
      }
      ],
      "metadata": {
      string:
      },
      "name": string, Nom de l’image
      "progress": percent, Pourcentage de progression de mise en place de l’image
      "public": bool, Booléen indiquant si l’image fait partie du catalogue privé ou public
      "status": enumStatusImage, Status de l’image
      "updated": datetime Date de dernière mise à jour de l’image
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/images/detail?status=ACTIVE&amps;server_id=01234567-89ab-cdef-0123-456789abcdef&amps;name=(LAMP|WAMP) HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "images": [ { "created": "2012-11-24T10:50:25+0200", "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "metadata": { "architecture": "x86_64", "os": "Linux" }, "name": "my_name", "progress": 10, "public": true, "status": "ACTIVE", "updated": "2012-11-24T10:50:25+0200" }, { "created": "2012-11-24T10:50:25+0200", "flavors": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "name": "my_name" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "links": [ { "href": "http://www.api.com/documentation", "rel": "self", "type": "application/json" } ], "metadata": { "architecture": "x86_64", "os": "Linux" }, "name": "my_name", "progress": 10, "public": true, "status": "ACTIVE", "updated": "2012-11-24T10:50:25+0200" } ] }
  • FlowRules

    La matrice de flux permet de configurer les ouvertures de flux entre les IP publiques de votre environnement et le monde extérieur. Pour cela il est nécessaire de mettre en place des règles de routage entre les IP publiques ( RIPs ) de l’environnement et les IPs avec lesquelles on souhaite les mettre en relation. Une règle est construite à partir de : • Un groupe d’IP publiques de l’environnement • Le sens de la règle, entrant, sortant ou les deux • Le protocole, TCP, UDP ou les deux • Le groupe de ports ouverts • La liste des IPs extérieures à l’environnement ou ANY Une règle peut être activée ou désactivée. Lorsqu’elle est désactivée, le flux correspondant à la règle est coupé.
    • GroupExternalIpCreate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la création d’un groupe
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_external_ips
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "group_external_ip": {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "ips": [ OptionalListe des IPs externes du groupe
      {
      "ip": ip Adresse IP externe
      }
      ],
      "name": string, Nom du groupe
      "subnets": [ OptionalListe des subnets du groupe
      {
      "ip": ip, Adresse réseau
      "prefix": number Identifiant du sous-groupe
      }
      ]
      }
      }
      Response:
      Body:
      {
      "group_external_ip_id": uuid Identifiant du groupe
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_external_ips HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "group_external_ip": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "ips": [ { "ip": "127.0.0.1" }, { "ip": "127.0.0.1" } ], "name": "my_name", "subnets": [ { "ip": "127.0.0.1", "prefix": 24 }, { "ip": "127.0.0.1", "prefix": 24 } ] } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_external_ip_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupExternalIpDelete

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la suppression d’un groupe
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_external_ips/{group_external_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_external_ip_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      DELETE /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_external_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupExternalIpGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’un groupe en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_external_ips/{group_external_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_external_ip_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_external_ip": {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "ips": [ OptionalListe des IPs externes du groupe
      {
      "ip": ip Adresse IP externe
      }
      ],
      "name": string, Nom du groupe
      "subnets": [ OptionalListe des subnets du groupe
      {
      "ip": ip, Adresse réseau
      "prefix": number Identifiant du sous-groupe
      }
      ]
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_external_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_external_ip": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ips": [ { "ip": "127.0.0.1" }, { "ip": "127.0.0.1" } ], "name": "my_name", "subnets": [ { "ip": "127.0.0.1", "prefix": 24 }, { "ip": "127.0.0.1", "prefix": 24 } ] } }
    • GroupExternalIpUpdate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la mise à jours d’un groupe.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_external_ips/{group_external_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_external_ip_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "group_external_ip": {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "ips": [ OptionalListe des IPs externes du groupe
      {
      "ip": ip Adresse IP externe
      }
      ],
      "name": string, Nom du groupe
      "subnets": [ OptionalListe des subnets du groupe
      {
      "ip": ip, Adresse réseau
      "prefix": number Identifiant du sous-groupe
      }
      ]
      }
      }
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête (null si pas de requête)
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 The group ID is missing L’identifiant du groupe est manquant
      Sample:
      Request:
      PUT /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_external_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "group_external_ip": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "ips": [ { "ip": "127.0.0.1" }, { "ip": "127.0.0.1" } ], "name": "my_name", "subnets": [ { "ip": "127.0.0.1", "prefix": 24 }, { "ip": "127.0.0.1", "prefix": 24 } ] } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupExternalIpsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les groupes d’IPs externes d’un environnement.
      Cet appel permet de lister les groupes d’IPs externes d’un environnement, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_external_ips
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_external_ips": [ Ensemble des groupes
      {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "ips": [ OptionalListe des IPs externes du groupe
      {
      "ip": ip Adresse IP externe
      }
      ],
      "name": string, Nom du groupe
      "subnets": [ OptionalListe des subnets du groupe
      {
      "ip": ip, Adresse réseau
      "prefix": number Identifiant du sous-groupe
      }
      ]
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_external_ips HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_external_ips": [ { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ips": [ { "ip": "127.0.0.1" }, { "ip": "127.0.0.1" } ], "name": "my_name", "subnets": [ { "ip": "127.0.0.1", "prefix": 24 }, { "ip": "127.0.0.1", "prefix": 24 } ] }, { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ips": [ { "ip": "127.0.0.1" }, { "ip": "127.0.0.1" } ], "name": "my_name", "subnets": [ { "ip": "127.0.0.1", "prefix": 24 }, { "ip": "127.0.0.1", "prefix": 24 } ] } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_external_ips HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_external_ips": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" } ] }
    • GroupExternalIpsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les groupes d’IPs externes d’un environnement, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_floating_ips/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_external_ips": [ Ensemble des groupes
      {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "ips": [ OptionalListe des IPs externes du groupe
      {
      "ip": ip Adresse IP externe
      }
      ],
      "name": string, Nom du groupe
      "subnets": [ OptionalListe des subnets du groupe
      {
      "ip": ip, Adresse réseau
      "prefix": number Identifiant du sous-groupe
      }
      ]
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips/detail HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_external_ips": [ { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ips": [ { "ip": "127.0.0.1" }, { "ip": "127.0.0.1" } ], "name": "my_name", "subnets": [ { "ip": "127.0.0.1", "prefix": 24 }, { "ip": "127.0.0.1", "prefix": 24 } ] }, { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ips": [ { "ip": "127.0.0.1" }, { "ip": "127.0.0.1" } ], "name": "my_name", "subnets": [ { "ip": "127.0.0.1", "prefix": 24 }, { "ip": "127.0.0.1", "prefix": 24 } ] } ] }
    • GroupFloatingIpCreate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la création d’un groupe Par défaut, chaque IP interne d’un environnement est contenu dans un groupe atomique qui contient un identifiant, un nom et l’adresse IP. Tous les groupes composés par l’utilisateurs sont des groupes de groupes
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_floating_ips
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "group_floating_ip": {
      "groups": [ Liste des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "name": string Nom du groupe
      }
      }
      Response:
      Body:
      {
      "group_floating_ip_id": uuid Identifiant du groupe
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "group_floating_ip": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "name": "my_name" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_floating_ip_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupFloatingIpDelete

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la suppression d’un groupe
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_floating_ips/{group_floating_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_floating_ip_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      DELETE /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupFloatingIpGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’un groupe en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_floating_ips/{group_floating_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_floating_ip_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_floating_ip": {
      "groups": [ Liste des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "ip": ip, OptionalAdresse IP du groupe
      "name": string Nom du groupe
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_floating_ip": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name" } }
    • GroupFloatingIpUpdate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la mise à jours d’un groupe.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_floating_ips/{group_floating_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_floating_ip_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "group_floating_ip": {
      "groups": [ Liste des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "name": string Nom du groupe
      }
      }
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête (null si pas de requête)
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 The group ID is missing L’identifiant du groupe est manquant
      Sample:
      Request:
      PUT /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "group_floating_ip": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "name": "my_name" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupFloatingIpsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les groupes d’IPs publiques d’un environnement.
      Cet appel permet de lister les groupes d’IPs publiques d’un environnement, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_floating_ips
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_floating_ips": [ Ensemble des groupes
      {
      "groups": [ Liste des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "ip": ip, OptionalAdresse IP du groupe
      "name": string Nom du groupe
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_floating_ips": [ { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name" }, { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name" } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_floating_ips": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" } ] }
    • GroupFloatingIpsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les groupes d’IPs publiques d’un environnement, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_floating_ips/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_floating_ips": [ Ensemble des groupes
      {
      "groups": [ Liste des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "ip": ip, OptionalAdresse IP du groupe
      "name": string Nom du groupe
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_floating_ips/detail HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_floating_ips": [ { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name" }, { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name" } ] }
    • GroupPortCreate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la création d’un groupe
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_ports
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "group_port": {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "name": string, Nom du groupe
      "ports": [ OptionalListe des ports du groupe
      {
      "port": number Numéro du port
      }
      ],
      "segments": [ OptionalListe des plages de ports du groupe
      {
      "end": number, Fin de la plage
      "start": number Début de la plage
      }
      ]
      }
      }
      Response:
      Body:
      {
      "group_port_id": uuid Identifiant du groupe
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_ports HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "group_port": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "name": "my_name", "ports": [ { "port": 123 }, { "port": 123 } ], "segments": [ { "end": 84, "start": 80 }, { "end": 84, "start": 80 } ] } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_port_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupPortDelete

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la suppression d’un groupe
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_ports/{group_port_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_port_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      DELETE /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_ports/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupPortGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’un groupe en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_ports/{group_port_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_port_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_port": {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "name": string, Nom du groupe
      "ports": [ OptionalListe des ports du groupe
      {
      "port": number Numéro du port
      }
      ],
      "segments": [ OptionalListe des plages de ports du groupe
      {
      "end": number, Fin de la plage
      "start": number Début de la plage
      }
      ]
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_ports/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_port": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ports": [ { "port": 123 }, { "port": 123 } ], "segments": [ { "end": 84, "start": 80 }, { "end": 84, "start": 80 } ] } }
    • GroupPortUpdate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la mise à jours d’un groupe.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_ports/{group_port_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      group_port_id uuid Identifiant du groupe
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "group_port": {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "name": string, Nom du groupe
      "ports": [ OptionalListe des ports du groupe
      {
      "port": number Numéro du port
      }
      ],
      "segments": [ OptionalListe des plages de ports du groupe
      {
      "end": number, Fin de la plage
      "start": number Début de la plage
      }
      ]
      }
      }
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête (null si pas de requête)
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 The group ID is missing L’identifiant du groupe est manquant
      Sample:
      Request:
      PUT /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_ports/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "group_port": { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "name": "my_name", "ports": [ { "port": 123 }, { "port": 123 } ], "segments": [ { "end": 84, "start": 80 }, { "end": 84, "start": 80 } ] } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • GroupPortsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les groupes de ports d’un environnement.
      Cet appel permet de lister les groupes de ports d’un environnement, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_ports
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_ports": [ Ensemble des groupes
      {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "name": string, Nom du groupe
      "ports": [ OptionalListe des ports du groupe
      {
      "port": number Numéro du port
      }
      ],
      "segments": [ OptionalListe des plages de ports du groupe
      {
      "end": number, Fin de la plage
      "start": number Début de la plage
      }
      ]
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_ports HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_ports": [ { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ports": [ { "port": 123 }, { "port": 123 } ], "segments": [ { "end": 84, "start": 80 }, { "end": 84, "start": 80 } ] }, { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ports": [ { "port": 123 }, { "port": 123 } ], "segments": [ { "end": 84, "start": 80 }, { "end": 84, "start": 80 } ] } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_ports HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_ports": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" } ] }
    • GroupPortsListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les groupes de ports d’un environnement, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/group_ports/detail
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "group_ports": [ Ensemble des groupes
      {
      "groups": [ OptionalListe des sous-groupes
      {
      "id": uuid Identifiant du sous-groupe
      }
      ],
      "id": uuid, Identifiant du groupe
      "name": string, Nom du groupe
      "ports": [ OptionalListe des ports du groupe
      {
      "port": number Numéro du port
      }
      ],
      "segments": [ OptionalListe des plages de ports du groupe
      {
      "end": number, Fin de la plage
      "start": number Début de la plage
      }
      ]
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/group_ports/detail HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "group_ports": [ { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ports": [ { "port": 123 }, { "port": 123 } ], "segments": [ { "end": 84, "start": 80 }, { "end": 84, "start": 80 } ] }, { "groups": [ { "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "id": "01234567-89ab-cdef-0123-456789abcdef" } ], "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name", "ports": [ { "port": 123 }, { "port": 123 } ], "segments": [ { "end": 84, "start": 80 }, { "end": 84, "start": 80 } ] } ] }
    • RouteTableCreate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la création d’une route.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/route_tables
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "route_table": {
      "group_external_ips_id": uuid, Identifiant du groupe d’IPs externes
      "group_floating_ips_id": uuid, Identifiant du Groupe d’IPs internes
      "group_ports_id": uuid, Identifiant du groupe de ports
      "in_out": enumListDirectionRoute, Sens de la route
      "name": string, Nom de la route
      "protocols": enumListProtocolRoute, Liste des protocoles supportés par la route
      "status": enumStatusRoute Statut de la route
      }
      }
      Response:
      Body:
      {
      "request_id": uuid, OptionalIdentifiant de la requête
      "route_table_id": uuid Identifiant de la route
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 A part of the given route table is already covered by an existing route table Tout ou partie de la route couvre une autre route
      400 A route table can not cover every port and "ANY" internet address Une route ne doit pas être de type ANY/ANY
      401 This route table can not be edited La route ne peut pas être modifiée
      503 Route tables are not available La gestion des routes n’est pas disponible.
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/route_tables HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "route_table": { "group_external_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_floating_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_ports_id": "01234567-89ab-cdef-0123-456789abcdef", "in_out": "OUT", "name": "my_name", "protocols": "TCP", "status": "ACTIVE" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef", "route_table_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • RouteTableDelete

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la suppression d’une route.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/route_tables/{route_table_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      route_table_id uuid Identifiant de la route
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      409 An action is already pending on the given route table Une autre action est déjà en cours sur la route
      503 Route tables are not available La gestion des routes n’est pas disponible.
      Sample:
      Request:
      DELETE /V0.1/01234567-89ab-cdef-0123-456789abcdef/route_tables/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • RouteTableGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’une route en particulier
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/route_tables/{route_table_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      route_table_id uuid Identifiant de la route
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "route_table": { Route demandée
      "group_external_ips_id": uuid, Identifiant du groupe d’IPs externes
      "group_floating_ips_id": uuid, Identifiant du Groupe d’IPs internes
      "group_ports_id": uuid, Identifiant du groupe de ports
      "id": uuid, Identifiant de la route
      "in_out": enumListDirectionRoute, Sens de la route
      "name": string, Nom de la route
      "protocols": enumListProtocolRoute, Liste des protocoles supportés par la route
      "status": enumStatusRoute Statut de la route
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Route tables are not available La gestion des routes n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/route_tables/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "route_table": { "group_external_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_floating_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_ports_id": "01234567-89ab-cdef-0123-456789abcdef", "id": "01234567-89ab-cdef-0123-456789abcdef", "in_out": "OUT", "name": "my_name", "protocols": "TCP", "status": "ACTIVE" } }
    • RouteTableUpdate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel demande la mise à jours d’une route.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/route_tables/{route_table_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      route_table_id uuid Identifiant de la route
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "route_table": {
      "group_external_ips_id": uuid, Identifiant du groupe d’IPs externes
      "group_floating_ips_id": uuid, Identifiant du Groupe d’IPs internes
      "group_ports_id": uuid, Identifiant du groupe de ports
      "in_out": enumListDirectionRoute, Sens de la route
      "name": string, Nom de la route
      "protocols": enumListProtocolRoute, Liste des protocoles supportés par la route
      "status": enumStatusRoute Statut de la route
      }
      }
      Response:
      Body:
      {
      "request_id": uuid OptionalIdentifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 A part of the given route table is already covered by an existing route table Tout ou partie de la route couvre une autre route
      400 A route table can not cover every port and "ANY" internet address Une route ne doit pas être de type ANY/ANY
      400 The route table ID is missing L’identifiant de la route est manquant
      401 This route table can not be edited La route ne peut pas être modifiée
      503 Route tables are not available La gestion des routes n’est pas disponible.
      Sample:
      Request:
      PUT /V0.1/01234567-89ab-cdef-0123-456789abcdef/route_tables/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "route_table": { "group_external_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_floating_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_ports_id": "01234567-89ab-cdef-0123-456789abcdef", "in_out": "OUT", "name": "my_name", "protocols": "TCP", "status": "ACTIVE" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • RouteTablesList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les routes d’un environnement.
      Cet appel permet de lister les routes d’un environnement, sans les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/route_tables
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "route_tables": [ Ensemble des routes
      {
      "group_external_ips_id": uuid, Identifiant du groupe d’IPs externes
      "group_floating_ips_id": uuid, Identifiant du Groupe d’IPs internes
      "group_ports_id": uuid, Identifiant du groupe de ports
      "id": uuid, Identifiant de la route
      "in_out": enumListDirectionRoute, Sens de la route
      "name": string, Nom de la route
      "protocols": enumListProtocolRoute, Liste des protocoles supportés par la route
      "status": enumStatusRoute Statut de la route
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Route tables are not available La gestion des routes n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/route_tables HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "route_tables": [ { "group_external_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_floating_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_ports_id": "01234567-89ab-cdef-0123-456789abcdef", "id": "01234567-89ab-cdef-0123-456789abcdef", "in_out": "OUT", "name": "my_name", "protocols": "TCP", "status": "ACTIVE" }, { "group_external_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_floating_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_ports_id": "01234567-89ab-cdef-0123-456789abcdef", "id": "01234567-89ab-cdef-0123-456789abcdef", "in_out": "OUT", "name": "my_name", "protocols": "TCP", "status": "ACTIVE" } ] }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/route_tables HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "route_tables": [ { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" }, { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "my_name" } ] }
    • RouteTablesListDetail

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les routes d’un environnement, avec les détails.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/route_tables
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "route_tables": [ Ensemble des routes
      {
      "group_external_ips_id": uuid, Identifiant du groupe d’IPs externes
      "group_floating_ips_id": uuid, Identifiant du Groupe d’IPs internes
      "group_ports_id": uuid, Identifiant du groupe de ports
      "id": uuid, Identifiant de la route
      "in_out": enumListDirectionRoute, Sens de la route
      "name": string, Nom de la route
      "protocols": enumListProtocolRoute, Liste des protocoles supportés par la route
      "status": enumStatusRoute Statut de la route
      }
      ]
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      503 Route tables are not available La gestion des routes n’est pas disponible.
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/route_tables HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "route_tables": [ { "group_external_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_floating_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_ports_id": "01234567-89ab-cdef-0123-456789abcdef", "id": "01234567-89ab-cdef-0123-456789abcdef", "in_out": "OUT", "name": "my_name", "protocols": "TCP", "status": "ACTIVE" }, { "group_external_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_floating_ips_id": "01234567-89ab-cdef-0123-456789abcdef", "group_ports_id": "01234567-89ab-cdef-0123-456789abcdef", "id": "01234567-89ab-cdef-0123-456789abcdef", "in_out": "OUT", "name": "my_name", "protocols": "TCP", "status": "ACTIVE" } ] }
  • Monitoring

    Le monitoring permet de récupérer des statistiques et données relatives à l’utilisation de la plate-forme.
    • MeasureFloatingIp

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de récupérer les données de monitorings relatives aux IP publiques
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/monitoring/floating_ip/{floating_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      floating_ip_id uuid Identifiant de l’IP publique
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "floating_ip": {
      "measures": [ Ensemble des sauvegardes
      enumListMeasureNetworkFloatingIp Type de mesure demandée
      ],
      "period": enumUnitTimeMonitoring Plage de periode souhaitée
      }
      }
      Response:
      Body:
      {
      "floating_ip": {
      "end_date": datetime, Date de la dernière valeur
      "measures": [ Ensemble des mesures demandées
      {
      "data": [
      number OptionalListe de valeurs. L’absence de donnée est transcrit par la valeur "NULL".
      ],
      "data_unit": enumUnitDataNework, Unitée de la donnée
      "measure": enumListMeasureNetworkFloatingIp Type de mesure remontée
      }
      ],
      "start_date": datetime, Date de la première valeur
      "step": number, Nombre d’unités de temps entre deux valeurs
      "step_unit": enumUnitTimeStep Unité de temps entre deux valeurs
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/monitoring/floating_ip/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "floating_ip": { "measures": [ "DIRECTION_IN", "DIRECTION_IN" ], "period": "DAY" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "floating_ip": { "end_date": "2012-11-24T10:50:25+0200", "measures": [ { "data": [ 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2 ], "data_unit": "Kbps", "measure": "DIRECTION_IN" }, { "data": [ 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2 ], "data_unit": "Kbps", "measure": "DIRECTION_IN" } ], "start_date": "2012-11-24T10:50:25+0200", "step": 300, "step_unit": "SECOND" } }
    • MeasureLoadbalancer

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de récupérer les données de monitorings relatives aux LoadBalancer
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/monitoring/loadbalancer/{loadbalancer_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      loadbalancer_id uuid Identifiant du LoadBalancer
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "loadbalancer": {
      "measures": [ Ensemble des sauvegardes
      enumListMeasureNetworkLoadBalancer Type de mesure demandée
      ],
      "period": enumUnitTimeMonitoring Plage de periode souhaitée
      }
      }
      Response:
      Body:
      {
      "loadbalancer": {
      "end_date": datetime, Date de la dernière valeur
      "measures": [ Ensemble des mesures demandées
      {
      "data_unit": enumUnitDataNework, Unitée de la donnée
      "measure": enumListMeasureNetworkLoadBalancer, Type de mesure remontée
      "nodes": [ Liste des nœud
      {
      "data": [
      number OptionalListe de valeurs. L’absence de donnée est transcrit par la valeur "NULL".
      ],
      "id": uuid Identifiant du nœud
      }
      ]
      }
      ],
      "start_date": datetime, Date de la première valeur
      "step": number, Nombre d’unités de temps entre deux valeurs
      "step_unit": enumUnitTimeStep Unité de temps entre deux valeurs
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/monitoring/loadbalancer/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "loadbalancer": { "measures": [ "DIRECTION_IN", "DIRECTION_IN" ], "period": "DAY" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "loadbalancer": { "end_date": "2012-11-24T10:50:25+0200", "measures": [ { "data_unit": "Kbps", "measure": "DIRECTION_IN", "nodes": [ { "data": [ 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2 ], "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "data": [ 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2 ], "id": "01234567-89ab-cdef-0123-456789abcdef" } ] }, { "data_unit": "Kbps", "measure": "DIRECTION_IN", "nodes": [ { "data": [ 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2 ], "id": "01234567-89ab-cdef-0123-456789abcdef" }, { "data": [ 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2, 5.2 ], "id": "01234567-89ab-cdef-0123-456789abcdef" } ] } ], "start_date": "2012-11-24T10:50:25+0200", "step": 300, "step_unit": "SECOND" } }
    • MeasureServer

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de récupérer les données de monitorings relatives aux serveurs
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/monitoring/server/{server_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      server_id uuid Identifiant du serveur
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "server": {
      "measures": [ Ensemble des sauvegardes
      enumListMeasureServer Type de mesure demandée
      ],
      "period": enumUnitTimeMonitoring Plage de periode souhaitée
      }
      }
      Response:
      Body:
      {
      "server": {
      "end_date": datetime, Date de la dernière valeur
      "measures": [ Ensemble des mesures demandées
      {
      "data": [
      number OptionalListe de valeurs. L’absence de donnée est transcrit par la valeur "NULL".
      ],
      "data_unit": enumUnitDataServer, Unitée de la donnée
      "measure": enumListMeasureServer Type de mesure remontée
      }
      ],
      "start_date": datetime, Date de la première valeur
      "step": number, Nombre d’unités de temps entre deux valeurs
      "step_unit": enumUnitTimeStep Unité de temps entre deux valeurs
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/monitoring/server/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "server": { "measures": [ "CPU", "CPU" ], "period": "DAY" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "server": { "end_date": "2012-11-24T10:50:25+0200", "measures": [ { "data": [ 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1 ], "data_unit": "RATIO", "measure": "CPU" }, { "data": [ 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1, 0.1 ], "data_unit": "RATIO", "measure": "CPU" } ], "start_date": "2012-11-24T10:50:25+0200", "step": 300, "step_unit": "SECOND" } }
    • MeasureStorage

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de récupérer les données de monitorings relatives au stockage de données
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/monitoring/storage
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "storage": {
      "measures": [ Ensemble des sauvegardes
      enumListMeasureStorage Type de mesure demandée
      ],
      "period": enumUnitTimeMonitoring Plage de periode souhaitée
      }
      }
      Response:
      Body:
      {
      "storage": {
      "end_date": datetime, Date de la dernière valeur
      "measures": [ Ensemble des mesures demandées
      {
      "data": [
      number OptionalListe de valeurs. L’absence de donnée est transcrit par la valeur "NULL".
      ],
      "data_unit": enumUnitDataStorage, Unitée de la donnée
      "measure": enumListMeasureStorage Type de mesure remontée
      }
      ],
      "start_date": datetime, Date de la première valeur
      "step": number, Nombre d’unités de temps entre deux valeurs
      "step_unit": enumUnitTimeStep Unité de temps entre deux valeurs
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/monitoring/storage HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "storage": { "measures": [ "SERVER", "SERVER" ], "period": "DAY" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "storage": { "end_date": "2012-11-24T10:50:25+0200", "measures": [ { "data": [ 2048, 2048, 2048, 2048, 2048, 2048, 2048, 2048, 2048, 2048 ], "data_unit": "MiB", "measure": "SERVER" }, { "data": [ 2048, 2048, 2048, 2048, 2048, 2048, 2048, 2048, 2048, 2048 ], "data_unit": "MiB", "measure": "SERVER" } ], "start_date": "2012-11-24T10:50:25+0200", "step": 300, "step_unit": "SECOND" } }
    • Usage

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de récupérer les données de monitorings relatives aux serveurs
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/monitoring/usage
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Query String Parameters:
      Parameter Type Optional Description
      end_date datetime Date de fin
      start_date datetime Date de début
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      { Utilisation de l’environnement
      "usage": { Ensembles des usages
      "end_date": datetime, Date de fin
      "servers": [ Liste des serveurs
      {
      "created": datetime, Date de création du serveur
      "deleted": datetime, OptionalDate de suppression du serveur (null lorsque le serveur existe toujours)
      "id": uuid, Identifiant du serveur
      "image": { Image du serveur
      "id": uuid, Identifiant de l’image
      "name": uuid Nom de l’image
      },
      "max_flavor": { Gabarit maximum utilisé sur la période
      "id": uuid, Identifiant du gabarit
      "name": uuid Nom du gabarit
      },
      "uptime": number Temps en SECONDES où la machine était allumée sur la période
      }
      ],
      "start_date": datetime Date de début
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      400 A start date parameter is required Il manque le paramètre start_date
      400 An end date parameter is required Il manque le paramètre end_date
      400 Monitoring is not allowed for reseller Les revendeurs ne peuvent pas utiliser les API de monitoring
      400 The end date is not valid Le paramètre end_date n’est pas une date valide
      400 The start date is not valid Le paramètre start_date n’est pas une date valide
      400 The start date must be before the end date La date du paramètre start_date doit être antérieur à celle du paramètre end_date
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/monitoring/usage?end_date=2012-11-24T10:50:25+0200&amps;start_date=2012-11-24T10:50:25+0200 HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "usage": { "end_date": "2012-11-24T10:50:25+0200", "servers": [ { "created": "2012-11-24T10:50:25+0200", "deleted": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "image": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "01234567-89ab-cdef-0123-456789abcdef" }, "max_flavor": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "01234567-89ab-cdef-0123-456789abcdef" }, "uptime": 123 }, { "created": "2012-11-24T10:50:25+0200", "deleted": "2012-11-24T10:50:25+0200", "id": "01234567-89ab-cdef-0123-456789abcdef", "image": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "01234567-89ab-cdef-0123-456789abcdef" }, "max_flavor": { "id": "01234567-89ab-cdef-0123-456789abcdef", "name": "01234567-89ab-cdef-0123-456789abcdef" }, "uptime": 123 } ], "start_date": "2012-11-24T10:50:25+0200" } }
  • Network

    Le service des IP publique et des LoadBalancers est packagé sous forme de PackIP comprenant un certain nombre d’IP publique et de LoadBalancer. Lorsque l’on ajoute un PackIp à un environnement les IP publiques sont ajoutées au pool de l’IP publique de l’environnement et les LoadBalancers aux LoadBalancers
    • FloatingIpCreate

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel réserve une Ip.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/os-floating-ips/{floating_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      floating_ip_id uuid Identifiant de l’IP à reserver
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "floating_ip": { l'ip configurée
      "blocked": bool, Indique si l’adresse IP est bloquée ou non
      "fixed_ip": ip, OptionalAdresse IPv4 du serveur, null si aucune.
      "id": uuid, Identifiant de l’IP
      "instance_id": uuid, OptionalIdentifiant de l’instance à laquelle est liée l’IP, null si aucune.
      "ip": ip, OptionalAdresse IPv4
      "name": string Nom de l’IP
      },
      "request_id": uuid Identifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/os-floating-ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "floating_ip": { "blocked": true, "fixed_ip": "127.0.0.1", "id": "01234567-89ab-cdef-0123-456789abcdef", "instance_id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name" }, "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • FloatingIpGet

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Donne les détails d’une IP en particulier.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/os_floating_ips/{floating_ip_id} https://api2.numergy.com/{version_id}/{tenant_id}/os-floating-ips/{floating_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      floating_ip_id uuid Identifiant de l’IP
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "floating_ip": { IP demandée
      "blocked": bool, Indique si l’adresse IP est bloquée ou non
      "fixed_ip": ip, OptionalAdresse IPv4 du serveur, null si aucune.
      "id": uuid, Identifiant de l’IP
      "instance_id": uuid, OptionalIdentifiant de l’instance à laquelle est liée l’IP, null si aucune.
      "ip": ip, OptionalAdresse IPv4
      "name": string, Nom de l’IP
      "server_id": uuid OptionalIdentifiant de l’instance à laquelle est liée l’IP, null si aucune.
      }
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/os_floating_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "floating_ip": { "blocked": true, "fixed_ip": "127.0.0.1", "id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name", "server_id": "01234567-89ab-cdef-0123-456789abcdef" } }
      Sample:
      Request:
      GET /V0.1/01234567-89ab-cdef-0123-456789abcdef/os-floating-ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "floating_ip": { "blocked": true, "fixed_ip": "127.0.0.1", "id": "01234567-89ab-cdef-0123-456789abcdef", "instance_id": "01234567-89ab-cdef-0123-456789abcdef", "ip": "127.0.0.1", "name": "my_name" } }
    • FloatingIpMap

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet d’associer un serveur avec une IP publique d’un environnement.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/os-floating-ips/{floating_ip_id}/addFloatingIp
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      floating_ip_id uuid Identifiant de l’IP publique
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "addFloatingIp": {
      "address": ip, Adresse IPv4 du serveur.
      "server": uuid Identifiant du serveur associé
      }
      }
      Response:
      Body:
      {
      "request_id": uuid Identifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      409 Another request is pending Une autre action est déjà en cours sur cette Ip
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/os-floating-ips/01234567-89ab-cdef-0123-456789abcdef/addFloatingIp HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "addFloatingIp": { "address": "127.0.0.1", "server": "01234567-89ab-cdef-0123-456789abcdef" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • FloatingIpRename

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Met à jour la configuration de l’IP publique. Seul le nom est paramétrable le reste est « immutable » et entraîne une erreur.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/os_floating_ips/{floating_ip_id} https://api2.numergy.com/{version_id}/{tenant_id}/os-floating-ips/{floating_ip_id}
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      floating_ip_id uuid Identifiant de l’IP
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "name": string Nom de l’IP
      }
      Response:
      Body:
      {
      "request_id": uuid Identifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      Sample:
      Request:
      PUT /V0.1/01234567-89ab-cdef-0123-456789abcdef/os_floating_ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "name": "my_name" }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
      Sample:
      Request:
      PUT /V0.1/01234567-89ab-cdef-0123-456789abcdef/os-floating-ips/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "name": "my_name" }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • FloatingIpUnmap

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de supprimer l’association entre un serveur et une IP publique d’un environnement.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/os-floating-ips/{floating_ip_id}/removeFloatingIp
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      floating_ip_id uuid Identifiant de l’IP publique
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Body:
      {
      "removeFloatingIp": {
      "address": ip, Adresse IPv4 du serveur.
      "server": uuid Identifiant du serveur associé
      }
      }
      Response:
      Body:
      {
      "request_id": uuid Identifiant de la requête
      }
      Codes:
      Code Message Description
      400 Bad Request La syntaxe de la requête est erronée
      401 Unauthorized Une authentification est nécessaire pour accéder à la ressource
      403 Forbidden L’authentification est refusée. Contrairement à l’erreur 401, aucune demande d’authentification ne sera faite
      413 Request Entity Too Large Traitement abandonné dû à une requête trop importante
      500 Internal Server Error Erreur interne du serveur
      503 Service Unavailable Service temporairement indisponible ou en maintenance
      409 Another request is pending Une autre action est déjà en cours sur cette Ip
      Sample:
      Request:
      POST /V0.1/01234567-89ab-cdef-0123-456789abcdef/os-floating-ips/01234567-89ab-cdef-0123-456789abcdef/removeFloatingIp HTTP/1.1 Content-Type: application/json; charset=utf-8 X-Auth-Token: 1234567890abcdefghij { "removeFloatingIp": { "address": "127.0.0.1", "server": "01234567-89ab-cdef-0123-456789abcdef" } }
      Response:
      HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 { "request_id": "01234567-89ab-cdef-0123-456789abcdef" }
    • FloatingIpsList

      Diff
      • v1.0
      • v1.1
      • v2.0
      no implementation for this version
      Cet appel permet de lister les IPs publiques d’un environnement.
      Request:
      Resource:
      https://api2.numergy.com/{version_id}/{tenant_id}/os_floating_ips https://api2.numergy.com/{version_id}/{tenant_id}/os-floating-ips
      URI Parameters:
      Parameter Type Optional Description
      version_id version Identifiant de la version
      tenant_id uuid Identifiant de l’environnement
      Headers:
      Parameter Type Description
      X-Auth-Token string Jeton d’authentification
      Response:
      Body:
      {
      "floating_ips": [ Ensemble des IP publiques
      {
      "blocked": bool, Indique si l’adresse IP est bloquée ou non
      "fixed_ip": ip, OptionalAdresse IPv4 du serveur, null si aucune.
      "id": uuid, Identifiant de l’IP
      "instance_id":