Enviar mensagem para o tópico de Publicação/Assinatura

  • Artigo

APLICA-SE A: Desenvolvedor | Premium

Essa política publish-to-dapr instrui o gateway de Gerenciamento de API a enviar uma mensagem para um tópico de Publicação/Assinatura do Dapr. A política faz isso realizando uma solicitação HTTP POST para http://localhost:3500/v1.0/publish/{{pubsub-name}}/{{topic}}, substituindo parâmetros do modelo e adicionando conteúdos especificados na instrução da política.

A política pressupõe que o runtime do Dapr está sendo executado em um contêiner sidecar no mesmo pod que o gateway. O runtime do Dapr implementa a semântica de Publicação/Assinatura. Saiba mais sobre a integração do Dapr ao Gerenciamento de API.

Observação

Defina os elementos da política e os elementos filho na ordem fornecida na declaração da política. Saiba mais sobre como definir e editar as políticas de Gerenciamento de API.

Declaração de política

<publish-to-dapr pubsub-name="pubsub-name" topic="topic-name" ignore-error="false|true" response-variable-name="resp-var-name" timeout="in seconds" template="Liquid" content-type="application/json">
    <!-- message content -->
</publish-to-dapr>

Atributos

Atributo Descrição Obrigatório Padrão
pubsub-name Nome do componente de destino do PubSub. É mapeado para o parâmetro pubsubname do Dapr. Se não estiver presente, o valor do atributo topic deverá estar no formato de pubsub-name/topic-name. Expressões de política são permitidas. Não Nenhum
topic O nome do tópico. É mapeado para o parâmetro topic do Dapr. Expressões de política são permitidas. Sim N/D
ignore-error Se definido como true, instrui a política para não disparar a seção "on-error" ao receber o erro do runtime do Dapr. Expressões de política não são permitidas. Não false
response-variable-name Nome da entrada da coleção Variables a ser usada para armazenar a resposta do runtime do Dapr. Expressões de política não são permitidas. Não Nenhum
tempo limite Tempo (em segundos) a aguardar para o runtime do Dapr responder. Pode variar de 1 a 240 segundos. Expressões de política são permitidas. Não 5
template Mecanismo de modelagem a ser usado para transformar o conteúdo da mensagem. "Liquid" é o único valor com suporte. Não Nenhum
content-type Tipo de conteúdo da mensagem. "application/json" é o único valor com suporte. Não Nenhum

Uso

Observações de uso

O suporte ao Dapr deve ser habilitado no gateway auto-hospedado.

Exemplo

O exemplo a seguir demonstra o envio do corpo da solicitação atual para o tópico "novo" do componente de Publicação/Assinatura "orders". A resposta recebida do runtime do Dapr é armazenada na entrada "dapr-response" da coleção Variables do objeto context.

Se o runtime do Dapr não for capaz de localizar o tópico de destino, por exemplo, e responder com um erro, a seção "on-error" será disparada. A resposta recebida do runtime do Dapr será retornada ao chamador na íntegra. Caso contrário, a resposta padrão 200 OK será retornada.

A seção "back-end" está vazia e a solicitação não será encaminhada para o back-end.

<policies>
     <inbound>
        <base />
        <publish-to-dapr
           pubsub-name="orders"
               topic="new"
               response-variable-name="dapr-response">
            @(context.Request.Body.As<string>())
        </publish-to-dapr>
    </inbound>
    <backend>
    </backend>
    <outbound>
        <base />
    </outbound>
    <on-error>
        <base />
        <return-response response-variable-name="pubsub-response" />
    </on-error>
</policies>

Conteúdo relacionado

Para obter mais informações sobre como trabalhar com políticas, consulte: