翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# API を使用する場合
<a name="guardrails-use-invoke-guardrail-checks-using"></a>

ガードレールチェックを実行するには、Amazon Bedrock ランタイムエンドポイントに`InvokeGuardrailChecks`リクエストを送信します。

## リクエストの形式
<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` – 必須。少なくとも 1 つのメッセージと 1 つのテキストコンテンツブロック。
+ `checks` – 必須。少なくとも 1 つのチェックフィールドを設定する必要があります。

## レスポンスの形式
<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 }
  }
}
```

リクエストしたチェックのみが `results`と の下に表示されます`usage`。各`textUnits`値は、チェックで評価されたテキスト単位の数です。テキスト単位の定義については、[「Amazon Bedrock の料金](https://aws.amazon.com/bedrock/pricing/)」を参照してください。

## エラー
<a name="guardrails-use-invoke-guardrail-checks-errors"></a>

次の表に、`InvokeGuardrailChecks`API が返すことができるエラーを示します。


**InvokeGuardrailChecks API エラー**  

| HTTP コード | エラー | 原因 | 
| --- | --- | --- | 
| 400 | ValidationException | リクエストの形式が正しくないか、必須フィールドがないか、制約に違反しています。 | 
| 403 | AccessDeniedException | 呼び出し元には API を呼び出す権限がありません。 | 
| 429 | ThrottlingException | リクエストレートがアカウントのクォータを超えました。エクスポネンシャルバックオフで再試行します。 | 
| 500 | InternalServerException | サービス中に予期しないエラーが発生しました。リクエストを再試行します。 | 
| 503 | ServiceUnavailableException | サービスが一時的に使用できません エクスポネンシャルバックオフで再試行します。 |