가드레일 버전 생성 및 관리 - Amazon Bedrock
가드레일 버전 생성가드레일 버전에 대한 정보 보기가드레일 버전 삭제

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

가드레일 버전 생성 및 관리

다음 항목에서는 가드레일을 배포할 준비가 되었을 때 해당 버전을 생성하고, 관련 정보를 확인하고, 더 이상 필요하지 않을 때 삭제하는 방법에 대해 설명합니다.

참고

가드레일 버전은 리소스로 간주되지 않으므로 ARN이 없습니다. 가드레일에 적용되는 IAM 정책은 모든 버전에 적용됩니다.

Amazon 베드락 가드레일 버전 만들기

가드레일의 버전을 만드는 방법을 알아보려면 선택한 방법에 해당하는 탭을 선택하고 단계를 따르세요.

Console
버전을 만들려면

  1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/bedrock/ 에서 Amazon Bedrock 콘솔을 엽니다.

  2. Amazon Bedrock 콘솔의 왼쪽 탐색 창에서 가드레일을 선택하고 가드레일 섹션에서 편집하려는 가드레일의 이름을 선택합니다.

  3. 다음 단계 중 하나를 수행하십시오.

    • 버전, 섹션에서 생성을 선택합니다.

    • 작업 중인 초안을 선택하고 페이지 상단에서 버전 생성을 선택합니다.

  4. 버전에 대한 설명 (선택 사항) 을 제공한 다음 버전 생성을 선택합니다.

  5. 성공하면 새 버전이 추가된 버전 목록이 있는 화면으로 리디렉션됩니다.

API

가드레일의 버전을 만들려면 요청을 보내세요. CreateGuardrailVersion ID와 설명 (선택 사항) 을 포함하세요.

요청 형식은 다음과 같습니다.

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 베드락 가드레일 버전에 대한 정보 보기

가드레일의 버전 또는 버전에 대한 정보를 보는 방법을 알아보려면 선택한 방법에 해당하는 탭을 선택하고 단계를 따르십시오.

Console
가드레일 버전에 대한 정보를 보려면

  1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/bedrock/ 에서 Amazon Bedrock 콘솔을 엽니다.

  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 베드락 가드레일의 버전 삭제

가드레일의 버전을 삭제하는 방법을 알아보려면 선택한 방법에 해당하는 탭을 선택하고 단계를 따르세요.

Console

버전이 더 이상 필요하지 않은 경우 다음 단계에 따라 삭제할 수 있습니다.

버전을 삭제하려면 다음을 수행하세요.

  1. 에 AWS Management Console로그인하고 https://console.aws.amazon.com/bedrock/ 에서 Amazon Bedrock 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 가드레일을 선택합니다. 그런 다음 가드레일 섹션에서 가드레일을 선택합니다.

  3. 버전 섹션에서 삭제하려는 버전을 선택하고 삭제를 선택합니다.

  4. 이 버전의 가드레일에 종속된 리소스에 대해 경고하는 모드가 나타납니다. 오류를 방지하려면 삭제하기 전에 리소스에서 버전을 분리하세요.

  5. 사용자 입력 delete 필드에 입력하고 삭제를 선택하여 가드레일 버전을 삭제합니다.

API

가드레일의 버전을 삭제하려면 요청을 보내십시오. DeleteGuardrail 필드에는 가드레일의 ARN을, guardrailIdentifier 필드에는 버전을 지정합니다. guardrailVersion

요청 형식은 다음과 같습니다.

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

삭제에 성공하면 응답은 HTTP 200 상태 코드를 반환합니다.