빠른 시작: PowerShell을 사용하여 새 Azure API Management 인스턴스 만들기
적용 대상: 소비 | 개발자 | 기본 | 표준 | 프리미엄
이 빠른 시작에서 Azure PowerShell cmdlet을 사용하여 새 API Management 인스턴스를 만듭니다. 인스턴스를 만든 후 API Management 인스턴스에서 API 가져오기와 같은 일반적인 관리 작업에 Azure PowerShell cmdlet을 사용할 수 있습니다.
Azure API Management를 통해 조직은 외부, 파트너 및 내부 개발자에게 API를 게시하여 데이터 및 서비스의 잠재성을 활용할 수 있습니다. API Management는 개발자 참여, 비즈니스 통찰력, 분석, 보안과 보호 등을 통해 성공적인 API 프로그램을 보장하는 핵심적인 역량을 제공합니다. API Management를 사용하면 어디에서나 호스트되는 기존 백 엔드 서비스에 대한 최신 API 게이트웨이를 만들고 관리할 수 있습니다.
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
필수 조건
- Azure PowerShell을 로컬로 사용하도록 선택하는 경우:
- 최신 버전의 Az PowerShell 모듈을 설치합니다.
- Connect-AzAccount cmdlet을 사용하여 Azure 계정에 로그인합니다.
- Azure Cloud Shell을 사용하도록 선택하는 경우:
- 자세한 내용은 Azure Cloud Shell 개요를 참조하세요.
리소스 그룹 만들기
New-AzResourceGroup을 사용하여 Azure 리소스 그룹을 만듭니다. 리소스 그룹은 Azure 리소스가 배포 및 관리되는 논리적 컨테이너입니다.
다음 명령은 미국 서부 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다.
New-AzResourceGroup -Name myResourceGroup -Location WestUS
API Management 인스턴스 만들기
이제 리소스 그룹이 있으므로 API Management 서비스 인스턴스를 만들 수 있습니다. New-AzApiManagement를 사용하여 만들고 서비스 이름과 게시자 세부 정보를 제공합니다. 서비스 이름은 Azure 내에서 고유해야 합니다.
다음 예제에서는 myapim이 서비스 이름에 사용됩니다. 이름을 고유한 값으로 업데이트합니다. 또한 API 게시자의 조직 이름과 알림을 받을 관리자 이메일 주소를 업데이트합니다.
기본적으로 이 명령은 Azure API Management를 평가하는 경제적인 옵션인 개발자 계층에서 인스턴스를 만듭니다. 이 계층은 프로덕션 용도가 아닙니다. API Management 계층에 대한 자세한 내용은 Azure API Management 계층의 기능 기반 비교를 참조하세요.
팁
이는 장기 실행 작업입니다. 이 계층에서 API Management 서비스를 만들고 활성화하는 데 30~40분 정도 걸릴 수 있습니다.
New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
-Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com"
명령이 반환되면 Get-AzApiManagement를 실행하여 Azure API Management 서비스의 속성을 봅니다. 활성화 후 ProvisioningState는 Succeeded이고 인스턴스에는 여러 개의 연결된 URL이 있습니다. 예시:
Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup"
예제 출력:
PublicIPAddresses : {203.0.113.1}
PrivateIPAddresses :
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ApiManagement/service/myapim
Name : myapim
Location : West US
Sku : Developer
Capacity : 1
CreatedTimeUtc : 9/9/2022 9:07:43 PM
ProvisioningState : Succeeded
RuntimeUrl : https://myapim.azure-api.net
RuntimeRegionalUrl : https://myapi-westus-01.regional.azure-api.net
PortalUrl : https://myapim.portal.azure-api.net
DeveloperPortalUrl : https://myapim.developer.azure-api.net
ManagementApiUrl : https://myapim.management.azure-api.net
ScmUrl : https://myapim.scm.azure-api.net
PublisherEmail : admin@contoso.com
OrganizationName : Contoso
NotificationSenderEmail : apimgmt-noreply@mail.windowsazure.com
VirtualNetwork :
VpnType : None
PortalCustomHostnameConfiguration :
ProxyCustomHostnameConfiguration : {myapim.azure-api.net}
ManagementCustomHostnameConfiguration :
ScmCustomHostnameConfiguration :
DeveloperPortalHostnameConfiguration :
SystemCertificates :
Tags : {}
AdditionalRegions : {}
SslSetting : Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementSslSetting
Identity :
EnableClientCertificate :
EnableClientCertificate :
Zone :
DisableGateway : False
MinimalControlPlaneApiVersion :
PublicIpAddressId :
PlatformVersion : stv2
PublicNetworkAccess : Enabled
PrivateEndpointConnections :
ResourceGroupName : myResourceGroup
API Management 서비스 인스턴스가 배포되면 사용할 준비가 된 것입니다. 자습서를 시작하여 첫 번째 API를 가져오고 게시하세요.
리소스 정리
더 이상 필요하지 않은 경우 Remove-AzResourceGroup 명령을 사용하여 리소스 그룹 및 모든 관련 리소스를 제거할 수 있습니다.
Remove-AzResourceGroup -Name myResourceGroup