Ambari(六)----Ambari api使用

最新推荐文章于 2023-12-20 16:18:38 发布
最新推荐文章于 2023-12-20 16:18:38 发布
阅读量2k 收藏 11
点赞数 1
分类专栏： Ambari 文章标签： 1024程序员节 ambari curl
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_40861707/article/details/109257476
版权

本博客主要是对Ambari官方api文档的翻译.
并在此基础上,结合实际Ambari环境,给出了一些具体的操作示例,方便自己检索.

Ambari api官方文档

文章目录

一. curl简介
二. 认证
三. 监控

四. 管理

五.资源

六. 部分响应
七. 查询谓词
八. 批量请求
九. 请求信息
十. 时间指标
十一. 分页
十二. 异常
十三. 操作中遇到的问题

一. curl简介

    curl命令是一个功能强大的网络工具，它能够通过http、ftp等方式下载文件，也能够上传文件。
    不仅如此,curl可以很方便的完成许多rest api的测试需求,甚至是需要登录认证的rest api。
    利用curl指令,可以发出GET,POST,PUT,DELETE请求,也可以改变HTTP header来满足使用rest api需要的特定条件。
    这里列出一些测试Rest api需要用到的curl参数

curl参数参数含义
-X/–request [GET,POST,…]使用指定的http method发出http request
-H/–header设定request的header
-i/–includeresponse的header
-d/–datahttp parameters
-v/–ver bose显示详细信息
-u/–user使用者用户密码
-b/–cookiecookie

二. 认证

执行Ambari API操作需要身份认证. 访问Api需要使用基本身份认证.
您需要在您的请求中发送授权:基本标头已使用基本身份认证.
例如:使用curl和–user选项可以解决此问题

curl --user name:password http://{your.ambari.server}/api/v1/clusters

操作实例:

# 
curl -u admin:admin http://192.168.226.140:8080/api/v1/clusters

注意: 身份认证方法和来源是在Ambari Server配置的,本文档未涵盖更改和配置身份认证的方法和来源

三. 监控

Ambari API提供对Apache Hadoop集群的监控和指标信息的访问。

3.1 GET

使用GET方法读取Ambari资源的属性，指标和子资源。
调用GET方法将返回请求的资源，并且不会产生任何副作用。
响应代码200表示使用包含在响应主体中的请求资源成功处理了请求。

实例:

获取集群名为hadoop的HDFS服务的DATANODE组件资源


GET /clusters/hadoop/services/HDFS/components/DATANODE

curl -u -X GET admin:admin http://ip:8083/api/v1/clusters/ambari_develop_cluster/services/HDFS/components/DATANODE

响应码:

200 OK

响应结果(部分):

{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS/components/DATANODE",
  "ServiceComponentInfo" : {
    "category" : "SLAVE",
    "cluster_name" : "hadoop",
    "component_name" : "DATANODE",
    "desired_stack" : "HDP-2.6",
    "desired_version" : "2.6.3.0-235",
    "display_name" : "DataNode",
    "init_count" : 0,
    "install_failed_count" : 0,
    "installed_count" : 0,
    "recovery_enabled" : "false",
    "repository_state" : "CURRENT",
    "service_name" : "HDFS",
    "started_count" : 0,
    "state" : "STARTED",
    "total_count" : 3,
    "unknown_count" : 3
  },
  "host_components" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/hosts/slave1.hadoop/host_components/DATANODE",
      "HostRoles" : {
        "cluster_name" : "hadoop",
        "component_name" : "DATANODE",
        "host_name" : "slave1.hadoop"
      }
    }
  ]
}

四. 管理

Ambari API提供了对Apache Hadoop集群的资源的管理。
这包括创建，删除和更新资源。

4.1 POST

POST方法用于创建新资源. 如果新资源创建成功,则返回201相应代码
还可以返回代码202表示该指令已被服务器接受(参见4.4 异步响应)

实例

为集群hadoop创建HDFS服务

POST /clusters/hadoop/services/HDFS

curl -u admin:admin -X POST http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS

响应:

201 Created

4.2 PUT

PUT方法用于更新资源。
如果修改了现有资源，则将返回200响应代码以指示请求已成功完成。
还可以返回响应代码202以指示该指令已被服务器接受（参见4.4 异步响应）。

实例:

启动HDFS服务(将HDFS服务的状态转变为"STARTED")

PUT /clusters/hadoop/services/HDFS/

请求体

{
  "ServiceInfo": {
    "state" : "STARTED"
  }
}

# curl操作实例
curl -u admin:admin -X PUT -d '{"ServiceInfo":{"state":"STARTED"}}' http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS

响应
响应代码202指示服务器已经接受了更新资源的指令。
响应的主体包含为执行指令而创建的请求资源的ID和href（参见异步响应)

{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/requests/20",
  "Requests" : {
    "id" : 20,
    "status" : "Accepted"
  }
}

4.3 DELETE

使用DELETE方法删除资源。
如果删除了现有资源，则将返回200响应代码以指示请求已成功完成。
还可以返回响应代码202，指示服务器已接受该指令并且该资源已标记为删除（参见4.4异步响应）

实例

删除命名为hadoop的集群

DELETE /clusters/hadoop

curl -u admin:admin -X DELETE http://192.168.226.140:8080/api/v1/clusters/hadoop

响应

200 OK

4.4 异步响应

管理API可以返回响应代码202，该响应代码表示请求已被接受。
响应的正文包含为执行指令而创建的请求资源的ID和href

实例

# 获取hadoop集群 id为20的请求
curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/clusters/hadoop/requests/20

响应(部分)

202 Accepted
{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/requests/20",
  "Requests" : {
    "id" : 20,
    "request_status" : "IN_PROGRESS"
    ...
  } 
}

然后，可以使用响应主体中的href来查询关联的请求资源并监视请求的进度。
一个请求资源具有一个或多个任务子资源。
以下示例显示如何使用部分响应来查询请求资源的任务资源。

