Pular para o conteúdo principal
PUT
Definir ou rotacionar uma credencial de fila

Autorizações

Authorization
string
header
obrigatório

Um JWT bearer emitido pelo plugin-auth (lib-auth). A identidade do tenant é resolvida a partir das claims validadas do token; a superfície /v1 nunca lê um tenant do corpo, do path ou da query. Chamadores de máquina obtêm um token via o fluxo client-credentials do plugin-auth. A superfície /admin autoriza contra um escopo de operador e não carrega contexto de tenant.

Parâmetros de caminho

id
string<uuid>
obrigatório

The unique identifier of the subscription (UUIDv7).

Corpo

application/json

The queue-credential body. sinkConfig is a kind-specific, write-only object that is probed and, on success, stored encrypted. It is never returned on any read path.

sinkConfig
object
obrigatório

The candidate outbound credential for the queue kind. For rabbitmq, an object such as {"uri":"amqps://user:pass@broker.example.com:5671/vhost"}; for AWS kinds, the region and access material. Write-only — never logged or returned.

Exemplo:

Resposta

A sondagem rodou; o corpo carrega o resultado classificado. Em caso de sucesso a credencial foi persistida e a assinatura está active; em uma falha classificada nada foi persistido.

The classified result of a synchronous probe (ping, verify, or credential write). A classified failure is still returned with HTTP 200 — the probe ran and produced a verdict. It carries no secret, endpoint, or detail string.

outcome
enum<string>
obrigatório

The classified verdict of a synchronous probe.

Opções disponíveis:
ok,
failed
statusCode
integer
obrigatório

The target's protocol status. For webhook probes, the HTTP status (0 when none applies, e.g. a transport error or a blocked endpoint). For queue-kind credential probes, always 0.

Exemplo:

200

errorClass
string
obrigatório

A frozen taxonomy token classifying a failure. Empty on success.

Exemplo:

""