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

# 가드레일 정보 확인
<a name="guardrails-view"></a>

 AWS 콘솔 또는 API에 대한 다음 단계에 따라 가드레일에 대한 정보를 볼 수 있습니다.

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

**가드레일 버전 및 설정에 대한 정보를 확인하는 방법**

1. Amazon Bedrock 콘솔을 사용할 권한이 있는 IAM 자격 증명 AWS Management Console 으로에 로그인합니다. 그 다음 [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` 필드에 설정할 수 있습니다. 설정한 수보다 많은 결과가 있는 경우 응답에서 `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"
}
```

------