HP OneView - Manuel (Page 61)

5 Utilisation des API REST et d'autres interfaces de
programmation
REST (Representational State Transfer) est un format de service Web qui exécute des opérations
CRUD (Create, Read, Update et Delete) de base sur les ressources en utilisant HTTP POST, GET,
PUT
et DELETE. Pour en savoir plus sur les concepts REST, visitez le lien http://en.wikipedia.org/
wiki/Representational_state_transfer .
L'appareil dispose d'une architecture axée sur les ressources qui fournit une interface REST uniforme.
Chaque ressource possède un URI (Uniform Resource Identifier) et représente un périphérique
physique ou une construction logique. Vous pouvez utiliser des API REST pour manipuler des
ressources.
Pour obtenir des informations générales sur les API REST, consultez les rubriques suivantes :
•
« Opérations de ressources »
•
« Codes de retour »
•
« Format du URI »
•
« Format de modèle de ressource »
•
« Connexion à l'appareil à l'aide d'API REST »
•
« Version d'API REST »
•
« Opérations asynchrones et opérations synchrones »
•
« Ressource de tâche »
•
« Traitement des erreurs »
•
« Contrôle de concurrence à l'aide d'etags »
•
« Interrogation de ressources en utilisant des paramètres d'API REST communs »
•
« State Change Message Bus »
•
« Outils de développement dans un navigateur Web »
•
« Utilisation de commandes Windows PowerShell et Python (aperçu technique) »
5.1 Opérations de ressources
Les API RESTful sont sans état. Le gestionnaire de ressources maintient l'état de la ressource qui
est signalé en tant que représentation de ressource. Le client maintient l'état de l'application et le
client peut manipuler la ressource localement mais, jusqu'à ce qu'une opération PUT ou POST soit
effectuée, la ressource telle que connue par le gestionnaire de ressources n'est pas modifiée.
Description Verbe HTTP Opération
Crée de nouvelles ressources. Une opération POST synchrone retourne
la ressource nouvellement créée. Une opération POST asynchrone
retourne un URI TaskResource dans l'en-tête Location. Cet URI
suit le déroulement de l'opération POST. POST resource URI (payload =
resource data)
Création
Renvoie la ou les représentations de ressource demandées GET resource URI Lecture
Met à jour une ressource existante PUT resource URI (payload =
update data)
Mise à jour
Supprime la ressource spécifiée DELETE resource URI Suppression
5.1 Opérations de ressources 61