AMS API 및 CLI 사용 - AMS 고급 사용 설명서
REST 호출을 위한 AMS API HTTP 엔드포인트AMS CLI 설치 또는 업그레이드

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

AMS API 및 CLI 사용

AWS Managed Services(AMS) API는 다른 AWS 서비스의 APIs. AMS API 참조에서 AMS API에 대해 읽을 수 있습니다.

REST 호출을 위한 AMS API HTTP 엔드포인트

다양한 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 설치 또는 업그레이드

AMS CLI는 AMS API와 쉽게 상호 작용할 수 있는 방법이며이 섹션의 예제에서 사용됩니다. AWS CLI 및 AMS CLI에 대한 사용 규칙은 AWS 명령줄 인터페이스 사용을 참조하세요.

SAML 설치에 대한 자세한 내용은 섹션을 참조하세요AD FS 클레임 규칙 및 SAML 설정.

AMS CLI를 설치하거나 업그레이드하려면 다음 지침을 따르세요.

참고

이 절차를 수행하려면 관리자 자격 증명이 있어야 합니다.

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

  1. AWS CLI를 설치하려면 AWS 명령줄 인터페이스 설치를 참조하고 적절한 지침을 따릅니다. 해당 페이지 하단에는 Linux, MS Windows, macOS, 가상 환경, 번들 설치 관리자(Linux, macOS 또는 Unix) 등 다양한 설치 프로그램을 사용하기 위한 지침이 있습니다.

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

  2. AWS CLI가 설치되면 AMS CLI를 설치하거나 업그레이드하려면 AMS AMS CLI 또는 AMS SDK 배포 가능 zip 파일을 다운로드하고 압축을 풉니다. AMS 콘솔 왼쪽 탐색 창의 개발자 리소스 링크를 통해 AMS CLI 배포 파일에 액세스할 수 있습니다.

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

    다음 중 하나를 엽니다.

    • CLI zip: AMS CLI만 제공합니다.

    • SDK zip: 모든 AMS APIs와 AMS CLI를 제공합니다.

    Windows의 경우 적절한 설치 관리자(32비트 또는 64비트 시스템만 해당)를 실행합니다.

    • 32비트: ManagedCloudAPI_x86.msi

    • 64비트: ManagedCloudAPI_x64.msi

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

  4. 기업 자격 증명을 AWS와의 페더레이션(AMS 기본 구성)을 통해 사용하는 경우 페더레이션 서비스에 액세스할 수 있는 자격 증명 관리 도구를 설치해야 합니다. 예를 들어이 AWS 보안 블로그 SAML 2.0 및 AD FS를 사용하여 연합 API 및 CLI 액세스를 구현하는 방법을 사용하여 자격 증명 관리 도구를 구성할 수 있습니다.

  5. 설치 후 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.