Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
DOTYCZY: Zużycie | Deweloper | Podstawowa | Standardowa | Premia
Ten przewodnik szybkiego startu opisuje kroki tworzenia nowego wystąpienia usługi API Management za pomocą poleceń Azure CLI. 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 jeszcze konta platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
Wymagania wstępne
Użyj środowiska Bash w Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Get started with Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj Azure CLI. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie Azure CLI w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić Azure CLI w kontenerze Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do Azure CLI za pomocą polecenia az login. Aby zakończyć proces uwierzytelniania, wykonaj kroki wyświetlane na Twoim terminalu. Aby uzyskać inne opcje logowania, zobacz Uwierzytelnianie na platformie Azure przy użyciu interfejsu wiersza polecenia platformy Azure.
Gdy zostaniesz o to poproszony/a, zainstaluj rozszerzenie Azure CLI przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Używanie rozszerzeń i zarządzanie nimi za pomocą interfejsu wiersza polecenia platformy Azure.
Uruchom az version, aby sprawdzić zainstalowaną wersję i biblioteki zależne. Aby zaktualizować do najnowszej wersji, uruchom 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
Utwórz wystąpienie zarządzania API
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 oraz 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 uaktualnianie i skalowanie.
Wskazówka
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 wynik jest podobny do poniższego i pokazuje stan Activating.
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
Po zakończeniu aktywacji stan to Online, a instancja usługi posiada adres bramy oraz publiczny adres IP. Na razie te adresy nie ujawniają żadnej zawartości. 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 je użyć. Zacznij od samouczka, aby zaimportować i opublikować swój pierwszy interfejs API.
Uprzątnij zasoby
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