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 操作来查看描述、用法和选项。
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
空间名称。
以下选项可用于 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]
指定如何在已导入服务配置中对敏感信息进行编码。受支持的编码值为 xor 和 aes。缺省编码算法为 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 发生未知错误。

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



时间戳记图标 最近一次更新时间: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_blmx_utility
文件名:rwlp_blmx_utility.html