Realizar uma operação PUT em um recurso de permissão específico substitui todo o recurso do usuário. Todas as propriedades configuráveis do usuário, a ID, permissionMode e recurso, devem ser enviadas no corpo para realizar a substituição. Embora todas as propriedades configuráveis precisem ser enviadas no corpo da solicitação, nem todas as propriedades precisam ter alterações. Um novo token de recurso é criado na substituição bem-sucedida da permissão. O novo token de recurso expira em uma hora, que é o período padrão, a menos que seja substituído usando o cabeçalho x-ms-documentdb-expiry-seconds .
Observe que {databaseaccount} é o nome da conta do Azure Cosmos DB criada em sua assinatura. O valor {db-id} é o nome/id gerado pelo usuário do banco de dados, não a ID gerada pelo sistema (rid). O valor {user-name} é o nome do usuário. O valor de {permission-name} é o nome da permissão a ser substituída.
O período de validade do token de recurso retornado pela operação. Por padrão, um token de recursos é válido para uma hora. Para substituir o padrão, defina esse cabeçalho com o período de validade desejado em segundos. O valor máximo de substituição é 18.000, ou seja, cinco horas.
Corpo
Propriedade
Obrigatório
Descrição
id
Obrigatório
É um nome exclusivo que identifica a permissão, ou seja, nenhuma duas permissões pertencentes a um usuário podem compartilhar a mesma ID. A ID não deve exceder 255 caracteres
permissionMode
Obrigatório
O modo de acesso no recurso para o usuário: Tudo ou Leitura.
Tudo fornece acesso de leitura, gravação e exclusão a um recurso.
Leitura restringe o usuário para o recurso de acesso de leitura.
recurso
Obrigatório
O caminho totalmente endereçável do recurso associado com a permissão. Por exemplo, dbs/volcanodb/colls/volcano1.
A tabela a seguir lista os códigos de status comuns retornados por esta operação. Para obter uma lista completa de códigos de status, consulte Códigos de status HTTP.
Código de status HTTP
Descrição
200 Ok
A operação de substituição foi bem-sucedida.
400 Solicitação Inválida
O corpo JSON é inválido. Verifique por colchetes ou aspas ausentes. Além disso, 400 é retornado quando pelo menos uma das propriedades definíveis não está no corpo da solicitação. Verifique se todas as três propriedades configuráveis estão incluídas.
404 Não Encontrado
O usuário a ser substituído não é mais um recurso, ou seja, a permissão foi excluída.
409 Conflito
A ID fornecida para a permissão foi obtida por uma permissão existente. 409 também é retornado quando a nova permissão já foi atribuída a outra permissão para o usuário.
Corpo
Propriedade
Descrição
_Livrar
É uma propriedade gerada pelo sistema. A ID do recurso (_rid) é um identificador exclusivo que também é hierárquico de acordo com a pilha de recursos no modelo de recurso. É usada internamente para posicionamento e navegação do recurso de permissão.
_Ts
É uma propriedade gerada pelo sistema. Especifica o último carimbo de data/hora atualizado do recurso. O valor é um carimbo de data/hora.
_Auto
É uma propriedade gerada pelo sistema. É o URI endereçável exclusivo do recurso.
_Etag
É uma propriedade gerada pelo sistema que representa a etag de recurso necessária para o controle de simultaneidade otimista.
_Token
É um token de recurso gerado pelo sistema para o recurso e o usuário específicos.