Configura a hospedagem de site estático e as regras de redirecionamento para um bucket do Object Storage Service (OSS).
Sintaxe
{
"Type": "ALIYUN::OSS::Website",
"Properties": {
"BucketName": String,
"WebsiteConfiguration": Map
}
}
Propriedades
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
BucketName |
String |
Sim |
Não |
Nome do bucket. |
Nenhuma. |
|
WebsiteConfiguration |
Map |
Não |
Não |
Configuração do site. |
Sintaxe de WebsiteConfiguration
"WebsiteConfiguration": {
"IndexDocument": Map,
"RoutingRules": List,
"ErrorDocument": Map
}
Propriedades de WebsiteConfiguration
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
ErrorDocument |
Map |
Não |
Não |
Propriedades da página de erro padrão. |
|
|
IndexDocument |
Map |
Não |
Não |
Propriedades da página inicial padrão. |
|
|
RoutingRules |
List |
Não |
Não |
Regras de redirecionamento. Máximo: 20. |
Sintaxe de IndexDocument
"IndexDocument": {
"Type": String,
"Suffix": String,
"SupportSubDir": String
}
Propriedades de IndexDocument
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
Suffix |
String |
Sim |
Não |
Página inicial padrão. |
Quando definida, o OSS retorna esta página para solicitações de objetos que terminam com barra (/). |
|
SupportSubDir |
String |
Não |
Não |
Define se o redirecionamento ocorre para a página inicial padrão no subdiretório. |
Valores válidos:
|
|
Type |
String |
Não |
Não |
Ação executada quando a página inicial padrão está definida, o nome do objeto acessado não termina com barra (/) e o objeto não existe. |
Válida apenas quando SupportSubDir é true. Aplicada após RoutingRule e antes de ErrorFile. Por exemplo, se a página inicial padrão for index.html e você acessar bucket.oss-cn-hangzhou.aliyuncs.com/abc (onde o objeto abc não existe). Valores válidos:
|
Sintaxe de RoutingRules
"RoutingRules": [
{
"Condition": Map,
"RuleNumber": Integer,
"Redirect": Map
}
]
Propriedades de RoutingRules
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
Condition |
Map |
Sim |
Não |
Condições de correspondência. |
A regra executa apenas quando todas as condições especificadas são atendidas. Propriedades de Condition. |
|
RuleNumber |
Integer |
Sim |
Não |
Número de sequência da regra de redirecionamento. O OSS corresponde às regras em ordem crescente. |
Se houver correspondência, o OSS executa esta regra e ignora as subsequentes. |
|
Redirect |
Map |
Sim |
Não |
Ação a executar quando a regra corresponder. |
Sintaxe de Condition
"Condition": {
"IncludeHeaders": List,
"KeyPrefixEquals": String,
"HttpErrorCodeReturnedEquals": String,
"KeySuffixEquals": String
}
Propriedades de Condition
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
HttpErrorCodeReturnedEquals |
String |
Não |
Não |
Código de status HTTP que aciona a regra. Quando RedirectType é Mirror, este valor deve ser 404. |
Nenhuma. |
|
IncludeHeaders |
List |
Não |
Não |
Cabeçalhos de solicitação para correspondência. A regra é acionada apenas quando a solicitação contém esses cabeçalhos e valores. |
É possível especificar até 10 cabeçalhos para esta propriedade. |
|
KeyPrefixEquals |
String |
Não |
Não |
Prefixo do nome do objeto para correspondência. |
Nenhuma. |
|
KeySuffixEquals |
String |
Não |
Não |
Sufixo do nome do objeto para correspondência. |
Nenhuma. |
Sintaxe de IncludeHeaders
"IncludeHeaders": [
{
"Equals": String,
"Key": String
}
]
Propriedades de IncludeHeaders
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
Key |
String |
Sim |
Não |
Nome do cabeçalho. |
Nenhuma. |
|
Equals |
String |
Não |
Não |
Valor do cabeçalho. |
Nenhuma. |
Sintaxe de Redirect
"Redirect": {
"MirrorURL": String,
"ReplaceKeyWith": String,
"MirrorHeaders": Map,
"HttpRedirectCode": String,
"EnableReplacePrefix": Boolean,
"PassQueryString": Boolean,
"MirrorFollowRedirect": Boolean,
"ReplaceKeyPrefixWith": String,
"RedirectType": String,
"MirrorPassQueryString": Boolean,
"MirrorCheckMd5": Boolean,
"Protocol": String,
"HostName": String
}
Propriedades de Redirect
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
RedirectType |
String |
Sim |
Não |
Tipo de redirecionamento. |
Valores válidos:
|
|
EnableReplacePrefix |
Boolean |
Não |
Não |
Define se o prefixo do nome do objeto deve ser substituído pelo valor de ReplaceKeyPrefixWith. Se estiver vazio ou nulo, o prefixo será truncado. |
Nota
Esta propriedade só pode ser definida como true quando ReplaceKeyWith estiver definido como null. Valor padrão: false. |
|
HttpRedirectCode |
String |
Não |
Não |
Código de redirecionamento HTTP na resposta. |
Esta propriedade tem efeito apenas quando RedirectType está definido como External ou AliCDN. Valor padrão: 302. Valores válidos:
|
|
HostName |
String |
Não |
Não |
Nome de domínio para redirecionamento. |
O nome de domínio deve estar em conformidade com as convenções de nomenclatura. Por exemplo, se o nome do objeto a acessar for test, Protocol estiver definido como |
|
MirrorURL |
String |
Não |
Não |
URL de origem para back-to-origin baseado em espelhamento. Tem efeito apenas quando RedirectType é Mirror. |
Deve começar com http:// ou https:// e terminar com barra (/). O OSS anexa o nome do objeto para gerar a URL de back-to-origin. Por exemplo, para acessar myobject: se MirrorURL for |
|
MirrorHeaders |
Map |
Não |
Não |
Cabeçalhos retornados à origem durante o back-to-origin baseado em espelhamento. |
Tem efeito apenas quando RedirectType é Mirror. |
|
MirrorFollowRedirect |
Boolean |
Não |
Não |
Define se o cabeçalho Location deve ser seguido caso a origem retorne um código de status 3xx. |
Tem efeito apenas quando RedirectType é Mirror. Valores válidos:
|
|
MirrorPassQueryString |
Boolean |
Não |
Não |
Igual a PassQueryString, mas tem precedência. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. Valor padrão: false. |
|
MirrorCheckMd5 |
Boolean |
Não |
Não |
Define se o hash MD5 do corpo da resposta da origem deve ser verificado. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. Quando definido como true e a resposta da origem incluir o cabeçalho Content-Md5, o OSS verifica se o MD5 dos dados corresponde. Caso contrário, o OSS não armazena os dados. Valor padrão: false. |
|
PassQueryString |
Boolean |
Não |
Não |
Define se os parâmetros da solicitação original devem ser incluídos no redirecionamento ou na solicitação de back-to-origin. |
Por exemplo, se PassQueryString for true e a solicitação contiver a=b&c=d: para um redirecionamento 302, os parâmetros são anexados ao cabeçalho Location (ex.: Valor padrão: false. Valores válidos: true e false. |
|
Protocol |
String |
Não |
Não |
Protocolo de redirecionamento. |
Tem efeito quando RedirectType é External ou AliCDN. Por exemplo, se o objeto for test e HostName for Valores válidos: http, https. |
|
ReplaceKeyWith |
String |
Não |
Não |
Valor usado para substituir o nome do objeto durante o redirecionamento. |
É possível especificar uma variável para ReplaceKeyWith. A variável ${key} é suportada. Por exemplo, suponha que o nome do objeto a ser acessado seja test. Se ReplaceKeyWith estiver definido como prefix/{key}, o prefixo do nome do objeto especificado por prefix/ também será incluído no endereço do objeto no cenário de acesso real. Neste exemplo, o endereço do objeto especificado pelo cabeçalho Location é |
|
ReplaceKeyPrefixWith |
String |
Não |
Não |
Valor usado para substituir o prefixo do nome do objeto durante o redirecionamento. |
Por exemplo, se KeyPrefixEquals estiver definido como ABC/ e ReplaceKeyPrefixWith estiver definido como def/ ao acessar um objeto chamado ABC/test.txt, o OSS substitui ABC por def. O caminho original do objeto é ABC/test.txt. Após a aplicação da regra de redirecionamento, o caminho do objeto muda para def/test.txt. Neste exemplo, o redirecionamento ocorre para Consulte a documentação do OSS para obter detalhes sobre o comportamento de redirecionamento. |
Sintaxe de MirrorHeaders
"MirrorHeaders": {
"PassAll": Boolean,
"Pass": List,
"Sets": List,
"Remove": List
}
Propriedades de MirrorHeaders
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
PassAll |
Boolean |
Não |
Não |
Define se os cabeçalhos da solicitação (exceto os excluídos) devem ser repassados para a origem. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. Os seguintes cabeçalhos são excluídos:
Valor padrão: false. |
|
Pass |
List |
Não |
Não |
Cabeçalhos a serem repassados para a origem. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. Cada cabeçalho pode ter até 1.024 bytes de comprimento e conter apenas dígitos, letras e traços curtos (‒). É possível especificar até 10 cabeçalhos para esta propriedade. |
|
Remove |
List |
Não |
Não |
Cabeçalhos a serem bloqueados no repasse para a origem. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. Cada cabeçalho pode ter até 1.024 bytes de comprimento e conter dígitos, letras e traços curtos (‒). É possível especificar até 10 cabeçalhos para esta propriedade. |
|
Sets |
List |
Não |
Não |
Cabeçalhos enviados à origem independentemente de estarem presentes na solicitação original. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. É possível especificar até 10 cabeçalhos. |
Sintaxe de Sets
"Sets": [
{
"Value": String,
"Key": String
}
]
Propriedades de Sets
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
Key |
String |
Sim |
Não |
Chave do cabeçalho. Pode ter até 1.024 bytes de comprimento. O conjunto de caracteres desta propriedade é o mesmo da propriedade Pass. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. |
|
Value |
String |
Sim |
Não |
Valor do cabeçalho. Pode ter até 1.024 bytes de comprimento e não pode conter \r\n. |
Esta propriedade tem efeito apenas quando RedirectType está definido como Mirror. |
Sintaxe de ErrorDocument
"ErrorDocument": {
"HttpStatus": String,
"Key": String
}
Propriedades de ErrorDocument
|
Propriedade |
Tipo |
Obrigatória |
Editável |
Descrição |
Restrição |
|
Key |
String |
Sim |
Não |
Página de erro padrão. |
Retorna esta página quando o objeto solicitado não existe. |
|
HttpStatus |
String |
Não |
Não |
Código de status HTTP retornado com a página de erro. |
Valores válidos:
|
Valores de retorno
Fn::GetAtt
Nenhum.