REST Resource: projects.sites.customDomains

{
  "name": string,
  "annotations": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "etag": string,
  "hostState": enum (HostState),
  "ownershipState": enum (OwnershipState),
  "requiredDnsUpdates": {
    object (DnsUpdates)
  },
  "issues": [
    {
      object (Status)
    }
  ],
  "certPreference": enum (Type),
  "cert": {
    object (Certificate)
  },
  "redirectTarget": string,
  "reconciling": boolean,
  "labels": {
    string: string,
    ...
  }
}

string

Chỉ đầu ra. Tên đủ điều kiện của CustomDomain .

map (key: string, value: string)

Chú thích mà bạn có thể thêm để để lại cả siêu dữ liệu mà con người và máy có thể đọc được về CustomDomain của bạn.

Một đối tượng chứa danh sách các cặp "key": value . Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

string ( Timestamp format)

Chỉ đầu ra. Thời gian tạo của miền tùy chỉnh.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Chỉ đầu ra. Lần cuối cùng CustomDomain được cập nhật.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Chỉ đầu ra. Thời điểm CustomDomain bị xóa; null cho các miền tùy chỉnh chưa bị xóa. Các miền tùy chỉnh đã xóa sẽ tồn tại trong khoảng 30 ngày, sau thời gian đó Hosting sẽ xóa chúng hoàn toàn. Để khôi phục miền tùy chỉnh đã xóa, hãy thực hiện yêu cầu customDomains.undelete .

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Chỉ đầu ra. Thời gian tối thiểu trước khi CustomDomain bị xóa mềm bị xóa hoàn toàn khỏi Hosting; null cho các miền tùy chỉnh chưa bị xóa.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

string

Chỉ đầu ra. Một chuỗi đại diện cho trạng thái hiện tại của CustomDomain và cho phép bạn xác nhận trạng thái ban đầu của nó trong các yêu cầu sửa đổi nó. Sử dụng thẻ để đảm bảo tính nhất quán khi thực hiện các yêu cầu customDomains.patch , customDomains.delete và customDomains.undelete .

enum ( HostState )

Chỉ đầu ra. HostState của tên miền mà CustomDomain này đề cập đến.

enum ( OwnershipState )

Chỉ đầu ra. OwnershipState của tên miền mà CustomDomain này đề cập đến.

object ( DnsUpdates )

Chỉ đầu ra. Một loạt các cập nhật bạn nên thực hiện đối với bản ghi DNS của tên miền để cho phép Hosting thay mặt họ cung cấp nội dung bảo mật.

object ( Status )

Chỉ đầu ra. Một tập hợp các lỗi mà hệ thống Hosting gặp phải khi cố gắng thiết lập khả năng của Hosting để cung cấp nội dung bảo mật cho tên miền của bạn. Giải quyết những vấn đề này để đảm bảo CustomDomain của bạn hoạt động đúng cách.

enum ( Type )

Trường cho phép bạn chỉ định loại chứng chỉ SSL mà Hosting tạo cho tên miền của bạn. Các miền tùy chỉnh của gói Spark chỉ có quyền truy cập vào loại chứng chỉ GROUPED , trong khi các miền của gói Blaze có thể chọn bất kỳ tùy chọn nào.

object ( Certificate )

Chỉ đầu ra. Chứng chỉ SSL Hosting dành cho tên miền của miền tùy chỉnh này. Đối với các miền tùy chỉnh mới, điều này thường thể hiện mục đích của Hosting là tạo chứng chỉ chứ không phải chứng chỉ thực tế. Kiểm tra trường state để biết thêm.

string

Một tên miền mà CustomDomain này sẽ hướng lưu lượng truy cập tới. Nếu được chỉ định, Hosting sẽ phản hồi các yêu cầu đối với miền tùy chỉnh này bằng mã HTTP 301 và định tuyến lưu lượng truy cập đến redirectTarget được chỉ định.

boolean

Chỉ đầu ra. Trường này, nếu đúng, cho biết hệ thống của Hosting đang cố gắng làm cho trạng thái của miền tùy chỉnh khớp với trạng thái ưa thích của bạn. Điều này thường true nhất khi ban đầu cung cấp CustomDomain sau yêu cầu customDomains.create hoặc khi tạo chứng chỉ SSL mới để khớp với certPreference được cập nhật sau yêu cầu customDomains.patch .

map (key: string, value: string)

Nhãn được sử dụng để bổ sung thêm siêu dữ liệu và/hoặc lọc.

Một đối tượng chứa danh sách các cặp "key": value . Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

{
  "discovered": [
    {
      object (DnsRecordSet)
    }
  ],
  "desired": [
    {
      object (DnsRecordSet)
    }
  ],
  "checkTime": string
}

object ( DnsRecordSet )

Bộ bản ghi DNS mà Hosting phát hiện khi kiểm tra một miền.

object ( DnsRecordSet )

Bộ bản ghi DNS mà Hosting cần để phục vụ nội dung an toàn trên miền.

string ( Timestamp format)

Lần cuối cùng Hosting kiểm tra bản ghi DNS của miền tùy chỉnh của bạn.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

{
  "domainName": string,
  "checkError": {
    object (Status)
  },
  "records": [
    {
      object (DnsRecord)
    }
  ]
}

string

Chỉ đầu ra. Tên miền mà bản ghi được thiết lập liên quan đến.

object ( Status )

