Mandato bluemixUtility

Utilice el programa de utilidad de línea de mandatos de IBM® Cloud para configurar el servidor de Liberty local a fin de utilizar determinados servicios en la nube de IBM Cloud.

IBM Bluemix es ahora IBM Cloud y estos nombres hacen referencia a la misma plataforma en la nube en https://console.bluemix.net.

Orígenes

Conozca los servicios de IBM Cloud, como los servicios de Watson y Cloudant, que puede utilizar con el programa de utilidad de línea de mandatos.

Sintaxis

La sintaxis del mandato es la siguiente:
bluemixUtility acción [opciones]
Utilice los siguientes mandatos acción:
login
Iniciar la sesión en IBM Cloud. Si ejecuta el mandato login sin ninguna opción, la herramienta le solicita más información, como, por ejemplo, nombre de usuario y contraseña. Después de un inicio de sesión satisfactorio, las credenciales de IBM Cloud se guardan en un archivo para que pueda ejecutar otros mandatos sin especificar de nuevo el nombre de usuario y la contraseña.
Si inicia la sesión en IBM Cloud con el cliente de Cloud Foundry (cf), bluemixUtility utiliza las credenciales guardadas por el cliente cf. Para obtener más información, consulte Mandatos de Cloud Foundry (cf).
marketplace
Listar todos los servicios de IBM Cloud que se pueden configurar utilizando el programa de utilidad de línea de mandatos.
createService
Crear una instancia de servicio a partir del catálogo de IBM Cloud.
listServices
Listar todas las instancias de servicio de IBM Cloud disponibles.
showService
Mostrar información sobre una instancia de servicio.
import
Importar una configuración para un servicio. La configuración de servicio importada y sus dependencias se colocan en el directorio siguiente:
${wlp.user.dir}/shared/config/services/nombreServicio
listImports
Listar todas las configuraciones de servicio importadas que se pueden enlazar a un servidor de Liberty.
bind
Enlazar una configuración de servicio de IBM Cloud con un servidor de Liberty. La configuración de un servicio puede proporcionar valores predeterminados para determinadas opciones, como por ejemplo el jndiName de un elemento dataSource. En algunos casos, los valores predeterminados no coinciden con lo que la aplicación espera. Utilice la opción --v para alterar temporalmente un valor predeterminado con el valor que la aplicación espera.
unbind
Desenlazar una configuración de servicio de un servidor de Liberty.
deleteService
Suprimir una instancia de servicio.
switch
Conmutar a otro espacio u organización de IBM Cloud.
info
Ver información de conexión de IBM Cloud.
help
Utilizar la acción de ayuda en cada mandato para ver descripciones, el uso y opciones.
logout
Cerrar la sesión de IBM Cloud. El mandato logout suprime el archivo que se ha creado al iniciar la sesión con las credenciales de IBM Cloud.

Uso

Vea los ejemplos de uso que puede ejecutar para cada acción.

Utilice el mandato siguiente para ejecutar la acción login:
bluemixUtility login [opciones]
Utilice el mandato siguiente para ejecutar la acción marketplace:
bluemixUtility marketplace [tipoServicio...]
Utilice el mandato siguiente para ejecutar la acción createService:
bluemixUtility createService [opciones] tipoServicio planServicio nombreServicio
Utilice el mandato siguiente para ejecutar la acción listServices:
bluemixUtility listServices
Utilice el mandato siguiente para ejecutar la acción showService:
bluemixUtility showService [opciones] nombreServicio
Utilice el mandato siguiente para ejecutar la acción import:
bluemixUtility import [opciones] nombreServicio
Utilice el mandato siguiente para ejecutar la acción listImports:
bluemixUtility listImports [nombreServidor]
Utilice el mandato siguiente para ejecutar la acción bind:
bluemixUtility bind [opciones] nombreServidor
nombreServicio
Utilice el mandato siguiente para ejecutar la acción unbind:
bluemixUtility unbind nombreServidor nombreServicio
Utilice el mandato siguiente para ejecutar la acción deleteService:
bluemixUtility deleteService [opciones] nombreServicio
Utilice el mandato siguiente para ejecutar la acción switch:
bluemixUtility switch [opciones]
Utilice el mandato siguiente para ejecutar la acción logout:
bluemixUtility logout

Opciones

Vea las opciones disponibles para cada acción.

