Ejemplo: API REST de Application Management

Workflow:
Este ejemplo muestra cómo utilizar la API REST Application Management de operaciones en la nube para gestionar el ciclo de vida de una aplicación empresarial en una suscripción en la nube.

El ejemplo le guía por el proceso de instalar una aplicación de empresa (archivo .ear) en un servidor de flujo de trabajo, actualizarla, iniciarla y detenerla y, finalmente, desinstalarla del servidor de flujo de trabajo.

Antes de empezar

Todas las llamadas a la API requieren un token válido de solicitud de falsificación de sitios cruzados (CSRF) en la cabecera IBM® -CSRF-TOKEN de la llamada. Obtenga una señal CSRF mediante POST /instance/services/csrf_token. Para obtener más información, consulte Cómo evitar la falsificación de solicitudes entre sitios.

Gestionar el ciclo de vida de la aplicación

Visualice una lista de las aplicaciones instaladas.
Utilice la llamada siguiente para recuperar una lista de todas las aplicaciones instaladas en un entorno:
```
GET /bpm/services/environments/{environment}/applications
```
El parámetro de entorno es obligatorio, los valores que puede tomar dependen de la configuración de la suscripción. Así, para el entorno de desarrollo, la llamada puede ser:
```
GET /bpm/services/environments/dev/applications
```
La API admite la paginación utilizando los parámetros offset y size. Por ejemplo:
```
GET /bpm/services/environments/dev/applications?offset=3&size=10
```

Instale una aplicación nueva.

Para instalar un nuevo Integration Designer en el entorno de desarrollo, utilice la llamada siguiente e incluya el nombre de aplicación y el archivo .ear como multipart/form-data en la llamada:

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--

Actualice una aplicación.

Para actualizar una aplicación empresarial en el entorno de desarrollo, utilice la llamada siguiente e incluya el archivo .ear actualizado como datos multipart/form-data en la llamada:

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--

Inicie una aplicación.
Para iniciar una aplicación de empresa, por ejemplo AC_MOPApp, en el entorno de desarrollo, utilice la llamada siguiente:
```
POST /bpm/services/environments/dev/applications/AC_MOPApp/start
```
Detenga una aplicación.
Para detener una aplicación de empresa, por ejemplo AC_MOPApp, en el entorno de desarrollo, utilice la llamada siguiente:
```
POST /bpm/services/environments/dev/applications/AC_MOPApp/stop
```
Suprima una aplicación.
Para suprimir una aplicación de empresa, por ejemplo AC_MOPApp, en el entorno de desarrollo, utilice la llamada siguiente:
```
DELETE /bpm/services/environments/dev/applications/AC_MOPApp
```