View a markdown version of this page

레지스트리 생성 및 관리 - Amazon Bedrock AgentCore
레지스트리 생성레지스트리 나열레지스트리 세부 정보 보기레지스트리 업데이트레지스트리 삭제

레지스트리 생성 및 관리

예정된 네임스페이스 마이그레이션

AWS 에이전트 레지스트리는 현재 bedrock-agentcore 네임스페이스에서 공개 미리 보기 중입니다. 2026년 8월 6일부터 서비스는 에이전트 레지스트리 네임스페이스로 이동합니다. AWS 에이전트 레지스트리를 사용하는 경우 엔드포인트, IAM 정책, SDK 클라이언트, CLI 스크립트 및 레지스트리 데이터를 업데이트해야 합니다. 공개 미리 보기에서 마이그레이션하는 방법에 대한 자세한 내용은 포괄적인 레지스트리 마이그레이션 가이드를 참조하세요.

레지스트리 생성

콘솔

  1. Amazon Bedrock AgentCore 콘솔을 엽니다.

  2. 탐색 창의 검색에서 레지스트리를 선택합니다.

  3. 레지스트리 섹션에서 레지스트리 생성을 선택합니다.

  4. 이름에 레지스트리의 이름을 입력합니다. 이름은 문자 또는 숫자로 시작해야 합니다. 유효한 문자는 a-z, A-Z, 0-9, _(밑줄), -(하이픈), .(점) 및 /(슬래시)입니다. 이름은 최대 64자까지 가능합니다.

  5. (선택 사항) 추가 세부 정보를 확장하고 설명(1~4,096자)을 입력합니다.

  6. (선택 사항) API 권한 부여 검색을 확장하여 레지스트리를 검색할 때 소비자가 권한을 부여하는 방법을 구성합니다(인바운드 권한 부여). 표준 AWS 자격 증명을 사용하려면 AWS IAM을 선택하고 기업 자격 증명 공급자 자격 증명을 사용하려면 JSON 웹 토큰(JWT)을 선택합니다. JWT를 선택하면 Cognito로 빠르게 생성하거나 검색 URL, 대상, 범위, 사용자 지정 클레임 및 클라이언트를 제공하여 자체 IdP를 가져올 수 있습니다.

  7. 레코드 승인에서 자동 승인을 활성화할지 여부를 선택합니다. 자동 승인이 꺼져 있으면 큐레이터가 각 레코드를 검토하고 승인해야 검색할 수 있습니다.

  8. 레지스트리 생성을 선택합니다.

레지스트리 상태는 생성 중으로 시작되고 프로비저닝이 완료되면 준비됨으로 전환됩니다.

참고

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/<poolId>/.well-known/openid-configuration", "allowedClients": ["<appClientId>"]}}' \
  --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/<poolId>/.well-known/openid-configuration',
            'allowedClients': ['<appClientId>']
        }
    }
)
print(response['registryArn'])

레지스트리 나열

