기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Bedrock Agentcore에 사용되는 작업, 리소스 및 조건 키
Amazon Bedrock Agentcore(서비스 접두사: bedrock-agentcore)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
주제
Amazon Bedrock Agentcore에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 이러한 권한은 작업 자체에 대한 권한 외에 추가로 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| AllowVendedLogDeliveryForResource [권한만 해당] | 리소스에 대해 판매된 원격 측정을 구성할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| BatchCreateMemoryRecords | 하나 이상의 메모리 레코드를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| BatchDeleteMemoryRecords | 하나 이상의 메모리 레코드를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| BatchUpdateMemoryRecords | 하나 이상의 메모리 레코드를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CompleteResourceTokenAuth | OAuth2 for 3LO 흐름으로 액세스 토큰을 검색하여 외부 리소스에 액세스할 수 있는 권한을 부여합니다. | Read | |||
|
bedrock-agentcore:InboundJwtClaim/iss bedrock-agentcore:InboundJwtClaim/sub bedrock-agentcore:InboundJwtClaim/aud bedrock-agentcore:InboundJwtClaim/scope |
|||||
| ConnectBrowserAutomationStream | 브라우저 자동화 스트림에 연결할 수 있는 권한을 부여합니다. | Read | |||
| ConnectBrowserLiveViewStream | 브라우저 라이브 뷰 스트림에 연결할 수 있는 권한을 부여합니다. | Read | |||
| CreateAgentRuntime | 새 에이전트 런타임을 생성할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| CreateAgentRuntimeEndpoint | 새 에이전트 런타임 엔드포인트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateApiKeyCredentialProvider | 새 API 키 자격 증명 공급자를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateBrowser | 새 사용자 지정 브라우저를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateCodeInterpreter | 새 사용자 지정 코드 인터프리터를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateEvent | 이벤트를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateGateway | 새 게이트웨이를 생성할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| CreateGatewayTarget | 기존 게이트웨이에서 새 대상을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateMemory | 메모리 리소스를 생성할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| CreateOauth2CredentialProvider | OAuth2 프로토콜을 사용하여 외부 리소스에 액세스할 수 있는 새 자격 증명 공급자를 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateWorkloadIdentity | 새 워크로드 자격 증명을 생성할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAgentRuntime | 에이전트 런타임을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteAgentRuntimeEndpoint | 에이전트 런타임 엔드포인트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteApiKeyCredentialProvider | 등록된 API 키 자격 증명 공급자를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteBrowser | 사용자 지정 브라우저를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteCodeInterpreter | 사용자 지정 코드 인터프리터를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteEvent | 이벤트를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteGateway | 기존 게이트웨이를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteGatewayTarget | 기존 게이트웨이 대상을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteMemory | 메모리 리소스를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteMemoryRecord | 메모리 레코드를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteOauth2CredentialProvider | 등록된 OAuth2 자격 증명 공급자를 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteWorkloadIdentity | 등록된 워크로드 자격 증명을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| GetAgentCard | A2A용 에이전트 카드를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetAgentRuntime | 에이전트 런타임의 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetAgentRuntimeEndpoint | 에이전트 런타임 엔드포인트의 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetApiKeyCredentialProvider | 등록된 API 키 자격 증명 공급자를 이름으로 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetBrowser | 브라우저의 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetBrowserSession | 브라우저 세션의 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetCodeInterpreter | 코드 인터프리터의 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetCodeInterpreterSession | 코드 인터프리터 세션의 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetEvent | 이벤트를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetGateway | 기존 게이트웨이를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetGatewayTarget | 기존 게이트웨이 대상을 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetMemory | 메모리 리소스에 대한 세부 정보를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetMemoryRecord | 메모리 레코드를 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetOauth2CredentialProvider | 등록된 OAuth2 자격 증명 공급자를 이름으로 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetResourceApiKey | Api 키 자격 증명 공급자와 연결된 API 키를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetResourceOauth2Token | OAuth2 2LO 또는 3LO 흐름으로 액세스 토큰을 검색하여 외부 리소스에 액세스할 수 있는 권한을 부여합니다. | Read | |||
| GetTokenVault | 암호화 설정을 포함하여 TokenVault의 현재 구성을 가져올 수 있는 권한을 부여합니다. | Read | |||
| GetWorkloadAccessToken | 사용자를 대신하여 작동하지 않는 에이전트 워크로드에 대한 워크로드 액세스 토큰을 검색할 수 있는 권한을 부여합니다. | 쓰기 | |||
| GetWorkloadAccessTokenForJWT | JWT 토큰을 사용하여 사용자를 대신하여 작동하는 에이전트 워크로드에 대한 워크로드 액세스 토큰을 검색할 수 있는 권한을 부여합니다. | 쓰기 | |||
|
bedrock-agentcore:InboundJwtClaim/iss bedrock-agentcore:InboundJwtClaim/sub bedrock-agentcore:InboundJwtClaim/aud |
|||||
| GetWorkloadAccessTokenForUserId | 사용자 ID가 있는 사용자를 대신하여 작동하는 에이전트 워크로드에 대한 워크로드 액세스 토큰을 검색할 수 있는 권한을 부여합니다. | 쓰기 | |||
| GetWorkloadIdentity | 이름 및 허용된 OAuth2 반환 URLs | Read | |||
| InvokeAgentRuntime | 에이전트 런타임 엔드포인트를 호출할 수 있는 권한을 부여합니다. | 쓰기 | |||
| InvokeAgentRuntimeForUser | X-Amzn-Bedrock-AgentCore-Runtime-User-Id 헤더를 사용하여 에이전트 런타임 엔드포인트를 호출할 수 있는 권한을 부여합니다. | 쓰기 | |||
| InvokeCodeInterpreter | 코드 인터프리터 세션을 호출할 수 있는 권한을 부여합니다. | 쓰기 | |||
| InvokeGateway [권한만 해당] | 게이트웨이를 호출할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| ListActors | 작업자를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAgentRuntimeEndpoints | 에이전트 런타임 엔드포인트를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAgentRuntimeVersions | 에이전트 런타임 버전을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListAgentRuntimes | 에이전트 런타임을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListApiKeyCredentialProviders | 토큰 볼트의 모든 API 키 자격 증명 공급자를 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListBrowserSessions | 브라우저 세션을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListBrowsers | 브라우저를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListCodeInterpreterSessions | 코드 인터프리터 세션을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListCodeInterpreters | 코드 인터프리터를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListEvents | 이벤트를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListGatewayTargets | 기존 게이트웨이 대상을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListGateways | 기존 게이트웨이를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListMemories | 메모리 리소스를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListMemoryRecords | 메모리 레코드를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListOauth2CredentialProviders | 토큰 볼트의 모든 OAuth2 자격 증명 공급자를 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListSessions | 세션을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListTagsForResource | Bedrock-AgentCore 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListWorkloadIdentities | 호출자의에 있는 모든 워크로드 ID를 나열할 수 있는 권한을 부여합니다. AWS 계정 | Read | |||
| RetrieveMemoryRecords | 스키마 쿼리를 통해 메모리 레코드를 검색할 수 있는 권한을 부여합니다. | List | |||
| SetTokenVaultCMK | 고객 관리형 키(CMK) 또는 서비스 관리형 키를 특정 TokenVault와 연결할 수 있는 권한을 부여합니다. | Read | |||
| StartBrowserSession | 새 브라우저 세션을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StartCodeInterpreterSession | 새 코드 인터프리터 세션을 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopBrowserSession | 브라우저 세션을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopCodeInterpreterSession | 코드 인터프리터 세션을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| StopRuntimeSession | 런타임 세션을 중지할 수 있는 권한을 부여합니다. | 쓰기 | |||
| SynchronizeGatewayTargets [권한만 해당] | 게이트웨이에서 검색을 활성화할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| TagResource | Bedrock-AgentCore 리소스에 태그를 지정할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | Bedrock-AgentCore 리소스의 태그를 해제할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateAgentRuntime | 에이전트 런타임을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| UpdateAgentRuntimeEndpoint | 에이전트 런타임 엔드포인트를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateApiKeyCredentialProvider | 기존 API 키 자격 증명 공급자를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateBrowserStream | 브라우저 세션 스트림의 상태를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateGateway | 기존 게이트웨이를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| UpdateGatewayTarget | 기존 게이트웨이 대상을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateMemory | 메모리 리소스를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
| UpdateOauth2CredentialProvider | 기존 OAuth2 자격 증명 공급자를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
| UpdateWorkloadIdentity | 기존 워크로드 자격 증명의 메타데이터를 업데이트할 수 있는 권한을 부여합니다. | 쓰기 | |||
Amazon Bedrock Agentcore에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| memory |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:memory/${MemoryId}
|
|
| gateway |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:gateway/${GatewayId}
|
|
| workload-identity |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}/workload-identity/${WorkloadIdentityName}
|
|
| oauth2credentialprovider |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/oauth2credentialprovider/${Name}
|
|
| apikeycredentialprovider |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}/apikeycredentialprovider/${Name}
|
|
| runtime |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}
|
|
| runtime-endpoint |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:runtime/${RuntimeId}/runtime-endpoint/${Name}
|
|
| code-interpreter-custom |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:code-interpreter-custom/${CodeInterpreterId}
|
|
| code-interpreter |
arn:${Partition}:bedrock-agentcore:${Region}:aws:code-interpreter/${CodeInterpreterId}
|
|
| browser-custom |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:browser-custom/${BrowserId}
|
|
| browser |
arn:${Partition}:bedrock-agentcore:${Region}:aws:browser/${BrowserId}
|
|
| workload-identity-directory |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:workload-identity-directory/${DirectoryId}
|
|
| token-vault |
arn:${Partition}:bedrock-agentcore:${Region}:${Account}:token-vault/${TokenVaultId}
|
Amazon Bedrock Agentcore에 사용되는 조건 키
Amazon Bedrock Agentcore는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | 형식 |
|---|---|---|
| aws:RequestTag/${TagKey} | 각 필수 태그에 허용되는 값 세트를 기준으로 요청을 생성하여 액세스를 필터링합니다. | String |
| aws:ResourceTag/${TagKey} | 리소스와 연결된 태그 값을 기준으로 작업을 수행하여 액세스를 필터링합니다. | String |
| aws:TagKeys | 요청에 필수 태그가 있는지를 기준으로 요청을 생성하여 액세스를 필터링합니다. | ArrayOfString |
| bedrock-agentcore:GatewayAuthorizerType | 게이트웨이의 authorizerType 속성을 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:InboundJwtClaim/aud | 요청에 전달된 JWT의 대상 클레임(aud)을 기준으로 액세스를 필터링합니다. | ArrayOfString |
| bedrock-agentcore:InboundJwtClaim/client_id | 요청에 전달된 JWT의 client_id 클레임을 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:InboundJwtClaim/iss | 요청에 전달된 JWT에 있는 발급자(iss) 클레임을 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:InboundJwtClaim/scope | 요청에 전달된 JWT의 범위 클레임을 기준으로 액세스를 필터링합니다. | ArrayOfString |
| bedrock-agentcore:InboundJwtClaim/sub | 요청에 전달된 JWT의 제목 클레임(하위)을 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:actorId | 작업자 ID를 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:namespace | 네임스페이스를 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:securityGroups | AgentCore 런타임에 대해 구성된 보안 그룹의 ID를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| bedrock-agentcore:sessionId | 세션 ID를 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:strategyId | 메모리 전략 ID를 기준으로 액세스를 필터링합니다. | String |
| bedrock-agentcore:subnets | AgentCore 런타임에 대해 구성된 서브넷의 ID를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| bedrock-agentcore:userid | 요청에 전달된 정적 사용자 ID 값을 기준으로 액세스를 필터링합니다. | String |
