HPE Ezmeral Data Fabric 6.1.x is In Maintenance and transitions to "End of Maintenance" in June 2024. Please see the latest documentation.

About MapR 6.1
This site contains the main documentation for Version 6.1 of the MapR Converged Data Platform, including installation, configuration, administration, and reference information.
6.1 Installation
This section contains information about installing and upgrading MapR software. It also contains information about how to migrate data and applications from an Apache Hadoop cluster to a MapR cluster.
6.1 MapR Data Platform
MapR Data Platform is the industry-leading data platform for AI and analytics that solves enterprise business needs.
6.1 Administration
This section describes how to manage the nodes and services that make up a cluster.
6.1 Development
This section contains information related to application development for Ezmeral ecosystem components and MapR Data Platform products, including the file system, Database (Key-Value and JSON), and Event Streams.
- Application Development Process
  Before you start developing applications on the MapR Data Platform platform, consider how you will get the data into the platform, the storage format of the data, the type of processing or modeling that is required, and how the data will be accessed.
- MapR XD and Apps
  The following sections provide information about accessing the MapR XD with C and Java applications.
- MapR Database and Apps
  This section contains information about developing client applications for JSON and key-value tables.
- MapR Event Store For Apache Kafka and Apps
  MapR Event Store For Apache Kafka brings integrated publish and subscribe messaging to MapR Data Platform.
- MapReduce and Apps
  This section contains information associated with developing YARN applications.
- MapR Data Science Refinery
  The MapR Data Science Refinery product is an easy-to-deploy and scalable data science toolkit with native access to all platform assets and superior out-of-the-box security.
- MapR Data Fabric for Kubernetes
  This section describes how to leverage the capabilities of the MapR Data Fabric for Kubernetes.
- Ecosystem Components
  The following sections provide information about each open-source project that is supported by the MapR Data Platform.
  - Ezmeral Ecosystem Packs
  - AsyncHBase
  - Cascading
  - Apache Drill
  - Flume
  - HBase
  - HBase Client and MapR Database Binary Tables
  - HCatalog
  - Hive
  - HttpFS
  - Hue
  - Impala
  - Livy
    Apache Livy is primarily used to provide integration between Hue and Spark.
  - MapR Event Store For Apache Kafka Clients and Tools
    Describes the supported MapR Event Store For Apache Kafka tools and clients.
    - KSQL
      KSQL is an open-source streaming SQL engine that implements continuous, interactive queries.
    - Kafka Streams
      Kafka Streams is a programming library used for creating Java or Scala streaming applications and, specifically, building streaming applications that transform input topics into output topics.
    - Kafka REST Proxy
      The Kafka REST Proxy provides a RESTful interface to MapR Event Store For Apache Kafka clusters to consume and produce messages and to perform administrative operations.
      - Configuration
        This section describes how to configure the Kafka REST Proxy for MapR Event Store For Apache Kafka.
      - Services Management
        The Kafka REST Proxy for MapR Event Store For Apache Kafka service can be started, restarted, and stopped via the maprcli nodes services command or using the REST API equivalent.
      - HTTP Methods and URI Summary
        This section provides HTTP method and URI summaries for multiple Kafka REST Proxy API versions for MapR Event Store For Apache Kafka.
        API v2 HTTP Methods and URIs
        GET /topics
        Retrieves a list of topic names.
        GET /topics/{string: topic_name}
        Retrieves metadata about a specific topic.
        POST /topics/{string: topic_name}
        Produces messages to a topic.
        GET /topics/{string: topic_name}/partitions
        Retrieves a list of partitions for the topic.
        GET /topics/{string: topic_name}/partitions/{string: partition_id}
        Retrieves metadata about a specific partition within a topic.
        POST /topics/{string: topic_name}/partitions/{string: partition_id}
        Produces messages into a partition of a topic.
        POST /consumers/{string: group_name}
        Creates a new consumer instance in the consumer group.
        DELETE /consumers/{string: group_name}/instances/{string: instance_id}
        Destroys the consumer instance.
        POST /consumers/{string: group_name}/instances/{string: consumer_instance_id}/offsets
        Commits a list of offsets for the consumer. When the post body is empty, it commits all the records that have been fetched by the consumer instance.
        GET /consumers/{string: group_name)/instances/{string: instance_id}/offsets
        Gets the last committed offsets for the given partitions (whether the commit happened by this process or another).
        POST /consumers/{string: group_name}/instances/{string: instance_id}/subscription
        Subscribes to the given list of topics or a topic pattern to get dynamically assigned partitions. If a prior subscription exists, it would be replaced by the latest subscription.
        GET /consumers/{string: group_name}/instances/{string: instance_id}/subscription
        Gets the current subscribed list of topics.
        DELETE /consumers/{string: group_name}/instances/{string: instance_id}/subscription
        Unsubscribes from topics currently subscribed to.
        POST /consumers/{string: group_name}/instances/{string: instance_id}/assignments
        Manually assigns a list of partitions to a consumer.
        GET /consumers/{string: group_name}/instances/{string: instance_id}/assignments
        Retrieves the list of partitions currently assigned to this consumer.
        POST /consumers/{string: group_name}/instances/{string: instance_id}/positions
        Overrides the fetch offsets that the consumer will use for the next set of records to fetch.
        POST /consumers/{string: group_name}/instances/{string: instance_id}/positions/beginning
        Seek to the first offset for each of the given partitions.
        POST /consumers/{string: group_name}/instances/{string: instance_id}/positions/end
        Seek to the last offset for each of the given partitions.
        GET /consumers/{string: group_name}/instances/{string: instance_id}/records
        Fetches data for the topics or partitions specified using one of the subscribe/assign APIs.
        GET /streams/{string: stream_name}/topics
        Retrieves a list of topics in a given stream.
    - Kafka Connect
      Kafka Connect is a utility for streaming data between MapR Event Store For Apache Kafka and other storage systems.
    - Kafka Schema Registry
      Kafka Schema Registry provides a RESTful interface for storing and retrieving schemas.
    - Structured Streaming in Spark
      Starting in EEP 5.0.0, structured streaming is supported in Spark.
  - S3 Gateway
    The S3 gateway is a service that provides an S3-compatible interface to expose data in MapR Data Platform as objects. The S3 gateway manages all inbound S3 API requests to put data into and get data out of cloud storage.
  - Myriad
  - Oozie
  - Pig
  - Sentry
  - Apache Spark
  - Sqoop
  - YARN
  - Zeppelin
- Maven and MapR
  This section discusses topics associated with Maven and MapR.
- Developer's Reference
  This section contains in-depth information for the developer.
- API Documentation
  MapR Data Platform supports public APIs for MapR File System, MapR Database, and MapR Event Store For Apache Kafka. These APIs are available for application-development purposes.
Other Docs
This section contains release-independent information, including: MapR Installer documentation, Ecosystem release notes, interoperability matrices, security vulnerabilities, and links to other MapR version documentation.
Glossary
Definitions for commonly used terms in MapR Converged Data Platform environments.

POST /consumers/{string: group_name}/instances/{string: instance_id}/subscription

Subscribes to the given list of topics or a topic pattern to get dynamically assigned partitions. If a prior subscription exists, it would be replaced by the latest subscription.

Parameters

Table 1. Parameters
Parameter	Description
group_name (string)	Name of the consumer group.
instance (string)	ID of the consumer instance.

Syntax

http://<host>:8082/consumers/<group_name>/instances/<consumer_name>/subscription

Request Example

curl -X POST -H "Content-Type: application/vnd.kafka.v2+json" --data
'{"topics":["/stream:first","/stream:second"]}'
https://localhost:8082/consumers/grouptest/instances/user/subscription

Response Example

HTTP/1.1 204 No Content