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