Udostępnij za pośrednictwem


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

  • 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

Następne kroki