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
- Sections de la stratégie : inbound
- Étendues de la stratégie : global, product, API, operation
- Passerelles : auto-hébergées
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>
Stratégies connexes
Contenu connexe
Pour plus d’informations sur l’utilisation des stratégies, consultez :
- Tutoriel : Transformer et protéger votre API
- Référence de stratégie pour obtenir la liste complète des instructions et des paramètres de stratégie
- Expressions de stratégie
- Définir ou modifier des stratégies
- Réutilisation de configurations de stratégie
- Référentiel d’extrait de stratégie
- Créer des stratégies à l’aide de Microsoft Copilot dans Azure