REST Resource: projects.locations.backends.domains

Kaynak: Alan

Arka uçla ilişkilendirilen alan adı.

JSON gösterimi
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "type": enum (Type),
  "disabled": boolean,
  "serve": {
    object (ServingBehavior)
  },
  "customDomainStatus": {
    object (CustomDomainStatus)
  },
  "reconciling": boolean,
  "deleteTime": string,
  "purgeTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
Alanlar
name

string

Tanımlayıcı. Alanın kaynak adı, ör. /projects/p/locations/l/backends/b/domains/foo.com.

displayName

string

İsteğe bağlı. Alan için kullanıcıların okuyabileceği değiştirilebilir ad. 63 karakterle sınırlıdır. ör. prod domain

createTime

string (Timestamp format)

Yalnızca çıkış. Alanın oluşturulduğu saat.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Yalnızca çıkış. Alanın son güncellenme zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

type

enum (Type)

Yalnızca çıkış. Alanın türü.

disabled

boolean

İsteğe bağlı. Alanın devre dışı olup olmadığı. Varsayılan olarak yanlış değerine ayarlanır.

serve

object (ServingBehavior)

İsteğe bağlı. Alanın sunma davranışı. Belirtilirse alan, arka ucunun canlı içeriği dışında içerik sunar.

customDomainStatus

object (CustomDomainStatus)

Yalnızca çıkış. CUSTOM türü bir alanın durumunu ve yapılandırmasını gösterir. Yalnızca bu türdeki alanlarda bulunur.

reconciling

boolean

Yalnızca çıkış. Doğru ise derlemenin devam eden bir LRO'su olduğunu gösteren alan.

deleteTime

string (Timestamp format)

Yalnızca çıkış. Alanın silindiği saat.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

purgeTime

string (Timestamp format)

Yalnızca çıkış. Geri yüklenebilir şekilde silinmiş bir alanın kalıcı olarak silineceği ve kalıcı olarak silineceği zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

İsteğe bağlı. Anahtar/değer çiftleri olarak etiketler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

İsteğe bağlı. Anahtar/değer çiftleri olarak notlar.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

uid

string

Yalnızca çıkış. Sistem tarafından atanmış, benzersiz tanımlayıcı.

etag

string

Yalnızca çıkış. Diğer değerleri temel alan sunucu tarafından hesaplanan sağlama toplamı; işlemin beklenen kaynak üzerinde yapılmasını sağlamak için güncelleme veya silme sırasında gönderilebilir.

Tür

Alanın türü.

Sıralamalar
TYPE_UNSPECIFIED Tür belirtilmemiş (bunun olmaması gerekir).
DEFAULT Varsayılan, Uygulama Barındırma tarafından sağlanan ve yönetilen alanlardır. Bu alanlar, üst arka uçlarıyla otomatik olarak oluşturulur ve yalnızca üst arka uç kullanılarak silinemez ve başka bir arka uca taşınamaz. Varsayılan alan adları, disabled alanı aracılığıyla devre dışı bırakılabilir.
CUSTOM Geliştiriciye ait özel alanlar. Özel alan adları, sahibi olduğunuz bir alanı Uygulama Barındırma arka ucunuzla ilişkilendirmenize ve bu alanı arka ucunuzun içeriğini sunacak şekilde yapılandırmanıza olanak tanır.

Sunma Davranışı

Uygulama Barındırma'nın alanda içerik sunup sunmayacağını belirtir.

JSON gösterimi
{

  // Union field serving_behavior can be only one of the following:
  "redirect": {
    object (Redirect)
  }
  // End of list of possible types for union field serving_behavior.
}
Alanlar
Birleştirme alanı serving_behavior. Belirtilirse alanın sunma davranışını özelleştirir. serving_behavior şunlardan yalnızca biri olabilir:
redirect

object (Redirect)

İsteğe bağlı. Varsa, bir alan için yönlendirme davranışı.

Yönlendirme

Bir alan adı için yönlendirme davranışını belirtir.

JSON gösterimi
{
  "uri": string,
  "status": string
}
Alanlar
uri

string

Zorunlu. Yönlendirmenin amaçlanan hedefinin URI'sı. Bu URI, orijinal istek yolunun başına eklenecektir. Şema içermeyen URI'nin HTTPS olduğu varsayılır.

status

string (int64 format)

İsteğe bağlı. Yönlendirme yanıtında kullanılacak durum kodu. Geçerli bir HTTP 3XX durum kodu olmalıdır. Yoksa varsayılan olarak 302'dir.

Özel Alan Durumu

Özel alan adının arka uca bağlantısının durumu.