/clusters/c1/requests/6?fields=tasks/Tasks/* 

curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/clusters/hadoop/requests/20?fields=tasks/Tasks/*

返回的任务资源可用于确定请求的状态
stdout属性由于篇幅过长被省略


{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/requests/20",
  "Requests" : {
    "cluster_name" : "hadoop",
    "id" : 20
  },
  "tasks" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/requests/20/tasks/402",
      "Tasks" : {
        "attempt_cnt" : 1,
        "cluster_name" : "hadoop",
        "command" : "INSTALL",
        "command_detail" : "HDFS_CLIENT INSTALL",
        "end_time" : 1603519829073,
        "error_log" : "/var/lib/ambari-agent/data/errors-402.txt",
        "exit_code" : 0,
        "host_name" : "master.hadoop",
        "id" : 402,
        "output_log" : "/var/lib/ambari-agent/data/output-402.txt",
        "request_id" : 20,
        "role" : "HDFS_CLIENT",
        "stage_id" : 0,
        "start_time" : 1603519825310,
        "status" : "COMPLETED",
        "stderr" : "None",
        "stdout" : "",
        "structured_out" : {
          "repository_version_id" : "2",
          "version" : "2.6.3.0-235"
        }
      }
    },
    {
      "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/requests/20/tasks/403",
      "Tasks" : {
        "attempt_cnt" : 1,
        "cluster_name" : "hadoop",
        "command" : "START",
        "command_detail" : "NAMENODE START",
        "end_time" : -1,
        "error_log" : "/var/lib/ambari-agent/data/errors-403.txt",
        "exit_code" : 777,
        "host_name" : "master.hadoop",
        "id" : 403,
        "output_log" : "/var/lib/ambari-agent/data/output-403.txt",
        "request_id" : 20,
        "role" : "NAMENODE",
        "stage_id" : 1,
        "start_time" : 1603519829430,
        "status" : "IN_PROGRESS",
        "stderr" : "",
        "stdout" : "",
        "structured_out" : {
          "repository_version_id" : "2",
          "version" : "2.6.3.0-235"
        }
      }
    }
  ]
}

五.资源

5.1 集合资源

集合资源是一组相同类型的资源，而不是任何特定资源。
例如:

/clusters # 指的是集群的集合

5.2 实例资源

实例资源是单个特定资源。
例如:

/clusters/hadoop

指代ID为hadoop的集群资源

5.3 资源类型

资源分为几种类型。
这允许用户查询相同类型的资源集合。
一些资源类型由子类型组成（例如，服务是集群的子资源）。

以下是一些Ambari资源类型的列表以及说明和用法示例

5.3.1 集群

集群资源代表命名的hadoop集群.
集群是顶级资源

集群资源配置

配置描述
Clusters/cluster_id唯一的集群id
Clusters/cluster_name集群名称
Clusters/versionHDP服务版本
Clusters/desired_configs所需的配置

集群资源操作

# 获取集群列表
GET /clusters
# 获取集群信息
GET /clusters/:name
# 创建集群
POST /clusters/:name 
# 删除集群
DELETE /clusters/:name

5.3.2 服务

服务资源是Hadoop群集的服务（例如HDFS，MapReduce和Ganglia）。
服务资源是集群的子资源。

服务配置

配置描述
ServiceInfo/service_name服务名称
ServiceInfo/cluster_name父集群名称
ServiceInfo/state服务当前状态
ServiceInfo/desired_configs所需配置

服务状态列表

状态描述
INIT首次创建服务后的初始状态
INSTALLING服务安装中…
INSTALL_FAILED服务安装失败
INSTALLED服务安装成功,但并未运行
STARTING服务启动中…
STARTED服务已启动
STOPPING服务停止中…
UNINSTALLING服务卸载中…
UNINSTALLED服务已卸载
WIPING_OUT已安装服务清除中…
UPGRADING服务升级中…
MAINTENANCE服务已标记为维护
UNKNOWN无法确定服务状态

服务资源操作

# 列出服务列表
GET /clusters/:name/services
# 查看服务信息
GET /clusters/:clusterName/services/:serviceName
# 创建服务
POST /clusters/:clusterName/services/:serviceName
# 更新服务
PUT/clusters/:clusterName/services
# 更新指定服务
PUT /clusters/:clusterName/services/:serviceName

5.3.3 组件

组件资源是服务的各个组件（例如HDFS / NameNode和MapReduce / JobTracker）。
组件是服务的子资源。

组件资源配置

配置描述
ServiceComponentInfo/service_name父服务名称
ServiceComponentInfo/component_name组件名称
ServiceComponentInfo/cluster_name父集群名称
ServiceComponentInfo/description组件描述
ServiceComponentInfo/desired_configs所需的配置

组件操作

# 获取组件列表
GET /clusters/:clusterName/services/:serviceName/components
# 查看组件信息
GET /clusters/:name/services/:serviceName/components/:componentName
# 创建组件
POST /clusters/:clusterName/services/:serviceName/components/:componentName

5.3.4 主机

主机资源是组成Hadoop集群的主机。
主机是顶级资源，但也可以是集群的子资源。

主机资源配置

配置描述
Hosts/host_name主机名
Hosts/cluster_name父集群名称
Hosts/ip主机ip地址
Hosts/total_mem主机上可用总内存
Hosts/cpu_count主机cpu数量
Hosts/os_arch主机的操作系统架构（例如x86_64）
Hosts/os_type主机的操作系统类型（例如 centos 6）
Hosts/rack_info主机的机架信息
Hosts/last_heartbeat_time自Unix时代以来主机发出的最后一次心跳的时间（以毫秒为单位）
Hosts/last_agent_env主机环境信息
Hosts/last_registration_time自Unix时代以来主机最后一次注册的时间（以毫秒为单位）
Hosts/disk_info主机磁盘信息
Hosts/host_status主机状态(未知,健康,不健康)
Hosts/public_host_name公用主机名。 请注意，通常在创建主机资源的过程中以特定于环境的方式填充此属性。 如果无法确定公共主机名，则它将与host_name属性相同
Hosts/host_state主机状态
Hosts/desired_configs所需配置

主机状态列表

状态描述
INIT新的主机状态
WAITING_FOR_HOST_STATUS_UPDATES从主机接收到注册请求，但主机尚未响应其状态更新检查
HEALTHY服务器定期从主机接收心跳，并且主机状态正常
HEARTBEAT_LOST在配置的心跳到期窗口中，服务器未从主机接收到心跳
UNHEALTHY主机本身或通过其他方式（监视层）报告的主机处于不正常状态

主机操作

# 获取主机列表
GET /clusters/:clusterName/hosts
# 查看主机信息
GET /clusters/:clusterName/hosts/:hostName
# 创建主机
POST /clusters/:clusterName/hosts/:hostName

5.3.5 主机组件

主机组件资源是特定主机上的组件。
主机组件是主机的子资源。

主机组件资源配置

配置描述
HostRoles/role_id主机组件id
HostRoles/cluster_name父资源集群名称
HostRoles/host_name父资源主机名称
HostRoles/component_name父组件名称
HostRoles/state主机组件状态
HostRoles/actual_configs实际配置
HostRoles/desired_configs所需配置
HostRoles/stack_id服务id(例如 HDP-1.3.0)

主机组件操作

# 主机组件列表
GET /clusters/:name/hosts/:hostName/host_components
# 查看主机组件信息
GET /clusters/:name/hosts/:hostName/host_components/:componentName
# 创建主机组件
POST clusters/:clusterName/hosts/:hostName/host_components/:componentName
# 更新主机组件
PUT api/v1/clusters/:name/hosts/:hostName/host_components/:hostComponentName

5.3.6 配置

配置资源是一组键/值对，用于配置Hadoop集群的服务。
集群具有许多配置集，每个配置集都可以应用于特定功能。
配置由类型，标签和定义它们的属性组成。 例如:

{
  "type": "core-site",
  "tag": "version1",
  "properties": {
    "fs.default.name": "hdfs://h0:8020"
    // ...
  }
}

配置资源操作

# 获取集群(名称为hadoop)配置信息
GET /api/v1/clusters/hadoop/configurations
curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/clusters/hadoop/configurations


# 获取集群(名称为hadoop)yarn-site 标签为version1配置信息
GET /api/v1/clusters/hadoop/configurations?type=yarn-sie&tag=version1


curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/clusters/hadoop/configurations?type=yarn-sie&tag=version1
{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/configurations?type=yarn-site",
  "items" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/configurations?type=yarn-site&tag=version1",
      "tag" : "version1",
      "type" : "yarn-site",
      "version" : 1,
      "Config" : {
        "cluster_name" : "hadoop",
        "stack_id" : "HDP-2.6"
      }
    }
  ]
}


# 要创建新配置，可以进行以下调用。 创建配置与应用配置不同。
POST /api/v1/clusters/hadoop/configurations
{
  "tag" : "version2",
  "type" : "global",
  "Config" : {
    "cluster_name" : "c2"
  }
}

5.3.7 请求

请求资源是为执行指令而创建的任务组

请求资源配置

配置描述
Requests/id请求id
Requests/cluster_name父集群名称
Requests/request_context请求上下文

请求操作

# 获取请求列表
GET /clusters/:clusterName/requests

5.3.8 任务

任务资源是组成请求资源的各个任务

任务资源配置

配置描述
Tasks/id任务id
Tasks/request_id父请求id
Tasks/cluster_name父集群名称
Tasks/attempt_cnt完成此任务的尝试次数
Tasks/command任务命令
Tasks/exit_code退出码
Tasks/host_name主机名
Tasks/role角色
Tasks/stage_id阶段id
Tasks/start_time任务开始时间
Tasks/status任务状态
Tasks/stderr运行任务的错误输出
Tasks/stdout运行任务的标准输出

任务资源状态列表

状态描述
PENDING等待状态…
QUEUED排队中…
IN_PROGRESS正在运行
COMPLETED运行成功
FAILED失败
TIMEDOUT主机未及时响应
ABORTED行动被放弃

任务资源操作

# 列出任务列表
GET /clusters/:clusterName/requests/:requestId/tasks

5.3.9 请求调度

请求调度根据调度计划定义要执行的一批请求

请求调度操作示例

#  列举集群定义的所有请求调度列表
GET /api/v1/clusters/c1/request_schedules
# 创建请求调度资源
POST /api/v1/clusters/c1/request_schedules
# 删除指定的请求调度资源
DELETE /api/v1/clusters/c1/request_schedules/:id

5.3.10 工作流程

工作流资源是Hadoop集群中MapReduce作业的DAG。

工作流程资源操作

# 获取工作流资源列表
GET /clusters/:name/workflows
# 查看工作流资源信息
GET /clusters/:name/workflows/:workflowid

5.3.11 作业

作业资源代表工作流程中的各个节点（MapReduce作业）

作业资源操作

# 获取作业资源列表
GET /clusters/:name/workflows/:workflowid/jobs
# 查看作业资源信息
GET /clusters/:name/workflows/:workflowid/jobs/:jobid

5.3.12 任务尝试

任务尝试资源是job中map或者reduce任务的尝试

任务尝试资源操作

# 获取任务尝试资源列表
GET /clusters/:name/workflows/:workflowid/jobs/:jobid/taskattempts
# 查看任务尝试资源信息
GET /clusters/:name/workflows/:workflowid/jobs/:jobid/taskattempts/:taskattempt

5.3.13 视图

视图提供了一种系统化的方式来插入UI，
以提供Ambari Web中的自定义可视化，管理和监视功能

视图资源操作

# 获取视图资源列表
GET http://<server>:8080/api/v1/views/
curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/views

# 获取指定视图资源
GET http://<server>:8080/api/v1/views/FILES/
 curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/views/FILES

结果如下:

{
  "href" : "http://192.168.226.140:8080/api/v1/views/FILES",
  "ViewInfo" : {
    "view_name" : "FILES"
  },
  "versions" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/views/FILES/versions/1.0.0",
      "ViewVersionInfo" : {
        "version" : "1.0.0",
        "view_name" : "FILES"
      }
    }
  ]
}

# 获取指定视图资源版本
GET http://<server>:8080/api/v1/views/FILES/versions/
curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/views/FILES/versions

{
  "href" : "http://192.168.226.140:8080/api/v1/views/FILES/versions",
  "items" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/views/FILES/versions/1.0.0",
      "ViewVersionInfo" : {
        "version" : "1.0.0",
        "view_name" : "FILES"
      }
    }
  ]
}

# 获取指定视图资源的指定版本
GET http://<server>:8080/api/v1/views/FILES/versions/1.0.0/
curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/views/FILES/versions/1.0.0

# 获取指定视图资源指定版本的全部实例
GET http://<server>:8080/api/v1/views/FILES/versions/1.0.0/instances/
curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/views/FILES/versions/1.0.0/instances

# 获取指定视图资源指定版本的指定实例
GET http://<server>:8080/api/v1/views/FILES/versions/1.0.0/instances/AUTO_FLES_INSTANCE
curl -u admin:admin -X  GET http://192.168.226.140:8080/api/v1/views/FILES/versions/1.0.0/instances/AUTO_FLES_INSTANCE


#创建指定视图资源指定版的实例
PUT http://<server>:8080/api/v1/views/FILES/versions/1.0.0/instances/AUTO_FLES_INSTANCE_2
# 删除指定视图资源指定版的实例
DELETE http://<server>:8080/api/v1/views/FILES/versions/1.0.0/instances/AUTO_FLES_INSTANCE_2

5.3.14 仓库版本

仓库版本资源包含有关具有Hadoop服务的可用仓库信息。

仓库版本资源操作

# 获取仓库版本资源列表
GET http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/

curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/stacks/HDP/versions/2.6/repository_versios
{ 
  "href" : "http://192.168.226.140:8080/api/v1/stacks/HDP/versions/2.6/repository_versions",
  "items" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/stacks/HDP/versions/2.6/repository_versions/2",
      "RepositoryVersions" : {
        "id" : 2,
        "stack_name" : "HDP",
        "stack_version" : "2.6"
      }
    }
  ]
}

# 通过API创建新的存储库版本。 至少应提供一组基本存储库URL。
POST http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/
{
  "RepositoryVersions": {
    "repository_version": "2.2.1.1",
    "display_name": "HDP-2.2.1.1"
  },
  "operating_systems": [
    {
      "OperatingSystems": {
        "os_type": "redhat6"
      },
      "repositories": [
        {
          "Repositories": {
            "repo_id": "HDP-2.2",
            "repo_name": "HDP",
            "base_url": "http://..."
          }
        },
        {
          "Repositories": {
            "repo_id": "HDP-UTILS-1.1.0.20",
            "repo_name": "HDP-UTILS",
            "base_url": "http://..."
          }
        }
      ]
    }
  ]
}

# 获取特定服务的指定仓库版本
GET http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/2
 curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/stacks/HDP/versions/2.6/repository_version/2


# 删除特定服务的指定仓库版本
DELETE http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/2
curl -u admin:admin -X  DELETE  http://192.168.226.140:8080/api/v1/stacks/HDP/versions/2.6/repository_version/2

# 更新存储库版本。 可以更改显示名称和基本URL
PUT http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/1

{
  "RepositoryVersions": {
    "display_name": "HDP-2.2.1.1",
    "id": 1,
    "repository_version": "2.2.1.1"
  },
  "operating_systems": [
    {
      "href": "http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/1/operating_systems/redhat5",
      "OperatingSystems": {
        "os_type": "redhat5"
      },
      "repositories": [
        {
          "href": "http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/1/operating_systems/redhat5/repositories/HDP-2.2",
          "Repositories": {
            "base_url": "http://...",
            "os_type": "redhat5",
            "repo_id": "HDP-2.2",
            "repo_name": "HDP"
          }
        },
        {
          "href": "http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/repository_versions/1/operating_systems/redhat5/repositories/HDP-UTILS-1.1.0.20",
          "Repositories": {
            "base_url": "http://...",
            "os_type": "redhat5",
            "repo_id": "HDP-UTILS-1.1.0.20",
            "repo_name": "HDP-UTILS"
          }
        }
      ]
    }
  ]
}

# 可以在持久化之前验证存储库的URL。
POST http://<server>:8080/api/v1/stacks/<stack_name>/versions/<stack_version>/operating_systems/redhat5/repositories/HDP-UTILS-1.1.0.20?validate_only=true

{
  "Repositories": {
    "base_url": "http://..."
  }
}

5.3.15 服务版本

服务版本资源包含某些资源版本库与存储库版本之间的关系。

服务版本资源操作

# 获取所有服务版本(集群级别)
GET http://<server>:8080/api/v1/clusters/<cluster_name>/stack_versions/
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/stack_versions
{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/stack_versions",
  "items" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/stack_versions/2",
      "ClusterStackVersions" : {
        "cluster_name" : "hadoop",
        "id" : 2,
        "repository_version" : 2,
        "stack" : "HDP",
        "version" : "2.6"
      }
    }
  ]
}


# 获取所有服务版本(主机级别)
GET http://<server>:8080/api/v1/hosts/<host_name>/stack_versions
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/hosts/master/stack_versions

# 获取单一服务版本(集群级别)
GET http://<server>:8080/api/v1/clusters/<cluster_name>/stack_versions/2
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/stack_versions/2


# 获取单一服务版本(主机级别)
GET http://<server>:8080/api/v1/hosts/<host_name>/stack_versions/1
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/hosts/master/stack_versions/1


# 在服务版本资源上执行指定仓库版本的安装(集群级别)
POST http://<server>:8080/api/v1/clusters/<cluster_name>/stack_versions/
{
  "ClusterStackVersions": {
    "stack": "HDP",
    "version": "2.2",
    "repository_version": "2.2.0.1-885"
  }
}

# 在服务版本资源上执行指定仓库版本的安装(主机级别)
POST http://<server>:8080/api/v1/hosts/<host_name>/stack_versions/

{
  "HostStackVersions": {
    "stack": "HDP",
    "version": "2.2",
    "repository_version": "2.2.0.1-885"
  }
}

5.3.16 滚动升级检查

滚动升级检查资源存储有关在滚动升级之前执行的检查成功或者检查失败信息。

# 检索滚动升级检查的结果。 在运行滚动升级之前，所有检查的状态均应为“通过”
GET http://<server>:8080/api/v1/clusters/<cluster_name>/rolling_upgrades_check/
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/rolling_upgrades_check/

#以下是一个滚动升级检查成功的实例
{
  href: "http://<server>:8080/api/v1/clusters/<cluster_name>/rolling_upgrades_check/?fields=*",
  items: [
    {
      href: "http://<server>:8080/api/v1/clusters/<cluster_name>/rolling_upgrades_check/HOSTS_HEARTBEAT",
      UpgradeChecks: {
        check: "All hosts must be heartbeating with the server unless they are in Maintenance Mode",
        check_type: "HOST",
        cluster_name: "1",
        failed_on: [
          
        ],
        id: "HOSTS_HEARTBEAT",
        reason: "",
        status: "PASS"
      }
    },
    {
      href: "http://<server>:8080/api/v1/clusters/<cluster_name>/rolling_upgrades_check/SECONDARY_NAMENODE_MUST_BE_DELETED",
      UpgradeChecks: {
        check: "The SECONDARY_NAMENODE component must be deleted from all hosts",
        check_type: "SERVICE",
        cluster_name: "<cluster_name>",
        failed_on: [
          "SECONDARY_NAMENODE"
        ],
        id: "SECONDARY_NAMENODE_MUST_BE_DELETED",
        reason: "The SECONDARY_NAMENODE component must be deleted from host(s): c6401.ambari.apache.org. Please use the REST API to delete it.",
        status: "FAIL"
      }
    }
  ]
}

5.3.17 升级

升级资源用于管理和查询正在进行的滚动升级的状态。

5.3.18 警报

警报资源包含定义，历史记录和出站通知的调度之间的关系。
Ambari利用其自己的警报框架来监视服务，组件或托管并向相关方发出通知
告警定义:
告警定义是用于将警报分发到适当的Ambari代理的模板。 它们控制警报的类型，阈值以及通知目标时要使用的信息。
告警调度:
告警调度涉及创建警报定义组，并向这些组添加通知目标。
告警历史:
告警历史可用于查询告警的当前状态以及所有历史事件

5.3.19 凭证

凭证资源是主体（或用户名）和密码对，它们使用别名标记并存储在临时或持久存储设施中。
这些资源可以被创建，更新和删除。
但是，（出于安全原因）获取凭据资源时，仅返回别名和凭据是存储在临时存储还是持久存储中的指示符。
凭据是集群的子资源。

凭证资源配置

配置描述
Credential/cluster_name集群名称
Credential/alias别名
Credential/principal主体（或用户名）-获取凭据时此值不可见
Credential/key私钥（或密码）-获取凭据时此值不可见
Credential/type凭证存储的类型：持久存储还是临时存储

凭证资源操作

# 获取凭证资源列表
GET /clusters/:clusterName/credentials
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/credentials
# 获取有关现有凭证的详细信息。 出于安全考虑，也不会返回有关凭据的所有信息。
GET /clusters/:clusterName/credentials/:alias
GET /clusters/hadoop/credentials/kdc.admin.credentials
{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/credentials/kdc.admin.credentials",
  "Credential" : {
    "alias" : "kdc.admin.credentials",
    "cluster_name" : "hadoop",
    "type" : "temporary"
  }
}
# 创建凭证
POST /clusters/:clusterName/credentials/:alias
# 更新凭证
PUT /clusters/:clusterName/credentials/:alias
# 删除凭证
DELETE /clusters/:clusterName/credentials/:alias
DELETE /clusters/hadoop/credentials/external.db

5.3.20 权限

权限资源用于帮助确定用户的授权权限。
通过在用户和要投影到某个资源上的权限之间建立特权关系，将权限分配给用户

权限资源配置

配置描述
PermissionInfo/permission_id权限的唯一ID-该值可用于唯一标识权限
PermissionInfo/permission_name权限的唯一名称-此值可用于唯一标识权限
PermissionInfo/permission_label权限的描述性标签-此值可用于在用户界面中显示权限
PermissionInfo/resource_name此权限与之相关的资源类型。 可能的值包括：Ambari(Ambari服务器自身),CLUSTER(由Ambari服务器管理的集群),VIEW(由Ambari服务器管理的视图)

权限资源操作

# 返回现有权限的集合
GET /permissions
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/permissions
{
  "href" : "http://192.168.226.140:8080/api/v1/permissions",
  "items" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/permissions/1",
      "PermissionInfo" : {
        "permission_id" : 1
      }
    },
    {
      "href" : "http://192.168.226.140:8080/api/v1/permissions/2",
      "PermissionInfo" : {
        "permission_id" : 2
      }
    },
    {
      "href" : "http://192.168.226.140:8080/api/v1/permissions/3",
      "PermissionInfo" : {
        "permission_id" : 3
      }
    },
    {
      "href" : "http://192.168.226.140:8080/api/v1/permissions/4",
      "PermissionInfo" : {
        "permission_id" : 4
      }
    },
    {
      "href" : "http://192.168.226.140:8080/api/v1/permissions/5",
      "PermissionInfo" : {
        "permission_id" : 5
      }
    },
    {
      "href" : "http://192.168.226.140:8080/api/v1/permissions/6",
      "PermissionInfo" : {
        "permission_id" : 6
      }
    },
    {
      "href" : "http://192.168.226.140:8080/api/v1/permissions/7",
      "PermissionInfo" : {
        "permission_id" : 7
      }
    }
  ]
}

# 获取现有权限的详细信息
GET /permissions/:permission_id
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/permissions/1

# 创建一个新的权限资源。 不支持此操作，权限是只读资源。 会返回500的状态码
POST /permissions/:permission_id
# 更新已有的权限资源 不支持此操作，权限是只读资源。 会返回500的状态码
PUT /permissions/:permission_id
# 删除已有的权限资源 不支持此操作，权限是只读资源。 会返回500的状态码
DELETE /permissions/:permission_id

5.3.21 用户

用户资源代表可以使用Ambari的用户。
用户被授予在Ambari中执行任务的权限。

用户资源配置列表

配置描述
Users/user_id用户的唯一ID-该值可用于唯一标识用户。该值在内部生成，并且是只读的。
Users/user_name用户的唯一名称-此值不区分大小写，可用于唯一标识用户。创建资源时必须设置该值； 否则为只读。
Users/local_user_name用户的本地用户名-该值区分大小写，并用作通过Ambari Views访问服务时要使用的用户名。 如果未设置，将使用用户名值。该值可由Ambari管理员设置； 否则为只读。
Users/display_name用户的本地用户名-此值用于消息和用户界面中的显示目的。 如果未设置，将使用用户名值。该值可由用户或Ambari管理员设置。
Users/active用户活动状态(活动返回true,否则返回false)
Users/consecutive_failures自上次成功进行身份验证以来的连续身份验证失败次数。该值是只读的。
Users/created指示何时创建用户资源的时间戳。该值在内部生成，并且是只读的。
Users/groups用户是组中的一个成员。该值是只读的。
Users/admin只是用户是否具有管理权限,不推荐使用此属性,可以通过查询用户或角色的权限找到此信息.该值可由Ambari管理员设置； 否则为只读。
Users/ldap_user表示从LDAP服务器导入用户。 不推荐使用此属性.可以通过查询用户的身份验证源找到此信息。该值是只读的。
Users/user_type用户帐户的类型。 可能的值包括：LOCAL(用户具有Ambari本地密码),LDAP(用户使用LDAP服务器进行身份验证),KERBEROS(用户使用Kerberos令牌进行身份验证),PAM(用户使用PAM进行身份验证),JWT(用户使用来自Knox的JWT令牌进行身份验证)
Users/password用户密码
Users/old_password用户曾用密码

用户资源操作

# 获取存在的用户列表
GET /users
 curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/users
{
  "href" : "http://192.168.226.140:8080/api/v1/users",
  "items" : [
    {
      "href" : "http://192.168.226.140:8080/api/v1/users/admin",
      "Users" : {
        "user_name" : "admin"
      }
    }
  ]
} 

# 获取指定的用户
GET /users/:user_name
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/users/admin


# 创建用户 仅具有AMBARI.MANAGE_USERS特权的用户（当前为Ambari管理员）可以执行此操作。
POST /users/:user_name

# 更新用户
PUT /users/:user_name
# 删除用户
DELETE /users/:user_name

5.3.22 认证来源

认证源资源是用户资源的子资源。
每个来源都代表一个用户可以用来登录Ambari的身份验证来源。
有不同类型的身份验证源，例如（但不限于）Local，LDAP，JWT和Kerberos。

认证来源配置
配置|描述
AuthenticationSourceInfo/source_id(内部生成,只读)|身份验证源的唯一ID-该值可用于唯一标识身份验证源。
AuthenticationSourceInfo/user_name(只读)|父资源用户名
AuthenticationSourceInfo/authentication_type|身份验证源的类型。 可能的值包括LOCAL,LDAP,KERBEROS,PAM,JWT
AuthenticationSourceInfo/key|身份验证类型专用密钥
AuthenticationSourceInfo/old_key(只读)|身份验证类型曾用密钥
AuthenticationSourceInfo/created(只读)|创建身份验证源资源的时间戳
AuthenticationSourceInfo/updated|(只读)|指示何时更新认证源资源的时间戳

认证来源资源操作

# 获取认证来源
GET /users/:user_name/sources
# 获取指定用户指定source id的认证来源
GET /users/:user_name/sources/:source_id
#创建认证来源资源
POST /users/:user_name/sources
# 更新认证来源资源
PUT /user/:user_name/sources/:source_id
# 删除认证来源资源
DELETE /user/:user_name/sources/:source_id

六. 部分响应

部分响应用于控制查询返回哪些字段。
部分响应可用于限制返回哪些字段，此外，它还允许查询到达并从子资源返回数据。关键字“字段”用于指定部分响应。 仅将指定的字段返回给客户端。
要指定子元素，请使用符号“ a / b / c”。 可以指定属性，类别和子资源。
通配符“ *”可用于显示资源的所有类别，字段和子资源。
可以组合使用这些功能来为子组件提供“扩展”功能。 无论指定了部分响应字段如何，总是为资源返回某些字段。
这些字段是唯一标识资源的字段。 这将是资源的主要ID字段，并且是资源所有祖先的主要ID字段的外键。

示例:使用部分响应将响应限制为特定字段

GET    /api/v1/clusters/hadoop/services/HDFS/components/NAMENODE?fields=metrics/disk/disk_total
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS/components/NAMENODE?fields=metrics/disk/disk_total
{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS/components/NAMENODE?fields=metrics/disk/disk_total",
  "ServiceComponentInfo" : {
    "cluster_name" : "hadoop",
    "component_name" : "NAMENODE",
    "service_name" : "HDFS"
  }
}

示例:使用部分响应将响应限制为多个字段/类别

GET	/api/v1/clusters/hadoop/services/HDFS/components/NAMENODE?fields=metrics/disk/disk_total,metrics/cpu
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS/components/NAMENODE?fields=metrics/disk/disk_total,metrics/cpu
{
  "href" : "http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS/components/NAMENODE?fields=metrics/disk/disk_total,metrics/cpu",
  "ServiceComponentInfo" : {
    "cluster_name" : "hadoop",
    "component_name" : "NAMENODE",
    "service_name" : "HDFS"
  }
}

示例:使用部分响应来限制对子资源的响应

GET	/api/v1/clusters/hadoop/hosts/master.hadoop?fields=host_components
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/hosts/master.hadoop?fieldshost_components

示例:使用部分响应将子资源扩展到一个级别

GET	/api/v1/clusters/hadoop/hosts/master.hadoop?fields=host_components/*
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/hosts/master.hadoop?fieldshost_components/*

示例:使用部分响应进行子资源的多级扩展

GET /api/v1/clusters/hadoop/hosts/master.hadoop?fields=host_components/component/*
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/hosts/master.hadoop?fieldshost_components/component/*

示例：使用部分响应将收集资源实例扩展到一个深度

GET /api/v1/clusters/hadoop/hosts?fields=*
 curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/hosts/?fields=*

示例: 对于每个群集，获取群集名称，所有主机名和所有服务名称

GET   /api/v1/clusters?fields=Clusters/cluster_name,hosts/Hosts/host_name,services/ServiceInfo/service_name

示例:获取给定组件的所有主机名

GET	/api/v1/clusters/c1/services/HDFS/components/DATANODE?fields=host_components/HostRoles/host_name

示例:获取给定服务的所有主机名和组件名称

GET	/api/v1/clusters/c1/services/HDFS?fields=components/host_components/HostRoles/host_name,
                                  	          components/host_components/HostRoles/component_name

七. 查询谓词

查询谓词用于限制查询返回的数据. 与SQL查询中的where语句同义.
出了谓词中使用的字段外,提供查询参数不会导致返回数据的任何链接扩展.
查询谓词只能应用于集合资源,由至少一个关系表达式组成.
具有多个关系表达式的谓词还包含逻辑运算符，这些运算符连接关系表达式。 谓词也可以使用方括号对表达式进行显式分组。

关系查询操作符

操作符实例描述
=name=host1字符串或数字相等
!=name!=host1字符串或数字不等
<disk_total<50数字小于
>disk_total>50数字大于
<=disk_total<=50数字小于等于
>=disk_total>=50数字大于等于

逻辑运算操作符

操作符实例描述
|name=host1|name=host2或
&prop1=foo&prop2=bar与
!!prop<50非

逻辑运算符优先级

标准逻辑运算符优先级规则适用。
以最低优先级开始的优先顺序列出了以上逻辑运算符。

括号

符号含义
(左括号
)右括号

括号可用于提供表达式的显式分组。
方括号内的表达式具有最高优先级。

操作符功能

操作符实例描述
in()name.in(foo,bar)in功能,类似逻辑运算符中的或
isEmpty()category.isEmpty()用于确定类别是否包含任何属性

运算符函数的行为类似于关系运算符，并提供其他功能。
某些运算符函数（例如in（））像上述关系运算符一样充当二进制运算符，其中存在左和右操作数。
一些运算符函数是一元运算符，例如isEmpty（），其中只有一个操作数。

查询谓词操作

示例:获取具有2个以上cpu并且状态为HEALTHY的主机

GET	/api/v1/clusters/hadoop/hosts?Hosts/host_status=HEALTHY&Hosts/cpu_count>=2
 curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/hosts?Hosts/host_status=HEALTHY&Hosts/cpu_count>=2

示例:获取cpu小于两个或者状态不是HEALTHY的主机

GET	/api/v1/clusters/c1/hosts?Hosts/cpu_count<2|Hosts/host_status!=HEALTHY

示例:获取所有cpu小于2的rhel6主机或者cpu大于3的centos6主机

GET	/api/v1/clusters/c1/hosts?Hosts/os_type=rhel6&Hosts/cpu_count<2|Hosts/os_type=centos6&Hosts/cpu_count>=3

示例:获取状态不是HEALTHY或者最后一次心跳时间小于1360600135905并且机架信息为default_rack的所有主机

GET	/api/v1/clusters/c1/hosts?(Hosts/host_status!=HEALTHY|Hosts/last_heartbeat_time<1360600135905)
                              &Hosts/rack_info=default_rack

示例:使用IN运算符获取主机名为host1或host2或host3的主机

GET	/api/v1/clusters/c1/hosts?Hosts/host_name.in(host1,host2,host3)

示例:获取并扩展所有HDFS组件，这些组件在“ metrics / jvm”类别中至少具有1个属性（组合查询和部分响应语法）

GET	/api/v1/clusters/c1/services/HDFS/components?!metrics/jvm.isEmpty()&fields=*

示例:将所有“已安装”服务的状态更新为“已开始”

PUT /api/v1/clusters/c1/services?ServiceInfo/state=INSTALLED 
{
  "ServiceInfo": {
    "state" : "STARTED"
  }
}

八. 批量请求

可以批量处理请求。
这允许在单个请求中将多个主体指定为数组。

示例:在单个请求中创建多个主机

POST /api/v1/clusters/c1/hosts/         

[
  {
    "Hosts" : {
      "cluster_name" : "c1",
      "host_name" : "host1"
    }
  },
  {
    "Hosts" : {
      "cluster_name" : "c1",
      "host_name" : "host2"
    }
  },
  {
    "Hosts" : {
      "cluster_name" : "c1",
      "host_name" : "host3"
    }
  }
]

九. 请求信息

请求信息资源允许用户在请求主体中指定其他属性。

键描述
查询请求的查询字符串。 对于克服URL的长度限制以及为批处理请求的每个元素指定查询字符串很有用。
上下文上下文字符串,API客户端尅传递上下文字符串以指定请求的内容(比如:启动HDFS服务,添加主机等)

查询
查询属性允许用户将查询字符串指定为请求主体的一部分。
如果查询字符串很长，导致请求超出URL的限制，有时这是必需的。
示例:在请求正文中指定查询字符串

PUT  /clusters/c1/services

{
  "RequestInfo":{
    "query":"ServiceInfo/state=STARTED&ServiceInfo/service_name=HDFS&…"
  },

  "Body":
  {
    "ServiceInfo": {
      "state" : "INSTALLED"
    }
  }
}

查询属性也可以应用于批处理请求的元素。

示例:在请求主体中为批处理请求指定查询字符串

PUT /api/v1/clusters/c1/hosts

[
  {
    "RequestInfo":{
      "query":"Hosts/host_name=host1"
    },
    "Body":
    {
      "Hosts": {
        "desired_config": {
          "type": "global",
          "tag": "version50",
          "properties": { "a": "b", "x": "y" }
        }
      }
    }
  },
  {
    "RequestInfo":{
      "query":"Hosts/host_name=host2"
    },
    "Body":
    {
      "Hosts": {
        "desired_config": {
          "type": "global",
          "tag": "version51",
          "properties": { "a": "c", "x": "z" }
        }
      }
    }
  }
]

上下文
在某些情况下，请求将返回202以指示该指令已被服务器接受（请参见异步响应）。
在这些情况下，响应的正文包含为执行指令而创建的请求资源的ID和href。
可能需要将上下文字符串附加到请求，然后将其分配给结果请求响应。

在以下示例中，发出了停止HDFS服务的请求。
请注意，上下文是作为请求信息属性传递的。

示例:在请求正文中指定查询字符串

PUT  /clusters/c1/services

{
  "RequestInfo":{
    "query":"ServiceInfo/state=STARTED&ServiceInfo/service_name=HDFS",
    "context":"Stop HDFS service."
  },

  "Body":
  {
    "ServiceInfo": {
      "state" : "INSTALLED"
    }
  }
}

响应:

{
  "href" : "http://your.ambari.server/api/v1/clusters/c1/requests/13",
  "Requests" : {
    "id" : 13,
    "status" : "InProgress"
  }
}

当查询上例中返回的请求资源时，将提供的上下文字符串作为响应的一部分返回。

GET api/v1/clusters/c1/requests/13 
#响应
{
  "href" : "http://ec2-50-19-183-89.compute-1.amazonaws.com:8080/api/v1/clusters/c1/requests/13",
  "Requests" : {
    "id" : 13,
    "cluster_name" : "c1",
    "request_context" : "Stop HDFS service."
  },
  "tasks" : [
    …
  ]
}

十. 时间指标

某些指标的值在一定范围内可用。要查询度量标准的值范围，请使用以下部分响应语法。

要获取单个属性的时态数据：？fields = category / property [开始时间，结束时间，步骤]

要获取类别中所有属性的时间数据：？fields = category [开始时间，结束时间，步骤]

开始时间：必填字段。 Unix纪元时间格式的查询开始时间。结束时间：可选字段，默认为现在。 Unix纪元时间格式的查询结束时间。步骤：可选字段，默认为相应指标系统的默认值。如果提供，还必须提供结束时间。返回的数据点之间的时间间隔（以秒为单位）。提供的值越大，返回的数据点就越少，因此可用于限制在给定时间范围内返回的数据量。这仅用作建议，因此结果间隔可能与指定的间隔不同。

返回的结果是指定时间范围内的数据点列表。每个数据点都是一个值/时间戳对。

注意：必须理解，请求大量的时间数据可能会导致严重的性能下降，这一点很重要。始终要求提供最少的信息量。如果需要大量数据，请考虑将请求分成多个较小的请求。

实例:仅使用开始时间对单个属性进行时间查询

GET /api/v1/clusters/hadoop/hosts/master.hadoop?fields=metrics/jvm/gcCount[1360610225]
curl -u admin:admin -X  GET  http://192.168.226.140:8080/api/v1/clusters/hadoop/hosts/master.hadoop?fields=metrics/jvm/gcCount[1360610225]

实例:使用开始时间,结束时间和步骤来临时查询类别

GET	/api/v1/clusters/c1/hosts/host1?fields=metrics/jvm[1360610200,1360610500,100]

200 OK
{
	“href” : …/clusters/c1/hosts/host1?fields=metrics/jvm[1360610200,1360610500,100]”,
	...
	“metrics”: [
    	{
        	“jvm”: {
      	    	"gcCount" : [
               		[10, 1360610200],
                 	[12, 1360610300],
                 	[13, 1360610400],
                 	[14, 1360610500]
              	],
            	"gcTimeMillis" : [
               		[1000, 1360610200],
                 	[2000, 1360610300],
                 	[5000, 1360610400],
                 	[9500, 1360610500]
              	],
              	...
         	}
     	}
	]
}

十一. 分页

通过指定页面大小和偏移量，可以将为请求返回的资源划分为多个页面。

参数描述
page_size分页响应要返回的资源数量
from起始页资源(包含起始页)
to结束页资源(包含结束页)

注意：可以指定from或to，不能两者都指定。 如果两者均未指定，则假定为“ from = 0”。
offset是一个整数值，表示资源集中的偏移量（基于零）。
例如，“ from = 21”表示响应页面的第一个资源应为资源集的第21个资源。

实例:从21号开始获取包含10个请求资源的页面

/api/v1/clusters/cl1/requests?from=21&page_size=10

start关键字指示资源集的开始，相当于偏移量0。

实例:从头开始获取包含10个请求资源的页面

/api/v1/clusters/cl1/requests?from=start&page_size=10

/api/v1/clusters/cl1/requests?from=0&page_size=10

end关键字指示资源集的结尾，相当于偏移量为-1。

实例:获取最后10个请求资源

/api/v1/clusters/cl1/requests?to=end&page_size=10

/api/v1/clusters/cl1/requests?to=-1&page_size=10

隐含资源的默认排序（通过资源键属性的自然排序）。

HTTP返回码

http码描述
200OK
400错误的请求
401未经授权
403禁止的
404未找到
500内部服务器错误

十二. 异常

异常响应的实例

404 Not Found
{   
	"status" : 404,   
	"message" : "The requested resource doesn't exist: Cluster not found, clusterName=someInvalidCluster" 
} 

400 Bad Request
{   
	"status" : 400,   
	"message" : "The properties [foo] specified in the request or predicate are not supported for the 
            	 resource type Cluster."
}

十三. 操作中遇到的问题

创建服务失败:

# 执行如下命令创建HDFS服务
curl -u admin:admin -X POST http://192.168.226.140:8080/api/v1/clusters/hadoop/services/HDFS

报错如下:

{
  "status" : 400,
  "message" : "CSRF protection is turned on. X-Requested-By HTTP header is required."
}

解决方案:

vi /etc/ambari-server/conf/ambari.properties
# 添加如下内容:
api.csrfPrevention.enabled=false
# 重启ambari-server
ambari-server restart
# 重新执行添加/删除服务命令
new个对象先
关注
  • 1
    点赞
  • 踩
  • 11
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
ambari-blueprint-examples
05-24
Ambari蓝图示例 通过一些蓝图，可以真正轻松地通过向导并启动HDP群集。 蓝图清单 相当于沙盒-非常便宜的蓝图，可在亚马逊上运行某些内容以处理我们的东西 小型群集-可能有8-10个代表标准群集的节点。 HA群集-可能有20个具有HA的节点，代表了实际生产群集上的良好开端。 流式集群-部署10个节点，包括Storm和Kafka Spark Cluster-部署一个std。 在群集上的YARN上使用Spark正确配置了10个节点的群集。 已知的问题 HA集群正在运行。
Ambari-部署常见问题
aodiyi6351的博客
05-16 99
重新启动ambari-server端后调用install、start API后返回200 导致该问题的解决办法是server在启动后没有收到agent的心跳即没有与agent建立连接，在此时进行API调用会导致仅仅改变集群服务的状态，实际server并没有进行命令发送。详细查看agent与server连接情况能够到 http://<ambari-ser...
AmbariMetrics详解.docx
01-14
AmbariMetrics详解，详述AmbariMetrics概念，以及API接口，技术架构等
ambari-blueprints
06-28
Ambari 蓝图 此存储库提供了一些示例，可帮助您开始使用 Ambari快速设置 Hadoop 集群。 ＃概述 蓝图可用于定义和安装 Hortonworks HDP 集群。 所需的步骤是（高级视图）： 使用操作系统安装集群节点 在所有节点上安装（一个）Ambari 服务器和代理 在 JSON 中定义蓝图 定义主机映射以应用蓝图 使用 Ambaris REST API 设置和应用您的 JSON 配置 #蓝图示例 1.) 使用基本 HDFS/YARN 组件（包括监控）设置。 2.) 使用基本 HDFS/YARN 组件、Hive&Pig、Monitoring 和 Kafka brokers 设置一个。 成功安装 Hortonworks HDP 2.1（单节点）集群后的屏幕截图
ambari汉化
04-23
ambari汉化文档，按照此文档汉化，可汉化成功，目前生产已经经测试上线！
Ambari Rest API
最新发布
zincooo的博客
12-20 890
ambari rest api
ambari 异常总结及解决办法
主要分享大数据相关的知识，如Spark、Hudi
08-03 1万+
本文总结在使用ambari时产生的异常，以及如何解决的。如果发生了异常，在界面上不能直观的看出异常的原因，那么我一般通过查看日志的方法解决。通过下面的命令查看若该日志文件没有异常信息，可在其他日志文件里查找。...
Ambari 操作指南 (Ambari Operations) 之四
devalone 的专栏
06-27 9858
继  (Ambari 操作 (Ambari Operations) 之三 :      https://blog.csdn.net/devalone/article/details/80813176 )8 启用服务自动启动 (Managing Alerts and Notifications)-----------------------------------------------------...
【ambari】ambari api使用
superone52033的博客
02-28 908
ambari api的使用
Ambari架构设计文档 -- (官方翻译版)
a11en_03的博客
07-11 650
写作背景 首先如题目所示，这是一篇翻译自Ambari官方设计文档的文章，那么Ambari是什么就不多说了，翻译这篇文章的目的是，作者所在的项目组的大数据管理框架目前刚好决定要用Ambari代替了CDH，在Ambari基础上进行二次开发来满足我们的项目需求，作为QA同学要测好这个项目那么就需要对Ambari有一个基本的了解，所以有了翻译这篇技术文档的想法，一是满足自己学习的目的了二是想着也可以给类似和我一样需要的同学一个学习资料吧。 设计目标 跨平台（Platform Independence ） 系统架构必
ambari-check-service
05-11
Ambari服务检查python util 您可以使用此python util来启动选定服务或所有服务的Ambari服务检查。 API调用基于。 设定档 您可以在下面的示例配置中找到。 请设置权限，只有可能运行此脚本的用户才能阅读它。 样本配置： { " hostname " : " localhost " , " port " : 8080 , " cluster_name " : " sandbox " , " user " : " admin " , " password " : " admin " , " ssl " : false } 用法 您可以指定两个选项： 用-c配置文件位置 您要使用-s检查的服务列表，请仅使用逗号分隔service_names 如果不使用-s选项，则表示脚本将检查所有服务。 如果不使用-c选项，则意味着脚本将在../con
ambari server 添加主机api
08-29
通过ambari server api 添加节点 可以脱离ambari dashboard
Ambari 操作指南 .docx
08-21
Apache Ambari 从集群节点和服务收集了大量的信息，并把它们表现为容易使用的，集中化的接口：Ambari Web
ambari-custom-alerts:Ambari服务器的自定义警报
05-19
ambari-custom-alerts Ambari服务器的自定义警报 通过Ambari REST API推送新警报。 curl -u admin:admin -i -H ' X-Requested-By: ambari ' -X POST -d @alerts.json http://ambari.cloudapp.net:8080/api/v1/clusters/hdptest/alert_definitions 您还需要在/ var / lib / ambari-server / resources / host_scripts中复制python脚本，然后重新启动ambari-server。 重新启动后，脚本将被推送到不同主机上的/ var / lib / ambari-agent / cache / host_scripts中。 您可以通过运行找到警报的ID curl
ansible-ambari-config-module:通过Ambari API更新Ambari配置的模块
05-16
ansible-ambari-config-module 通过Ambari API更新Ambari配置的模块。 请在以下位置找到实际的模块文件： extra_modules/ambari_cluster_config.py extra_modules/ambari_service_control.py extra_modules/ambari_component_extend.py 重要信息请注意，以上模块正在调用Ambari API，因此在ambari服务器节点上运行这些模块的理想位置。 在这种情况下，您只需将localhost连接到ambari服务器即可进行设置。 一个例子是： hosts: ambari-server ambari_service_control: host: localhost ----> this will run the mo
ambari之API操作
zxl1033394132的专栏
05-03 5471
从今天起，开始对ambari官网的api进行小小的总结（当然，也对官网的api进行了小小的翻译）。
Ambari 常用的 REST API 介绍
热门推荐
程裕强的专栏
03-10 1万+
Ambari 借鉴了很多成熟分布式软件的 API 设计。 Rest API 就是一个很好地体现。通过 Ambari 的 Rest API，可以在脚本中通过 curl 维护整个集群。 并且，我们可以用 Rest API 实现一些无法在 Ambari GUI 上面做的操作。下面是一些实例。例1，通过 API 卸载已安装的 Service目前 Ambari 不支持在 GUI 上面卸载已安装的 Serv
Apache Ambari官方文档中文版
qianmoQ - 关注云计算,关注大数据
12-19 2813
Apache Ambari Installation Apache Ambari Administration 持续更新中。。。
AMBARI HDP 官方安装文档
wangfengjunaaa的专栏
09-20 2380
https://docs.hortonworks.com/HDPDocuments/HDP2/HDP-2.6.2/index.html这里写链接内容
ambari使用API卸载datanode
04-22
，应该如何操作？ 您可以使用以下命令通过Ambari API从群集中卸载DataNode： 1. 首先，您需要使用以下命令获取Ambari集群的安全令牌： ``` curl -i -u <ambari-username>:<ambari-password> -H 'X-Requested-By:ambari' -X POST http://<ambari-server>:<ambari-port>/api/v1/clusters/<cluster-name>/services/AMBARI_METRICS/components/AMBARI_METRICS_MONITOR?action=start ``` 请替换以下变量： - ambari-username：Ambari管理员用户名 - ambari-password：Ambari管理员密码 - ambari-server：Ambari服务器主机名或IP地址 - ambari-port：Ambari服务器端口号 - cluster-name：Ambari集群的名称 2. 然后使用以下命令列出DataNode的主机组件： ``` curl -u <ambari-username>:<ambari-password> -H 'X-Requested-By:ambari' -X GET http://<ambari-server>:<ambari-port>/api/v1/clusters/<cluster-name>/hosts/<datanode-hostname>/host_components/DATANODE ``` 请替换以下变量： - datanode-hostname：DataNode主机的主机名或IP地址 3. 最后，使用以下命令从群集中卸载DataNode： ``` curl -i -u <ambari-username>:<ambari-password> -H 'X-Requested-By:ambari' -X DELETE http://<ambari-server>:<ambari-port>/api/v1/clusters/<cluster-name>/hosts/<datanode-hostname>/host_components/DATANODE ``` 请替换以下变量： - datanode-hostname：DataNode主机的主机名或IP地址 希望这些命令可以帮助您成功卸载DataNode！

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值