Envoyer une demande à un service

S’APPLIQUE À : Développeur | Premium

La stratégie set-backend-service définit l’URL cible de la demande actuelle sur http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name}, en remplaçant les paramètres de modèle par les valeurs spécifiées dans la déclaration de stratégie.

La stratégie part du principe que Dapr s’exécute dans un conteneur sidecar se trouvant dans le même pod que la passerelle. Lors de la réception de la demande, le runtime Dapr effectue la détection du service et l’appel réel, en ce compris la traduction de protocole possible entre HTTP et gRPC, les nouvelles tentatives, le suivi distribué et la gestion des erreurs. En savoir plus sur l’intégration de Dapr à Gestion des API.

Notes

Définissez les éléments enfants et de stratégie dans l’ordre fourni dans l’instruction de stratégie. En savoir plus sur comment définir ou modifier des stratégies du service Gestion des API.

Instruction de la stratégie

<set-backend-service backend-id="dapr" dapr-app-id="app-id" dapr-method="method-name" dapr-namespace="ns-name" />

Attributs

Attribut Description Obligatoire Default
id de principal Doit être défini sur « dapr ». Oui N/A
dapr-app-id Nom du microservice cible. Utilisé pour former le paramètre appId dans Dapr. Les expressions de stratégie sont autorisées. Oui N/A
dapr-method Nom de la méthode ou URL à appeler sur le microservice cible. Correspond au paramètre method-name dans Dapr. Les expressions de stratégie sont autorisées. Oui N/A
dapr-namespace Nom de l’espace de noms dans lequel réside le microservice cible. Utilisé pour former le paramètre appId dans Dapr. Les expressions de stratégie sont autorisées. Non N/A

Usage

Notes d’utilisation

La prise en charge de Dapr doit être activée dans la passerelle auto-hébergée.

Exemple

L’exemple suivant illustre l’appel de la méthode nommée « back » sur le microservice nommé « echo ». La stratégie set-backend-service définit l’URL de destination sur http://localhost:3500/v1.0/invoke/echo.echo-app/method/back. La stratégie forward-request distribue la demande au runtime Dapr, qui le remet au microservice.

La stratégie forward-request est présentée ici par souci de clarté. La stratégie est généralement « héritée » de l’étendue globale via le mot clé base.

<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>

Pour plus d’informations sur l’utilisation des stratégies, consultez :