Chỉ đầu ra. Đã xảy ra lỗi Dịch vụ lưu trữ khi truy vấn bản ghi DNS tên miền của bạn. Lưu ý: Dịch vụ lưu trữ bỏ qua các lỗi NXDOMAIN vì những lỗi này thường chỉ có nghĩa là tên miền chưa được thiết lập.

object ( DnsRecord )

Chỉ đầu ra. Bản ghi trên miền.

{
  "domainName": string,
  "type": enum (Type),
  "rdata": string,
  "requiredAction": enum (Action)
}

string

Chỉ đầu ra. Tên miền mà bản ghi liên quan đến, ví dụ: foo.bar.com. .

enum ( Type )

Chỉ đầu ra. Loại bản ghi, xác định dữ liệu nào chứa trong bản ghi.

string

Chỉ đầu ra. Dữ liệu của bản ghi. Ý nghĩa của giá trị tùy thuộc vào loại bản ghi: - A và AAAA: Địa chỉ IP cho tên miền. - CNAME: Một tên miền khác để kiểm tra hồ sơ. - TXT: Chuỗi văn bản tùy ý gắn với tên miền. Dịch vụ lưu trữ sử dụng bản ghi TXT để xác định dự án Firebase nào có quyền hành động thay mặt tên miền. - CAA: Flag, tag, value của record, vd 0 issue "pki.goog" .

enum ( Action )

Chỉ đầu ra. Một enum cho biết hành động bắt buộc đối với bản ghi này.

{
  "type": enum (Type),
  "state": enum (CertState),
  "verification": {
    object (CertVerification)
  },
  "issues": [
    {
      object (Status)
    }
  ],
  "createTime": string,
  "expireTime": string
}

enum ( Type )

Chỉ đầu ra. Loại chứng chỉ.

enum ( CertState )

Chỉ đầu ra. Trạng thái của chứng chỉ. Chỉ các trạng thái CERT_ACTIVE và CERT_EXPIRING_SOON mới cung cấp phạm vi bảo hiểm SSL cho tên miền. Nếu trạng thái PROPAGATING và Hosting đã có chứng chỉ hoạt động cho tên miền trước đó thì chứng chỉ hoạt động trước đây đó sẽ cung cấp phạm vi bảo hiểm SSL cho tên miền cho đến khi chứng chỉ hiện tại được phổ biến.

object ( CertVerification )

Chỉ đầu ra. Một tập hợp các thử thách ACME mà bạn có thể thêm vào bản ghi DNS của mình hoặc nhà cung cấp dịch vụ lưu trữ hiện tại, không phải Dịch vụ lưu trữ để cho phép Dịch vụ lưu trữ tạo chứng chỉ SSL cho tên miền của bạn trước khi bạn hướng lưu lượng truy cập về phía dịch vụ lưu trữ. Bạn có thể sử dụng những thách thức này như một phần của quá trình chuyển đổi không có thời gian ngừng hoạt động từ nhà cung cấp cũ sang Dịch vụ lưu trữ.

object ( Status )

Chỉ đầu ra. Một tập hợp các lỗi mà Hosting gặp phải khi cố gắng tạo chứng chỉ cho tên miền của bạn. Giải quyết những vấn đề này để đảm bảo Dịch vụ lưu trữ có thể cung cấp liên lạc an toàn với khách truy cập trang web của bạn.

string ( Timestamp format)

Chỉ đầu ra. Thời gian tạo chứng chỉ. Đối với chứng chỉ TEMPORARY , đây là lần đầu tiên Dịch vụ lưu trữ tạo ra thử thách cho tên miền của bạn. Đối với tất cả các loại chứng chỉ khác, đây là thời điểm chứng chỉ thực tế được tạo.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

Chỉ đầu ra. Thời gian hết hạn của chứng chỉ. Sau thời gian này, chứng chỉ không thể được sử dụng để cung cấp liên lạc an toàn giữa Dịch vụ lưu trữ và khách truy cập trang web của bạn nữa.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

{
  "dns": {
    object (DnsUpdates)
  },
  "http": {
    object (HttpUpdate)
  }
}

object ( DnsUpdates )

Chỉ đầu ra. Bản ghi TXT để thêm vào bản ghi DNS nhằm xác nhận ý định của bạn cho phép Hosting tạo chứng chỉ SSL cho tên miền của bạn.

object ( HttpUpdate )

Chỉ đầu ra. Một tệp để thêm vào dịch vụ lưu trữ hiện tại, không phải của Hosting xác nhận ý định của bạn cho phép Hosting tạo chứng chỉ SSL cho tên miền của bạn.

{
  "path": string,
  "desired": string,
  "discovered": string,
  "lastCheckTime": string,
  "checkError": {
    object (Status)
  }
}

string

Chỉ đầu ra. Đường dẫn đến tập tin.

string

Chỉ đầu ra. Một chuỗi văn bản để phục vụ tại đường dẫn.

string

Chỉ đầu ra. Liệu Hosting có thể tìm thấy nội dung tệp được yêu cầu trên đường dẫn đã chỉ định trong lần kiểm tra cuối cùng hay không.

string ( Timestamp format)

Chỉ đầu ra. Lần cuối cùng hệ thống Hosting kiểm tra nội dung tệp.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu", với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z" .

object ( Status )

Chỉ đầu ra. Đã xảy ra lỗi trong lần kiểm tra nội dung gần đây nhất. Nếu null, việc kiểm tra đã hoàn tất thành công.