JSON gösterimi
{
  "hostState": enum (HostState),
  "ownershipState": enum (OwnershipState),
  "certState": enum (CertState),
  "requiredDnsUpdates": [
    {
      object (DnsUpdates)
    }
  ],
  "issues": [
    {
      object (Status)
    }
  ]
}
Alanlar
hostState

enum (HostState)

Yalnızca çıkış. Özel bir alanın, trafiği Uygulama Barındırma'ya uygun şekilde yönlendirip yönlendirmediğini takip eder.

ownershipState

enum (OwnershipState)

Yalnızca çıkış. Alanın DNS kayıtlarına göre arka ucun alanda içerik sunma izni olup olmadığını izler.

certState

enum (CertState)

Yalnızca çıkış. Alanın SSL sertifika durumunu izler.

requiredDnsUpdates[]

object (DnsUpdates)

Yalnızca çıkış. Kurulumu tamamlamak ve içerik yayınlamaya başlamak için özel alanın DNS'ine eklenmesi veya kaldırılması gereken kayıtları listeler. İlk katılım sırasında alan mevcut. Ayrıca, yukarıdaki durumlardan biri veya daha fazlası *_ACTIVE değilse alan ilk katılımdan sonra mevcuttur. Bu, alanın DNS kayıtlarının kötü durumda olduğunu gösterir.

issues[]

object (Status)

Yalnızca çıkış. Alan yapılandırmasıyla ilgili sorunların listesi. Kullanıcıların DNS kayıtlarıyla ilgili sorunları kendi kendilerine düzeltmelerine olanak tanır.

Ana Makine Eyaleti

Alanınızın ana makine durumudur. Ana makine durumu, alan adınızla ilişkili her bir IP adresinin, Uygulama Barındırma Kaynağı'nın uygun parçası üzerinden sunulup sunulmadığını görmek için kontrol edilerek belirlenir.

Sıralamalar
HOST_STATE_UNSPECIFIED Özel alanınızın ana makine durumu belirtilmedi. Bu belirtilmemişse ileti geçersizdir.
HOST_UNHOSTED Özel alan adınız herhangi bir IP adresiyle ilişkilendirilmemiş.
HOST_UNREACHABLE Özel alanınıza ulaşılamıyor. Uygulama Barındırma hizmetleri Alanınızın IP adreslerini bulmaya yönelik DNS sorguları hatayla sonuçlandı. Daha fazla bilgi için CustomDomainStatus cihazınızın issues alanına bakın.
HOST_NON_FAH Alanınızda yalnızca Uygulama Barındırma'ya çözümlenemeyen IP adresleri bulunuyor.
HOST_CONFLICT Alanınızda hem Uygulama Barındırma'ya hem de diğer hizmetlere çözümlenen IP adresleri var. Tutarlı sonuçlar elde etmek için uygulama barındırma dışı hizmetlerle ilgili A ve AAAA kayıtlarını kaldırın.
HOST_WRONG_SHARD Alanınızda, yanlış bir bölgeye çözümlenen IP adresleri ve/veya App Hosting'in replika parçası var.
HOST_ACTIVE Alanınıza yönelik tüm istekler, alanınıza atanan parçayla Uygulama Barındırma tarafından sunulur. Özel alanın OwnershipState değeri de OWNERSHIP_ACTIVE ise Uygulama Barındırma, alan için yapılan isteklerde arka uç içeriğini sunar.

Sahiplik Durumu

Özel alanınızın sahiplik durumu.

Sıralamalar
OWNERSHIP_STATE_UNSPECIFIED Özel alanınızın sahiplik durumu belirtilmedi. Böyle bir durum asla olmamalıdır.
OWNERSHIP_MISSING Özel alan adınızda Uygulama Barındırma ile ilgili sahiplik kaydı bulunmuyor; bu Kaynak kırığındaki alanda herhangi bir arka uçun sunulma yetkisi yok.
OWNERSHIP_UNREACHABLE Özel alanınıza ulaşılamıyor. Uygulama Barındırma hizmetleri Alanınızın sahiplik kayıtlarını bulmaya yönelik DNS sorguları hataya neden olmuştur. Daha fazla bilgi için CustomDomainStatus cihazınızın issues alanına bakın.
OWNERSHIP_MISMATCH Özel alanınız başka bir Uygulama Barındırma özel alanına ait. Çakışan kayıtları kaldırın ve mevcut özel alanınızın kayıtlarıyla değiştirin.
OWNERSHIP_CONFLICT Özel alanınızda, hem mevcut özel alanınızın bir veya daha fazla kişiye ait olduğunu gösteren çakışan TXT kayıtları var. Geçerli özel alan sahipliğini vermek için fazladan sahiplik kayıtlarını kaldırın.
OWNERSHIP_PENDING Özel alanınızın DNS kayıtları doğru şekilde yapılandırıldı. App Hosting, alanınızın sahipliğini 24 saat içinde bu özel alana aktarır.
OWNERSHIP_ACTIVE Özel alanınız, kendi alanına ait.

