Method: projects.locations.backends.domains.patch

Cập nhật thông tin cho một miền.

yêu cầu HTTP

PATCH https://firebaseapphosting.googleapis.com/v1beta/{domain.name=projects/*/locations/*/backends/*/domains/*}

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

Tham số đường dẫn

Thông số
domain.name

string

Giá trị nhận dạng. Tên tài nguyên của miền, ví dụ: /projects/p/locations/l/backends/b/domains/foo.com

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Bắt buộc. Mặt nạ trường dùng để chỉ định các trường cần ghi đè trong Tài nguyên miền khi cập nhật. Các trường được chỉ định trong updateMask liên quan đến tài nguyên, chứ không phải toàn bộ yêu cầu. Một trường sẽ bị ghi đè nếu nằm trong mặt nạ. Nếu người dùng không cung cấp mặt nạ thì tất cả các trường sẽ bị ghi đè.

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

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 sửa đổi bất kỳ tài nguyên nào.

allowMissing

boolean

Không bắt buộc. Nếu bạn đặt chính sách này thành true nhưng hệ thống không tìm thấy miền này, thì một miền mới sẽ được tạ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ể 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.