Exemples d’utilisation

Avec un navigateur Web

  1. Pointer votre navigateur Web sur l’adresse https://tsmlabapi.in2p3.fr en vérifiant bien le certificat SSL présenté par le site Web avant de saisir vos identifiants.

  2. Saisir les identifiants qui vous ont communiqué par les administrateurs du service de sauvegarde du CC-IN2P3.

L’interface Web qui est actuellement affichée n’est que le résultat d’un rendu basique effectué par votre navigateur Web du document XML retourné par l’API.

En ligne de commande

L’outil qui sera utilisé à titre d’exemple est cURL. Les options qui seront utilisées dans les exemples suivants sont :

  • -H "Accept: application/json" qui permet de rajouter le header HTTP Accept: application/json à la requête ;

  • -u "username:password" qui permet de s’authentifier auprès du serveur Web avec le login « username » et le mot de passe « password » ;

  • -L qui indique à cURL de suivre les redirections HTTP.

Exemple de récupération des données au format JSON

% curl -L -H 'Accept: application/json' -u 'username:password' https://tsmlabapi.in2p3.fr
output:
{
    "details": {
        "generated_in": "0.66ms",
        "last_cache_update": 1406551433
    },
    "results": [
        {
            "laboratory": "CCIN2P3",
            "nodes": [
                {
                    "contacts": [
                        "no-reply@cc.in2p3.fr"
                    ],
                    "days_since_last_access": "<1",
                    "filespaces": [
                        {
                            "filespace_name": "/backup/volume1",
                            "num_files": 6,
                            "physical_b": 21
                        },
                        {
                            "filespace_name": "/backup/volume2",
                            "num_files": 6,
                            "physical_b": 21
                        }
                    ],
                    "last_access": 1406524790,
                    "node_name": "DEMO_NODE",
                    "total": {
                        "num_files": 12,
                        "physical_b": 42
                    }
                }
            ],
            "total": {
                "nodes": 1,
                "num_files": 12,
                "physical_b": 42
            }
        }
    ]
}

Note

La sortie de cette commande a été formatée avec curl | python -mjson.tool.