Sertifika Durumu

App Hosting'in alan adınız için sahip olduğu SSL sertifikasının durumu. Bu, gerçek sertifikanın durumunu veya yeni özel alanlar için App Hosting'in devam eden bir sertifika oluşturma denemesini gösterebilir.

Sıralamalar
CERT_STATE_UNSPECIFIED Sertifikanın durumu belirtilmedi. Bu belirtilmemişse ileti geçersizdir.
CERT_PREPARING Her sertifikanın ilk durumu, App Hosting'in Sertifika Yetkilisine istek yapılmadan önce sertifika oluşturma niyetini gösterir.
CERT_VALIDATING App Hosting, bir alan adının DNS kayıtlarının, alan adına sertifika oluşturmaya izin veren bir durumda olup olmadığını doğruluyor.
CERT_PROPAGATING Sertifika kısa süre önce oluşturuldu ve App Hosting'in yük dengeleyicilerinde yayılması için zamana ihtiyacı var.
CERT_ACTIVE Sertifika etkin durumda ve temsil ettiği alan adları için güvenli bağlantılar sağlıyor.
CERT_EXPIRING_SOON Sertifikanın süresi doluyor. Sertifikadaki tüm alan adlarına yeni sertifika verilecek.
CERT_EXPIRED Sertifikanın süresi doldu. App Hosting artık alan adınızda güvenli içerik sunamaz.

DNS Güncellemeleri

App Hosting'in alanınıza yönelik isteklere yanıt olarak güvenli içerik sunmasına izin vermek için yapmanız gereken bir dizi DNS kaydı güncellemesidir. Bu güncellemeler, alanınızın ve ilgili alt alan adlarının mevcut durumunu gösterir. App Hosting bunları en son sorguladığı zaman DNS kayıtları ve özel alanınızın tam olarak etkinleştirilebilmesi için Uygulama Barındırma'nın görmesi gereken kayıt kümesi gösterilir.

JSON gösterimi
{
  "domainName": string,
  "discovered": [
    {
      object (DnsRecordSet)
    }
  ],
  "desired": [
    {
      object (DnsRecordSet)
    }
  ],
  "checkTime": string
}
Alanlar
domainName

string

Yalnızca çıkış. DNS güncellemelerinin ait olduğu alan adı.

discovered[]

object (DnsRecordSet)

Yalnızca çıkış. Bir alan incelenirken bulunan App Hosting adlı DNS kayıtları grubu.

desired[]

object (DnsRecordSet)

Yalnızca çıkış. Uygulama Barındırma'nın, alanda güvenli içerik sunabilmesi için gereken DNS kayıtları kümesi.

checkTime

string (Timestamp format)

Yalnızca çıkış. App Hosting, özel alanınızın DNS kayıtlarını en son kontrol ettiğinde.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

DnsRecordSet

Uygulama Barındırma'da özel bir alanın kurulumu ve bakımıyla ilgili DNS kayıtları grubu.

JSON gösterimi
{
  "domainName": string,
  "checkError": {
    object (Status)
  },
  "records": [
    {
      object (DnsRecord)
    }
  ]
}
Alanlar
domainName

string

Yalnızca çıkış. Kayıt kümesinin ait olduğu alan adı.

checkError

object (Status)

Yalnızca çıkış. Alanınızın DNS kayıtları sorgulanırken App Hosting hizmetleriyle ilgili hata oluştu. Not: Uygulama Barındırma, NXDOMAIN hatalarını yok sayar. Bunlar genellikle bir alan adının henüz oluşturulmadığı anlamına gelir.

records[]

object (DnsRecord)

Yalnızca çıkış. Alandaki kayıtlar.

DNS Kaydı

Bir alan adı için DNS kayıtlarının temsili.

DNS kayıtları, bir alan için yapılan istekleri işlerken sistemlerin ve hizmetlerin nasıl davranması gerektiğini tanımlayan kaynak kayıtlarıdır. Örneğin, alanınızın DNS kayıtlarına A kayıtları eklediğinizde, diğer sistemleri (ör. kullanıcılarınızın web tarayıcıları) alanınızla alakalı kaynakları (ör. Uygulama Barındırma dosyalarınız) almak için söz konusu IPv4 adresleriyle iletişime geçmeleri konusunda bilgilendirirsiniz.

JSON gösterimi
{
  "domainName": string,
  "type": enum (Type),
  "rdata": string,
  "requiredAction": enum (Action),
  "relevantState": [
    enum (CustomDomainState)
  ]
}
Alanlar
domainName

