Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::CDN::Domain

Última atualização: Jun 27, 2026

O recurso ALIYUN::CDN::Domain adiciona um nome de domínio acelerado.

Nota
  • Antes de adicionar um nome de domínio acelerado, ative o Alibaba Cloud CDN (CDN). Para mais informações, consulte Ativar o Alibaba Cloud CDN.

  • O nome de domínio deve ter registro ICP.

  • Cada chamada à API permite adicionar apenas um nome de domínio ao CDN. É possível adicionar até 50 nomes de domínio por conta da Alibaba Cloud.

  • Se o conteúdo do servidor de origem não estiver armazenado na Alibaba Cloud, ele passará por revisão. A análise será concluída até o final do próximo dia útil após o envio da solicitação.

  • Cada usuário pode chamar esta operação no máximo 30 vezes por segundo.

Sintaxe

{
  "Type": "ALIYUN::CDN::Domain",
  "Properties": {
    "CdnType": String,
    "Sources": String,
    "CheckUrl": String,
    "DomainName": String,
    "ResourceGroupId": String,
    "Scope": String,
    "TopLevelDomain": String,
    "Tags": List,
    "OriginServers": List
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

CdnType

String

Sim

Não

Tipo de carga de trabalho do nome de domínio acelerado.

Valores válidos:

  • web: imagens e arquivos pequenos

  • download: downloads de arquivos grandes

  • video: streaming de vídeo e áudio sob demanda

DomainName

String

Sim

Não

Nome de domínio acelerado a ser adicionado ao CDN.

Há suporte para nomes de domínio com curinga. O nome de domínio deve começar com um ponto (.).

Exemplo: .example.com.

CheckUrl

String

Não

Não

URL usada para verificações de integridade.

Exemplo: example.com/test.html.

OriginServers

List

Não

Não

Configurações dos endereços dos servidores de origem.

A propriedade OriginServers tem o mesmo efeito que a propriedade Sources, mas tem precedência sobre ela. É possível especificar até 20 conjuntos de configurações. Para mais informações, consulte Propriedades de OriginServers.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

Scope

String

Não

Não

Região de aceleração.

Valores válidos:

  • domestic (padrão): China continental

  • overseas: global (exceto a China continental)

  • global: global

Sources

String

Não

Sim

Configurações dos endereços dos servidores de origem.

Exemplo: [{"content":"1.1.1.1","type":"ipaddr","priority":"20","port":80,"weight":"15"}].

Tags

List

Não

Sim

As tags.

É possível adicionar até 20 tags.

Para mais informações, consulte Propriedades de Tags.

TopLevelDomain

String

Não

Sim

Nome de domínio raiz.

Exemplo: www.yourTopLevelDomain.

Sintaxe de Tags

"Tags": [
  {
    "Key": String,
    "Value": String
  }
]  

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Sim

Não

Chave da tag.

A chave da tag deve ter de 1 a 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Value

String

Não

Não

Valor da tag.

O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Sintaxe de OriginServers

"OriginServers": [
  {
    "Port": Integer,
    "Weight": String,
    "Priority": String,
    "Content": String,
    "Type": String
  }
]  

Propriedades de OriginServers

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Content

String

Sim

Não

Endereço do servidor de origem.

Especifique um endereço IP ou um nome de domínio.

Type

String

Sim

Não

Tipo do servidor de origem.

Valores válidos:

  • ipaddr: o servidor de origem usa um endereço IP.

  • domain: o servidor de origem usa um nome de domínio.

  • oss: o servidor de origem usa um bucket do Object Storage Service (OSS).

  • fc_domain: o servidor de origem usa um nome de domínio do Function Compute.

Port

Integer

Não

Não

A porta.

Especifique a porta 443, a porta 80 ou uma porta personalizada. Valor padrão: 80. Se você especificar a porta 443, o CDN se comunicará com o servidor de origem via HTTPS.

Priority

String

Não

Não

Prioridade do servidor de origem.

Valores válidos: 20 e 30. Valor padrão: 20. O valor 20 indica que o servidor de origem é primário. O valor 30 indica que o servidor de origem é secundário.

Weight

String

Não

Não

Peso do servidor de origem.

Valores válidos: um valor numérico menor que 100. Valor padrão: 10.

Valores de retorno

Fn::GetAtt

  • DomainName: o nome de domínio acelerado adicionado ao CDN.

  • Cname: o alias do nome de domínio acelerado. Um nome canônico (CNAME) é fornecido ao Domain Name System (DNS) para mapear o nome de domínio acelerado ao CNAME.

  • Arn: o Alibaba Cloud Resource Name (ARN).

Exemplos

Formato YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
 CdnType:
  AllowedValues:
  - video
  - download
  - web
  - liveStream
  Description: 'The business type. Valid values: web, download, video, livestream,
   and httpsdelivery. web: acceleration of images and small files download. download:
   acceleration of large file downloads. video: live streaming acceleration. httpsdelivery:
   SSL acceleration for HTTPS.'
  Type: String
 CheckUrl:
  Description: The validation of the origin.
  Type: String
 DomainName:
  Description: The CDN domain name. Wildcard domain names that start with periods
   (.) are supported. For example, .example.com.
  Type: String
 ResourceGroupId:
  Description: The ID of the resource group. If this is left blank, the system automatically
   fills in the ID of the default resource group.
  Type: String
 Scope:
  Description: 'Valid values: domestic, overseas, and global. Default value: domestic.
   The setting is supported for users outside mainland China, users in mainland
   China of level 3 or above.'
  Type: String
 Sources:
  Description: The list of origin URLs.
  Type: String
 Tags:
  Description: Tags to attach to instance. Max support 20 tags to add during create
   instance. Each tag with two properties Key and Value, and Key is required.
  MaxLength: 20
  Type: Json
 TopLevelDomain:
  Description: The top-level domain, which can only be configured by users on the
   whitelist.
  Type: String
Resources:
 Domain:
  Properties:
   CdnType:
    Ref: CdnType
   CheckUrl:
    Ref: CheckUrl
   DomainName:
    Ref: DomainName
   ResourceGroupId:
    Ref: ResourceGroupId
   Scope:
    Ref: Scope
   Sources:
    Ref: Sources
   Tags:
    Ref: Tags
   TopLevelDomain:
    Ref: TopLevelDomain
  Type: ALIYUN::CDN::Domain
Outputs:
 Cname:
  Description: The CNAME generated for the CDN domain.You must add a CNAME record
   with your DNS provider to map the CDN domain name to the CNAME.
  Value:
   Fn::GetAtt:
   - Domain
   - Cname
 DomainName:
  Description: The CDN domain name. Wildcard domain names that start with periods
   (.) are supported. For example, .example.com.
  Value:
   Fn::GetAtt:
   - Domain
   - DomainName

Formato JSON

{
 "ROSTemplateFormatVersion": "2015-09-01",
 "Parameters": {
  "CheckUrl": {
   "Type": "String",
   "Description": "The validation of the origin."
  },
  "ResourceGroupId": {
   "Type": "String",
   "Description": "The ID of the resource group. If this is left blank, the system automatically fills in the ID of the default resource group."
  },
  "Scope": {
   "Type": "String",
   "Description": "Valid values: domestic, overseas, and global. Default value: domestic. The setting is supported for users outside mainland China, users in mainland China of level 3 or above."
  },
  "DomainName": {
   "Type": "String",
   "Description": "The CDN domain name. Wildcard domain names that start with periods (.) are supported. For example, .example.com."
  },
  "CdnType": {
   "Type": "String",
   "Description": "The business type. Valid values: web, download, video, livestream, and httpsdelivery. web: acceleration of images and small files download. download: acceleration of large file downloads. video: live streaming acceleration. httpsdelivery: SSL acceleration for HTTPS.",
   "AllowedValues": [
    "video",
    "download",
    "web",
    "liveStream"
   ]
  },
  "TopLevelDomain": {
   "Type": "String",
   "Description": "The top-level domain, which can only be configured by users on the whitelist."
  },
  "Sources": {
   "Type": "String",
   "Description": "The list of origin URLs."
  },
  "Tags": {
   "Type": "Json",
   "Description": "Tags to attach to instance. Max support 20 tags to add during create instance. Each tag with two properties Key and Value, and Key is required.",
   "MaxLength": 20
  }
 },
 "Resources": {
  "Domain": {
   "Type": "ALIYUN::CDN::Domain",
   "Properties": {
    "CheckUrl": {
     "Ref": "CheckUrl"
    },
    "ResourceGroupId": {
     "Ref": "ResourceGroupId"
    },
    "Scope": {
     "Ref": "Scope"
    },
    "DomainName": {
     "Ref": "DomainName"
    },
    "CdnType": {
     "Ref": "CdnType"
    },
    "TopLevelDomain": {
     "Ref": "TopLevelDomain"
    },
    "Sources": {
     "Ref": "Sources"
    },
    "Tags": {
     "Ref": "Tags"
    }
   }
  }
 },
 "Outputs": {
  "DomainName": {
   "Description": "The CDN domain name. Wildcard domain names that start with periods (.) are supported. For example, .example.com.",
   "Value": {
    "Fn::GetAtt": [
     "Domain",
     "DomainName"
    ]
   }
  },
  "Cname": {
   "Description": "The CNAME generated for the CDN domain.You must add a CNAME record with your DNS provider to map the CDN domain name to the CNAME.",
   "Value": {
    "Fn::GetAtt": [
     "Domain",
     "Cname"
    ]
   }
  }
 }
}