# update

The cldkctl registry tag update command updates an existing tag immutability rule in the container registry. This command allows you to modify rule conditions, such as the repository pattern, tag pattern, or operation type, to adjust how immutability rules are applied.

## Usage

```
cldkctl registry tag update [tag ID] [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. Ensure that you are logged in. Refer to the Registry Login section.
2. Run the following command in your terminal:

```
cldkctl --registry [registry name] registry tag update [tag ID] \
  --repo [repository name] \
  --repo-op [matching|excluding] \
  --tag [tag pattern] \
  --tag-op [matching|excluding]
```

3. To retrieve the list of existing tag immutability rules and their IDs, refer to the Registry Tag List section.
4. Replace `[registry name]` with the target registry, `[tag ID]` with the ID of the rule you want to update, `[repository name]` with the target repository, `[tag pattern]` with the desired tag pattern, and `[repo-op] / [tag-op]` with the corresponding operation (matching or excluding).
5. Once successful, the terminal displays **"✓ Registry tag immutability rule updated".**

<figure><img src="/files/g6veh1N9GRPVo4cFYFhD" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="info" %}
This command supports global flags. Refer to the Global Flags section for details
{% endhint %}

| Flag             | Description                                                                                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| -h, --help       | Help for the registry tag update command.                                                                                                                       |
| --repo string    | Specifies the name or pattern of the repository to which the rule applies.                                                                                      |
| --repo-op string | Defines how the repository pattern is interpreted. Use matching to apply the rule to repositories that fit the specified pattern, or excluding to exclude them. |
| --tag string     | Specifies the tag pattern affected by the rule.                                                                                                                 |
| --tag-op string  | Defines how the tag pattern is interpreted. Use matching to include tags that fit the specified pattern, or excluding to exclude them.                          |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-registry/tag/update.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.