Provedení operace PUT u konkrétního prostředku oprávnění nahradí celý prostředek uživatele. Všechny uživatelem nastavitelné vlastnosti, id, permissionMode a prostředek, musí být odeslány v těle, aby bylo možné provést nahrazení. I když se všechny nastavitelné vlastnosti musí odeslat v textu požadavku, ne všechny vlastnosti musí mít změny. Po úspěšném nahrazení oprávnění se vytvoří nový token prostředku. Platnost nového tokenu prostředku vyprší za jednu hodinu, což je výchozí období, pokud ho nepřepíšete pomocí hlavičky x-ms-documentdb-expiry-seconds .
Všimněte si, že {databaseaccount} je název účtu služby Azure Cosmos DB vytvořeného v rámci vašeho předplatného. Hodnota {db-id} je uživatelem vygenerované jméno nebo id databáze, nikoli id (RID) generované systémem. Hodnota {user-name} je jméno uživatele. Hodnota {permission-name} je název oprávnění, které se má nahradit.
Doba platnosti tokenu prostředku vráceného operací. Ve výchozím nastavení je token prostředku platný po dobu jedné hodiny. Pokud chcete výchozí nastavení přepsat, nastavte v této hlavičce požadovanou dobu platnosti v sekundách. Maximální hodnota přepsání je 18000, což je pět hodin.
Text
Vlastnost
Povinné
Popis
id
Vyžadováno
Jedná se o jedinečný název, který identifikuje oprávnění, to znamená, že žádná dvě oprávnění vlastněná uživatelem nemohou sdílet stejné ID. ID nesmí být delší než 255 znaků.
permissionMode
Vyžadováno
Režim přístupu k prostředku pro uživatele: Vše nebo Číst.
Vše poskytuje přístup ke čtení, zápisu a odstranění prostředku.
Čtení omezuje uživatele na přístup ke čtení prostředku.
Zdrojů
Vyžadováno
Úplná adresovatelná cesta prostředku přidruženého k oprávnění. Například dbs/volcanodb/colls/volcano1.
Následující tabulka obsahuje seznam běžných stavových kódů vrácených touto operací. Úplný seznam stavových kódů najdete v tématu Stavové kódy HTTP.
Stavový kód HTTP
Popis
200 Ok
Operace nahrazení byla úspěšná.
400 – Chybný požadavek
Text JSON je neplatný. Zkontrolujte, jestli nechybí složené závorky nebo uvozovky. Kromě toho se vrátí hodnota 400, pokud v textu požadavku není alespoň jedna z nastavitelných vlastností. Zkontrolujte, jestli jsou zahrnuté všechny tři nastavitelné vlastnosti.
404 Nenalezeno
Uživatel, který má být nahrazen, již není prostředkem, to znamená, že oprávnění bylo odstraněno.
409 – Konflikt
ID zadané pro oprávnění bylo převzato existujícím oprávněním. 409 se vrátí také v případě, že nové oprávnění již bylo přiřazeno jinému oprávnění pro uživatele.
Text
Vlastnost
Popis
_Zbavit
Jedná se o systémem vygenerovanou vlastnost. ID prostředku (_rid) je jedinečný identifikátor, který je také hierarchický podle zásobníku prostředků v modelu prostředků. Používá se interně k umístění a navigaci prostředku oprávnění.
_Ts
Jedná se o systémem vygenerovanou vlastnost. Určuje časové razítko poslední aktualizace prostředku. Hodnota je časové razítko.
_Vlastní
Jedná se o systémem vygenerovanou vlastnost. Jedná se o jedinečný adresovatelný identifikátor URI prostředku.
_Etag
Jedná se o systémem vygenerovanou vlastnost, která představuje etag prostředku vyžadovanou pro optimistické řízení souběžnosti.
_Token
Jedná se o systémem vygenerovaný token prostředku pro konkrétní prostředek a uživatele.