Todos los productos
Search
Centro de documentos

Object Storage Service:create-cname-token

Última actualización: Oct 10, 2026

Cree un token de CNAME para verificar la propiedad de un nombre de dominio.

Nota de uso

De forma predeterminada, una cuenta de Alibaba Cloud tiene los permisos necesarios para crear un token de CNAME y verificar la propiedad de un nombre de dominio. Si opera como usuario de RAM o mediante STS, el permiso oss:CreateCnameToken es obligatorio para crear el token de CNAME. Para obtener más información, consulte Grant a custom policy.

Sintaxis del comando

ossutil api create-cname-token --bucket value --cname-configuration value --wildcard=value [flags]

Parámetro

Tipo

Descripción

--bucket

string

El nombre del bucket de destino.

--cname-configuration

string

El contenedor de la configuración de CNAME.

--wildcard

bool

Indica si la operación se aplica a 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 create-cname-token corresponde a la operación de API CreateCnameToken. Para obtener más información sobre los parámetros, consulte CreateCnameToken.

  • La opción --wildcard se usa en 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 formatos XML y JSON. Si el valor incluye 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. Cree un token de CNAME para verificar la propiedad del nombre de dominio personalizado example.com, asignado al bucket 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 create-cname-token --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 create-cname-token --bucket examplebucket --cname-configuration file://cname-configuration.json
    • Use parámetros de configuración JSON. Comando de ejemplo:

      ossutil api create-cname-token --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"
  2. Cree un token de CNAME para verificar la propiedad del dominio base example.com de un dominio comodín correspondiente al Agentic Bucket myab-$uid-$region-ab-apsr.

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

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