Exemple : API REST Application Management

Workflow:
Cet exemple montre comment utiliser l'API REST Application Management des opérations de cloud pour gérer le cycle de vie d'une application d'entreprise sur un abonnement de cloud.

L'exemple vous montre comment installer une application d'entreprise (fichier.ear) sur un serveur de flux de travaux, la mettre à jour, la démarrer et l'arrêter, et enfin la désinstaller du serveur de flux de travaux.

Avant de commencer

Tous les appels à l'API nécessitent un jeton de demande de falsification de site croisée (CSRF) valide dans l'en-tête IBM® -CSRF-TOKEN de l'appel. Obtenez un jeton CSRF via POST /instance/services/csrf_token. Pour plus d'informations, voir Prévention de la falsification de requêtes entre sites (CSRF).

Gérer le cycle de vie de l'application

Affichez la liste des applications installées.
Utilisez l'appel suivant pour extraire la liste de toutes les applications installées dans un environnement :
```
GET /bpm/services/environments/{environment}/applications
```
Le paramètre d'environnement est obligatoire. Les valeurs pouvant être définies dépendent de la configuration de votre abonnement. Pour l'environnement de développement, par exemple, l'appel peut être :
```
GET /bpm/services/environments/dev/applications
```
L'API prend en charge la pagination à l'aide du paramètre de décalage et de taille. Exemple :
```
GET /bpm/services/environments/dev/applications?offset=3&size=10
```

Installez une nouvelle application.

Pour installer un nouveau Integration Designer dans l'environnement de développement, utilisez l'appel suivant et incluez le nom de l'application et le fichier .ear en tant que données de formulaire / multiple dans l'appel:

POST /bpm/services/environments/dev/applications
...
/**
 * Required header contains the key used as the boundary in the payload
*/
Content-Type: multipart/form-data; boundary=---------------------------24104172026364
...
/**
	* The boundary specified in the header
*/
-----------------------------24104172026364
/**
	* The application name, ACMoApp
*/

Content-Disposition: form-data; name="application_name"
AC_MOApp
/**
	* The .ear file as a binary stream
*/
-----------------------------24104172026364
Content-Disposition: form-data; name="ear"; filename="AC_MOPApp.ear"
Content-Type: application/octet-stream
application .ear file as binary stream
-----------------------------24104172026364--

Permet de mettre à jour une application.

Pour mettre à jour une application d'entreprise dans l'environnement de développement, utilisez l'appel suivant et incluez le fichier .ear sous forme de données à plusieurs parties/formulaire dans l'appel :

POST /bpm/services/environments/dev/applications/AC_MOPApp
...
/**
 * Required header contains the key used as the boundary in the payload
*/
Content-Type: multipart/form-data; boundary=---------------------------24104172026364
...
/**
	* The boundary specified in the header
*/
-----------------------------24104172026364
Content-Disposition: form-data; name="ear"; filename="AC_MOPApp.ear"
Content-Type: application/octet-stream
application .ear file as binary stream
-----------------------------24104172026364--

Démarrez une application.
Pour démarrer une application d'entreprise, par exemple AC_MOPApp dans l'environnement de développement, utilisez l'appel suivant :
```
POST /bpm/services/environments/dev/applications/AC_MOPApp/start
```
Arrêtez une application.
Pour arrêter une application d'entreprise, par exemple AC_MOPApp dans l'environnement de développement, utilisez l'appel suivant :
```
POST /bpm/services/environments/dev/applications/AC_MOPApp/stop
```
Permet de supprimer une application.
Pour supprimer une application d'entreprise, par exemple AC_MOPApp dans l'environnement de développement, utilisez l'appel suivant :
```
DELETE /bpm/services/environments/dev/applications/AC_MOPApp
```