Szybki start: tworzenie nowego wystąpienia usługi Azure API Management przy użyciu interfejsu wiersza polecenia platformy Azure
DOTYCZY: Zużycie | Deweloper | Podstawowa | Standardowa | Premium
W tym przewodniku Szybki start opisano kroki tworzenia nowego wystąpienia usługi API Management przy użyciu poleceń interfejsu wiersza polecenia platformy Azure. Po utworzeniu wystąpienia można użyć interfejsu wiersza polecenia platformy Azure do wykonywania typowych zadań zarządzania, takich jak importowanie interfejsów API w wystąpieniu usługi API Management.
Usługa Azure API Management pomaga organizacjom publikować interfejsy API dla deweloperów zewnętrznych, partnerskich i wewnętrznych w celu odblokowania potencjału swoich danych i usług. Usługa API Management udostępnia podstawowe funkcje wymagane do tworzenia skutecznych interfejsów API przez zaangażowanych deweloperów, a także zapewnia informacje biznesowe, analizy, zabezpieczenia i ochronę. Usługa API Management umożliwia tworzenie nowoczesnych bram interfejsów API i zarządzanie nimi dla istniejących usług zaplecza hostowanych w dowolnym miejscu.
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Wymagania wstępne
Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
- Ten artykuł wymaga wersji 2.11.1 lub nowszej interfejsu wiersza polecenia platformy Azure. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.
Tworzenie grupy zasobów
Wystąpienia usługi Azure API Management, podobnie jak wszystkie zasoby platformy Azure, muszą zostać wdrożone w grupie zasobów. Grupy zasobów umożliwiają organizowanie powiązanych zasobów platformy Azure i zarządzanie nimi.
Najpierw utwórz grupę zasobów o nazwie myResourceGroup w lokalizacji Środkowe stany USA za pomocą następującego polecenia az group create :
az group create --name myResourceGroup --location centralus
Tworzenie wystąpienia usługi API Management
Teraz, gdy masz grupę zasobów, możesz utworzyć wystąpienie usługi API Management. Utwórz je przy użyciu polecenia az apim create i podaj nazwę usługi i szczegóły wydawcy. Nazwa usługi musi być unikatowa na platformie Azure.
W poniższym przykładzie myapim jest używany dla nazwy usługi. Zaktualizuj nazwę na unikatową wartość. Zaktualizuj również nazwę organizacji wydawcy interfejsu API i adres e-mail, aby otrzymywać powiadomienia.
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
Domyślnie polecenie tworzy wystąpienie w warstwie Deweloper— ekonomiczną opcję oceny usługi Azure API Management. Ta warstwa nie jest używana w środowisku produkcyjnym. Aby uzyskać więcej informacji na temat skalowania warstw usługi API Management, zobacz Upgrade and scale (Uaktualnianie i skalowanie).
Napiwek
Utworzenie i aktywowanie usługi API Management w tej warstwie może potrwać od 30 do 40 minut. Poprzednie polecenie używa --no-wait opcji , aby polecenie zwracało się natychmiast podczas tworzenia usługi.
Sprawdź stan wdrożenia, uruchamiając polecenie az apim show :
az apim show --name myapim --resource-group myResourceGroup --output table
Początkowo dane wyjściowe są podobne do następujących, pokazując Activating stan:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
Po aktywacji stan to Online , a wystąpienie usługi ma adres bramy i publiczny adres IP. Na razie te adresy nie ujawniają żadnej zawartości. Na przykład:
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
Gdy wystąpienie usługi API Management jest w trybie online, możesz go użyć. Zacznij od samouczka, aby zaimportować i opublikować swój pierwszy interfejs API.
Czyszczenie zasobów
Możesz użyć polecenia az group delete , aby usunąć grupę zasobów i wystąpienie usługi API Management, gdy nie są potrzebne.
az group delete --name myResourceGroup