Amazon Bedrock에 사용되는 작업, 리소스 및 조건 키

Amazon Bedrock(서비스 접두사: bedrock)에서는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.

참조:

• 이 서비스의 구성 방법을 알아봅니다.

• 이 서비스에 사용 가능한 API 작업 목록을 봅니다.

• IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

Amazon Bedrock에서 정의한 작업

IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.

작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.

작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.

참고

리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키	종속 작업
AllowVendedLogDeliveryForResource [권한만 해당]	지식창고에 대한 벤드 로그 전달을 구성할 권한을 부여합니다.	권한 관리	knowledge-base
ApplyGuardrail	가드레일을 적용할 수 있는 권한을 부여합니다.	읽기	guardrail*
AssociateAgentKnowledgeBase	지식 기반을 에이전트와 연결할 수 있는 권한 부여	쓰기	agent*
			knowledge-base*
AssociateThirdPartyKnowledgeBase [권한만 해당]	타사 플랫폼을 사용하여 지식 데이터를 저장할 수 있는 권한 부여	쓰기		bedrock:ThirdPartyKnowledgeBaseCredentialsSecretArn
CreateAgent	새 에이전트를 생성하고 DRAFT 에이전트 버전을 가리키는 테스트 에이전트 별칭을 생성할 수 있는 권한 부여	쓰기		aws:RequestTag/${TagKey} aws:TagKeys
CreateAgentActionGroup	기존 에이전트에서 새 작업 그룹을 만들 수 있는 권한 부여	쓰기	agent*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateAgentAlias	에이전트에 대한 새 별칭을 생성할 수 있는 권한 부여	쓰기	agent*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDataSource	데이터 원본을 만들 수 있는 권한을 부여합니다.	쓰기	knowledge-base*
CreateEvaluationJob	평가 기반 모델이나 사용자 지정 모델에 대한 작업을 생성할 수 있는 권한을 부여합니다.	쓰기	custom-model*
			foundation-model*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateFlow	프롬프트 플로우를 만들 수 있는 권한을 부여합니다.	쓰기		aws:RequestTag/${TagKey} aws:TagKeys
CreateFlowAlias	프롬프트 흐름의 별칭을 만들 수 있는 권한을 부여합니다.	쓰기	flow*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateFlowVersion	프롬프트 흐름의 변경할 수 없는 버전을 만들 수 있는 권한을 부여합니다.	쓰기	flow*
CreateFoundationModelAgreement	새 파운데이션 모델을 생성할 수 있는 권한 부여	쓰기
CreateGuardrail	새 가드레일을 생성할 수 있는 권한을 부여합니다.	쓰기		aws:RequestTag/${TagKey} aws:TagKeys
CreateGuardrailVersion	새 가드레일 버전을 생성할 수 있는 권한을 부여합니다.	쓰기	guardrail*
CreateKnowledgeBase	지식 기반을 생성할 수 있는 권한을 부여합니다.	쓰기		aws:RequestTag/${TagKey} aws:TagKeys
CreateModelCustomizationJob	사용자 지정 훈련 데이터로 모델을 사용자 지정하기 위한 작업을 생성할 수 있는 권한을 부여합니다.	쓰기	custom-model*
			foundation-model*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateModelEvaluationJob	평가 기반 모델이나 사용자 지정 모델에 대한 작업을 생성할 수 있는 권한을 부여합니다.	쓰기	custom-model*
			foundation-model*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateModelInvocationJob	새 모델 간접 호출 작업을 생성할 수 있는 권한을 부여합니다.	쓰기	custom-model*
			foundation-model*
				aws:RequestTag/${TagKey} aws:TagKeys
CreatePrompt	프롬프트를 만들 수 있는 권한을 부여합니다.	쓰기		aws:RequestTag/${TagKey} aws:TagKeys
CreatePromptVersion	프롬프트 버전을 만들 수 있는 권한을 부여합니다.	쓰기	prompt*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateProvisionedModelThroughput	프로비저닝된 모델 처리량을 생성할 수 있는 권한 부여	쓰기	custom-model*
			foundation-model*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAgent	이전에 생성한 에이전트를 삭제할 수 있는 권한을 부여합니다.	쓰기	agent*
