Tài nguyên: Miền tùy chỉnh
CustomDomain
là một thực thể liên kết tên miền với trang web Lưu trữ Firebase. Thêm CustomDomain
vào trang web của bạn để cho phép Dịch vụ lưu trữ phân phối nội dung của trang web nhằm đáp ứng các yêu cầu đối với tên miền của bạn.
Biểu diễn JSON |
---|
{ "name": string, "annotations": { string: string, ... }, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string, "etag": string, "hostState": enum ( |
Lĩnh vực | |
---|---|
name | Chỉ đầu ra. Tên đủ điều kiện của |
annotations | 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ề Một đối tượng chứa danh sách các cặp |
createTime | 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ụ: |
updateTime | Chỉ đầu ra. Lần cuối cùng 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ụ: |
deleteTime | Chỉ đầu ra. Thời điểm 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ụ: |
expireTime | Chỉ đầu ra. Thời gian tối thiểu trước khi 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ụ: |
etag | Chỉ đầu ra. Một chuỗi đại diện cho trạng thái hiện tại của |
hostState | Chỉ đầu ra. |
ownershipState | Chỉ đầu ra. |
requiredDnsUpdates | 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. |
issues[] | 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 |
certPreference | 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ỉ |
cert | 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 |
redirectTarget | Một tên miền mà |
reconciling | 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 |
labels | 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 |
Nhà nước
Trạng thái máy chủ của tên miền của bạn. Trạng thái máy chủ được xác định bằng cách kiểm tra từng địa chỉ IP được liên kết với tên miền của bạn để xem liệu địa chỉ đó có phục vụ nội dung Lưu trữ hay không.
Enum | |
---|---|
HOST_STATE_UNSPECIFIED | Trạng thái máy chủ của miền tùy chỉnh của bạn chưa được chỉ định. Tin nhắn không hợp lệ nếu điều này không được chỉ định. |
HOST_UNHOSTED | Tên miền miền tùy chỉnh của bạn không được liên kết với bất kỳ địa chỉ IP nào. |
HOST_UNREACHABLE | Không thể truy cập được tên miền của miền tùy chỉnh của bạn. Truy vấn DNS của dịch vụ lưu trữ để tìm địa chỉ IP tên miền của bạn đã dẫn đến lỗi. Xem trường issues của đối tượng CustomDomain của bạn để biết thêm chi tiết. |
HOST_MISMATCH | Tên miền của miền tùy chỉnh của bạn có các địa chỉ IP cuối cùng không phân giải thành Dịch vụ lưu trữ. |
HOST_CONFLICT | Tên miền miền tùy chỉnh của bạn có địa chỉ IP phân giải cho cả Dịch vụ lưu trữ và các dịch vụ khác. Để đảm bảo kết quả nhất quán, hãy xóa bản ghi A và AAAA liên quan đến các dịch vụ không phải Hosting. |
HOST_ACTIVE | Tất cả các yêu cầu đối với tên miền miền tùy chỉnh của bạn đều do Hosting phục vụ. Nếu OwnershipState của miền tùy chỉnh cũng là ACTIVE thì Hosting sẽ phân phát nội dung trang web Lưu trữ của bạn trên tên miền. |
Quyền sở hữuNhà nước
Trạng thái sở hữu miền của bạn. Một miền có thể được sở hữu bởi nhiều nhất một Trang web lưu trữ Firebase. Quyền sở hữu có thể được xác định theo hai cách:
* 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.
Nếu CustomDomain
của bạn ở OwnershipState
không phải OWNERSHIP_ACTIVE
trong hơn 30 ngày và miền này chưa được cập nhật trong ít nhất 30 ngày, thì hệ thống quyền sở hữu của Hosting sẽ xóa CustomDomain
. Để khôi phục CustomDomain
đã xóa, hãy thực hiện yêu cầu customDomains.undelete
.
Enum | |
---|---|
OWNERSHIP_STATE_UNSPECIFIED | Trạng thái quyền sở hữu miền tùy chỉnh của bạn chưa được chỉ định. Điều này không bao giờ nên xảy ra. |
OWNERSHIP_MISSING | Tên miền miền tùy chỉnh của bạn không có hồ sơ quyền sở hữu liên quan đến Dịch vụ lưu trữ; không có dự án Firebase nào có quyền hành động thay mặt tên miền. |
OWNERSHIP_UNREACHABLE | Không thể truy cập được tên miền của miền tùy chỉnh của bạn. Truy vấn DNS của dịch vụ lưu trữ để tìm hồ sơ quyền sở hữu tên miền của bạn đã dẫn đến lỗi. Xem trường issues của đối tượng CustomDomain của bạn để biết thêm chi tiết. |
OWNERSHIP_MISMATCH | Tên miền miền tùy chỉnh của bạn thuộc sở hữu của một dự án Firebase khác. Xóa các bản ghi TXT xung đột và thay thế chúng bằng các bản ghi dành riêng cho dự án cho dự án Firebase hiện tại của bạn. |
OWNERSHIP_CONFLICT | Tên miền miền tùy chỉnh của bạn có các bản ghi TXT xung đột cho biết quyền sở hữu của cả dự án Firebase hiện tại của bạn và dự án khác. Xóa hồ sơ quyền sở hữu của dự án khác để cấp quyền sở hữu dự án hiện tại. |
OWNERSHIP_PENDING | Bản ghi DNS của miền tùy chỉnh của bạn được định cấu hình chính xác. Dịch vụ lưu trữ sẽ chuyển quyền sở hữu miền của bạn sang CustomDomain này trong vòng 24 giờ. |
OWNERSHIP_ACTIVE | Tên miền miền tùy chỉnh của bạn có bản ghi TXT cấp quyền cho dự án được hành động thay mặt cho dự án. |
DnsCập nhật
Một tập hợp các bản cập nhật bản ghi DNS mà bạn nên thực hiện để cho phép Dịch vụ lưu trữ cung cấp nội dung bảo mật nhằm đáp ứng các yêu cầu đối với tên miền của bạn. Những cập nhật này trình bày trạng thái hiện tại của bản ghi DNS tên miền của bạn khi Hosting truy vấn chúng lần cuối và bộ bản ghi mong muốn mà Hosting cần xem trước khi miền tùy chỉnh của bạn có thể hoạt động hoàn toàn.
Biểu diễn JSON |
---|
{ "discovered": [ { object ( |
Lĩnh vực | |
---|---|
discovered[] | Bộ bản ghi DNS mà Hosting phát hiện khi kiểm tra một miền. |
desired[] | Bộ bản ghi DNS mà Hosting cần để phục vụ nội dung an toàn trên miền. |
checkTime | 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ụ: |
Bộ bản ghi Dns
Một tập hợp các bản ghi DNS liên quan đến việc thiết lập và duy trì miền tùy chỉnh trong Firebase Hosting.
Biểu diễn JSON |
---|
{ "domainName": string, "checkError": { object ( |
Lĩnh vực | |
---|---|
domainName | Chỉ đầu ra. Tên miền mà bản ghi được thiết lập liên quan đến. |
checkError | 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 |
records[] | Chỉ đầu ra. Bản ghi trên miền. |
Bản ghi Dns
Bản ghi DNS là bản ghi tài nguyên xác định cách hoạt động của hệ thống và dịch vụ khi xử lý các yêu cầu về tên miền. Ví dụ: khi bạn thêm bản ghi A
vào bản ghi DNS của tên miền, bạn đang thông báo cho các hệ thống khác (chẳng hạn như trình duyệt web của người dùng) liên hệ với các địa chỉ IPv4 đó để truy xuất các tài nguyên liên quan đến tên miền của bạn (chẳng hạn như các tệp trang web Lưu trữ của bạn). ).
Biểu diễn JSON |
---|
{ "domainName": string, "type": enum ( |
Lĩnh vực | |
---|---|
domainName | Chỉ đầu ra. Tên miền mà bản ghi liên quan đến, ví dụ: |
type | Chỉ đầu ra. Loại bản ghi, xác định dữ liệu nào chứa trong bản ghi. |
rdata | 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 |
requiredAction | Chỉ đầu ra. Một enum cho biết hành động bắt buộc đối với bản ghi này. |
Kiểu
Loại bản ghi DNS, bao gồm A
, TXT
, AAAA
và CAA
.
Enum | |
---|---|
TYPE_UNSPECIFIED | Loại bản ghi không được chỉ định. Tin nhắn không hợp lệ nếu điều này không được chỉ định. |
A | Bản ghi A , như được định nghĩa trong RFC 1035 . Bản ghi xác định địa chỉ IPv4 nào mà tên miền hướng lưu lượng truy cập tới. |
CNAME | Bản ghi CNAME , như được định nghĩa trong RFC 1035 . Bản ghi CNAME hoặc Tên chuẩn sẽ ánh xạ một tên miền tới một tên miền chuẩn khác. Nếu có bản ghi CNAME thì đó sẽ là bản ghi duy nhất trên tên miền. |
TXT | Bản ghi TXT , như được định nghĩa trong RFC 1035 . Bản ghi TXT chứa dữ liệu văn bản tùy ý trên một 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 hoạt động trên một tên miền. |
AAAA | Bản ghi AAAA, như được xác định trong bản ghi RFC 3596 AAAA, xác định địa chỉ IPv6 nào mà tên miền hướng lưu lượng truy cập tới. |
CAA | Bản ghi CAA, như được định nghĩa trong RFC 6844 . CAA, hay Ủy quyền của Tổ chức phát hành chứng chỉ, các hồ sơ xác định Tổ chức phát hành chứng chỉ nào (tổ chức tạo chứng chỉ SSL) được phép tạo chứng chỉ cho tên miền. Firebase Hosting sử dụng Bản ghi CAA xếp tầng. Bản ghi CAA trên Hồ sơ CAA là tùy chọn. Nếu một tên miền và tên miền gốc của nó không có bản ghi CAA thì tất cả các CA đều được ủy quyền tạo ra các chứng chỉ thay mặt cho tên miền đó. Nói chung, Hosting chỉ yêu cầu bạn sửa đổi bản ghi CAA khi việc làm đó là bắt buộc để bỏ chặn việc tạo chứng chỉ SSL. |
Hoạt động
Hành động là loại hành động bạn nên thực hiện đối với bản ghi DNS này để định cấu hình miền của mình nhằm sử dụng với Firebase Hosting.
Enum | |
---|---|
NONE | Không cần hành động. |
ADD | Thêm bản ghi này vào bản ghi DNS của bạn. |
REMOVE | Xóa bản ghi này khỏi bản ghi DNS của bạn. |
Kiểu
Loại chứng chỉ. Xác định cách hệ thống lưu trữ xử lý việc tạo và duy trì chứng chỉ.
Enum | |
---|---|
TYPE_UNSPECIFIED | Loại chứng chỉ không được chỉ định. Tin nhắn không hợp lệ nếu điều này không được chỉ định. |
TEMPORARY | Loại chứng chỉ có thời hạn sử dụng tạm thời bao gồm một tên miền, trong khi Hosting tạo chứng chỉ lâu dài hơn. |
GROUPED | Chứng chỉ tiêu chuẩn cho miền tùy chỉnh của gói Spark. |
PROJECT_GROUPED | Chỉ có kế hoạch Blaze. Chứng chỉ bao gồm từ 1 đến 100 tên miền với các miền tùy chỉnh trên cùng một dự án Firebase. |
DEDICATED | Chỉ có kế hoạch Blaze. Chứng chỉ bao gồm một tên miền duy nhất. |
Giấy chứng nhận
Chứng chỉ SSL được sử dụng để cung cấp mã hóa đầu cuối cho các yêu cầu đối với tên miền của bạn. Certificate
có thể là chứng chỉ SSL thực tế hoặc đối với các miền tùy chỉnh mới được tạo, mục đích của Hosting là tạo một chứng chỉ.
Biểu diễn JSON |
---|
{ "type": enum ( |
Lĩnh vực | |
---|---|
type | Chỉ đầu ra. Loại chứng chỉ. |
state | Chỉ đầu ra. Trạng thái của chứng chỉ. Chỉ các trạng thái |
verification | 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ữ. |
issues[] | 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. |
createTime | Chỉ đầu ra. Thời gian tạo chứng chỉ. Đối với chứng chỉ 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ụ: |
expireTime | 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ụ: |
Chứng chỉ trạng thái
Trạng thái của chứng chỉ SSL mà Hosting dành cho tên miền của bạn. Điều này có thể thể hiện trạng thái của chứng chỉ thực tế hoặc đối với các miền tùy chỉnh mới, nỗ lực tạo chứng chỉ của Hosting.
Enum | |
---|---|
CERT_STATE_UNSPECIFIED | Trạng thái của chứng chỉ không được chỉ định. Tin nhắn không hợp lệ nếu điều này không được chỉ định. |
CERT_PREPARING | Trạng thái ban đầu của mọi chứng chỉ thể hiện ý định tạo chứng chỉ của Hosting trước khi đưa ra yêu cầu tới Cơ quan cấp chứng chỉ. |
CERT_VALIDATING | Dịch vụ lưu trữ đang xác thực xem bản ghi DNS của tên miền có ở trạng thái cho phép tạo chứng chỉ thay mặt cho tên miền đó hay không. |
CERT_PROPAGATING | Chứng chỉ mới được tạo gần đây và cần thời gian để phổ biến trong CDN của Hosting. |
CERT_ACTIVE | Chứng chỉ đang hoạt động, cung cấp kết nối an toàn cho tên miền mà nó đại diện. |
CERT_EXPIRING_SOON | Chứng chỉ sắp hết hạn, tất cả tên miền trên đó sẽ được cấp chứng chỉ mới. |
CERT_EXPIRED | Chứng chỉ đã hết hạn. Dịch vụ lưu trữ không thể phân phát nội dung bảo mật trên tên miền của bạn nữa. |
Xác minh chứng chỉ
Một tập hợp các thử thách ACME mà bạn có thể sử dụng để cho phép Hosting tạo chứng chỉ SSL cho tên miền của bạn trước khi hướng lưu lượng truy cập đến máy chủ Hosting. Sử dụng thử thách DNS hoặc HTTP; không cần thiết phải cung cấp cả hai.
Biểu diễn JSON |
---|
{ "dns": { object ( |
Lĩnh vực | |
---|---|
dns | Chỉ đầu ra. Bản ghi |
http | 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. |
HttpCập nhật
Một tệp bạn có thể 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 là cho phép Tổ chức phát hành chứng chỉ của Hosting tạo chứng chỉ SSL cho miền của bạn.
Biểu diễn JSON |
---|
{
"path": string,
"desired": string,
"discovered": string,
"lastCheckTime": string,
"checkError": {
object ( |
Lĩnh vực | |
---|---|
path | Chỉ đầu ra. Đường dẫn đến tập tin. |
desired | Chỉ đầu ra. Một chuỗi văn bản để phục vụ tại đường dẫn. |
discovered | 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. |
lastCheckTime | 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ụ: |
checkError | 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. |
phương pháp | |
---|---|
| Tạo một CustomDomain . |
| Xóa CustomDomain được chỉ định. |
| Nhận CustomDomain được chỉ định. |
| Liệt kê từng CustomDomain được liên kết với trang web Lưu trữ chính được chỉ định. |
| Cập nhật CustomDomain được chỉ định. |
| Phục hồi CustomDomain được chỉ định nếu nó đã bị xóa mềm. |