# 레지스트리 생성 및 관리
**예정된 네임스페이스 마이그레이션**
AWS 에이전트 레지스트리는 현재 bedrock-agentcore 네임스페이스에서 공개 미리 보기 중입니다. 2026년 8월 6일부터 서비스는 에이전트 레지스트리 네임스페이스로 이동합니다. AWS 에이전트 레지스트리를 사용하는 경우 엔드포인트, IAM 정책, SDK 클라이언트, CLI 스크립트 및 레지스트리 데이터를 업데이트해야 합니다. 공개 미리 보기에서 마이그레이션하는 방법에 대한 자세한 내용은 [포괄적인 레지스트리 마이그레이션 가이드를](registry-faq.md) 참조하세요.
## 레지스트리 생성
### 콘솔
1. [Amazon Bedrock AgentCore 콘솔](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#)을 엽니다.
1. 탐색 창의 **검색**에서 **레지스트리**를 선택합니다.
1. **레지스트리** 섹션에서 **레지스트리 생성을** 선택합니다.
1. **이름**에 레지스트리의 이름을 입력합니다. 이름은 문자 또는 숫자로 시작해야 합니다. 유효한 문자는 a-z, A-Z, 0-9, \_(밑줄), -(하이픈), .(점) 및 /(슬래시)입니다. 이름은 최대 64자까지 가능합니다.
1. (선택 사항) **추가 세부 정보를** 확장하고 **설명**(1\~4,096자)을 입력합니다.
1. (선택 사항) **API 권한 부여 검색을** 확장하여 레지스트리를 검색할 때 소비자가 권한을 부여하는 방법을 구성합니다(인바운드 권한 부여). 표준 AWS 자격 증명을 사용하려면 ** AWS IAM**을 선택하고 **기업 자격 증명 공급자 자격 증명을 사용하려면 JSON 웹 토큰(JWT)**을 선택합니다. JWT를 선택하면 Cognito로 빠르게 생성하거나 검색 URL, 대상, 범위, 사용자 지정 클레임 및 클라이언트를 제공하여 자체 IdP를 가져올 수 있습니다.
1. **레코드 승인**에서 **자동 승인을** 활성화할지 여부를 선택합니다. 자동 승인이 꺼져 있으면 큐레이터가 각 레코드를 검토하고 승인해야 검색할 수 있습니다.
1. **레지스트리 생성을** 선택합니다.
레지스트리 상태는 **생성** 중으로 시작되고 프로비저닝이 완료되면 **준비**됨으로 전환됩니다.
**참고**
JWT 지원 레지스트리의 경우 허용된 대상, 허용된 클라이언트, 허용된 범위 또는 사용자 지정 클레임과 같은 하나 이상의 **JWT 권한 부여 구성** 필드가 필요합니다. 둘 이상의를 구성하는 경우 AWS 에이전트 레지스트리는 모든 항목을 확인합니다.
### AWS CLI
**IAM 기반 레지스트리:**
```
aws bedrock-agentcore-control create-registry \
--name "MyRegistry" \
--description "Production registry" \
--region us-east-1
```
**JWT 기반 레지스트리:**
```
aws bedrock-agentcore-control create-registry \
--name "MyOAuthRegistry" \
--authorizer-type CUSTOM_JWT \
--authorizer-configuration '{"customJWTAuthorizer": {"discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com//.well-known/openid-configuration", "allowedClients": [""]}}' \
--region us-east-1
```
### AWS SDK
**IAM 기반 레지스트리:**
```
import boto3
client = boto3.client('bedrock-agentcore-control')
response = client.create_registry(
name='MyRegistry',
description='Production registry'
)
print(response['registryArn'])
```
**JWT 기반 레지스트리:**
```
import boto3
client = boto3.client('bedrock-agentcore-control')
response = client.create_registry(
name='MyOAuthRegistry',
authorizerType='CUSTOM_JWT',
authorizerConfiguration={
'customJWTAuthorizer': {
'discoveryUrl': 'https://cognito-idp.us-east-1.amazonaws.com//.well-known/openid-configuration',
'allowedClients': ['']
}
}
)
print(response['registryArn'])
```
## 레지스트리 나열
### 콘솔
1. [Amazon Bedrock AgentCore 콘솔](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#)을 엽니다.
1. 탐색 창의 **검색**에서 **레지스트리**를 선택합니다.
1. **레지스트리** 테이블에는 계정의 모든 레지스트리가 다음 열과 함께 표시됩니다.
1. **이름** - 레지스트리 이름(세부 정보 페이지에 연결됨).
1. **설명** - 제공된 경우 레지스트리 설명입니다.
1. **권한 부여 유형** - 인바운드 권한 부여 방법(AWS\_IAM 또는 CUSTOM\_JWT).
1. **상태** - 현재 상태(생성 중, 준비됨, 업데이트 중, 삭제 중 또는 실패 상태).
1. **ARN** - 레지스트리 Amazon 리소스 이름입니다.
1. **생성됨** - 생성 타임스탬프입니다.
1. **최종 업데이트** - 마지막 수정 타임스탬프입니다.
1. **레지스트리 찾기** 검색 창을 사용하여 이름을 기준으로 필터링합니다.
1. 페이지 매김 컨트롤을 사용하여 결과를 탐색합니다.
### AWS CLI
```
aws bedrock-agentcore-control list-registries \
--region us-east-1
```
### AWS SDK
```
import boto3
client = boto3.client('bedrock-agentcore-control')
response = client.list_registries()
for registry in response['registries']:
print(f"{registry['name']} - {registry['status']} - {registry['registryArn']}")
```
## 레지스트리 세부 정보 보기
### 콘솔
1. [Amazon Bedrock AgentCore 콘솔](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#)을 엽니다.
1. 탐색 창의 **검색**에서 **레지스트리**를 선택합니다.
1. 레지스트리 테이블에서 **레지스트리** 이름을 선택합니다.
1. 레지스트리 세부 정보 페이지에는 두 개의 탭이 있습니다.
1. **레코드 관리** - 레지스트리 레코드를 보고 관리합니다.
1. **레코드 검색** - 레지스트리에서 승인된 레코드를 검색합니다.
1. **레지스트리 세부 정보** 섹션에는 이름, 상태, 설명, 자동 승인(활성화 또는 비활성화), 레지스트리 ARN, 마지막 업데이트 날짜, 생성 날짜가 표시됩니다.
1. **레지스트리 레코드** 섹션에는 상태 요약 카운터(총 제출됨, 승인 보류 중, 승인됨, 사용 중단됨, 거부됨)와 레코드 테이블이 표시됩니다.
1. **검색 API 권한 부여**(인바운드 권한 부여) 섹션에는 현재 권한 부여 유형이 표시됩니다.
### AWS CLI
```
aws bedrock-agentcore-control get-registry \
--registry-id "" \
--region us-east-1
```
### AWS SDK
```
import boto3
client = boto3.client('bedrock-agentcore-control')
response = client.get_registry(
registryId=''
)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['registryArn']}")
```
## 레지스트리 업데이트
### 콘솔
1. [Amazon Bedrock AgentCore 콘솔](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#)을 엽니다.
1. 탐색 창의 **검색**에서 **레지스트리**를 선택합니다.
1. 편집하려는 레지스트리 옆의 라디오 버튼을 선택한 다음 **편집**을 선택합니다. 또는 레지스트리 이름을 선택한 다음 **편집**을 선택합니다.
1. **레지스트리 편집** 페이지에서 다음 중 하나를 업데이트합니다.
1. **이름** - 레지스트리 이름을 변경합니다(생성과 동일한 이름 지정 규칙).
1. **설명** - **추가 세부 정보**에서 설명을 업데이트하거나 추가합니다.
1. **레코드 승인** **- 자동 승인을** 켜거나 끕니다. 변경 사항은 업데이트 후 제출된 레코드에만 영향을 줍니다.
1. **변경 사항 저장**을 선택합니다.
**참고**
자동 승인 구성을 OFF에서 ON으로 업데이트하면 변경 후 제출된 레코드에만 영향을 줍니다. 이미 '승인 보류 중'인 기존 레코드는 영향을 받지 않으며 UpdateRegistryRecordStatus API를 호출하여 승인하거나 거부해야 합니다. 구성을 ON에서 OFF로 변경하면 변경 후 'Pending Approval'에 게시되는 레코드에만 영향을 줍니다.
**참고**
레지스트리가 생성된 후에는 검색 URL(JWT 인증 레지스트리의 경우)을 변경할 수 없습니다. 레지스트리가 생성된 후에는 인바운드 권한 부여 유형(IAM 또는 JWT)을 변경할 수 없습니다.
### AWS CLI
```
aws bedrock-agentcore-control update-registry \
--registry-id "" \
--description '{"optionalValue": "Updated description"}' \
--region us-east-1
```
### AWS SDK
```
import boto3
client = boto3.client('bedrock-agentcore-control')
response = client.update_registry(
registryId='',
description={'optionalValue': 'Updated description'}
)
print(f"Updated: {response['name']} - Status: {response['status']}")
```
## 레지스트리 삭제
### 콘솔
1. [Amazon Bedrock AgentCore 콘솔](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#)을 엽니다.
1. 탐색 창의 **검색**에서 **레지스트리**를 선택합니다.
1. 삭제할 레지스트리 옆의 라디오 버튼을 선택한 다음 **삭제**를 선택합니다.
1. 확인 대화 상자에서 경고를 검토합니다. 레지스트리를 삭제하기 전에 먼저 모든 레지스트리 레코드를 삭제해야 합니다.
1. 확인 필드에 **delete**를 입력합니다.
1. **삭제**를 선택합니다.
레지스트리 상태가 **삭제 중**으로 변경됩니다. 삭제가 완료되면 성공 배너가 확인됩니다.
### AWS CLI
```
aws bedrock-agentcore-control delete-registry \
--registry-id "" \
--region us-east-1
```
### AWS SDK
```
import boto3
client = boto3.client('bedrock-agentcore-control')
response = client.delete_registry(
registryId=''
)
print(f"Status: {response['status']}") # DELETING
```