Zasób: CustomDomain
CustomDomain
to encja łącząca nazwę domeny z witryną w Hostingu Firebase. Dodaj do swojej witryny atrybut CustomDomain
, aby zezwolić usłudze Hosting na udostępnianie treści witryny w odpowiedzi na żądania wysyłane pod kątem Twojej nazwy domeny.
Zapis JSON |
---|
{ "name": string, "annotations": { string: string, ... }, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string, "etag": string, "hostState": enum ( |
Pola | |
---|---|
name |
Tylko dane wyjściowe. Pełna nazwa elementu |
annotations |
Adnotacje, które możesz dodać, aby zachować metadane zrozumiałe dla człowieka i dla komputera ( Obiekt zawierający listę par |
createTime |
Tylko dane wyjściowe. Czas utworzenia domeny niestandardowej. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
updateTime |
Tylko dane wyjściowe. Ostatnia aktualizacja: Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
deleteTime |
Tylko dane wyjściowe. czas usunięcia obiektu Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
expireTime |
Tylko dane wyjściowe. Minimalny czas, po którym Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
etag |
Tylko dane wyjściowe. Ciąg znaków reprezentujący bieżący stan obiektu |
hostState |
Tylko dane wyjściowe. |
ownershipState |
Tylko dane wyjściowe. |
requiredDnsUpdates |
Tylko dane wyjściowe. Zestaw aktualizacji rekordów DNS nazwy domeny, aby umożliwić usłudze Hosting udostępnianie bezpiecznych treści w jej imieniu. |
issues[] |
Tylko dane wyjściowe. Zestaw błędów, które wystąpiły przez systemy hostingowe, gdy próbowano ustalić, czy Hosting może udostępniać bezpieczne treści dla Twojej nazwy domeny. Rozwiąż te problemy, aby mieć pewność, że |
certPreference |
Pole umożliwiające określenie typu certyfikatu SSL tworzonego przez Hosting dla nazwy domeny. Domeny niestandardowe abonamentu Spark mają dostęp tylko do typu certyfikatu |
cert |
Tylko dane wyjściowe. Certyfikat SSL dla tej nazwy domeny niestandardowej w Hostingu. W przypadku nowych domen niestandardowych jest to często sposób utworzenia certyfikatu przez Hosting, a nie rzeczywisty certyfikat. Sprawdź pole |
redirectTarget |
Nazwa domeny, na którą powinien kierować ruch |
reconciling |
Tylko dane wyjściowe. Pole, które (jeśli ma wartość true) wskazuje, że systemy Hostingu starają się dopasować stan domeny niestandardowej do preferowanego stanu. Najczęściej jest to |
labels |
Etykiety używane do dodatkowych metadanych lub filtrowania. Obiekt zawierający listę par |
HostState
Stan hosta Twojej nazwy domeny. Stan hosta jest określany przez sprawdzenie każdego adresu IP powiązanego z nazwą Twojej domeny w celu sprawdzenia, czy udostępnia on treści z Hostingu.
Wartości w polu enum | |
---|---|
HOST_STATE_UNSPECIFIED |
Stan hosta domeny niestandardowej jest nieokreślony. Jeśli to nie zostanie określone, komunikat jest nieprawidłowy. |
HOST_UNHOSTED |
Nazwa domeny niestandardowej nie jest powiązana z żadnym adresem IP. |
HOST_UNREACHABLE |
Nie można uzyskać dostępu do nazwy domeny Twojej domeny. Usługi hostingowe Zapytania DNS w celu znalezienia adresów IP Twojej domeny spowodowały błędy. Więcej informacji znajdziesz w polu issues obiektu CustomDomain . |
HOST_MISMATCH |
Nazwa domeny Twojej domeny niestandardowej zawiera adresy IP, które nie są ostatecznie powiązane z Hostingiem. |
HOST_CONFLICT |
Nazwa domeny niestandardowej zawiera adresy IP, które są dostępne zarówno w Hostingu, jak i w innych usługach. Aby zapewnić spójne wyniki, usuń rekordy A i AAAA powiązane z usługami niehostowanymi. |
HOST_ACTIVE |
Wszystkie żądania dotyczące nazwy domeny Twojej domeny są obsługiwane przez Hosting. Jeśli OwnershipState domeny niestandardowej to również ACTIVE , Hosting będzie udostępniać treści z Twojej witryny w usłudze hostingowej pod nazwą domeny. |
Stan własności
Stan własności domeny. Domena może być własnością maksymalnie jednej witryny Hostingu Firebase. Własność można określić na 2 sposoby:
* 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.
Jeśli CustomDomain
znajduje się w OwnershipState
innym niż OWNERSHIP_ACTIVE
przez ponad 30 dni i nie był aktualizowany od co najmniej 30 dni, systemy własności Hostingu usuwają CustomDomain
. Aby przywrócić usunięte konto CustomDomain
, wyślij prośbę o: customDomains.undelete
.
Wartości w polu enum | |
---|---|
OWNERSHIP_STATE_UNSPECIFIED |
Stan własności domeny niestandardowej jest nieokreślony. To nie powinno się nigdy zdarzyć. |
OWNERSHIP_MISSING |
nazwa domeny Twojej domeny niestandardowej nie zawiera rekordów własności związanych z Hostingiem; Żaden projekt Firebase nie ma uprawnień do działania w imieniu nazwy domeny. |
OWNERSHIP_UNREACHABLE |
Nie można uzyskać dostępu do nazwy domeny Twojej domeny. Usługi hostingowe Zapytania DNS w celu znalezienia rekordów własności nazwy domeny spowodowały błędy. Więcej informacji znajdziesz w polu issues obiektu CustomDomain . |
OWNERSHIP_MISMATCH |
Nazwa domeny Twojej domeny niestandardowej należy do innego projektu Firebase. Usuń powodujące konflikt rekordy TXT i zastąp je rekordami związanymi z bieżącym projektem Firebase. |
OWNERSHIP_CONFLICT |
Nazwa domeny Twojej domeny niestandardowej zawiera rekordy TXT powodujące konflikty, które wskazują własności zarówno przez bieżący projekt Firebase, jak i inny projekt. Usuń rekordy własności innego projektu, aby przypisać bieżącą własność projektu. |
OWNERSHIP_PENDING |
Rekordy DNS domeny niestandardowej są skonfigurowane prawidłowo. Hosting przeniesie prawo własności do Twojej domeny na to urządzenie CustomDomain w ciągu 24 godzin. |
OWNERSHIP_ACTIVE |
Nazwa domeny Twojej domeny niestandardowej zawiera rekordy (TXT ), które przyznają projektowi uprawnienia do działania w jej imieniu. |
Aktualizacje DNS
Zestaw aktualizacji rekordów DNS, które należy wprowadzić, aby zezwolić usłudze Hosting na udostępnianie bezpiecznych treści w odpowiedzi na żądania wysyłane pod kątem Twojej nazwy domeny. Aktualizacje te przedstawiają bieżący stan rekordów DNS Twojej nazwy domeny w momencie ostatniego zapytania ich przez Hosting oraz żądany zestaw rekordów, które musi mieć Hosting, zanim będzie można w pełni aktywować domenę niestandardową.
Zapis JSON |
---|
{ "discovered": [ { object ( |
Pola | |
---|---|
discovered[] |
Zestaw rekordów DNS wykrytych przez hosting podczas sprawdzania domeny. |
desired[] |
Zbiór rekordów DNS Hosting musi udostępniać bezpieczną treść w domenie. |
checkTime |
Czas ostatniego sprawdzenia rekordów DNS domeny niestandardowej przez Hosting. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
Zbiór rekordów DNS
Zestaw rekordów DNS związanych z konfiguracją i obsługą domeny niestandardowej w Hostingu Firebase.
Zapis JSON |
---|
{ "domainName": string, "checkError": { object ( |
Pola | |
---|---|
domainName |
Tylko dane wyjściowe. Nazwa domeny, której dotyczy zestaw rekordów. |
checkError |
Tylko dane wyjściowe. Podczas wysyłania zapytań dotyczących rekordów DNS nazwy domeny wystąpił błąd usług hostingu. Uwaga: Hosting ignoruje błędy |
records[] |
Tylko dane wyjściowe. Rekordy w domenie. |
Rekord DNS
Rekordy DNS to rekordy zasobów określające, jak powinny działać systemy i usługi podczas obsługi żądań dotyczących nazwy domeny. Na przykład gdy dodajesz rekordy A
do rekordów DNS nazwy domeny, informujesz inne systemy (takie jak przeglądarki użytkowników), aby skontaktowały się z tymi adresami IPv4 w celu pobrania zasobów związanych z nazwą Twojej domeny (na przykład plików witryny w Hostingu).
Zapis JSON |
---|
{ "domainName": string, "type": enum ( |
Pola | |
---|---|
domainName |
Tylko dane wyjściowe. Nazwa domeny, której dotyczy rekord, np. |
type |
Tylko dane wyjściowe. Typ rekordu, który określa, jakie dane zawiera. |
rdata |
Tylko dane wyjściowe. Dane rekordu. Znaczenie wartości zależy od typu rekordu: - A i AAAA: adresy IP nazwy domeny. – CNAME: inna domena, która ma sprawdzić rekordy. – TXT: dowolne ciągi tekstowe powiązane z nazwą domeny. Hosting używa rekordów TXT do określania, które projekty Firebase mają uprawnienia do działania w imieniu nazwy domeny. – CAA: flagi rekordu, tag i wartość, np. |
requiredAction |
Tylko dane wyjściowe. Enum, które wskazuje wymagane działanie w przypadku tego rekordu. |
Typ
Typ rekordu DNS, w tym A
, TXT
, AAAA
i CAA
.
Wartości w polu enum | |
---|---|
TYPE_UNSPECIFIED |
Typ rekordu jest nieokreślony. Jeśli to nie zostanie określone, komunikat jest nieprawidłowy. |
A |
Rekord A określony w RFC 1035. Rekordy A określają, na które adresy IPv4 dana nazwa domeny kieruje ruch. |
CNAME |
Rekord CNAME określony w RFC 1035. Rekordy nazwy kanonicznej CNAME mapują nazwę domeny na inną, kanoniczną nazwę domeny. Jeśli rekord CNAME istnieje, powinien on być jedynym rekordem w danej nazwie domeny. |
TXT |
Rekord TXT określony w RFC 1035. Rekordy TXT zawierają dowolne dane tekstowe w nazwie domeny. Hosting używa rekordów TXT do określenia, który projekt Firebase ma uprawnienia do działania w przypadku nazwy domeny. |
AAAA |
Rekord AAAA, zgodnie z definicją w RFC 3596, określa adresy IPv6, do których nazwa domeny kieruje ruch. |
CAA |
Rekord CAA zgodny z definicją podaną w RFC 6844. Rekordy CAA (ang. Certificate Authority Authorization, autoryzacja urzędu certyfikacji) określają, które urzędy certyfikacji (organizacje generujące certyfikaty SSL) są uprawnione do wygenerowania certyfikatu dla nazwy domeny. Hosting Firebase używa Rekordy CAA działają kaskadowo. Rekord CAA w domenie Rekordy CAA są opcjonalne. Jeśli nazwa domeny i jej jednostki nadrzędne nie mają rekordów CAA, wszystkie urzędy certyfikacji są uprawnione do generowania certyfikatów w jej imieniu. Hosting prosi o zmianę rekordów CAA tylko wtedy, gdy jest to wymagane do odblokowania tworzenia certyfikatu SSL. |
Działanie
Działanie to typ działania, które należy wykonać na tym rekordzie DNS, aby skonfigurować domenę na potrzeby Hostingu Firebase.
Wartości w polu enum | |
---|---|
NONE |
Nie musisz nic robić. |
ADD |
Dodaj ten rekord do rekordów DNS. |
REMOVE |
Usuń ten rekord z rekordów DNS. |
Typ
Typ certyfikatu. Określa, w jaki sposób systemy Hostingu obsługują tworzenie i utrzymywanie certyfikatu.
Wartości w polu enum | |
---|---|
TYPE_UNSPECIFIED |
Typ certyfikatu jest nieokreślony. Jeśli to nie zostanie określone, komunikat jest nieprawidłowy. |
TEMPORARY |
Typ certyfikatu o ograniczonym czasie ważności, który tymczasowo pokrywa nazwę domeny, podczas gdy Hosting tworzy certyfikat trwały. |
GROUPED |
Standardowy certyfikat dla domen niestandardowych w ramach abonamentu Spark. |
PROJECT_GROUPED |
Tylko abonament Blaze. Certyfikat, który obejmuje od 1 do 100 nazw domen z domenami niestandardowymi w tym samym projekcie Firebase. |
DEDICATED |
Tylko abonament Blaze. Certyfikat, który obejmuje pojedynczą nazwę domeny. |
Certyfikat
Certyfikat SSL używany do zapewnienia pełnego szyfrowania w przypadku żądań wysyłanych skierowanych do Twojej nazwy domeny. Certificate
może być rzeczywistym certyfikatem SSL lub – w przypadku nowo utworzonych domen niestandardowych – zamiarem utworzenia takiego certyfikatu przez Hosting.
Zapis JSON |
---|
{ "type": enum ( |
Pola | |
---|---|
type |
Tylko dane wyjściowe. Typ certyfikatu. |
state |
Tylko dane wyjściowe. Stan certyfikatu. Tylko stany |
verification |
Tylko dane wyjściowe. Zestaw testów ACME, które możesz dodać do swoich rekordów DNS lub do istniejącego dostawcy usług hostingowych, aby umożliwić usłudze Hosting utworzenie certyfikatu SSL dla Twojej nazwy domeny, zanim skierujesz ruch do usługi hostingowej. Możesz skorzystać z tych wyzwań w ramach przejścia ze starego dostawcy na usługę Hosting bez przestojów. |
issues[] |
Tylko dane wyjściowe. Zestaw błędów, które wystąpiły w Hostingu podczas próby utworzenia certyfikatu dla nazwy Twojej domeny. Rozwiąż te problemy, aby mieć pewność, że Hosting może zapewniać bezpieczną komunikację z użytkownikami Twojej witryny. |
createTime |
Tylko dane wyjściowe. czas utworzenia certyfikatu, W przypadku certyfikatów Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
expireTime |
Tylko dane wyjściowe. datę ważności certyfikatu; Po tym czasie certyfikat nie będzie już mógł być używany do zapewnienia bezpiecznej komunikacji między Hostingiem a użytkownikami Twojej witryny. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
Certyfikat CertState
Stan certyfikatu SSL Twojej domeny w Hostingu. Może to być stan rzeczywistego certyfikatu lub (w przypadku nowych domen niestandardowych) próbę utworzenia certyfikatu przez Hosting.
Wartości w polu enum | |
---|---|
CERT_STATE_UNSPECIFIED |
Stan certyfikatu jest nieokreślony. Jeśli to nie zostanie określone, komunikat jest nieprawidłowy. |
CERT_PREPARING |
Początkowy stan każdego certyfikatu odpowiada intencji Hostingu do utworzenia certyfikatu przed wysłaniem żądań do urzędu certyfikacji. |
CERT_VALIDATING |
Hosting sprawdza, czy rekordy DNS nazwy domeny są w stanie zezwalającym na tworzenie certyfikatów w jej imieniu. |
CERT_PROPAGATING |
Certyfikat został utworzony niedawno i potrzebuje czasu na rozpowszechnienie go w sieci CDN Hostingu. |
CERT_ACTIVE |
Certyfikat jest aktywny i zapewnia bezpieczne połączenia dla reprezentowanych przez niego nazw domen. |
CERT_EXPIRING_SOON |
Certyfikat wygaśnie, wszystkie jego nazwy domen otrzymają nowe certyfikaty. |
CERT_EXPIRED |
Certyfikat wygasł. Hosting nie może już obsługiwać treści zabezpieczonych w Twojej nazwie domeny. |
Certyfikacja
Zestaw testów ACME, których możesz użyć, aby umożliwić Hostingowi utworzenie certyfikatu SSL dla Twojej nazwy domeny przed skierowaniem ruchu na serwery Hostingu. Użyj testu zabezpieczającego DNS lub HTTP. nie musisz podawać obu.
Zapis JSON |
---|
{ "dns": { object ( |
Pola | |
---|---|
dns |
Tylko dane wyjściowe. Rekord |
http |
Tylko dane wyjściowe. Plik, który należy dodać do istniejącej usługi hostingowej niebędącej hostingiem, aby potwierdzić, że chcesz zezwolić usłudze Hosting na utworzenie certyfikatu SSL dla nazwy Twojej domeny. |
HttpUpdate
Plik, który możesz dodać do istniejącej usługi hostingowej niebędącej hostingiem, aby potwierdzić, że chcesz zezwolić urzędom certyfikacji Hostingu na utworzenie certyfikatu SSL dla Twojej domeny.
Zapis JSON |
---|
{
"path": string,
"desired": string,
"discovered": string,
"lastCheckTime": string,
"checkError": {
object ( |
Pola | |
---|---|
path |
Tylko dane wyjściowe. Ścieżka do pliku. |
desired |
Tylko dane wyjściowe. Ciąg tekstowy wyświetlany na ścieżce. |
discovered |
Tylko dane wyjściowe. Określa, czy podczas ostatniego sprawdzania usłudze Hosting udało się znaleźć wymaganą zawartość pliku w podanej ścieżce. |
lastCheckTime |
Tylko dane wyjściowe. Czas ostatniego sprawdzenia zawartości pliku przez systemy Hostingu. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
checkError |
Tylko dane wyjściowe. Podczas ostatniego sprawdzania treści wystąpił błąd. Jeśli ma wartość null, sprawdzanie zostało zakończone. |
Metody |
|
---|---|
|
Tworzy CustomDomain . |
|
Usuwa określoną wartość CustomDomain . |
|
Pobiera określoną wartość CustomDomain . |
|
Zawiera listę wszystkich elementów CustomDomain powiązanych z określoną nadrzędną witryną Hostingu. |
|
Aktualizuje określoną wartość CustomDomain . |
|
Przywraca określone CustomDomain , jeśli zostało przeniesione do kosza. |