

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AMS API 및 CLI 사용
<a name="understand-sent-api"></a>

AWS Managed Services(AMS) API는 다른 AWS 서비스의 APIs. AMS API [참조에서 AMS API](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/index.html)에 대해 읽을 수 있습니다.

## REST 호출을 위한 AMS API HTTP 엔드포인트
<a name="sent-api-endpoints"></a>

다양한 SDKs 외에도 AMS는 CLI를 제공합니다. AMS 엔드포인트에 대해 REST API 호출을 호출할 수도 있습니다.

두 개의 AMS APIs 
+ 변경 관리:이 API를 사용하여 RFCs 생성 및 업데이트, 새 인스턴스 배포, 인스턴스 업데이트 및 삭제, CTs에 대한 정보 가져오기, AMIs 생성 등 인프라에 대한 액세스 또는 변경을 요청합니다. HTTP 엔드포인트는 다음과 같습니다.

  `https://amscm.us-east-1.amazonaws.com`
+ SKMS:이 API를 사용하여 VPCs, 스택, 서브넷 및 AMIs를 포함한 인프라에 대한 정보를 가져옵니다. HTTP 엔드포인트는 다음과 같습니다.

  `https://amsskms.us-east-1.amazonaws.com`

## AMS CLI 설치 또는 업그레이드
<a name="install-sent-cli"></a>

AMS CLI는 AMS API와 쉽게 상호 작용할 수 있는 방법이며이 섹션의 예제에서 사용됩니다. AWS CLI 및 AMS CLI에 대한 사용 규칙은 [AWS 명령줄 인터페이스 사용을 참조하세요](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-using.html).

SAML 설치에 대한 자세한 내용은 섹션을 참조하세요[AD FS 클레임 규칙 및 SAML 설정](adfs-claim-rule-saml.md).

AMS CLI를 설치하거나 업그레이드하려면 다음 지침을 따르세요.
**참고**  
이 절차를 수행하려면 관리자 자격 증명이 있어야 합니다.

AWS CLI는 AWS Managed Services(AMS) CLIs(변경 관리 및 SKMS)를 사용하기 위한 사전 조건입니다.

1. AWS CLI를 설치하려면 [AWS 명령줄 인터페이스 설치를](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) 참조하고 적절한 지침을 따릅니다. 해당 페이지 하단에는 [Linux](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-linux.html), [MS Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html), [macOS](https://docs.aws.amazon.com/cli/latest/userguide/cli-install-macos.html), [가상 환경](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-virtualenv.html), [번들 설치 관리자(Linux, macOS 또는 Unix)](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-bundle.html) 등 다양한 설치 프로그램을 사용하기 위한 지침이 있습니다.

   설치 후를 실행`aws help`하여 설치를 확인합니다.

1. AWS CLI가 설치되면 AMS CLI를 설치하거나 업그레이드하려면 AMS **AMS CLI** 또는 **AMS SDK** 배포 가능 zip 파일을 다운로드하고 압축을 풉니다. AMS 콘솔 왼쪽 탐색 창의 [https://console.aws.amazon.com/managedservices/developerResources](https://console.aws.amazon.com/managedservices/developerResources) 링크를 통해 AMS CLI 배포 파일에 액세스할 수 있습니다.

1. README 파일은 모든 설치에 대한 지침을 제공합니다.

   다음 중 하나를 엽니다.
   + CLI zip: AMS CLI만 제공합니다.
   + SDK zip: 모든 AMS APIs와 AMS CLI를 제공합니다.

   **Windows**의 경우 적절한 설치 관리자(32비트 또는 64비트 시스템만 해당)를 실행합니다.
   + 32비트: **ManagedCloudAPI\$1x86.msi**
   + 64비트: **ManagedCloudAPI\$1x64.msi**

   **Mac/Linux**의 경우 명령을 실행하여 **AWSManagedServices\$1InstallCLI.sh**라는 파일을 실행합니다`sh AWSManagedServices_InstallCLI.sh`. **amscm** 및 **amsskms** 디렉터리와 해당 콘텐츠는 **AWSManagedServices\$1InstallCLI.sh** 파일과 동일한 디렉터리에 있어야 합니다.

1. 기업 자격 증명을 AWS와의 페더레이션(AMS 기본 구성)을 통해 사용하는 경우 페더레이션 서비스에 액세스할 수 있는 자격 증명 관리 도구를 설치해야 합니다. 예를 들어이 AWS 보안 블로그 [ SAML 2.0 및 AD FS를 사용하여 연합 API 및 CLI 액세스를 구현하는 방법을](https://blogs.aws.amazon.com/security/post/Tx1LDN0UBGJJ26Q/How-to-Implement-Federated-API-and-CLI-Access-Using-SAML-2-0-and-AD-FS) 사용하여 자격 증명 관리 도구를 구성할 수 있습니다.

1. 설치 후 `aws amscm help` 및를 실행`aws amsskms help`하여 명령과 옵션을 확인합니다.
**참고**  
이러한 명령이 작동하려면 AMS CLI가 설치되어 있어야 합니다. AMS API 또는 CLI를 설치하려면 AMS 콘솔 **개발자 리소스** 페이지로 이동합니다. AMS CM API 또는 AMS SKMS API에 대한 참조 자료는 사용 설명서의 AMS 정보 리소스 섹션을 참조하세요. 인증 `--profile` 옵션을 추가해야 할 수 있습니다. 예: `aws amsskms ams-cli-command --profile SAML`. 와 같이 모든 AMS 명령이 us-east-1에서 실행되므로 `--region` 옵션을 추가해야 할 수도 있습니다`aws amscm ams-cli-command --region=us-east-1`.