Partilhar via

Web Pub Sub - Revoke Permission

  • Referência
Serviço:
Azure Web PubSub Service
Versão da API:
2024-12-01

Revogar a permissão para a conexão.

DELETE {endpoint}/api/hubs/{hub}/permissions/{permission}/connections/{connectionId}?api-version=2024-12-01
Com parâmetros opcionais: 
DELETE {endpoint}/api/hubs/{hub}/permissions/{permission}/connections/{connectionId}?targetName={targetName}&api-version=2024-12-01

Parâmetros do URI

Name Em Necessário Tipo Description
connectionId
 path True

string

ID da conexão de destino.
endpoint
 path True

string

url

Ponto de extremidade HTTP ou HTTPS para a instância do serviço Web PubSub.
hub
 path True

string

Nome do hub de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.

Padrão Regex: ^[A-Za-z][A-Za-z0-9_`,.[\]]{0,127}$
permission
 path True

WebPubSubPermission

A permissão: as ações suportadas atuais são joinLeaveGroup e sendToGroup.
api-version
 query True

string

A versão das APIs REST.
targetName
 query

string

O significado do alvo depende da permissão específica. Para joinLeaveGroup e sendToGroup, targetName é um parâmetro obrigatório que representa o nome do grupo.

Respostas

Name Tipo Description
204 No Content

Sem conteúdo
Other Status Codes

ErrorDetail

Resposta de erro

Cabeçalhos

x-ms-error-code: string

Exemplos

WebPubSub_RevokePermission

Pedido de amostra

DELETE {endpoint}/api/hubs/hub1/permissions/joinLeaveGroup/connections/connection1?targetName=group1&api-version=2024-12-01

Resposta da amostra

Código de estado:
204

Definições

Name Description
ErrorDetail

O objeto de erro.
InnerError
WebPubSubPermission

A permissão: as ações suportadas atuais são joinLeaveGroup e sendToGroup.

ErrorDetail

Object

O objeto de erro.

Name Tipo Description
code

string

Um de um conjunto de códigos de erro definido pelo servidor.
details

ErrorDetail[]

Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
inner

InnerError

message

string

Uma representação legível por humanos do erro.
target

string

O alvo do erro.

InnerError

Object
Name Tipo Description
code

string

Um código de erro mais específico do que foi fornecido pelo erro que contém.
inner

InnerError

WebPubSubPermission

Enumeration

A permissão: as ações suportadas atuais são joinLeaveGroup e sendToGroup.

Valor Description
joinLeaveGroup
sendToGroup