DeleteAgentActionGroup	이전에 생성한 actionGroup을 삭제할 수 있는 권한을 부여합니다.	쓰기	agent*
DeleteAgentAlias	이전에 만든 앱을 삭제할 수 AgentAlias 있는 권한을 부여합니다.	쓰기	agent-alias*
DeleteAgentMemory	별칭의 기존 메모리를 삭제할 권한을 부여합니다.	쓰기	agent-alias*
DeleteAgentVersion	이전에 생성한 에이전트 버전을 삭제할 수 있는 권한을 부여합니다.	쓰기	agent*
DeleteCustomModel	이전에 생성한 사용자 지정 모델을 삭제할 수 있는 권한을 부여합니다.	쓰기	custom-model*
DeleteDataSource	데이터 원본을 삭제할 수 있는 권한을 부여합니다.	쓰기	knowledge-base*
DeleteFlow	프롬프트 플로우를 삭제할 권한을 부여합니다.	쓰기	flow*
DeleteFlowAlias	프롬프트 흐름의 별칭을 삭제할 권한을 부여합니다.	쓰기	flow-alias*
DeleteFlowVersion	프롬프트 흐름의 버전을 삭제할 권한을 부여합니다.	쓰기	flow*
DeleteFoundationModelAgreement	이전에 생성한 파운데이션 모델 계약을 삭제할 수 있는 권한 부여	쓰기
DeleteGuardrail	가드레일 또는 해당 버전을 삭제할 수 있는 권한을 부여합니다.	쓰기	guardrail*
DeleteKnowledgeBase	지식 기반을 삭제할 수 있는 권한을 부여합니다.	쓰기	knowledge-base*
DeleteModelInvocationLoggingConfiguration	기존 간접 호출 로깅 구성을 삭제할 수 있는 권한 부여	쓰기
DeletePrompt	프롬프트 또는 해당 버전을 삭제할 권한을 부여합니다.	쓰기	prompt*
			prompt-version*
DeleteProvisionedModelThroughput	이전에 생성한 프로비저닝된 모델 처리량을 삭제할 수 있는 권한 부여	쓰기	provisioned-model*
DetectGeneratedContent	제공된 콘텐츠가 Amazon Bedrock을 사용하여 생성되었는지 여부를 탐지할 권한을 부여합니다.	읽기	foundation-model*
DisassociateAgentKnowledgeBase	에이전트로부터 지식 기반을 연결 해제할 수 있는 권한 부여	쓰기	agent*
			knowledge-base*
GetAgent	기존 에이전트를 검색할 수 있는 권한 부여	읽기	agent*
GetAgentActionGroup	기존 작업 그룹을 검색할 권한 부여	읽기	agent*
GetAgentAlias	기존 별칭을 검색할 수 있는 권한 부여	읽기	agent-alias*
GetAgentKnowledgeBase	에이전트와 연결된 지식 기반을 설명할 수 있는 권한 부여	읽기	agent*
			knowledge-base*