콘솔

  1. Amazon Bedrock AgentCore 콘솔을 엽니다.

  2. 탐색 창의 검색에서 레지스트리를 선택합니다.

  3. 레지스트리 테이블에는 계정의 모든 레지스트리가 다음 열과 함께 표시됩니다.

    1. 이름 - 레지스트리 이름(세부 정보 페이지에 연결됨).

    2. 설명 - 제공된 경우 레지스트리 설명입니다.

    3. 권한 부여 유형 - 인바운드 권한 부여 방법(AWS_IAM 또는 CUSTOM_JWT).

    4. 상태 - 현재 상태(생성 중, 준비됨, 업데이트 중, 삭제 중 또는 실패 상태).

    5. ARN - 레지스트리 Amazon 리소스 이름입니다.

    6. 생성됨 - 생성 타임스탬프입니다.

    7. 최종 업데이트 - 마지막 수정 타임스탬프입니다.

  4. 레지스트리 찾기 검색 창을 사용하여 이름을 기준으로 필터링합니다.

  5. 페이지 매김 컨트롤을 사용하여 결과를 탐색합니다.

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 콘솔을 엽니다.

  2. 탐색 창의 검색에서 레지스트리를 선택합니다.

  3. 레지스트리 테이블에서 레지스트리 이름을 선택합니다.

  4. 레지스트리 세부 정보 페이지에는 두 개의 탭이 있습니다.

    1. 레코드 관리 - 레지스트리 레코드를 보고 관리합니다.

    2. 레코드 검색 - 레지스트리에서 승인된 레코드를 검색합니다.

  5. 레지스트리 세부 정보 섹션에는 이름, 상태, 설명, 자동 승인(활성화 또는 비활성화), 레지스트리 ARN, 마지막 업데이트 날짜, 생성 날짜가 표시됩니다.

  6. 레지스트리 레코드 섹션에는 상태 요약 카운터(총 제출됨, 승인 보류 중, 승인됨, 사용 중단됨, 거부됨)와 레코드 테이블이 표시됩니다.

  7. 검색 API 권한 부여(인바운드 권한 부여) 섹션에는 현재 권한 부여 유형이 표시됩니다.

AWS CLI

aws bedrock-agentcore-control get-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.get_registry(
    registryId='<registryId>'
)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['registryArn']}")

레지스트리 업데이트

콘솔

  1. Amazon Bedrock AgentCore 콘솔을 엽니다.

  2. 탐색 창의 검색에서 레지스트리를 선택합니다.

  3. 편집하려는 레지스트리 옆의 라디오 버튼을 선택한 다음 편집을 선택합니다. 또는 레지스트리 이름을 선택한 다음 편집을 선택합니다.

  4. 레지스트리 편집 페이지에서 다음 중 하나를 업데이트합니다.

    1. 이름 - 레지스트리 이름을 변경합니다(생성과 동일한 이름 지정 규칙).

    2. 설명 - 추가 세부 정보에서 설명을 업데이트하거나 추가합니다.

    3. 레코드 승인 - 자동 승인을 켜거나 끕니다. 변경 사항은 업데이트 후 제출된 레코드에만 영향을 줍니다.

  5. 변경 사항 저장을 선택합니다.

참고

자동 승인 구성을 OFF에서 ON으로 업데이트하면 변경 후 제출된 레코드에만 영향을 줍니다. 이미 '승인 보류 중'인 기존 레코드는 영향을 받지 않으며 UpdateRegistryRecordStatus API를 호출하여 승인하거나 거부해야 합니다. 구성을 ON에서 OFF로 변경하면 변경 후 'Pending Approval'에 게시되는 레코드에만 영향을 줍니다.

참고

레지스트리가 생성된 후에는 검색 URL(JWT 인증 레지스트리의 경우)을 변경할 수 없습니다. 레지스트리가 생성된 후에는 인바운드 권한 부여 유형(IAM 또는 JWT)을 변경할 수 없습니다.

AWS CLI

aws bedrock-agentcore-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry(
    registryId='<registryId>',
    description={'optionalValue': 'Updated description'}
)
print(f"Updated: {response['name']} - Status: {response['status']}")

레지스트리 삭제

콘솔

  1. Amazon Bedrock AgentCore 콘솔을 엽니다.

  2. 탐색 창의 검색에서 레지스트리를 선택합니다.

  3. 삭제할 레지스트리 옆의 라디오 버튼을 선택한 다음 삭제를 선택합니다.

  4. 확인 대화 상자에서 경고를 검토합니다. 레지스트리를 삭제하기 전에 먼저 모든 레지스트리 레코드를 삭제해야 합니다.

  5. 확인 필드에 delete를 입력합니다.

  6. 삭제를 선택합니다.

레지스트리 상태가 삭제 중으로 변경됩니다. 삭제가 완료되면 성공 배너가 확인됩니다.

AWS CLI

aws bedrock-agentcore-control delete-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.delete_registry(
    registryId='<registryId>'
)
print(f"Status: {response['status']}")  # DELETING