Object Storage Service:CreateCnameToken

Notas de uso

• De forma predeterminada, un token de CNAME caduca 72 horas después de su creación. Si vuelve a llamar a esta operación mientras un token de CNAME existente sigue siendo válido, se devuelve el token actual.

• Para un Agentic Bucket, el parámetro wildcard es obligatorio: wildcard=true crea un token para un CNAME comodín y wildcard=false crea un token para un CNAME exacto. No puede omitir este parámetro ni dejarlo en blanco.

• En un bucket estándar, esta operación se llama de la misma manera que las operaciones openapi de CNAME existentes de OSS para crear un token de CNAME exacto. No se requieren parámetros nuevos.

Sintaxis de la solicitud

POST /?cname&comp=token&wildcard=true HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 186
Date: GMT Date
Authorization: SignatureValue

<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
  </Cname>
</BucketCnameConfiguration>

Encabezados de la solicitud

Esta operación solo usa Common HTTP headers.

Parámetros de la solicitud

A continuación se describen los valores válidos del parámetro wildcard para cada tipo de bucket.

Elementos de la solicitud

Idempotencia

La idempotencia de CreateCnameToken varía según el tipo de bucket y depende de si el CNAME ya está asignado al bucket actual:

• Bucket estándar: si el CNAME ya está asignado al bucket actual en cualquier estado distinto de eliminado, se devuelve NoNeedCreateCnameToken y no es necesario crear un token.

• Agentic Bucket: se devuelve NoNeedCreateCnameToken únicamente cuando el nombre de dominio base ya está asignado al Agentic Bucket actual mediante un CNAME del mismo tipo.

Elementos de la respuesta

Ejemplos

• Solicitudes de ejemplo

  • Crear un token de CNAME para un bucket estándar

    POST /?cname&comp=token HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 17 Apr 2025 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
      </Cname>
    </BucketCnameConfiguration>

  • Crear un token de CNAME para un CNAME comodín de un Agentic Bucket

    POST /?cname&comp=token&wildcard=true HTTP/1.1
    Host: myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 17 Apr 2025 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
      </Cname>
    </BucketCnameConfiguration>

  • Crear un token de CNAME para un CNAME exacto de un Agentic Bucket

    POST /?cname&comp=token&wildcard=false HTTP/1.1
    Host: myab-$uid-$region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
    Content-Type: application/xml
    Content-Length: 186
    Date: Thu, 17 Apr 2025 15:39:12 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    
    <BucketCnameConfiguration>
      <Cname>
        <Domain>console.example.com</Domain>
      </Cname>
    </BucketCnameConfiguration>

• Respuestas de ejemplo

  • Se creó el token de CNAME.

    HTTP/1.1 200 OK
    x-oss-request-id: 5C1B138A109F4E405B2D
    Date: Mon, 26 Jul 2021 13:08:38 GMT
    Content-Length: 118
    Content-Type: application/xml
    Connection: keep-alive
    Server: AliyunOSS
    <?xml version="1.0" encoding="UTF-8"?>
    <CnameToken>
      <Bucket>myab-$uid-$region-ab-apsr</Bucket>
      <Cname>example.com</Cname>
      <Token>be1d49d863dea9ffeff3df7d6455****</Token>
      <ExpireTime>Fri, 01 Aug 2026 03:00:00 GMT</ExpireTime>
    </CnameToken>

  • La cantidad de tokens de CNAME supera el límite.

    HTTP/1.1 400 Bad Request
    x-oss-request-id: 5C1B138A109F4E405B2D
    Date: Mon, 26 Jul 2021 13:08:38 GMT
    Content-Length: 118
    Content-Type: application/xml
    Connection: keep-alive
    Server: AliyunOSS
    <?xml version="1.0" encoding="UTF-8"?>
    <Error>
      <Code>TooManyCnameToken</Code>
      <Message>You have attempted to create more cname token than allowed.</Message>
      <RequestId>6215FD21DA0E27393F004E9E</RequestId>
      <HostId>127.0.0.1</HostId>
      <Bucket>examplebucket</Bucket>
    </Error>

SDK de OSS

Los siguientes SDK de OSS admiten la operación CreateCnameToken:

• Java

• Python V2

• Go V2

• Node.js

• PHP V2

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación CreateCnameToken, consulte create-cname-token.

Códigos de error