GetAgentMemory	별칭의 기존 메모리를 검색할 수 있는 권한을 부여합니다.	읽기	agent-alias*
GetAgentVersion	기존 에이전트 버전을 검색할 수 있는 권한 부여	읽기	agent*
GetCustomModel	생성한 Bedrock 사용자 지정 모델과 연결된 속성을 가져올 수 있는 권한을 부여합니다.	읽기	custom-model*
GetDataSource	기존 데이터 소스를 검색하는 권한 부여	읽기	knowledge-base*
GetEvaluationJob	평가 작업과 관련된 속성을 가져올 권한을 부여합니다. 이 작업을 사용하면 평가 작업의 상태를 가져올 수 있습니다.	읽기	evaluation-job*
GetFlow	기존 프롬프트 흐름을 검색할 수 있는 권한을 부여합니다.	읽기	flow*
GetFlowAlias	프롬프트 흐름의 기존 별칭을 검색할 수 있는 권한을 부여합니다.	읽기	flow-alias*
GetFlowVersion	프롬프트 흐름의 기존 버전을 검색할 수 있는 권한을 부여합니다.	읽기	flow*
GetFoundationModel	Bedrock 파운데이션 모델과 연결된 속성을 가져올 수 있는 권한 부여	읽기	foundation-model*
GetFoundationModelAvailability	파운데이션 모델을 사용할 수 있는 권한 부여	읽기
GetGuardrail	가드레일 또는 해당 버전을 검색할 수 있는 권한을 부여합니다.	읽기	guardrail*
GetIngestionJob	기존 수집 작업을 검색할 수 있는 권한 부여	읽기	knowledge-base*
GetKnowledgeBase	기존 지식 기반을 검색할 수 있는 권한 부여	읽기	knowledge-base*
GetModelCustomizationJob	모델 사용자 지정 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. 모델 사용자 지정 작업의 상태를 가져오려면 이 작업을 사용합니다.	읽기	model-customization-job*
GetModelEvaluationJob	모델 평가 작업과 연결된 속성을 가져올 수 있는 권한을 부여합니다. 모델 평가 작업의 상태를 가져오려면 이 작업을 사용합니다.	읽기	model-evaluation-job*
GetModelInvocationJob	모델 간접 호출 작업을 검색할 수 있는 권한을 부여합니다.	읽기	model-invocation-job*
GetModelInvocationLoggingConfiguration	기존 간접 호출 로깅 구성을 검색할 수 있는 권한 부여	읽기
GetPrompt	기존 프롬프트 또는 해당 버전을 검색할 수 있는 권한을 부여합니다.	읽기	prompt*
			prompt-version*
GetProvisionedModelThroughput	프로비저닝된 모델 처리량을 검색할 수 있는 권한 부여	읽기	provisioned-model*
GetUseCaseForModelAccess	모델 액세스에 대한 사용 사례를 검색할 수 있는 권한 부여	읽기
InvokeAgent	Bedrock에 대한 에이전트 별칭에 사용자 입력(텍스트만)을 전송할 수 있는 권한 부여	읽기	agent-alias*
InvokeFlow	사용자 입력으로 프롬프트 흐름을 호출할 수 있는 권한을 부여합니다.	읽기	flow-alias*
InvokeModel	요청 본문에 제공된 입력을 사용하여 추론을 실행하기 위해 지정된 Bedrock 모델을 간접적으로 호출할 수 있는 권한을 부여합니다	읽기	foundation-model*
			provisioned-model*
InvokeModelWithResponseStream	스트리밍 응답과 함께 요청 본문에 제공된 입력을 사용하여 추론을 실행하기 위해 지정된 Bedrock 모델을 간접적으로 호출할 수 있는 권한을 부여합니다	읽기	foundation-model*
			provisioned-model*
ListAgentActionGroups	에이전트에 작업 그룹을 나열할 수 있는 권한 부여	나열	agent*
ListAgentAliases	에이전트의 별칭을 나열할 수 있는 권한 부여	나열	agent*
ListAgentKnowledgeBases	에이전트와와 관련된 지식 기반을 나열할 수 있는 권한 부여	나열	agent*
ListAgentVersions	기존 에이전트 버전을 나열할 수 있는 권한 부여	나열	agent*
ListAgents	기존 에이전트를 나열할 수 있는 권한 부여	나열
ListCustomModels	생성한 Bedrock 사용자 지정 모델의 목록을 가져올 수 있는 권한을 부여합니다.	나열
ListDataSources	지식 기반에 있는 기존 데이터 소스를 나열하는 권한 부여	나열	knowledge-base*
ListEvaluationJobs	제출한 평가 작업 목록을 가져올 권한을 부여합니다.	나열
ListFlowAliases	프롬프트 플로우의 기존 별칭을 나열할 수 있는 권한을 부여합니다.	나열	flow*
ListFlowVersions	프롬프트 흐름의 기존 버전을 나열할 권한을 부여합니다.	나열	flow*
ListFlows	기존 프롬프트 흐름을 나열할 권한을 부여합니다.	나열
ListFoundationModelAgreementOffers	파운데이션 모델 계약 상품 목록을 가져올 수 있는 권한 부여	나열
ListFoundationModels	사용할 수 있는 Bedrock 파운데이션 모델을 나열할 수 있는 권한을 부여합니다.	나열
ListGuardrails	가드레일 또는 해당 버전을 나열할 수 있는 권한을 부여합니다.	나열	guardrail
ListIngestionJobs	데이터 소스의 수집 작업을 나열할 수 있는 권한 부여합니다.	나열	knowledge-base*
ListKnowledgeBases	지식 기반을 나열할 수 있는 권한 부여합니다.	나열
ListModelCustomizationJobs	제출한 모델 사용자 지정 작업의 목록을 가져올 수 있는 권한을 부여합니다.	나열
ListModelEvaluationJobs	제출한 모델 평가 작업의 목록을 가져올 수 있는 권한을 부여합니다.	나열
ListModelInvocationJobs	이전에 생성한 모델 간접 호출 작업을 나열할 수 있는 권한을 부여합니다.	나열
ListPrompts	기존 프롬프트를 나열할 권한을 부여합니다.	나열
ListProvisionedModelThroughputs	이전에 생성한 프로비저닝된 모델 처리량을 나열할 수 있는 권한 부여합니다.	나열
ListTagsForResource	Bedrock 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다.	읽기	agent*
			agent-alias*
			custom-model*
			evaluation-job*
			flow*
			flow-alias*
			guardrail*
			knowledge-base*
			model-customization-job*
			model-evaluation-job*
			model-invocation-job*
			prompt*
			prompt-version*
			provisioned-model*
