add_ranger_config

在线编辑

使用此命令可以在 Ambari 服务器上定义 Ranger，以便进行 Hadoop 监视。

此命令需要 Ambari 服务器上的有效管理权限，例如 admin 或 service 管理员帐户。 Ambari 管理员必须重新启动受影响的 Hadoop 组件，以使更改生效。

此 API 在 Guardium V10.1.4 及更高版本中可用。

REST API 语法

此 API 可通过 POST 方法，以 REST 服务的形式使用。 请按如下方式调用此 API：
POST https://[Guardium hostname or IP address]:8443/restAPI/add_ranger_config

GuardAPI 语法

add_ranger_config parameter=value

参数

参数 值类型 描述
clusterName 字符串 必需。 Ambari 集群名称。
hostname 字符串 必需。 Ambari 服务器的主机名或 IP 地址。
password 字符串 必需。 由 userName 指定的管理员用户的密码。
port 整数 Ambari 服务器上用户界面的端口。 缺省值：8080。
sslEnabled 布尔值 设置是否对此 Ranger 的通信启用 SSL。 有效值：
  • 0 （假）
  • 1 (真)

缺省值 = 0 (false)
userName 字符串 必需。 Ambari 服务器用户名；必须是 admin 或 service 管理员用户。
api_target_host 字符串

指定执行 API 所在的目标主机。有效值：
  • all_managed：在所有受管单元上执行，但不在中央管理器上执行
  • all：在所有受管单元和中央管理器上执行
  • group:<group name>: 在 <group name> 标识的所有受管单元上执行
  • 受管单元的主机名或 IP 地址：从中央管理器指定，以便在受管单元上执行。 例如，api_target_host=10.0.1.123。
  • 中央管理器的主机名或 IP 地址：从受管单元指定，以便在中央管理器上执行。 例如，api_target_host=10.0.1.123。

IP 地址必须符合网络的 IP 方式。 在双重 IP 方式下，请使用向中央管理器注册受管单元时使用的 IP 协议。 例如，如果该注册使用的是 IPv6，请指定 IPv6 地址。 主机名与 IP 方式无关，可以在任何方式下使用。

GrdAPI 示例

定义护林员集群

grdapi add_ranger_config hostname=hw-cl4-05 userName=admin port=8080 password=xxxxx clusterName=Cluster4
样本输出：
ID=0Configuration for Cluster:  Cluster4 added.

REST API 示例

curl -k --header "Authorization:Bearer <access token>" -i -H "Content-Type: application/json" -X POST -d '{hostname="hw-cl4-05", userName="admin", port=8080, password="admin", clusterName="Cluster4"}' https://<Guardium server name>:8443/restAPI/add_ranger_config
样本输出：
[{"id": 2,
"clusterName": "Cluster4",
"serverHost": "hw-cl4-05",
"serverPort": 8080,
"userName": "admin",
"lastRefresh": "2016-09-27 11:31:03",
"status": []}]