Están disponibles las siguientes opciones para el mandato bluemixUtility login:
--api=url
Punto final de API Bluemix, por ejemplo, https://api.ng.bluemix.net. El punto final de API también se puede establecer como el nombre de región de Bluemix. Por ejemplo, puede establecerse en us-south para la región sur de EE.UU., eu-gb para la región de Londres en el Reino Unido y au-syd para la región de Sidney en Australia.
--user=nombre_usuario
Nombre de usuario de la cuenta de IBM Cloud.
--password=contraseña
Contraseña de la cuenta de IBM Cloud.
--org=nombre_organización
Nombre de organización.
--space=nombre_espacio
Nombre de espacio.
[16.0.0.3 and later]--sso
Un código de acceso de un solo uso necesario para iniciar la sesión utilizando un ID federado de IBM Cloud. Para generar el código de acceso, vaya al sitio web de código de acceso de IBM Cloud especificado por el mandato y, a continuación, escriba el código generado en la línea de mandatos. Esta opción no es necesaria para iniciar la sesión utilizando un ID de IBM.
Están disponibles las siguientes opciones para el mandato bluemixUtility marketplace:
[serviceType...]
Mostrar información detallada sobre un determinado servicio de IBM Cloud. Especifique varios nombres de servicio separándolos con un espacio.
Están disponibles las siguientes opciones para el mandato bluemixUtility createService:
--credentialName=name
Nombre de la credencial de servicio. De forma predeterminada, se utiliza credential-1.
serviceType
Tipo de servicio a crear.
servicePlan
Nombre del plan de servicio.
serviceName
Nombre del servicio que se debe crear.

No hay opciones disponibles para el mandato bluemixUtility listServices.

Están disponibles las siguientes opciones para el mandato bluemixUtility showService:

--showCredentials
Visualiza credenciales de servicio.
serviceName
El nombre de un servicio de IBM Cloud.

Están disponibles las siguientes opciones para el mandato bluemixUtility import:

--acceptLicense
Indica automáticamente la aceptación de los términos y condiciones de licencia.
--credentialName=name
Nombre de la credencial de servicio. De forma predeterminada, se utiliza la primera credencial que se encuentra.
--encodeAlgorithm=[xor|aes]
Especifica cómo codificar información confidencial en la configuración de servicio importada. Los valores de codificaciones soportados son xor y aes. El algoritmo de codificación predeterminado es xor.
--encodeKey=key
Especifica la clave que se debe utilizar cuando se codifica con el cifrado AES. Si no se proporciona esta opción, se utiliza una clave predeterminada.
--p[parameter]=value
Especifica los parámetros que ayudan a generar e importar una configuración para un servicio.
serviceName
El nombre de un servicio de IBM Cloud.

Están disponibles las siguientes opciones para el mandato bluemixUtility listImports:

[serverName]
Lista los servicios que ya están enlazados a este servidor en particular.

Están disponibles las siguientes opciones para el mandato bluemixUtility bind:

--v[variable]=value
Altera temporalmente las variables en la configuración de servicio importada.
--acceptLicense
Indica automáticamente la aceptación de los términos y condiciones de licencia.
serverName
Nombre del servidor a enlazar a la configuración de servicio.
serviceName
Nombre de la configuración del servicio importada.

Están disponibles las siguientes opciones para el mandato bluemixUtility unbind:

serverName
Nombre del servidor del que se debe desenlazar la configuración.
serviceName
Nombre de la configuración de servicio que se debe desenlazar.

Están disponibles las siguientes opciones para el mandato bluemixUtility deleteService:

--force
Fuerza la supresión sin confirmación.
serviceName
Nombre del servicio a suprimir.

Están disponibles las siguientes opciones para el mandato bluemixUtility switch:

--org=organizationName
Nombre de organización.
--space=spaceName
Nombre de espacio.

No hay opciones disponibles para el mandato bluemixUtility info.

No hay opciones disponibles para el mandato bluemixUtility logout.

Códigos de retorno

Tabla 1. Descripción de los códigos de retorno
Código de retorno Descripción
0 El mandato ha completado correctamente la operación solicitada.
20 No son válidos uno o más argumentos u opciones de línea de mandatos.
21 Se ha producido una excepción de tiempo de ejecución desconocida.
22 Se ha producido un error de E/S, normalmente al intentar suprimir un archivo del sistema de archivos.
24 El usuario ha terminado anormalmente. Se produce cuando el usuario no puede responder a una solicitud o cancela la operación.
26 Se ha producido una excepción desconocida.
27 Error de autenticación de IBM Cloud al intentar iniciar la sesión o al intentar realizar una tarea sin haber iniciado la sesión.
28 Un error genérico al comunicarse con IBM Cloud.
29 Un error genérico al comunicarse con el servicio de configuración.
30 Se ha producido un error de configuración del servicio genérico.
31 Se ha producido un error de instalación de característica genérico.
255 Se ha producido un error desconocido.

Icono que indica el tipo de tema Tema de referencia

Nombre de archivo: rwlp_blmx_utility.html