Method: projects.locations.backends.domains.create

Liên kết một miền mới với phần phụ trợ.

yêu cầu HTTP

POST https://firebaseapphosting.googleapis.com/v1beta/{parent=projects/*/locations/*/backends/*}/domains

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Phần phụ trợ mẹ ở định dạng:

projects/{project}/locations/{locationId}/backends/{backendId}.

Tham số truy vấn

Thông số
domainId

string

Bắt buộc. Mã của miền cần tạo. Phải là một tên miền hợp lệ.

requestId

string

Không bắt buộc. Mã yêu cầu (không bắt buộc) dùng để xác định các yêu cầu. Hãy chỉ định một mã yêu cầu duy nhất để nếu bạn phải thử lại yêu cầu của mình, máy chủ sẽ biết để bỏ qua yêu cầu nếu yêu cầu đã hoàn tất. Máy chủ sẽ đảm bảo việc đó trong ít nhất 60 phút kể từ yêu cầu đầu tiên.

Ví dụ: hãy xem xét một tình huống trong đó bạn đưa ra yêu cầu ban đầu và yêu cầu hết giờ. Nếu bạn gửi lại yêu cầu với cùng mã yêu cầu, máy chủ có thể kiểm tra xem thao tác ban đầu có cùng mã yêu cầu đó đã được nhận hay chưa. Nếu có, máy chủ sẽ bỏ qua yêu cầu thứ hai. Điều này giúp tránh việc khách hàng vô tình tạo cam kết trùng lặp.

Mã yêu cầu phải là một mã nhận dạng duy nhất (UUID) hợp lệ, ngoại trừ việc không hỗ trợ mã nhận dạng duy nhất (UUID) nào (00000000-0000-0000-0000-000000000000).

validateOnly

boolean

Không bắt buộc. Cho biết yêu cầu cần được xác thực và điền các giá trị mặc định mà không cần duy trì yêu cầu hoặc tạo bất kỳ tài nguyên nào.

Nội dung yêu cầu

Phần nội dung yêu cầu chứa một thực thể của Domain.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của Operation.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau đây:

  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem bài viết Tổng quan về việc xác thực.