Todos os produtos
Search
Central de documentação

Object Storage Service:exclua-cname

Última atualização: Sep 17, 2026

Exclui um nome de domínio personalizado (registro CNAME) mapeado a um bucket.

Observação de uso

Por padrão, uma conta Alibaba Cloud tem permissão para excluir um nome de domínio personalizado mapeado a um bucket. A permissão oss:DeleteCname é necessária para excluir um CNAME como usuário RAM ou ao usar STS. Para mais informações, consulte Grant a custom policy.

Sintaxe do comando

ossutil api delete-cname --bucket value --cname-configuration value --wildcard value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--cname-configuration

string

Contêiner de configuração do CNAME.

--wildcard

string

Indica se um CNAME de domínio com curinga deve ser excluído. Valores válidos: true e false. Para um Agentic Bucket, defina explicitamente este parâmetro como true ou false. Em buckets padrão, o parâmetro é opcional e assume false por padrão.

Nota
  • O comando delete-cname corresponde à operação da API DeleteCname. Para obter mais detalhes sobre os parâmetros, consulte DeleteCname.

  • A opção --wildcard é um novo parâmetro para operações de CNAME com domínio curinga. Verifique se sua versão do ossutil oferece suporte a esse parâmetro.

--cname-configuration

A opção --cname-configuration aceita XML e JSON. Se o valor contiver o prefixo file://, a configuração será lida de um arquivo.

  • Sintaxe XML:

    <BucketCnameConfiguration>
      <Cname>
        <Domain>string</Domain>
      </Cname>
    </BucketCnameConfiguration>
  • Sintaxe JSON:

    {
      "Cname": {
        "Domain": "string"
      }
    }
Nota

Para obter mais informações sobre as opções globais de linha de comando compatíveis, consulte Global command-line options.

Exemplos

  1. Exclua o nome de domínio personalizado example.com mapeado a examplebucket.

    • Use um arquivo de configuração XML. O conteúdo de cname-configuration.xml é o seguinte:

      <?xml version="1.0" encoding="UTF-8"?>
      <BucketCnameConfiguration>
        <Cname>
          <Domain>example.com</Domain>
        </Cname>
      </BucketCnameConfiguration>

      Comando de exemplo:

      ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml
    • Use um arquivo de configuração JSON. O conteúdo de cname-configuration.json é o seguinte:

      {
        "Cname": {
          "Domain": "example.com"
        }
      }

      Comando de exemplo:

      ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json
    • Use parâmetros de configuração JSON. Comando de exemplo:

      ossutil api delete-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
  2. Exclua o CNAME curinga de example.com (sem o prefixo *.) do Agentic Bucket my-uid-region-ab-apsr.

    • Use parâmetros de configuração JSON. Comando de exemplo:

      ossutil api delete-cname --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard true