Enviar pedido para um serviço
APLICA-SE A: Developer | Prémio
A set-backend-service
política define a URL de destino da solicitação atual como http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name}
, substituindo parâmetros de modelo por valores especificados na declaração de política.
A política pressupõe que o Dapr seja executado em um contêiner de sidecar no mesmo pod que o gateway. Ao receber a solicitação, o tempo de execução do Dapr executa a descoberta de serviço e a chamada real, incluindo a possível conversão de protocolo entre HTTP e gRPC, tentativas, rastreamento distribuído e tratamento de erros. Saiba mais sobre a integração do Dapr com o Gerenciamento de API.
Nota
Defina os elementos da política e os elementos filho na ordem fornecida na declaração de política. Saiba mais sobre como definir ou editar políticas de Gerenciamento de API.
Declaração de política
<set-backend-service backend-id="dapr" dapr-app-id="app-id" dapr-method="method-name" dapr-namespace="ns-name" />
Atributos
Atributo | Description | Necessário | Predefinição |
---|---|---|---|
ID de back-end | Deve ser definido como "dapr". | Sim | N/A |
dapr-app-id | Nome do microsserviço de destino. Usado para formar o parâmetro appId no Dapr. São permitidas expressões de política. | Sim | N/A |
método dapr | Nome do método ou uma URL a ser invocada no microsserviço de destino. Mapeia para o parâmetro method-name no Dapr. São permitidas expressões de política. | Sim | N/A |
dapr-namespace | Nome do namespace no qual o microsserviço de destino está residindo. Usado para formar o parâmetro appId no Dapr. São permitidas expressões de política. | No | N/A |
Utilização
- Secções políticas: entrada
- Escopos da política: global, produto, API, operação
- Gateways: auto-hospedados
Notas de utilização
O suporte a Dapr deve ser habilitado no gateway auto-hospedado.
Exemplo
O exemplo a seguir demonstra invocar o método chamado "back" no microsserviço chamado "echo". A set-backend-service
política define o URL de destino como http://localhost:3500/v1.0/invoke/echo.echo-app/method/back
. A forward-request
política envia a solicitação para o tempo de execução do Dapr, que a entrega ao microsserviço.
A forward-request
política é mostrada aqui para maior clareza. A política é normalmente "herdada" do âmbito global através da base
palavra-chave.
<policies>
<inbound>
<base />
<set-backend-service backend-id="dapr" dapr-app-id="echo" dapr-method="back" dapr-namespace="echo-app" />
</inbound>
<backend>
<forward-request />
</backend>
<outbound>
<base />
</outbound>
<on-error>
<base />
</on-error>
</policies>
Políticas relacionadas
Conteúdos relacionados
Para obter mais informações sobre como trabalhar com políticas, consulte:
- Tutorial: Transforme e proteja sua API
- Referência de política para uma lista completa de declarações de política e suas configurações
- Expressões de política
- Definir ou editar políticas
- Reutilizar configurações de política
- Recompra de trechos de política
- Kit de ferramentas de política de Gerenciamento de API do Azure
- Criar políticas usando o Microsoft Copilot no Azure