Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Data Processing
  • Getting started
    • All guides
      • Connecting to component interfaces
      • Using Sqoop
      • Setup Apache Iceberg™
    • Setting up and using Python virtual environments
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Public materials
  • FAQ

In this article:

  • UI Proxy
  • Enabling component interfaces
  • Retrieving a list of connection URLs
  • Port forwarding
  1. Step-by-step guides
  2. Apache and other third-party services
  3. Connecting to component interfaces

Connecting to component interfaces

Written by
Yandex Cloud
Improved by
Dmitry A.
Updated at May 5, 2025
  • UI Proxy
    • Enabling component interfaces
    • Retrieving a list of connection URLs
  • Port forwarding

You can connect to Yandex Data Processing component interfaces either using UI Proxy or a jump host VM. For more information, see Component interfaces and ports.

UI ProxyUI Proxy

Warning

You may need to additionally set up security groups to use UI Proxy.

Enabling component interfacesEnabling component interfaces

Management console
CLI
API
  1. Go to the folder page and select Yandex Data Processing.
  2. Select a cluster and click Edit in the top panel.
  3. Under Configuration, enable UI Proxy.
  4. Click Save changes.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

To enable access to cluster component web interfaces, set true for the --ui-proxy parameter:

yc dataproc cluster update <cluster_name_or_ID> \
   --ui-proxy=true

You can get the cluster ID and name with the list of clusters in the folder.

Use the update API method and include the following in the request:

  • Cluster ID in the clusterId parameter. To find out the cluster ID, get a list of clusters in the folder.
  • true in the uiProxy parameter.
  • List of updatable cluster configuration fields in the updateMask parameter (in this case, uiProxy).

Warning

The API method will assign default values to all the parameters of the object you are modifying unless you explicitly provide them in your request. To avoid this, list the settings you want to change in the updateMask parameter as a single comma-separated string.

Retrieving a list of connection URLsRetrieving a list of connection URLs

Management console
CLI
API
  1. Go to the folder page and select Yandex Data Processing.
  2. Click the cluster name.
  3. Connection links for the component web interfaces can be found under UI Proxy.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

To retrieve a list of URLs to connect to Yandex Data Processing cluster component web interfaces, run the following command:

yc dataproc cluster list-ui-links <cluster_name_or_ID>

You can get the cluster ID and name with the list of clusters in the folder.

Use the listUILinks API method and include the cluster ID in the clusterId request parameter.

You can get the cluster ID with the list of clusters in the folder.

Port forwardingPort forwarding

To access a component's network interface from the internet, create an intermediate virtual machine in Yandex Compute Cloud.

Requirements for a jump host VM:

  • An assigned public IP address.
  • Hosted in the same network as the required Yandex Data Processing cluster.
  • Security group settings that allow traffic exchange with the cluster via the corresponding components' ports.

For step-by-step instructions on how to configure security groups for port forwarding, see Configuring security groups.

To connect to the Yandex Data Processing host port you need, run the following command:

ssh -A \
    -J <VM_user_name>@<VM_public_IP_address> \
    -L <port_number>:<Yandex_Data_Processing_host_FQDN>:<port_number> <username>@<Yandex_Data_Processing_host_FQDN>

Where:

  • -A: Activates connection redirects from the authentication agent with the jump host VM to the target host of the Yandex Data Processing cluster.

  • -J: Connection to the target host via a jump host VM. Establishes a connection over SSH to the jump host VM that will redirect packages to the target host in the Yandex Data Processing cluster.

  • -L: Local port redirection to the Yandex Data Processing cluster host.

    To connect to cluster hosts with image version 1.x, use root for username; for version 2.x, use ubuntu.

You can find the FQDN of the Yandex Data Processing host on the Yandex Data Processing cluster page, in the Hosts tab, in the Host FQDN column.

Port numbers for Yandex Data Processing components are shown under Component interfaces and ports.

Was the article helpful?

Previous
Updating subclusters
Next
Using Sqoop
© 2025 Direct Cursus Technology L.L.C.