Recurso: CustomDomain
Um CustomDomain
é uma entidade que vincula um nome de domínio a um site do Firebase Hosting. Adicione um CustomDomain
ao seu site para permitir que o Hosting veicule o conteúdo do site em resposta às solicitações do seu nome de domínio.
Representação JSON |
---|
{ "name": string, "annotations": { string: string, ... }, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string, "etag": string, "hostState": enum ( |
Campos | |
---|---|
name | Somente saída. O nome totalmente qualificado do |
annotations | Anotações que você pode adicionar para deixar metadados legíveis por humanos e por máquina sobre seu Um objeto que contém uma lista de pares |
createTime | Somente saída. O horário de criação do domínio personalizado. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
updateTime | Somente saída. A última vez que Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
deleteTime | Somente saída. A hora em que Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
expireTime | Somente saída. O tempo mínimo antes que um Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
etag | Somente saída. Uma string que representa o estado atual do |
hostState | Somente saída. O |
ownershipState | Somente saída. O |
requiredDnsUpdates | Somente saída. Um conjunto de atualizações que você deve fazer nos registros DNS do nome de domínio para permitir que a Hosting forneça conteúdo seguro em seu nome. |
issues[] | Somente saída. Um conjunto de erros que os sistemas de hospedagem encontraram ao tentar estabelecer a capacidade da hospedagem de fornecer conteúdo seguro para o seu nome de domínio. Resolva esses problemas para garantir que seu |
certPreference | Um campo que permite especificar qual tipo de certificado SSL a Hosting cria para o seu nome de domínio. Os domínios personalizados do plano Spark só têm acesso ao tipo de certificado |
cert | Somente saída. O certificado SSL que a hospedagem possui para o nome de domínio deste domínio personalizado. Para novos domínios personalizados, isso geralmente representa a intenção da Hosting de criar um certificado, em vez de um certificado real. Verifique o campo |
redirectTarget | Um nome de domínio para o qual este |
reconciling | Somente saída. Um campo que, se verdadeiro, indica que os sistemas do Hosting estão tentando fazer com que o estado do domínio personalizado corresponda ao seu estado preferido. Isso |
labels | Rótulos usados para metadados e/ou filtragem extras. Um objeto que contém uma lista de pares |
EstadoHost
O estado do host do seu nome de domínio. O estado do host é determinado verificando cada endereço IP associado ao seu nome de domínio para ver se ele está veiculando conteúdo de hospedagem.
Enums | |
---|---|
HOST_STATE_UNSPECIFIED | O estado do host do seu domínio personalizado não é especificado. A mensagem é inválida se não for especificado. |
HOST_UNHOSTED | O nome de domínio do seu domínio personalizado não está associado a nenhum endereço IP. |
HOST_UNREACHABLE | O nome de domínio do seu domínio personalizado não pode ser acessado. As consultas DNS dos serviços de hospedagem para encontrar os endereços IP do seu nome de domínio resultaram em erros. Consulte o campo issues do seu objeto CustomDomain para obter mais detalhes. |
HOST_MISMATCH | O nome de domínio do seu domínio personalizado tem endereços IP que, em última análise, não são resolvidos para o Hosting. |
HOST_CONFLICT | O nome de domínio do seu domínio personalizado possui endereços IP que atendem tanto à hospedagem quanto a outros serviços. Para garantir resultados consistentes, remova os registros A e AAAA relacionados a serviços que não sejam de hospedagem. |
HOST_ACTIVE | Todas as solicitações referentes ao nome de domínio do seu domínio personalizado são atendidas pela Hosting. Se o OwnershipState do domínio personalizado também for ACTIVE , o Hosting exibirá o conteúdo do seu site Hosting no nome de domínio. |
PropriedadeEstado
O estado de propriedade do seu domínio. Um domínio pode pertencer a no máximo um site do Firebase Hosting. A propriedade pode ser determinada de duas maneiras:
* TXT records: A TXT record on the domain in the form
`hosting-site=[siteId]`.
* CNAME records: A CNAME record that points to a Hosting site's default
domain.
Se o seu CustomDomain
estiver em um OwnershipState
diferente de OWNERSHIP_ACTIVE
por mais de 30 dias e não tiver sido atualizado em pelo menos 30 dias, os sistemas de propriedade do Hosting excluirão o CustomDomain
. Para restaurar um CustomDomain
excluído, faça uma solicitação customDomains.undelete
.
Enums | |
---|---|
OWNERSHIP_STATE_UNSPECIFIED | O estado de propriedade do seu domínio personalizado não é especificado. Isso nunca deveria acontecer. |
OWNERSHIP_MISSING | O nome de domínio do seu domínio personalizado não possui registros de propriedade relacionados à hospedagem; nenhum projeto do Firebase tem permissão para agir em nome do nome de domínio. |
OWNERSHIP_UNREACHABLE | O nome de domínio do seu domínio personalizado não pode ser acessado. As consultas DNS dos serviços de hospedagem para encontrar os registros de propriedade do seu nome de domínio resultaram em erros. Consulte o campo issues do seu objeto CustomDomain para obter mais detalhes. |
OWNERSHIP_MISMATCH | O nome de domínio do seu domínio personalizado pertence a outro projeto do Firebase. Remova os registros TXT conflitantes e substitua-os por registros específicos do seu projeto atual do Firebase. |
OWNERSHIP_CONFLICT | O nome de domínio do seu domínio personalizado tem registros TXT conflitantes que indicam propriedade do seu projeto atual do Firebase e de outro projeto. Remova os registros de propriedade do outro projeto para conceder a propriedade do projeto atual. |
OWNERSHIP_PENDING | Os registros DNS do seu domínio personalizado estão configurados corretamente. A hospedagem transferirá a propriedade do seu domínio para este CustomDomain dentro de 24 horas. |
OWNERSHIP_ACTIVE | O nome de domínio do seu domínio personalizado possui registros TXT que concedem permissão ao projeto para agir em seu nome. |
Atualizações de DNS
Um conjunto de atualizações de registros DNS que você deve fazer para permitir que o Hosting forneça conteúdo seguro em resposta a solicitações feitas ao seu nome de domínio. Essas atualizações apresentam o estado atual dos registros DNS do seu nome de domínio quando o Hosting os consultou pela última vez e o conjunto desejado de registros que o Hosting precisa ver antes que seu domínio personalizado possa estar totalmente ativo.
Representação JSON |
---|
{ "discovered": [ { object ( |
Campos | |
---|---|
discovered[] | O conjunto de registros DNS que a hospedagem descobriu ao inspecionar um domínio. |
desired[] | O conjunto de registros DNS que a hospedagem precisa para servir conteúdo seguro no domínio. |
checkTime | A última vez que a Hosting verificou os registros DNS do seu domínio personalizado. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
Conjunto de registros DNS
Um conjunto de registros DNS relevantes para a configuração e manutenção de um domínio personalizado no Firebase Hosting.
Representação JSON |
---|
{ "domainName": string, "checkError": { object ( |
Campos | |
---|---|
domainName | Somente saída. O nome de domínio ao qual o conjunto de registros pertence. |
checkError | Somente saída. Um erro encontrado nos serviços de hospedagem ao consultar os registros DNS do seu nome de domínio. Nota: a hospedagem ignora os erros |
records[] | Somente saída. Registros no domínio. |
Registro DNS
Os registros DNS são registros de recursos que definem como os sistemas e serviços devem se comportar ao lidar com solicitações de um nome de domínio. Por exemplo, quando você adiciona registros A
aos registros DNS do seu nome de domínio, você está informando outros sistemas (como os navegadores dos seus usuários) para entrar em contato com esses endereços IPv4 para recuperar recursos relevantes para o seu nome de domínio (como os arquivos do seu site de hospedagem ).
Representação JSON |
---|
{ "domainName": string, "type": enum ( |
Campos | |
---|---|
domainName | Somente saída. O nome de domínio ao qual o registro pertence, por exemplo |
type | Somente saída. O tipo do registro, que determina quais dados o registro contém. |
rdata | Somente saída. Os dados do registro. O significado do valor depende do tipo de registro: - A e AAAA: endereços IP do nome de domínio. - CNAME: Outro domínio para verificar registros. - TXT: Sequências de texto arbitrárias associadas ao nome de domínio. A hospedagem usa registros TXT para determinar quais projetos do Firebase têm permissão para agir em nome do nome de domínio. - CAA: sinalizadores, tag e valor do registro, por exemplo |
requiredAction | Somente saída. Uma enumeração que indica uma ação necessária para esse registro. |
Tipo
O tipo de registro DNS, incluindo A
, TXT
, AAAA
e CAA
.
Enums | |
---|---|
TYPE_UNSPECIFIED | O tipo do registro não é especificado. A mensagem é inválida se não for especificado. |
A | Um registro A , conforme definido na RFC 1035 . Os registros determinam para quais endereços IPv4 um nome de domínio direciona o tráfego. |
CNAME | Um registro CNAME , conforme definido na RFC 1035 . Os registros CNAME ou Nome Canônico mapeiam um nome de domínio para um nome de domínio canônico diferente. Se um registro CNAME estiver presente, ele deverá ser o único registro no nome de domínio. |
TXT | Um registro TXT , conforme definido na RFC 1035 . Os registros TXT contêm dados de texto arbitrários em um nome de domínio. A hospedagem usa registros TXT para estabelecer qual projeto do Firebase tem permissão para atuar em um nome de domínio. |
AAAA | Um registro AAAA, conforme definido nos registros AAAA RFC 3596, determina para quais endereços IPv6 um nome de domínio direciona o tráfego. |
CAA | Um registro CAA, conforme definido na RFC 6844 . Os registros CAA, ou Autorização de Autoridade de Certificação, determinam quais Autoridades de Certificação (organizações de emissão de certificados SSL) estão autorizadas a emitir um certificado para o nome de domínio. O Firebase Hosting usa Cascata de registros CAA. Um registro CAA em Os registros CAA são opcionais. Se um nome de domínio e seus pais não tiverem registros CAA, todas as CAs estão autorizadas a emitir certificados em seu nome. Em geral, o Hosting apenas solicita que você modifique os registros CAA quando isso for necessário para desbloquear a criação do certificado SSL. |
Ação
Ação é um tipo de ação que você deve realizar neste registro DNS para configurar seu domínio para uso com o Firebase Hosting.
Enums | |
---|---|
NONE | Nenhuma ação é necessária. |
ADD | Adicione este registro aos seus registros DNS. |
REMOVE | Remova este registro dos seus registros DNS. |
Tipo
O tipo do certificado. Determina como os sistemas de hospedagem criam e mantêm o certificado.
Enums | |
---|---|
TYPE_UNSPECIFIED | O tipo do certificado não é especificado. A mensagem é inválida se não for especificado. |
TEMPORARY | Um tipo de certificado de curta duração que cobre um nome de domínio temporariamente, enquanto o Hosting cria um certificado mais permanente. |
GROUPED | O certificado padrão para domínios personalizados do plano Spark. |
PROJECT_GROUPED | Somente plano Blaze. Um certificado que abrange de 1 a 100 nomes de domínio com domínios personalizados no mesmo projeto do Firebase. |
DEDICATED | Somente plano Blaze. Um certificado que cobre um único nome de domínio. |
Certificado
Um certificado SSL usado para fornecer criptografia de ponta a ponta para solicitações em seu nome de domínio. Um Certificate
pode ser um certificado SSL real ou, para domínios personalizados recém-criados, a intenção da Hosting de criar um.
Representação JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type | Somente saída. O tipo do certificado. |
state | Somente saída. O estado do certificado. Somente os estados |
verification | Somente saída. Um conjunto de desafios ACME que você pode adicionar aos seus registros DNS ou ao provedor de hospedagem existente que não seja da Hosting para permitir que a Hosting crie um certificado SSL para o seu nome de domínio antes de direcionar o tráfego para a hospedagem. Você pode usar esses desafios como parte de uma transição com tempo de inatividade zero do seu antigo provedor para a hospedagem. |
issues[] | Somente saída. Um conjunto de erros que a hospedagem encontrou ao tentar criar um certificado para o seu nome de domínio. Resolva esses problemas para garantir que a Hosting seja capaz de fornecer comunicação segura com os visitantes do seu site. |
createTime | Somente saída. A hora de criação do certificado. Para certificados Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
expireTime | Somente saída. O tempo de expiração do certificado. Após esse período, o certificado não poderá mais ser usado para fornecer comunicação segura entre a Hosting e os visitantes do seu site. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
EstadoCertificado
O estado do certificado SSL que a hospedagem possui para o seu nome de domínio. Isso pode representar o estado do certificado real ou, para novos domínios personalizados, a tentativa da Hosting de criar um certificado.
Enums | |
---|---|
CERT_STATE_UNSPECIFIED | O estado do certificado não é especificado. A mensagem é inválida se não for especificado. |
CERT_PREPARING | O estado inicial de cada certificado representa a intenção da Hosting de criar um certificado, antes que as solicitações a uma Autoridade de Certificação sejam feitas. |
CERT_VALIDATING | A hospedagem valida se os registros DNS de um nome de domínio estão em um estado que permite a criação de certificados em seu nome. |
CERT_PROPAGATING | O certificado foi criado recentemente e precisa de tempo para ser propagado no CDN da Hosting. |
CERT_ACTIVE | O certificado está ativo, fornecendo conexões seguras para os nomes de domínio que representa. |
CERT_EXPIRING_SOON | O certificado está expirando, todos os nomes de domínio nele contidos receberão novos certificados. |
CERT_EXPIRED | O certificado expirou. A hospedagem não pode mais fornecer conteúdo seguro em seu nome de domínio. |
Verificação de certificado
Um conjunto de desafios ACME que você pode usar para permitir que o Hosting crie um certificado SSL para o seu nome de domínio antes de direcionar o tráfego para os servidores do Hosting. Use o desafio DNS ou HTTP; não é necessário fornecer ambos.
Representação JSON |
---|
{ "dns": { object ( |
Campos | |
---|---|
dns | Somente saída. Um registro |
http | Somente saída. Um arquivo para adicionar ao seu serviço de hospedagem existente, não pertencente à Hosting, que confirma sua intenção de permitir que a Hosting crie um certificado SSL para o seu nome de domínio. |
Atualização HTTP
Um arquivo que você pode adicionar ao seu serviço de hospedagem existente, não pertencente à Hosting, que confirma sua intenção de permitir que as autoridades de certificação da Hosting criem um certificado SSL para o seu domínio.
Representação JSON |
---|
{
"path": string,
"desired": string,
"discovered": string,
"lastCheckTime": string,
"checkError": {
object ( |
Campos | |
---|---|
path | Somente saída. O caminho para o arquivo. |
desired | Somente saída. Uma string de texto para veicular no caminho. |
discovered | Somente saída. Se o Hosting conseguiu encontrar o conteúdo do arquivo necessário no caminho especificado durante a última verificação. |
lastCheckTime | Somente saída. A última vez que os sistemas de hospedagem verificaram o conteúdo do arquivo. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: |
checkError | Somente saída. Um erro encontrado durante a última verificação de conteúdo. Se for nulo, a verificação foi concluída com êxito. |
Métodos | |
---|---|
| Cria um CustomDomain . |
| Exclui o CustomDomain especificado. |
| Obtém o CustomDomain especificado. |
| Lista cada CustomDomain associado ao site de hospedagem pai especificado. |
| Atualiza o CustomDomain especificado. |
| Recupera o CustomDomain especificado se ele tiver sido excluído de forma reversível. |