Wykonanie operacji PUT dla określonego zasobu uprawnień zastępuje cały zasób użytkownika. Wszystkie właściwości zestawu użytkownika, identyfikator, permissionMode i zasób muszą zostać przesłane w treści, aby wykonać zamianę. Podczas gdy wszystkie właściwości tabeli settable muszą zostać przesłane w treści żądania, nie wszystkie właściwości muszą mieć zmiany. Nowy token zasobu jest tworzony po pomyślnym zastąpieniu uprawnienia. Nowy token zasobu wygasa w ciągu jednej godziny, która jest okresem domyślnym, chyba że zostanie zastąpiony przy użyciu nagłówka x-ms-documentdb-expiry-seconds .
Pamiętaj, że {databaseaccount} jest nazwą konta usługi Azure Cosmos DB utworzonego w ramach subskrypcji. Wartość {db-id} to wygenerowana przez użytkownika nazwa/identyfikator bazy danych, a nie identyfikator wygenerowany przez system (rid). Wartość {user-name} jest nazwą użytkownika. Wartość {permission-name} to nazwa uprawnienia do zastąpienia.
Okres ważności tokenu zasobu zwrócony przez operację. Domyślnie token zasobu jest ważny przez jedną godzinę. Aby zastąpić wartość domyślną, ustaw ten nagłówek z żądanym okresem ważności w sekundach. Maksymalna wartość przesłonięcia to 18000, czyli pięć godzin.
Treść
Właściwość
Wymagane
Opis
id
Wymagane
Jest to unikatowa nazwa, która identyfikuje uprawnienie, tj. żadne dwa uprawnienia należące do użytkownika mogą współużytkować ten sam identyfikator. Identyfikator nie może przekraczać 255 znaków
permissionMode
Wymagane
Tryb dostępu dla zasobu użytkownika: Wszystko lub Odczyt.
Wszystkie zapewniają dostęp do odczytu, zapisu i usuwania zasobu.
Odczyt ogranicza użytkownikowi dostęp do odczytu w zasobie.
Zasobów
Wymagane
Pełna ścieżka adresowa zasobu skojarzonego z uprawnieniem. Na przykład dbs/volcanodb/colls/volcano1.
Poniższa tabela zawiera listę typowych kodów stanu zwracanych przez tę operację. Aby uzyskać pełną listę kodów stanu, zobacz Kody stanu HTTP.
Kod stanu HTTP
Opis
200 OK
Operacja zastępowania zakończyła się pomyślnie.
400 Nieprawidłowe żądanie
Treść JSON jest nieprawidłowa. Sprawdź brakujące nawiasy klamrowe lub cudzysłowy. Ponadto zwracana jest wartość 400, gdy co najmniej jedna z właściwości tabeli settable nie znajduje się w treści żądania. Sprawdź, czy uwzględniono wszystkie trzy właściwości tabeli settable.
404 — Nie znaleziono
Użytkownik, który ma zostać zastąpiony, nie jest już zasobem, czyli uprawnienie zostało usunięte.
409 Konflikt
Identyfikator podany dla uprawnienia został przejęty przez istniejące uprawnienie. 409 jest również zwracany, gdy nowe uprawnienie zostało już przypisane do innego uprawnienia dla użytkownika.
Treść
Właściwość
Opis
_Rid
Jest to właściwość wygenerowana przez system. Identyfikator zasobu (_rid) to unikatowy identyfikator, który jest również hierarchiczny dla stosu zasobów w modelu zasobów. Jest on używany wewnętrznie do umieszczania i nawigacji zasobu uprawnień.
_Ts
Jest to właściwość wygenerowana przez system. Określa ostatni zaktualizowany znacznik czasu zasobu. Wartość jest znacznikiem czasu.
_Własny
Jest to właściwość wygenerowana przez system. Jest to unikatowy adresowy identyfikator URI zasobu.
_Etag
Jest to właściwość wygenerowana przez system, która reprezentuje tag zasobu wymagany do optymistycznej kontroli współbieżności.
_Tokenu
Jest to token zasobu wygenerowany przez system dla określonego zasobu i użytkownika.