기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# API 시작하기
이 섹션에서는 AWS API를 통해 Amazon Bedrock을 요청하도록 환경을 설정하는 방법을 설명합니다.는 경험을 간소화하기 위해 다음 도구를 AWS 제공합니다.
+ AWS Command Line Interface (AWS CLI)
+ AWS SDKs
+ Amazon SageMaker AI 노트북 사용
API를 시작하려면 프로그래밍 방식 액세스 권한을 부여하기 위한 자격 증명이 필요합니다. 다음 섹션이 해당되는 경우 해당 섹션을 확장하고 지침을 따르세요. 그렇지 않으면 나머지 섹션을 진행합니다.
## 를 처음 사용하는 경우 AWS
이 없는 경우 다음 단계를 AWS 계정완료하여 생성합니다.
**에 가입하려면 AWS 계정**
1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)을 엽니다.
1. 온라인 지시 사항을 따르세요.
등록 절차 중 전화 또는 텍스트 메시지를 받고 전화 키패드로 확인 코드를 입력하는 과정이 있습니다.
에 가입하면 AWS 계정*AWS 계정 루트 사용자*이 생성됩니다. 루트 사용자에게는 계정의 모든 AWS 서비스 및 리소스에 액세스할 권한이 있습니다. 보안 모범 사례는 사용자에게 관리 액세스 권한을 할당하고, 루트 사용자만 사용하여 [루트 사용자 액세스 권한이 필요한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)을 수행하는 것입니다.
AWS 는 가입 프로세스가 완료된 후 확인 이메일을 보냅니다. 언제든지 [https://aws.amazon.com/](https://aws.amazon.com/)으로 이동하고 **내 계정**을 선택하여 현재 계정 활동을 확인하고 계정을 관리할 수 있습니다.
**보안 AWS 계정 루트 사용자**
1. **루트 사용자를** 선택하고 AWS 계정 이메일 주소를 입력하여 계정 소유자[AWS Management Console](https://console.aws.amazon.com/)로에 로그인합니다. 다음 페이지에서 비밀번호를 입력합니다.
루트 사용자를 사용하여 로그인하는 데 도움이 필요하면 *AWS Sign-In 사용 설명서*의 [루트 사용자로 로그인](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)을 참조하세요.
1. 루트 사용자의 다중 인증(MFA)을 활성화합니다.
지침은 *IAM 사용 설명서*의 [AWS 계정 루트 사용자(콘솔)에 대한 가상 MFA 디바이스 활성화를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html).
## AWS CLI 또는 AWS SDK를 설치해야 합니다.
를 설치하려면 설치의 단계를 AWS CLI따르[거나의 최신 버전으로 업데이트합니다 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
AWS SDK를 설치하려면 [Tools to Build on AWS](https://aws.amazon.com/developer/tools/)에서 사용하려는 프로그래밍 언어에 해당하는 탭을 선택합니다. AWS 소프트웨어 개발 키트(SDKs)는 널리 사용되는 여러 프로그래밍 언어에 사용할 수 있습니다. 각 SDK는 개발자가 선호하는 언어로 애플리케이션을 쉽게 구축할 수 있도록 하는 API, 코드 예제 및 설명서를 제공합니다. SDK는 다음과 같은 유용한 작업을 자동으로 수행합니다.
+ 서비스 요청에 대한 암호화 서명
+ 요청 재시도
+ 오류 응답 처리
## 프로그래밍 방식 액세스 권한을 부여하는 자격 증명 가져오기
사용자는 AWS 외부에서와 상호 작용하려는 경우 프로그래밍 방식의 액세스가 필요합니다 AWS Management Console.는 보안 문제에 따라 여러 옵션을 AWS 제공합니다.
**참고**
Amazon Bedrock API에 빠르게 액세스하는 데 사용할 수 있는 API 키를 생성하는 단계별 지침은 [Amazon Bedrock API 키 시작하기: 30일 키를 생성하고 첫 API 직접 호출 수행](getting-started-api-keys.md) 섹션을 참조하세요.
보안 요구 사항의 수준이 더 높은 경우, 이 섹션을 계속 진행합니다.
프로그래밍 방식 액세스를 부여하는 방법은에 액세스하는 사용자 유형에 따라 다릅니다 AWS.
사용자에게 프로그래밍 방식의 액세스 권한을 부여하려면 다음 옵션 중 하나를 선택합니다.
****
| 프로그래밍 방식 액세스가 필요한 위탁자는 누구인가요? | 목적 | 방법 |
| --- | --- | --- |
| IAM 사용자 | 장기 자격 증명의 기간을 제한하여 AWS CLI, AWS SDKs 또는 AWS APIs. | 사용하고자 하는 인터페이스에 대한 지침을 따릅니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/getting-started-api.html) |
| IAM 역할 | 임시 자격 증명을 사용하여 AWS CLI, AWS SDKs 또는 AWS APIs. | IAM 사용 설명서의 [AWS 리소스에서 임시 자격 증명 사용](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)의 지침을 따릅니다. |
| 작업 인력 ID (IAM Identity Center에서 관리되는 사용자) | 임시 자격 증명을 사용하여 AWS CLI, AWS SDKs 또는 AWS APIs. | 사용하고자 하는 인터페이스에 대한 지침을 따릅니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/getting-started-api.html) |
## IAM 사용자의 액세스 키를 구성하는 방법
IAM 사용자에 액세스 키를 사용하기로 결정한 경우 에서는 제한적인 인라인 정책을 포함하여 IAM 사용자에 대한 만료를 설정하는 것이 AWS 좋습니다.
**중요**
다음 경고에 주의하세요.
계정의 루트 자격 증명을 사용하여 AWS 리소스에 액세스**하지 마십시오**. 이 보안 인증은 계정 액세스에 제한이 없고 취소하기 어렵습니다.
**금지 사항.** 애플리케이션 파일에 리터럴 액세스 키나 보안 인증 정보를 넣으면 안 됩니다. 이를 어기는 경우, 예를 들어 프로젝트를 퍼블릭 리포지토리에 업로드하면 뜻하지 않게 보안 인증이 노출될 위험이 있습니다.
**금지 사항.** 프로젝트 영역에 보안 인증이 포함된 파일을 포함하지 마세요.
액세스 키를 안전하게 관리하세요. [계정 식별자를 찾는 데](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html) 도움이 되더라도 액세스 키를 권한 없는 당사자에게 제공하지 마세요. 이렇게 하면 다른 사람에게 계정에 대한 영구 액세스 권한을 부여할 수 있습니다.
공유 자격 증명 파일에 저장된 모든 AWS 자격 증명은 일반 텍스트로 저장됩니다.
자세한 내용은의 [AWS 액세스 키 관리 모범 사례를](https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html) 참조하세요 AWS 일반 참조.
**IAM 사용자를 생성합니다.**
1. AWS Management Console 홈 페이지에서 IAM 서비스를 선택하거나 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) IAM 콘솔로 이동합니다.
1. 탐색 창에서 **사용자**와 **사용자 생성**을 차례로 선택합니다.
1. IAM 콘솔의 지침에 따라 프로그래밍 방식 사용자(에 대한 액세스 권한 없음 AWS Management Console)와 권한 없음을 설정합니다.
**제한된 기간으로 사용자 액세스 제한**
생성하는 모든 IAM 사용자 액세스 키는 장기 자격 증명입니다. 이러한 자격 증명이 잘못 처리된 경우 만료되도록 하려면 키가 더 이상 유효하지 않은 날짜를 지정하는 인라인 정책을 생성하여 자격 증명에 시간 제한을 적용할 수 있습니다.
1. 방금 생성한 IAM 사용자를 엽니다. **권한** 탭에서 **권한 추가**, **인라인 정책 생성**을 차례로 선택합니다.
1. JSON 편집기에서 다음 권한을 지정합니다. 이 정책을 사용하려면 예제 정책의 `aws:CurrentTime` 타임스탬프 값 값을 자체 종료 날짜로 바꿉니다.
**참고**
IAM은 액세스 키를 12시간으로 제한할 것을 권장합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Deny",
"Action": "*",
"Resource": "*",
"Condition": {
"DateGreaterThan": {
"aws:CurrentTime": "2024-01-01T00:00:000"
}
}
}
]
}
```
------
**액세스 키 생성**
1. **사용자 세부 정보** 페이지에서 **보안 자격 증명** 탭을 선택합니다. **액세스 키** 섹션에서 **액세스 키 생성**을 선택합니다.
1. 이러한 액세스 키를 **기타**로 사용할 계획임을 표시하고 **액세스 키 생성**을 선택합니다.
1. **Retrieve access key page**(액세스 키 검색) 페이지에서 **Show**(표시)를 선택하여 사용자의 비밀 액세스 키 값을 표시합니다. 자격 증명을 복사하거나 .csv 파일을 다운로드할 수 있습니다.
**중요**
이 IAM 사용자가 더 이상 필요하지 않은 경우 이를 제거하고 [AWS 보안 모범 사례에](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials) 따라 액세스 시 인간 사용자에게 [AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)를 통해 임시 자격 증명을 사용하도록 요구하는 것이 좋습니다 AWS.
## 사용자 또는 역할에 Amazon Bedrock 권한 연결
프로그래밍 방식 액세스를 위한 자격 증명을 설정한 후에는 사용자 또는 IAM 역할이 Amazon Bedrock 관련 작업 세트에 액세스할 수 있도록 권한을 구성해야 합니다. 이러한 권한을 설정하려면 다음을 수행하세요.
1. AWS Management Console 홈 페이지에서 IAM 서비스를 선택하거나 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) IAM 콘솔로 이동합니다.
1. **사용자** 또는 **역할**을 선택한 다음 사용자나 역할을 선택합니다.
1. **권한** 탭에서 **권한 추가**를 선택한 다음 ** AWS 관리형 정책 추가**를 선택합니다. [AmazonBedrockFullAccess]() AWS 관리형 정책을 선택합니다.
1. 사용자 또는 역할이 모델을 구독하도록 허용하려면 **인라인 정책 생성**을 선택하고 JSON 편집기에서 다음 권한을 지정합니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "MarketplaceBedrock",
"Effect": "Allow",
"Action": [
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Unsubscribe",
"aws-marketplace:Subscribe"
],
"Resource": "*"
}
]
}
```
------
## Amazon Bedrock에 대한 API 직접 호출 수행해 보기
모든 사전 조건을 충족한 후에는 다음 주제 중 하나를 선택하여 Amazon Bedrock 모델을 사용하여 모델 간접 호출 요청을 테스트해 봅니다.
**Topics**
+ [프로그래밍 방식 액세스 권한을 부여하는 자격 증명 가져오기](#gs-grant-program-access)
+ [사용자 또는 역할에 Amazon Bedrock 권한 연결](#gs-api-br-permissions)
+ [Amazon Bedrock에 대한 API 직접 호출 수행해 보기](#gs-try-bedrock)
+ [Amazon Bedrock API 키 시작하기: 30일 키를 생성하고 첫 API 직접 호출 수행](getting-started-api-keys.md)
+ [를 사용하여 예제 Amazon Bedrock API 요청 실행 AWS Command Line Interface](getting-started-api-ex-cli.md)
+ [AWS SDK for Python(Boto3)을 통해 예제 Amazon Bedrock API 요청 실행](getting-started-api-ex-python.md)
+ [Amazon SageMaker AI 노트북을 사용하여 예제 Amazon Bedrock API 요청 실행](getting-started-api-ex-sm.md)