string

Yalnızca çıkış. Kaydın ait olduğu alan, ör. foo.bar.com.

type

enum (Type)

Yalnızca çıkış. Kaydın türü (kayda hangi verilerin yer aldığını belirler).

rdata

string

Yalnızca çıkış. Kayıt verileri. Değerin anlamı kayıt türüne bağlıdır: - A ve AAAA: Alanın IP adresleri. - CNAME: Kayıtların kontrol edileceği başka bir alan adı. - TXT: Alanla ilişkili rastgele metin dizeleri. App Hosting, hangi Firebase projelerinin alan adına işlem yapma iznine sahip olduğunu belirlemek için TXT kayıtlarını kullanır. - CAA: Kaydın işaretleri, etiketi ve değeri, ör. 0 issue "pki.goog"

requiredAction

enum (Action)

Yalnızca çıkış. Bu kayıt için gerekli işlemi gösteren bir sıralama. Kayıt, DnsUpdates discovered veya desired kayıt kümesindeki gerekli bir değişikliğin parçası olduğunda doldurulur.

relevantState[]

enum (CustomDomainState)

Yalnızca çıkış. Bu DNS kaydının geçerli olduğu durumları gösteren bir sıralama. ADD veya REMOVE gerekli işlemle tüm kayıtlar için doldurulur.

Tür

DNS kaydının türü (A, TXT, AAAA ve CAA dahil).

Sıralamalar
TYPE_UNSPECIFIED Kayıt türü belirtilmedi. Bu belirtilmemişse ileti geçersizdir.
A RFC 1035'te tanımlandığı gibi bir A kaydı. Kayıtlar, bir alanın trafiği hangi IPv4 adreslerine yönlendirdiğini belirler.
CNAME RFC 1035'te tanımlandığı gibi bir CNAME kaydı. CNAME veya Kurallı Ad kayıtları, bir alan adını farklı, standart bir alan adıyla eşler. CNAME kaydı varsa alandaki tek kayıt bu olmalıdır.
TXT RFC 1035'te tanımlandığı gibi bir TXT kaydı. TXT kayıtları, bir alanda rastgele metin verileri içerir. Hosting, hangi Firebase projesinin alanda işlem yapma iznine sahip olduğunu belirlemek için TXT kayıtlarını kullanır.
AAAA RFC 3596 AAAA kayıtlarında tanımlandığı gibi bir AAAA kaydı, bir alanın trafiği hangi IPv6 adreslerine yönlendirdiğini belirler.
CAA

RFC 6844'te tanımlandığı gibi bir CAA kaydı. CAA veya Sertifika Yetkilisi Yetkilendirmesi, kayıtları, alan için sertifika basmaya hangi Sertifika Yetkililerinin (SSL sertifikası veren kuruluşlar) yetkili olduğunu belirler. App Hosting, birincil sertifika yetkilisi olarak pki.goog kullanıyor.

CAA kayıtları basamakları. bar.foo.com kendi CAA kaydı kümesine sahip değilse foo.com hizmetindeki CAA kaydı bar.foo.com için de geçerlidir.

CAA kayıtları isteğe bağlıdır. Bir alanın ve üst öğelerinin CAA kaydı yoksa tüm CA'lar, alan adına sertifika basma yetkisine sahip olur. Genel olarak App Hosting, yalnızca SSL sertifikası oluşturma işleminin engellemesini kaldırmak için CAA kayıtlarını değiştirmenizi ister.

İşlem

Alanınızı Uygulama Barındırma ile kullanılmak üzere yapılandırmak için bu DNS kaydında gerçekleştirmeniz gereken işlem türüdür.

Sıralamalar
NONE Herhangi bir işlem yapmanız gerekmez.
ADD Bu kaydı DNS kayıtlarınıza ekleyin.
REMOVE Bu kaydı DNS kayıtlarınızdan kaldırın.

ÖzelAlanDurumu

Özel alanın sağlıklı çalışmasıyla alakalı bir dizi eyalet.

Sıralamalar
CUSTOM_DOMAIN_STATE_UNSPECIFIED Belirtilmemişse bu mesaj geçersizdir.
HOST_STATE Özel alanın ana makine durumu.
OWNERSHIP_STATE Özel alanın sahiplik durumu.
CERT_STATE Özel alanın sertifika durumu.

Yöntemler

create

Yeni bir alan adını bir arka uca bağlar.

delete

Tek bir alanı siler.

get

Bir alanla ilgili bilgileri alır.

list

Bir arka ucun alanlarını listeler.

patch

Tek bir alan için bilgileri günceller.