Cómo probar la API REST de IBM Systems Director usando Java
1. Manualmente (usando herramientas): utilice algún cliente REST externo, como Firefox Poster, http4e, etc., y llame a la API REST manualmente. Usamos Poster en este tutorial. Puede utilizar su cliente REST favorito.
2. Automático: Utilice un lenguaje de programación o script para llamar automáticamente a la API REST. Este tutorial presenta las pruebas automatizadas utilizando Java. Puede utilizar cualquier otro idioma o escritura que desee.
La descripción de estos dos métodos es la siguiente:
1. Manualmente (usando Poster):
En esta sección, analizaremos el uso de Poster para hacerlo manualmente. Pruebe algunas funciones básicas de IBM Systems Director:
1. Obtener la lista de recursos (operación GET)
2. Descubrir nuevos recursos (operación POST)
3. Modificar recursos descubiertos (operación PUT)
4. Eliminar recursos (operación DELETE)
1. Obtener la lista de recursos (operación GET):
Como se muestra en la figura. 1 Indica que puede utilizar la operación GET para enumerar recursos. GET recupera información sobre el recurso. La solicitud para recuperar el recurso se muestra en la Figura 1:
Figura 1. ¿Operación GET usando Poster?
En la Figura 1, usted como usuario puede ver la siguiente información:
1.URL: URI para recuperar información sobre el servidor.
2.Acciones: La acción seleccionada es GET. ?
3.Sección de encabezado: el usuario debe ingresar lo siguiente en esta sección:
ISDAPIVersion: La versión de IBM Systems Director.
Autorización: Se trata de un ID de usuario y una contraseña convertidos en base64 para utilizar con IBM Systems Director. ?
Aceptar: Tipos de contenido aceptables
La respuesta se muestra en la Figura 2:
Figura 2. Respuesta a la operación GET
En la Figura 2, puede ver la respuesta de IBM Systems Director a la solicitud GET. La respuesta incluye un código de retorno y un cuerpo de respuesta. El código de retorno en la Figura 2 es 200?
(OK) y el cuerpo de la respuesta es una lista de todos los recursos devueltos por IBM Systems Director.
Descubrimiento de recursos (operación POST)
El descubrimiento es una operación muy básica de IBM Systems Director que se utiliza para descubrir recursos. Debe utilizar el método POST para el descubrimiento, por lo que debe proporcionar un cuerpo HTTP.
(JSON) y encabezados HTTP. El texto HTTP descubierto es el siguiente:
Listado 1. Ingrese el JSON de la operación de descubrimiento POST
{
"IPAddress": ["9.1.2.3 "],
"ResourceTypes": ["Server", "OperatingSystem"]
}
Debe proporcionar la dirección IP y el tipo de recurso del recurso. Se pueden descubrir nuevas fuentes utilizando la operación POST, como se muestra en la Figura 3.
Figura 3. La operación POST descubre recursos
Hay algunas cosas importantes a tener en cuenta en la respuesta HTTP en la Figura 4:
La respuesta a la operación GET usando El URI de ubicación es el siguiente, como se muestra en la Figura 5.
Figura 5. Respuesta a la operación GET utilizando el URI de ubicación
Código de retorno: 201 para solicitud POST
Ubicación: la operación POST es una operación asincrónica e incluye devolución posición. Una ubicación es una URL que se puede utilizar para comprobar el estado de un trabajo mediante una operación GET, como se muestra en la Figura 1.
En HttpResponse, como se muestra en la Figura 5, puede ver los siguientes valores:
URI: Esta es la "Ubicación" de la operación POST anterior.
Porcentaje de finalización: Muestra el estado de finalización de la tarea en porcentaje. En la Figura 5 es 100%, lo que significa que la tarea está completa.
DiscoveryStatus: Este campo muestra el estado del trabajo, es decir, si fue exitoso. En la Figura 5, su valor es "Ok", lo que significa que el trabajo se completó exitosamente.
Modificar un recurso (operación PUT):
Para modificar un recurso existente, es necesario utilizar la operación PUT. Para las operaciones PUT, debe pasar el cuerpo HTTP y los encabezados HTTP. El texto HTTP utilizado para modificar recursos es el siguiente:
Listado 2. Listado 2. Ingrese el JSON de la operación de modificación de recursos PUT
{
"Propiedades ": {" DisplayName" : "NewName"}
}
Puede utilizar la operación PUT para modificar recursos, como se muestra en la Figura 6.
Figura 6. Operación PUT para modificar recursos