적용 대상: 소비 | 개발자 | 기본 | 표준 | 프리미엄
이 빠른 시작에서는 Azure CLI 명령을 사용하여 새 API Management 인스턴스를 만드는 단계를 설명합니다. 인스턴스를 만든 후 API Management 인스턴스에서 API 가져오기와 같은 일반적인 관리 작업에 Azure CLI를 사용할 수 있습니다.
Azure API Management 를 사용하면 조직에서 외부, 파트너 및 내부 개발자에게 API를 게시하여 데이터 및 서비스의 잠재력을 발휘할 수 있습니다. API Management는 개발자 참여, 비즈니스 통찰력, 분석, 보안과 보호 등을 통해 성공적인 API 프로그램을 보장하는 핵심적인 역량을 제공합니다. API Management를 사용하면 어디에서나 호스트되는 기존 백 엔드 서비스에 대한 최신 API 게이트웨이를 만들고 관리할 수 있습니다.
Azure 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
필수 조건
Bash 환경을 Azure Cloud Shell에서 사용합니다. 자세한 내용은 Azure Cloud Shell 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치하십시오. Windows 또는 macOS에서 실행하는 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 Azure에 인증을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI로 확장 사용 및 관리를 참조하세요.
az version을 실행하여 설치된 버전과 관련 종속 라이브러리를 확인합니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
- 이 문서에는 Azure CLI 버전 2.11.1 이상이 필요합니다. Azure Cloud Shell을 사용하는 경우 최신 버전이 이미 설치되어 있습니다.
리소스 그룹 만들기
모든 Azure 리소스와 마찬가지로 Azure API Management 인스턴스는 리소스 그룹에 배포되어야 합니다. 리소스 그룹을 사용하면 관련 Azure 리소스를 구성하고 관리할 수 있습니다.
먼저 다음 az group create 명령을 사용하여 미국 중부 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다.
az group create --name myResourceGroup --location centralus
API Management 인스턴스 만들기
이제 리소스 그룹이 있으므로 API Management 인스턴스를 만들 수 있습니다. az apim create 명령을 사용하여 하나를 만들고 서비스 이름 및 게시자 세부 정보를 제공합니다. 서비스 이름은 Azure 내에서 고유해야 합니다.
다음 예제에서는 myapim 이 서비스 이름에 사용됩니다. 이름을 고유한 값으로 업데이트합니다. 또한 API 게시자 조직의 이름을 업데이트하고 알림을 받도록 전자 메일 주소를 업데이트합니다.
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
기본적으로 이 명령은 Azure API Management를 평가하는 경제적인 옵션인 개발자 계층에 인스턴스를 만듭니다. 이 계층은 프로덕션용이 아닙니다. API Management 계층 크기 조정에 대한 자세한 내용은 업그레이드 및 크기를 참조하세요.
팁 (조언)
이 계층에서 API Management 서비스를 만들고 활성화하는 데 30~40분이 걸릴 수 있습니다. 이전 명령은 서비스를 만드는 동안 명령이 즉시 반환되도록 옵션을 사용합니다 --no-wait .
az apim show 명령을 실행하여 배포 상태를 확인합니다.
az apim show --name myapim --resource-group myResourceGroup --output table
처음에는 출력이 Activating 상태를 표시하며, 다음과 유사합니다.
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
활성화 후 상태는 서비스 Online 인스턴스에 게이트웨이 주소와 공용 IP 주소가 있습니다. 현재 이러한 주소는 콘텐츠를 노출하지 않습니다. 다음은 그 예입니다.
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- --------------------------------- ------------ ------------ -------- --------- -------
myapim myResourceGroup Central US https://myapim.azure-api.net 203.0.113.1 Online Developer 1
API Management 서비스 인스턴스가 온라인 상태이면 사용할 준비가 된 것입니다. 자습서부터 시작하여 첫 번째 API를 가져오고 게시합니다.
자원을 정리하세요
필요하지 않은 경우 az group delete 명령을 사용하여 리소스 그룹 및 API Management 서비스 인스턴스를 제거할 수 있습니다.
az group delete --name myResourceGroup