[Yandex Cloud documentation](../../../index.md) > [Yandex Container Registry](../../index.md) > [Step-by-step guides](../index.md) > Managing a registry > Updating a registry

# Updating a registry

Find out how to change:
* [Registry name](#update-name).
* [Registry label](#update-label).
* [Access for IP addresses](#access-ip).

To access a [registry](../../concepts/registry.md), use its ID or name. For information about how to get the registry ID or name, see [Getting information about existing registries](registry-list.md).

## Updating the name of a registry {#update-name}

{% list tabs group=instructions %}

- Management console {#console}

  To update the name of a [registry](../../concepts/registry.md):
  1. In the [management console](https://console.yandex.cloud), select the folder containing the registry.
  1. Navigate to **Container Registry**.
  1. Click ![image](../../../_assets/console-icons/ellipsis-vertical.svg) in the row of the registry to update.
  1. In the menu that opens, click **Edit**.
  1. In the window that opens, enter the registry name.
  1. (Optional) Update labels.
  1. Click **Edit**.

- CLI {#cli}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../../cli/quickstart.md#install).

  Change the registry name:

  ```bash
  yc container registry update my-reg --new-name new-reg
  ```

  Result:

  ```text
  id: crp3qleutgks********
  folder_id: b1g88tflru0e********
  name: new-reg
  status: ACTIVE
  created_at: "2019-01-15T14:39:48.154Z"
  ```

- API {#api}

  To edit a registry name, use the [update](../../api-ref/Registry/update.md) method for the [Registry](../../api-ref/Registry/index.md) resource.

{% endlist %}

## Updating the label of a registry {#update-label}

{% list tabs group=instructions %}

- CLI {#cli}

  Change the registry label (not to be confused with [Docker image](../../concepts/docker-image.md) tags):

  ```bash
  yc container registry update new-reg --labels new_label=test_label
  ```

  Result:

  ```text
  id: crp3qleutgks********
  folder_id: b1g88tflru0e********
  name: new-reg
  status: ACTIVE
  created_at: "2019-01-15T14:39:48.154Z"
  labels:
    new_label: test_label
  ```

- API {#api}

  To edit a registry label, use the [update](../../api-ref/Registry/update.md) method for the [Registry](../../api-ref/Registry/index.md) resource.

{% endlist %}

## Configuring access for IP addresses {#access-ip}

{% list tabs group=instructions %}

- Management console {#console}

  To add or delete an [IP address](../../../vpc/concepts/address.md) and configure access to a registry:
  1. In the [management console](https://console.yandex.cloud), select the folder containing the registry.
  1. Navigate to **Container Registry**.
  1. Click the name of the registry you need, select ![ip-address.svg](../../../_assets/console-icons/shield.svg) **Access for IP address**, and click **Set**.
  1. Click **Add** and specify the IP address and permission to perform an action with the registry: `PULL` to pull Docker images from the registry or `PUSH` to push them to the registry.
  1. Click ![image](../../../_assets/console-icons/xmark.svg) in the row of the IP address from which you need to delete the permissions.
  1. Click **Save**.

- CLI {#cli}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../../cli/quickstart.md#install).

  Add the IP address to grant permissions to:

  ```bash
  yc container registry add-ip-permissions \
    --name my-reg \
    --pull <IP_address_with_PULL_access> \
    --push <IP_address_with_PUSH_access>
  ```

  Remove the IP permission:

  ```bash
  yc container registry remove-ip-permissions \
    --name my-reg \
    --pull <IP_address_with_PULL_access> \
    --push <IP_address_with_PUSH_access>
  ```

- API {#api}

  To add, update, or delete an IP address and configure its [registry](../../concepts/registry.md) permissions, use the [updateIpPermission](../../api-ref/Registry/updateIpPermission.md) method for the [Registry](../../api-ref/Registry/index.md) resource.

{% endlist %}