---
url: /zh/build/internal-steps/artifact/remove-tag.md
---
`artifact:remove-tag`

\==删除 CNB 制品标签==，目前仅支持删除 CNB Docker 和 Helm 标签。需要有仓库写权限。

* [适用事件](#artifact-remove-tag-applicable-events)
* [参数](#artifact-remove-tag-parameters)
* [配置样例](#artifact-remove-tag-configuration-examples)

## 适用事件 {#artifact-remove-tag-applicable-events}

* `push`
* `commit.add`
* `tag_push`
* `tag_deploy`
* `pull_request.merged`
* `api_trigger`
* `web_trigger`
* `crontab`
* `branch.create`

## 参数 {#artifact-remove-tag-parameters}

以下列表先概览 `artifact:remove-tag` 的全部参数。

* [name](#artifact-remove-tag-parameters-name)：制品包名
* [tags](#artifact-remove-tag-parameters-tags)：要删除的标签列表
* [type](#artifact-remove-tag-parameters-type)：制品类型，仅支持 Docker 和 Helm（默认 `docker`）

各参数详细说明如下。

### name {#artifact-remove-tag-parameters-name}

* type: `String`
* required: `true`

制品包名

### tags {#artifact-remove-tag-parameters-tags}

* type: `Array<string>`
* required: `true`

### type {#artifact-remove-tag-parameters-type}

* type: `String`
* required: `false`
* default: `docker`

制品类型，目前仅支持 Docker 和 Helm

## 配置样例 {#artifact-remove-tag-configuration-examples}

```yaml title=".cnb.yml"
main:
  push:
    - stages:
        - name: remove tag
          type: artifact:remove-tag
          options:
            # 包名
            # 包名示例1，仓库同名制品：reponame
            # 包名示例2，仓库非同名制品：reponame/name
            name: reponame/name
            tags:
              - tag1
              - tag2
            type: docker
```