本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 查看关于护栏的信息
<a name="guardrails-view"></a>

您可以按照 AWS 控制台或 API 的以下步骤查看有关护栏的信息：

------
#### [ Console ]

**查看关于护栏版本和设置的信息**

1. 使用有权使用 Amazon Bedrock 控制台的 IAM 身份登录。 AWS 管理控制台 然后，在 [https://console.aws.amazon.com/](https://console.aws.amazon.com/bedrock)bedrock 上打开 Amazon Bedrock 控制台。

1. 从左侧导航窗格中选择**护栏**。然后，在**护栏**部分选择一项护栏。

1. **护栏概述**部分显示了适用于所有版本的护栏配置。

1. 要查看关于工作草稿的更多信息，请在**工作草稿**部分选择**工作草稿**。

1. 要查看关于护栏特定版本的更多信息，请在**版本**部分选择相应的版本。

要了解关于工作草稿和护栏版本的更多信息，请参阅[部署护栏](guardrails-deploy.md)。

------
#### [ API ]

要获取有关护栏的信息，请发送[GetGuardrail](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_GetGuardrail.html)请求并附上护栏的 ID 和版本。如果您不指定版本，响应将返回 `DRAFT` 版本的详细信息。

请求的格式如下：

```
GET /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1
```

响应的格式如下：

```
HTTP/1.1 200
Content-type: application/json

{
  "topicPolicy": {
    "topics": [
      {
        "definition": "string",
        "examples": [
          "string"
        ],
        "name": "string",
        "type": "DENY"
      }
    ]
  },
  "contentPolicy": {
    "filters": [
      {
        "type": "string",
        "inputStrength": "string",
        "outputStrength": "string"
      }
    ]
  },
  "wordPolicy": {
    "words": [
      {
        "text": "string"
      }
    ],
    "managedWordLists": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicy": {
    "piiEntities": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexes": [
      {
        "name": "string",
        "description": "string",
        "regex": "string",
        "action": "string"
      }
    ]
  },
  "contextualGroundingPolicy": {
    "groundingFilter": {
      "threshold": float
    },
    "relevanceFilter": {
      "threshold": float
    }
  },
  "createdAt": "string",
  "blockedInputMessaging": "string",
  "blockedOutputsMessaging": "string",
  "description": "string",
  "failureRecommendations": [
    "string"
  ],
  "guardrailArn": "string",
  "guardrailId": "string",
  "kmsKeyArn": "string",
  "name": "string",
  "status": "string",
  "statusReasons": [
    "string"
  ],
  "updatedAt": "string",
  "version": "string"
}
```

要列出有关您所有护栏的信息，请发送请求。[ListGuardrails](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListGuardrails.html)

请求的格式如下：

```
GET /guardrails?guardrailIdentifier=guardrailIdentifier&maxResults=maxResults&nextToken=nextToken HTTP/1.1
```
+ 要列出所有护栏的 `DRAFT` 版本，请不要指定 `guardrailIdentifier` 字段。
+ 要列出护栏的所有版本，请在 `guardrailIdentifier` 字段中指定护栏的 ARN。

您可以在 `maxResults` 字段中设置响应中返回的结果数量上限。如果结果数超过您设置的值，响应会返回 `nextToken`，您可以再发送一个 `ListGuardrails` 请求并在其中包含它，以查看下一批结果。

响应的格式如下：

```
HTTP/1.1 200
Content-type: application/json

{
   "guardrails": [ 
      { 
         "arn": "string",
         "createdAt": "string",
         "description": "string",
         "id": "string",
         "name": "string",
         "status": "string",
         "updatedAt": "string",
         "version": "string"
      }
   ],
   "nextToken": "string"
}
```

------