Method: projects.locations.backends.domains.patch

Aktualizuje informacje o pojedynczej domenie.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
domain.name

string

Identyfikator. Nazwa zasobu domeny, np. /projects/p/locations/l/backends/b/domains/foo.com

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Wymagane. Maska pola służy do określania pól, które mają zostać zastąpione w zasobie domeny w wyniku aktualizacji. Pola określone w updateMask odnoszą się do zasobu, a nie pełnego żądania. Jeśli pole znajduje się w masce, zostanie zastąpione. Jeśli użytkownik nie poda maski, wszystkie pola zostaną zastąpione.

Jest to rozdzielana przecinkami lista w pełni kwalifikowanych nazw pól. Przykład: "user.displayName,photo".
requestId

string

Opcjonalnie. Opcjonalny identyfikator żądania do identyfikowania żądań. Określ unikalny identyfikator żądania, dzięki czemu, jeśli spróbujesz ponownie wysłać żądanie, serwer będzie wiedział, że je zignorować, jeśli zostało już zakończone. Serwer gwarantuje, że będzie to możliwe na co najmniej 60 minut od pierwszego żądania.

Załóżmy na przykład, że wysyłasz pierwsze żądanie, a po jego upływie upływa limit czasu. Jeśli wyślesz żądanie ponownie z tym samym identyfikatorem, serwer może sprawdzić, czy otrzymano pierwotną operację z tym samym identyfikatorem żądania i zignoruje drugie. Zapobiega to przypadkowemu tworzeniu zduplikowanych zobowiązań przez klientów.

Identyfikator żądania musi być prawidłowym identyfikatorem UUID, ale ten identyfikator nie jest obsługiwany (00000000-0000-0000-0000-000000000000).
validateOnly

boolean

Opcjonalnie. Wskazuje, że żądanie powinno zostać zweryfikowane i uzupełnione domyślne bez zachowywania żądania ani modyfikowania żadnych zasobów.
allowMissing

boolean

Opcjonalnie. Jeśli ma wartość true (prawda), a domena nie została znaleziona, zostanie utworzona nowa domena.

Treść żądania

Treść żądania zawiera instancję Domain.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała instancję Operation.

Zakresy autoryzacji

Wymaga następującego zakresu protokołu OAuth:

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

Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).