创建和管理护栏版本

以下主题讨论了如何在准备部署时创建护栏版本、查看有关它的信息以及在不再需要时将其删除。

注意

护栏版本不被视为资源，因此没有 ARN。适用于护栏的 IAM 策略适用于其所有版本。

创建 Amazon Bedrock 护栏的版本

要了解如何创建护栏版本，请选择与您选择的方法相对应的选项卡，然后按照步骤操作。

Console

创建版本

1. 登录并打开 Amazon Bedrock 控制台，网址为 https://console.aws.amazon.com/bedrock/。 AWS Management Console

2. 从 Amazon Bedrock 控制台的左侧导航窗格中选择 “护栏”，然后在 “护栏” 部分选择要编辑的护栏名称。

3. 执行以下步骤之一。

   • 在 “版本” 部分中，选择创建。

   • 选择工作草稿并选择页面顶部的 “创建版本”

4. 为版本提供可选描述，然后选择创建版本。

5. 如果成功，您将被重定向到显示已添加新版本的版本列表的屏幕。

API

要创建您的护栏版本，请发送请求。CreateGuardrailVersion包括身份证和可选描述。

请求格式如下：

POST /guardrails/guardrailIdentifier HTTP/1.1
Content-type: application/json


{
  "clientRequestToken": "string",
  "description": "string"
}

响应格式如下：

HTTP/1.1 202
Content-type: application/json

{
   "guardrailId": "string",
   "version": "string"
}

查看有关 Amazon Bedrock 护栏版本的信息

要了解如何查看有关一个或多个版本的护栏的信息，请选择与您选择的方法相对应的选项卡，然后按照步骤操作。

Console

查看有关您的护栏版本的信息

1. 登录并打开 Amazon Bedrock 控制台，网址为 https://console.aws.amazon.com/bedrock/。 AWS Management Console

2. 从左侧导航窗格中选择 “护栏”。然后，在护栏部分选择护栏。

3. 在 “版本” 部分中，选择一个版本以查看有关该版本的信息。

API

要获取有关护栏版本的信息，请发送GetGuardrail请求并附上护栏的 ID 和版本。如果您未指定版本，则响应会返回该DRAFT版本的详细信息。

以下是请求格式：

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

以下是响应格式：

HTTP/1.1 200
Content-type: application/json

{
   "blockedInputMessaging": "string",
   "blockedOutputsMessaging": "string",
   "contentPolicy": { 
      "filters": [ 
         { 
            "inputStrength": "NONE | LOW | MEDIUM | HIGH",
            "outputStrength": "NONE | LOW | MEDIUM | HIGH",
            "type": "SEXUAL | VIOLENCE | HATE | INSULTS | MISCONDUCT | PROMPT_ATTACK"
         }
      ]
   },
    "wordPolicy": {
    "words": [
      {
        "text": "string"
      }
    ],
    "managedWordLists": [
      {
        "type": "string"
      }
    ]
  },
  "sensitiveInformationPolicy": {
    "piiEntities": [
      {
        "type": "string",
        "action": "string"
      }
    ],
    "regexes": [
      {
        "name": "string",
        "description": "string",
        "pattern": "string",
        "action": "string"
      }
    ]
  },
   "createdAt": "string",
   "description": "string",
   "failureRecommendations": [ "string" ],
   "guardrailArn": "string",
   "guardrailId": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "status": "string",
   "statusReasons": [ "string" ],
   "topicPolicy": { 
      "topics": [ 
         { 
            "definition": "string",
            "examples": [ "string" ],
            "name": "string",
            "type": "DENY"
         }
      ]
   },
   "updatedAt": "string",
   "version": "string"
}

要列出有关所有护栏的信息，请发送请求。ListGuardrails

以下是请求格式：

GET /guardrails?guardrailIdentifier=guardrailIdentifier&maxResults=maxResults&nextToken=nextToken HTTP/1.1

• 要列出所有护栏的DRAFT版本，请不要指定该guardrailIdentifier字段。

• 要列出护栏的所有版本，请在字段中指定护栏的 ARN。guardrailIdentifier

您可以在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"
}

删除 Amazon Bedrock 护栏的一个版本

要了解如何删除护栏的某个版本，请选择与您选择的方法相对应的选项卡，然后按照步骤操作。

Console

如果您不再需要某个版本，则可以通过以下步骤将其删除。

删除版本

1. 登录并打开 Amazon Bedrock 控制台，网址为 https://console.aws.amazon.com/bedrock/。 AWS Management Console

2. 从左侧导航窗格中选择 “护栏”。然后，在护栏部分选择护栏。

3. 在 “版本” 部分，选择要删除的版本，然后选择 “删除”。

4. 模式似乎会警告您注意依赖于此版本护栏的资源。为了避免出错，请在删除之前取消版本与资源的关联。

5. delete在用户输入字段中输入并选择删除以删除护栏版本。

API

要删除某个版本的护栏，请发送请求。DeleteGuardrail在字段中指定护栏的 ARN，在guardrailIdentifier字段中指定版本。guardrailVersion

以下是请求格式：

DELETE /guardrails/guardrailIdentifier?guardrailVersion=guardrailVersion HTTP/1.1

如果删除成功，则响应将返回 HTTP 200 状态码。