Hızlı Başlangıç: PowerShell kullanarak yeni bir Azure API Management örneği oluşturma

ŞUNLAR IÇIN GEÇERLIDIR: Tüketim | Geliştirici | Temel | Standart | Premium

Bu hızlı başlangıçta, Azure PowerShell cmdlet'lerini kullanarak yeni bir API Management örneği oluşturacaksınız. Örnek oluşturduktan sonra API Management örneğinizdeki API'leri içeri aktarma gibi yaygın yönetim eylemleri için Azure PowerShell cmdlet'lerini kullanabilirsiniz.

Azure API Management , kuruluşların veri ve hizmetlerinin potansiyelini ortaya çıkarmaları için API'leri dış, iş ortağı ve iç geliştiricilere yayımlamalarına yardımcı olur. API Management; geliştirici katılımı, iş öngörüleri, analizler, güvenlik ve koruma aracılığıyla başarılı bir API programı yürütmeye ilişkin temel uzmanlıklar sağlar. API Management ile her yerde barındırılan mevcut arka uç hizmetleri için modern API ağ geçitleri oluşturun ve yönetin.

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Önkoşullar

Kaynak grubu oluştur

New-AzResourceGroup ile bir Azure kaynak grubu oluşturun. Kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır.

Aşağıdaki komut, Batı ABD konumunda myResourceGroup adlı bir kaynak grubu oluşturur:

New-AzResourceGroup -Name myResourceGroup -Location WestUS

API Management örneği oluşturma

Artık bir kaynak grubunuz olduğuna göre, bir API Management hizmet örneği oluşturabilirsiniz. New-AzApiManagement kullanarak bir tane oluşturun ve bir hizmet adı ve yayımcı ayrıntıları sağlayın. Hizmet adı Azure içinde benzersiz olmalıdır.

Aşağıdaki örnekte hizmet adı için myapim kullanılmıştır. Adı benzersiz bir değere güncelleştirin. Ayrıca, bildirim almak için API yayımcısının kuruluş adını ve yönetici e-posta adresini güncelleştirin.

Varsayılan olarak, komutu Örneği Azure API Management'ı değerlendirmek için ekonomik bir seçenek olan Geliştirici katmanında oluşturur. Bu katman üretim kullanımı için değildir. API Management katmanları hakkında daha fazla bilgi için bkz . Azure API Management katmanlarının özellik tabanlı karşılaştırması.

İpucu

Bu, uzun süre çalışan bir eylemdir. Bu katmanda API Management hizmetinin oluşturulması ve etkinleştirilmesi 30 ile 40 dakika arasında sürebilir.

New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
  -Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com" 

Komut döndürdüğünde, Azure API Management hizmetinin özelliklerini görüntülemek için Get-AzApiManagement komutunu çalıştırın. Etkinleştirmeden ProvisioningState sonra Başarılı olur ve örneğin ilişkili birkaç URL'si vardır. Örneğin:

Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" 

Örnek çıkış:

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 hizmet örneğiniz dağıtıldıktan sonra kullanmaya hazır olursunuz. İlk API'nizi içeri aktarma ve yayımlama öğreticisiyle başlayın.

Kaynakları temizleme

Artık gerekli olmadığında Remove-AzResourceGroup komutunu kullanarak kaynak grubunu ve tüm ilgili kaynakları kaldırabilirsiniz.

Remove-AzResourceGroup -Name myResourceGroup

Sonraki adımlar