PrepareAgent	기존 에이전트의 런타임 요청 수신을 준비할 수 있는 권한을 부여합니다.	쓰기	agent*
PrepareFlow	프롬프트 흐름에 대한 최신 변경 내용을 적용하여 런타임에 반영할 수 있는 권한을 부여합니다.	쓰기	flow*
PutFoundationModelEntitlement	파운데이션 모델에 액세스할 수 있는 권한을 부여할 수 있는 권한 부여	쓰기
PutModelInvocationLoggingConfiguration	기존 간접 호출 로깅 구성을 생성할 수 있는 권한 부여	쓰기
PutUseCaseForModelAccess	모델 액세스에 대한 사용 사례를 제공할 수 있는 권한 부여	쓰기
Retrieve	지식 기반에서 수집된 데이터를 검색할 수 있는 권한을 부여합니다.	읽기	knowledge-base*
RetrieveAndGenerate	검색 및 생성을 수행하기 위해 사용자 입력을 전송할 수 있는 권한을 부여합니다.	쓰기
StartIngestionJob	수집 작업을 시작할 수 있는 권한 부여	쓰기	knowledge-base*
StopEvaluationJob	진행 중인 동안 평가 작업을 중지할 수 있는 권한을 부여합니다.	쓰기	evaluation-job*
StopModelCustomizationJob	진행 중인 Bedrock 모델 사용자 지정 작업을 중지할 수 있는 권한을 부여합니다.	쓰기	model-customization-job*
StopModelInvocationJob	이전에 시작한 모델 간접 호출 작업을 중지할 수 있는 권한을 부여합니다.	쓰기	model-invocation-job*
TagResource	Bedrock 리소스에 태그를 지정할 수 있는 권한을 부여합니다.	태그 지정	agent
			agent-alias
			custom-model
			evaluation-job
			flow
			flow-alias
			guardrail
			knowledge-base
			model-customization-job
			model-evaluation-job
			model-invocation-job
			prompt
			prompt-version
			provisioned-model
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Bedrock 리소스의 태그를 제거할 수 있는 권한을 부여합니다.	태그 지정	agent
			agent-alias
			custom-model
			evaluation-job
			flow
			flow-alias
			guardrail
			knowledge-base
			model-customization-job
			model-evaluation-job
			model-invocation-job
			prompt
			prompt-version
			provisioned-model
				aws:TagKeys
UpdateAgent	기존 에이전트를 업데이트할 수 있는 권한 부여	쓰기	agent*
UpdateAgentActionGroup	기존 작업 그룹을 업데이트할 수 있는 권한 부여	쓰기	agent*
UpdateAgentAlias	기존 별칭을 업데이트할 수 있는 권한 부여	쓰기	agent-alias*
UpdateAgentKnowledgeBase	에이전트와 연결된 지식 기반을 업데이트할 수 있는 권한 부여	쓰기	agent*
			knowledge-base*
