Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de l’API
<a name="guardrails-use-invoke-guardrail-checks-using"></a>

Pour effectuer des contrôles de sécurité, envoyez une `InvokeGuardrailChecks` demande au point de terminaison Amazon Bedrock Runtime.

## Format des demandes
<a name="guardrails-use-invoke-guardrail-checks-request"></a>

```
{
  "messages": [
    {
      "role": "user",
      "content": [{ "text": "string" }]
    }
  ],
  "checks": {
    "contentFilter": {
      "categories": [
        { "category": "VIOLENCE | HATE | SEXUAL | INSULTS | MISCONDUCT" }
      ]
    },
    "promptAttack": {
      "categories": [
        { "category": "JAILBREAK | PROMPT_INJECTION | PROMPT_LEAKAGE" }
      ]
    },
    "sensitiveInformation": {
      "entities": [
        { "type": "EMAIL | PHONE | US_SOCIAL_SECURITY_NUMBER | ..." }
      ]
    }
  }
}
```
+ `messages` : obligatoire. Au moins un message avec un bloc de contenu textuel.
+ `checks` : obligatoire. Au moins un champ de contrôle doit être défini.

## Format de la réponse
<a name="guardrails-use-invoke-guardrail-checks-response"></a>

```
{
  "results": {
    "contentFilter":        { "results": [ ... ] },
    "promptAttack":         { "results": [ ... ] },
    "sensitiveInformation": { "results": [ ... ], "truncated": false }
  },
  "usage": {
    "contentFilter":        { "textUnits": 0 },
    "promptAttack":         { "textUnits": 0 },
    "sensitiveInformation": { "textUnits": 0 }
  }
}
```

Seuls les chèques que vous avez demandés apparaissent sous `results` et`usage`. Chaque `textUnits` valeur est le nombre d'unités de texte évaluées par le contrôle. Pour la définition d'une unité de texte, consultez la [tarification d'Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/).

## Erreurs
<a name="guardrails-use-invoke-guardrail-checks-errors"></a>

Le tableau suivant répertorie les erreurs que l'`InvokeGuardrailChecks`API peut renvoyer.


**InvokeGuardrailChecks Erreurs d'API**  

| Code HTTP | Erreur | Cause | 
| --- | --- | --- | 
| 400 | ValidationException | La demande est mal formée, ne contient pas de champs obligatoires ou enfreint une contrainte. | 
| 403 | AccessDeniedException | L'appelant n'est pas autorisé à appeler l'API. | 
| 429 | ThrottlingException | Le taux de demandes a dépassé le quota du compte. Réessayez avec un recul exponentiel. | 
| 500 | InternalServerException | Le service a rencontré une erreur inattendue. Réitérez la demande. | 
| 503 | ServiceUnavailableException | Le service est temporairement indisponible. Réessayez avec un recul exponentiel. |