Todos los productos
Search
Centro de documentos

Object Storage Service:delete-cname

Última actualización: Sep 17, 2026

Elimina un nombre de dominio personalizado (registro CNAME) asignado a un bucket.

Nota de uso

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos para eliminar un nombre de dominio personalizado asignado a un bucket. El permiso oss:DeleteCname es obligatorio para eliminar un CNAME como usuario de RAM o mediante STS. Para obtener más información, consulte Grant a custom policy.

Sintaxis del comando

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

Parámetro

Tipo

Descripción

--bucket

string

El nombre del bucket.

--cname-configuration

string

Contenedor de la configuración de CNAME.

--wildcard

string

Indica si se elimina un CNAME de dominio comodín. Valores válidos: true y false. Para un Agentic Bucket, debe establecer este parámetro explícitamente en true o false. En un bucket estándar, el parámetro es opcional y su valor predeterminado es false.

Nota
  • El comando delete-cname corresponde a la operación de API DeleteCname. Para obtener más información sobre los parámetros, consulte DeleteCname.

  • La opción --wildcard es un parámetro nuevo para las operaciones con CNAME de dominios comodín. Compruebe que su versión de ossutil sea compatible con este parámetro.

--cname-configuration

La opción --cname-configuration acepta XML y JSON. Si el valor contiene el prefijo file://, la configuración se lee desde un archivo.

  • Sintaxis XML:

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

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

Para obtener más información sobre las opciones globales de línea de comandos compatibles, consulte Global command-line options.

Ejemplos

  1. Elimine el nombre de dominio personalizado example.com asignado a examplebucket.

    • Use un archivo de configuración XML. El contenido de cname-configuration.xml es el siguiente:

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

      Comando de ejemplo:

      ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.xml
    • Use un archivo de configuración JSON. El contenido de cname-configuration.json es el siguiente:

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

      Comando de ejemplo:

      ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json
    • Use parámetros de configuración JSON. Comando de ejemplo:

      ossutil api delete-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
  2. Elimine el CNAME comodín de example.com (sin el prefijo *.) del Agentic Bucket my-uid-region-ab-apsr.

    • Use parámetros de configuración JSON. Comando de ejemplo:

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