Recurso: CustomDomain
Un CustomDomain
es una entidad que vincula un nombre de dominio a un sitio de Firebase Hosting. Agrega una CustomDomain
a tu sitio para permitir que Hosting publique el contenido del sitio en respuesta a las solicitudes en tu nombre de dominio.
Representación JSON |
---|
{ "name": string, "annotations": { string: string, ... }, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string, "etag": string, "hostState": enum ( |
Campos | |
---|---|
name |
Solo salida. Es el nombre completamente calificado de |
annotations |
Anotaciones que puedes agregar para dejar metadatos legibles por humanos y máquinas sobre tu Un objeto que contiene una lista de pares |
createTime |
Solo salida. La fecha y hora de creación del dominio personalizado. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
updateTime |
Solo salida. La última vez que se actualizó el Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
deleteTime |
Solo salida. La hora a la que se borró Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
expireTime |
Solo salida. El tiempo mínimo antes de que un Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
etag |
Solo salida. Es una cadena que representa el estado actual de |
hostState |
Solo salida. El |
ownershipState |
Solo salida. El |
requiredDnsUpdates |
Solo salida. Un conjunto de actualizaciones que debes realizar en los registros DNS del nombre de dominio para permitir que Hosting entregue contenido seguro en su nombre. |
issues[] |
Solo salida. Una serie de errores que se encontraron en los sistemas de Hosting cuando se intentaba establecer la capacidad de Hosting de entregar contenido seguro para tu nombre de dominio. Resuelve estos problemas para asegurarte de que |
certPreference |
Es un campo que te permite especificar el tipo de certificado SSL que Hosting crea para tu nombre de dominio. Los dominios personalizados del plan Spark solo tienen acceso al tipo de certificado |
cert |
Solo salida. El certificado SSL que Hosting tiene para el nombre de dominio de este dominio personalizado. Para los dominios personalizados nuevos, esto suele representar la intención de Hosting de crear un certificado en lugar de un certificado real. Consulta el campo |
redirectTarget |
Un nombre de dominio al que este |
reconciling |
Solo salida. Un campo que, si es verdadero, indica que los sistemas de Hosting están intentando que el estado del dominio personalizado coincida con el estado que deseas. Con mayor frecuencia, es |
labels |
Etiquetas que se usan para metadatos adicionales o filtros. Un objeto que contiene una lista de pares |
Estado del host
El estado del host de tu nombre de dominio. El estado del host se determina verificando cada dirección IP asociada con tu nombre de dominio para comprobar si se entrega contenido de Hosting.
Enums | |
---|---|
HOST_STATE_UNSPECIFIED |
El estado del host de tu dominio personalizado no está especificado. El mensaje no es válido si no se especifica. |
HOST_UNHOSTED |
El nombre de dominio de tu dominio personalizado no está asociado con ninguna dirección IP. |
HOST_UNREACHABLE |
No se puede acceder al nombre de dominio de tu dominio personalizado. Servicios de hosting Las consultas de DNS para encontrar las direcciones IP de tu nombre de dominio generaron errores. Consulta el campo issues de tu objeto CustomDomain para obtener más detalles. |
HOST_MISMATCH |
El nombre de dominio de tu dominio personalizado tiene direcciones IP que, en última instancia, no se resuelven en Hosting. |
HOST_CONFLICT |
El nombre de dominio de tu dominio personalizado tiene direcciones IP que se resuelven tanto en Hosting como en otros servicios. Para garantizar resultados coherentes, quita los registros A y AAAA relacionados con servicios que no sean de Hosting. |
HOST_ACTIVE |
Hosting entrega todas las solicitudes en el nombre de dominio de tu dominio personalizado. Si el OwnershipState del dominio personalizado también es ACTIVE , Hosting entrega el contenido del sitio de Hosting en el nombre de dominio. |
Estado de propiedad
El estado de propiedad de tu dominio. Un dominio puede ser propiedad de un sitio de Firebase Hosting como máximo. La propiedad se puede determinar de dos maneras:
* 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.
Si tu CustomDomain
está en una OwnershipState
distinta de OWNERSHIP_ACTIVE
durante más de 30 días y no se actualiza en al menos 30 días, los sistemas de propiedad de Hosting borrarán la CustomDomain
. Para restablecer un CustomDomain
borrado, realiza una solicitud customDomains.undelete
.
Enums | |
---|---|
OWNERSHIP_STATE_UNSPECIFIED |
El estado de propiedad del dominio personalizado no está especificado. Esto nunca debería suceder. |
OWNERSHIP_MISSING |
El nombre de dominio de tu dominio personalizado no tiene registros de propiedad relacionados con Hosting. Ningún proyecto de Firebase tiene permiso para actuar en nombre del nombre de dominio. |
OWNERSHIP_UNREACHABLE |
No se puede acceder al nombre de dominio de tu dominio personalizado. Servicios de hosting Las consultas de DNS para encontrar los registros de propiedad del nombre de dominio generaron errores. Consulta el campo issues de tu objeto CustomDomain para obtener más detalles. |
OWNERSHIP_MISMATCH |
El nombre de dominio de tu dominio personalizado es propiedad de otro proyecto de Firebase. Quita los registros TXT en conflicto y reemplázalos por registros específicos del proyecto para tu proyecto de Firebase actual. |
OWNERSHIP_CONFLICT |
El nombre de dominio de tu dominio personalizado tiene registros TXT en conflicto que indican que eres el propietario de tu proyecto de Firebase actual y de otro proyecto. Quita los registros de propiedad del otro proyecto para otorgar la propiedad actual del proyecto. |
OWNERSHIP_PENDING |
Los registros DNS de tu dominio personalizado están configurados correctamente. Hosting transferirá la propiedad de tu dominio a este CustomDomain en un plazo de 24 horas. |
OWNERSHIP_ACTIVE |
El nombre de dominio de tu dominio personalizado tiene TXT registros que otorgan permiso al proyecto para actuar en su nombre. |
Actualizaciones de DNS
Un conjunto de actualizaciones de registros DNS que debes realizar para permitir que Hosting entregue contenido seguro en respuesta a las solicitudes en tu nombre de dominio. Estas actualizaciones presentan el estado actual de los registros DNS de tu nombre de dominio cuando Hosting los consultó por última vez y el conjunto de registros deseado que Hosting debe ver para que tu dominio personalizado pueda estar completamente activo.
Representación JSON |
---|
{ "discovered": [ { object ( |
Campos | |
---|---|
discovered[] |
El conjunto de registros DNS que se descubre cuando se inspecciona un dominio. |
desired[] |
El conjunto de registros DNS que Hosting necesita entregar contenido seguro en el dominio. |
checkTime |
La última vez que Hosting verificó los registros DNS de tu dominio personalizado. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
DnsRecordSet
Un conjunto de registros DNS relevantes para la configuración y el mantenimiento de un dominio personalizado en Firebase Hosting.
Representación JSON |
---|
{ "domainName": string, "checkError": { object ( |
Campos | |
---|---|
domainName |
Solo salida. El nombre de dominio al que pertenece el conjunto de registros. |
checkError |
Solo salida. Se produjo un error cuando se consultaban los servicios de Hosting cuando se consultaban los registros DNS de tu nombre de dominio. Nota: Hosting ignora los errores |
records[] |
Solo salida. Registros en el dominio. |
DnsRecord
Los registros DNS son registros de recursos que definen el comportamiento de los sistemas y servicios cuando se manejan solicitudes de un nombre de dominio. Por ejemplo, cuando agregas registros A
a los registros DNS de tu nombre de dominio, les estás informando a otros sistemas (como los navegadores web de tus usuarios) que se comuniquen con esas direcciones IPv4 para recuperar recursos relevantes para tu nombre de dominio (como tus archivos de sitio de Hosting).
Representación JSON |
---|
{ "domainName": string, "type": enum ( |
Campos | |
---|---|
domainName |
Solo salida. El nombre de dominio al que pertenece el registro, p.ej., |
type |
Solo salida. El tipo de registro, que determina qué datos contiene el registro. |
rdata |
Solo salida. Los datos del registro. El significado del valor depende del tipo de registro: - A y AAAA: direcciones IP para el nombre de dominio. - CNAME: otro dominio para buscar registros - TXT: cadenas de texto arbitrarias asociadas con el nombre de dominio. Hosting usa registros TXT para determinar qué proyectos de Firebase tienen permiso para actuar en nombre del nombre de dominio. - CAA: las marcas, la etiqueta y el valor del registro, p.ej., |
requiredAction |
Solo salida. Una enumeración que indica la acción necesaria para este registro. |
Tipo
El tipo de registro DNS, incluidos A
, TXT
, AAAA
y CAA
.
Enums | |
---|---|
TYPE_UNSPECIFIED |
El tipo de registro no está especificado. El mensaje no es válido si no se especifica. |
A |
Un registro A , como se define en RFC 1035 Los registros A determinan a qué direcciones IPv4 dirige el tráfico un nombre de dominio. |
CNAME |
Un registro CNAME , como se define en RFC 1035 Los registros CNAME o de nombre canónico asignan un nombre de dominio a otro nombre de dominio canónico. Si hay un registro CNAME presente, debe ser el único registro en el nombre de dominio. |
TXT |
Un registro TXT , como se define en RFC 1035 Los registros TXT contienen datos de texto arbitrarios en un nombre de dominio. Hosting usa registros TXT a fin de establecer qué proyecto de Firebase tiene permiso para realizar acciones en un nombre de dominio. |
AAAA |
Un registro AAAA, como se define en RFC 3596, los registros AAAA determinan a qué direcciones IPv6 dirige el tráfico un nombre de dominio. |
CAA |
Un registro de CAA, como se define en RFC 6844. Los registros de autorización de autoridad certificadora (CAA) determinan qué autoridades certificadoras (organizaciones de creación de certificados SSL) están autorizadas a acuñar un certificado para el nombre de dominio. Firebase Hosting usa Registros de CAA en cascada. Un registro de CAA en Los registros CAA son opcionales. Si un nombre de dominio y sus elementos superiores no tienen registros de CAA, todas las CA están autorizadas a acuñar certificados en su nombre. En general, Hosting solo te solicita que modifiques los registros de CAA cuando sea necesario para desbloquear la creación del certificado SSL. |
Acción
La acción es un tipo de acción que debes realizar en este registro DNS para configurar tu dominio y usarlo con Firebase Hosting.
Enums | |
---|---|
NONE |
No se requiere ninguna acción. |
ADD |
Agrega este registro a tus registros DNS. |
REMOVE |
Quita este registro de tus registros DNS. |
Tipo
El tipo de certificado. Determina cómo los sistemas de Hosting crean y mantienen el certificado.
Enums | |
---|---|
TYPE_UNSPECIFIED |
El tipo de certificado no está especificado. El mensaje no es válido si no se especifica. |
TEMPORARY |
Un tipo de certificado de corta duración que cubre un nombre de dominio de manera temporal, mientras que Hosting crea un certificado más permanente. |
GROUPED |
El certificado estándar para los dominios personalizados del plan Spark. |
PROJECT_GROUPED |
Solo para el plan Blaze. Un certificado que abarca de 1 a 100 nombres de dominio con dominios personalizados en el mismo proyecto de Firebase. |
DEDICATED |
Solo para el plan Blaze. Un certificado que cubre un solo nombre de dominio. |
Certificado
Un certificado SSL que se usa para proporcionar encriptación de extremo a extremo para las solicitudes realizadas a tu nombre de dominio. Un Certificate
puede ser un certificado SSL real o, en el caso de los dominios personalizados recién creados, el intent de Hosting de crear uno.
Representación JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type |
Solo salida. El tipo de certificado. |
state |
Solo salida. Estado del certificado. Solo los estados |
verification |
Solo salida. Un conjunto de desafíos de ACME que puedes agregar a tus registros DNS o a un proveedor de hosting existente que no es de Hosting para permitir que Hosting cree un certificado SSL para tu nombre de dominio antes de dirigir el tráfico hacia el hosting. Puedes usar estos desafíos como parte de una transición sin tiempo de inactividad desde tu proveedor anterior a Hosting. |
issues[] |
Solo salida. Un conjunto de errores que Hosting encontró cuando intentó crear un certificado para el nombre de tu dominio. Resuelve estos problemas para asegurarte de que Hosting pueda proporcionar una comunicación segura con los visitantes de tu sitio. |
createTime |
Solo salida. Hora de creación del certificado. En el caso de los certificados Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
expireTime |
Solo salida. Fecha y hora de vencimiento del certificado. Después de este período, ya no se podrá usar para proporcionar una comunicación segura entre Hosting y los visitantes de tu sitio. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
Estado de certificación
El estado del certificado SSL que tiene Hosting para tu nombre de dominio. Puede representar el estado del certificado real o, en el caso de los dominios personalizados nuevos, el intento de Hosting de crear un certificado.
Enums | |
---|---|
CERT_STATE_UNSPECIFIED |
El estado del certificado no está especificado. El mensaje no es válido si no se especifica. |
CERT_PREPARING |
El estado inicial de cada certificado representa la intención de Hosting de crear un certificado antes de que se realicen solicitudes a una autoridad certificadora. |
CERT_VALIDATING |
Hosting valida si los registros DNS de un nombre de dominio se encuentran en un estado que permite la creación de certificados en su nombre. |
CERT_PROPAGATING |
El certificado se creó recientemente y necesita tiempo para propagarse en la CDN de Hosting. |
CERT_ACTIVE |
El certificado está activo y proporciona conexiones seguras para los nombres de dominio que representa. |
CERT_EXPIRING_SOON |
El certificado vencerá. Todos los nombres de dominio que contenga recibirán certificados nuevos. |
CERT_EXPIRED |
El certificado venció. Hosting ya no puede entregar contenido seguro en tu nombre de dominio. |
CertVerificación
Un conjunto de desafíos de ACME que puedes usar para permitir que Hosting cree un certificado SSL para tu nombre de dominio antes de dirigir el tráfico a los servidores de Hosting. Usa el desafío de DNS o HTTP. no es necesario proporcionar ambos.
Representación JSON |
---|
{ "dns": { object ( |
Campos | |
---|---|
dns |
Solo salida. Un registro |
http |
Solo salida. Es un archivo que se agrega a tu servicio de hosting existente que no es de Hosting y que confirma tu intención de permitir que Hosting cree un certificado SSL para tu nombre de dominio. |
HttpUpdate
Un archivo que puedes agregar a tu servicio de hosting existente que no es de Hosting en el que se confirma tu intención de permitir que las autoridades certificadoras de Hosting creen un certificado SSL para tu dominio.
Representación JSON |
---|
{
"path": string,
"desired": string,
"discovered": string,
"lastCheckTime": string,
"checkError": {
object ( |
Campos | |
---|---|
path |
Solo salida. Es la ruta de acceso al archivo. |
desired |
Solo salida. Una cadena de texto para entregar en la ruta de acceso. |
discovered |
Solo salida. Indica si Hosting pudo encontrar el contenido del archivo requerido en la ruta especificada durante la última verificación. |
lastCheckTime |
Solo salida. La última vez que los sistemas de Hosting verificaron el contenido del archivo. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
checkError |
Solo salida. Se produjo un error durante la última verificación de contenido. Si es nulo, la verificación se completó correctamente. |
Métodos |
|
---|---|
|
Crea un CustomDomain . |
|
Borra la CustomDomain especificada. |
|
Obtiene el CustomDomain especificado. |
|
Enumera cada CustomDomain asociado con el sitio de Hosting superior especificado. |
|
Actualiza la CustomDomain especificada. |
|
Recupera el CustomDomain especificado si se borró de forma no definitiva. |