UpdateDataSource	데이터 원본을 업데이트할 수 있는 권한을 부여합니다.	쓰기	knowledge-base*
UpdateFlow	프롬프트 플로우를 업데이트할 권한을 부여합니다.	쓰기	flow*
UpdateFlowAlias	프롬프트 흐름의 별칭 구성을 업데이트할 수 있는 권한을 부여합니다.	쓰기	flow-alias*
UpdateGuardrail	가드레일을 업데이트할 수 있는 권한을 부여합니다.	쓰기	guardrail*
UpdateKnowledgeBase	지식 기반을 업데이트할 수 있는 권한 부여	쓰기	knowledge-base*
UpdatePrompt	프롬프트를 업데이트할 권한을 부여합니다.	쓰기	prompt*
UpdateProvisionedModelThroughput	이전에 생성한 프로비저닝된 모델 처리량을 업데이트할 수 있는 권한 부여	쓰기	custom-model*
			foundation-model*
			provisioned-model*

Amazon Bedrock에서 정의한 리소스 유형

이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업에서 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.

리소스 유형	ARN	조건 키
foundation-model	arn:${Partition}:bedrock:${Region}::foundation-model/${ResourceId}
custom-model	arn:${Partition}:bedrock:${Region}:${Account}:custom-model/${ResourceId}	aws:ResourceTag/${TagKey}
provisioned-model	arn:${Partition}:bedrock:${Region}:${Account}:provisioned-model/${ResourceId}	aws:ResourceTag/${TagKey}
model-customization-job	arn:${Partition}:bedrock:${Region}:${Account}:model-customization-job/${ResourceId}	aws:ResourceTag/${TagKey}
agent	arn:${Partition}:bedrock:${Region}:${Account}:agent/${AgentId}	aws:ResourceTag/${TagKey}
agent-alias	arn:${Partition}:bedrock:${Region}:${Account}:agent-alias/${AgentId}/${AgentAliasId}	aws:ResourceTag/${TagKey}
knowledge-base	arn:${Partition}:bedrock:${Region}:${Account}:knowledge-base/${KnowledgeBaseId}	aws:ResourceTag/${TagKey}
model-evaluation-job	arn:${Partition}:bedrock:${Region}:${Account}:model-evaluation-job/${ResourceId}	aws:ResourceTag/${TagKey}
evaluation-job	arn:${Partition}:bedrock:${Region}:${Account}:evaluation-job/${ResourceId}	aws:ResourceTag/${TagKey}
model-invocation-job	arn:${Partition}:bedrock:${Region}:${Account}:model-invocation-job/${JobIdentifier}	aws:ResourceTag/${TagKey}
guardrail	arn:${Partition}:bedrock:${Region}:${Account}:guardrail/${GuardrailId}	aws:ResourceTag/${TagKey}
flow	arn:${Partition}:bedrock:${Region}:${Account}:flow/${FlowId}	aws:ResourceTag/${TagKey}
flow-alias	arn:${Partition}:bedrock:${Region}:${Account}:flow/${FlowId}/alias/${FlowAliasId}	aws:ResourceTag/${TagKey}
prompt	arn:${Partition}:bedrock:${Region}:${Account}:prompt/${PromptId}	aws:ResourceTag/${TagKey}
prompt-version	arn:${Partition}:bedrock:${Region}:${Account}:prompt/${PromptId}:${PromptVersion}	aws:ResourceTag/${TagKey}

Amazon Bedrock에 사용되는 조건 키

Amazon Bedrock은 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.

조건 키	설명	유형
aws:RequestTag/${TagKey}	각 필수 태그에 허용되는 값 세트를 기준으로 요청을 생성하여 액세스를 필터링합니다.	String
aws:ResourceTag/${TagKey}	리소스와 연결된 태그 값을 기준으로 작업을 수행하여 액세스를 필터링합니다.	String
aws:TagKeys	요청에 필수 태그가 있는지를 기준으로 요청을 생성하여 액세스를 필터링합니다.	ArrayOfString
bedrock:ThirdPartyKnowledgeBaseCredentialsSecretArn	타사 플랫폼의 보안 인증을 포함하는 secretArn에 따라 액세스를 필터링합니다.	ARN