本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 檢視防護機制的相關資訊
<a name="guardrails-view"></a>

您可以依照 AWS 主控台或 API 的下列步驟來檢視護欄的相關資訊：

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

**檢視防護機制版本和設定的相關資訊**

1.  AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/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` 欄位中在回應中傳回的結果數量上限。如果結果數目多於您設定的數目，回應會傳回您可以在另一個 `ListGuardrails` 請求中傳送的 `nextToken`，如此即可查看下一批結果。

回應格式如下：

```
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"
}
```

------