bluemixUtility 命令

使用 IBM® Bluemix® 命令行实用程序,将您的本地 Liberty 服务器配置为使用特定 Bluemix 云服务。

了解有关可以与命令行实用程序配合使用的 Bluemix 服务(例如 Watson™Cloudant® 服务)的信息。

语法

命令语法如下所示:
bluemixUtility action [options]
使用以下 action 命令:
login
登录到 Bluemix。如果您在不带任何选项的情况下运行 login 命令,那么该工具将提示您输入更多信息,例如用户名和密码。成功登录后,Bluemix 凭证将保存到文件中,这样您无需再次指定用户名和密码就可以运行其他命令。
如果使用 Cloud Foundry (cf) 客户机登录到 Bluemix,那么 bluemixUtility 将使用 cf 客户机保存的凭证。有关更多信息,请参阅 Cloud Foundry (cf) 命令
marketplace
列出可以使用命令行实用程序配置的所有 Bluemix 服务。
createService
Bluemix 目录创建服务实例。
listServices
列出所有可用的 Bluemix 服务实例。
showService
显示有关服务实例的信息。
import
为服务导入配置。导入的服务配置及其依赖性将放入以下目录中:
${wlp.user.dir}/shared/config/services/serviceName
listImports
列出可以绑定到 Liberty 服务器的所有已导入服务配置。
bind
Bluemix 服务配置绑定到 Liberty 服务器。服务的配置可以为特定选项(例如 dataSource 元素的 jndiName)提供缺省值。在某些情况下,缺省值与应用程序所期望的值不匹配。借助 --v 选项,可使用应用程序期望的值覆盖缺省值。
unbind
Liberty 服务器取消服务配置的绑定。
deleteService
删除服务实例。
switch
切换到不同的 Bluemix 组织或空间。
info
查看 Bluemix 连接信息。
help
使用每个命令上的 help 操作来查看描述、用法和选项。
logout
Bluemix 注销。logout 命令将删除当您使用 Bluemix 凭证登录时创建的文件。

用法

查看可以为每个操作运行的用法示例。

使用以下命令来运行 login 操作:
bluemixUtility login [options]
使用以下命令来运行 marketplace 操作:
bluemixUtility marketplace [serviceType...]
使用以下命令来运行 createService 操作:
bluemixUtility createService [options] serviceType servicePlan serviceName
使用以下命令来运行 listServices 操作:
bluemixUtility listServices
使用以下命令来运行 showService 操作:
bluemixUtility showService [options] serviceName
使用以下命令来运行 import 操作:
bluemixUtility import [options] serviceName
使用以下命令来运行 listImports 操作:
bluemixUtility listImports [serverName]
使用以下命令来运行 bind 操作:
bluemixUtility bind [options] serverName serviceName
使用以下命令来运行 unbind 操作:
bluemixUtility unbind serverName serviceName
使用以下命令来运行 deleteService 操作:
bluemixUtility deleteService [options] serviceName
使用以下命令来运行 switch 操作:
bluemixUtility switch [options]
使用以下命令来运行 logout 操作:
bluemixUtility logout

选项

查看每个操作的可用选项。

以下选项可用于 bluemixUtility login 命令:
--api=url
Bluemix API 端点,例如,https://api.ng.bluemix.net。还可以将 API 端点设置为 Bluemix 区域名称。例如,可以将其对美国南部地区设置为 us-south,对英国伦敦地区设置为 eu-gb,而对澳大利亚悉尼地区设置为 au-syd
--user=username
Bluemix 帐户的用户名。
--password=password
Bluemix 帐户的密码。
--org=organizationName
组织名称。
--space=spaceName
空间名称。
[16.0.0.3 及更高版本]--sso
使用 Bluemix 联合标识登录所需的一次性口令。要生成口令,请转至此命令指定的 Bluemix 口令 Web 站点,然后在命令行上输入生成的口令。使用 IBM 标识登录时,不需要此选项。
以下选项可用于 bluemixUtility marketplace 命令:
[serviceType...]
显示有关特定 Bluemix 服务的详细信息。通过以空格分隔服务名称来指定多个服务名称。
以下选项可用于 bluemixUtility createService 命令:
--credentialName=name
服务凭证的名称。缺省情况下,将使用 credential-1
serviceType
要创建的服务的类型。
servicePlan
服务计划的名称。
serviceName
要创建的服务的名称。

bluemixUtility listServices 命令没有可用选项。

以下选项可用于 bluemixUtility showService 命令:

--showCredentials
显示服务凭证。
serviceName
Bluemix 服务的名称。

以下选项可用于 bluemixUtility import 命令:

--acceptLicense
自动地指示接受许可条款和条件。
--credentialName=name
服务凭证的名称。缺省情况下,将使用找到的第一个凭证。
--encodeAlgorithm=[xor|aes]
指定如何在已导入服务配置中对敏感信息进行编码。受支持的编码值为 xoraes。缺省编码算法为 xor
--encodeKey=key
指定在使用 AES 加密进行编码时要使用的密钥。如果未提供此选项,那么将使用缺省密钥。
--p[parameter]=value
指定帮助为服务生成和导入配置的参数。
serviceName
Bluemix 服务的名称。

以下选项可用于 bluemixUtility listImports 命令:

[serverName]
列出已绑定到此特定服务器的服务。

以下选项可用于 bluemixUtility bind 命令:

--v[variable]=value
覆盖已导入服务配置中的变量。
--acceptLicense
自动地指示接受许可条款和条件。
serverName
要绑定到服务配置的服务器的名称。
serviceName
已导入服务配置的名称。

以下选项可用于 bluemixUtility unbind 命令:

serverName
要从其取消服务配置绑定的服务器的名称。
serviceName
要取消绑定的服务配置的名称。

以下选项可用于 bluemixUtility deleteService 命令:

--force
强制删除而不确认。
serviceName
要删除的服务的名称。

以下选项可用于 bluemixUtility switch 命令:

--org=organizationName
组织名称。
--space=spaceName
空间名称。

bluemixUtility info 命令没有可用选项。

bluemixUtility logout 命令没有可用选项。

返回码

表 1. 返回码和说明
返回码 说明
0 此命令成功完成请求的操作。
20 一个或多个命令行自变量无效。
21 发生了未知运行时异常。
22 尝试从文件系统删除文件时,发生了 IO 错误。
24 用户异常中止。用户未能响应提示或取消操作时发生此错误。
26 发生未知的异常。
27 尝试登录或尝试在未登录的情况下执行任务时,发生 Bluemix 认证错误。
28 与 Bluemix 通信时发生通用错误。
29 与配置服务通信时发生通用错误。
30 发生了通用服务配置错误。
31 发生了通用功能部件安装错误。
255 发生了未知错误。

用于指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: Monday, 5 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-libcore-mp&topic=rwlp_blmx_utility
文件名:rwlp_blmx_utility.html