az apim api
Zarządzanie interfejsami API usługi Azure API Management.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az apim api create |
Tworzenie interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api delete |
Usuwanie interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api export |
Eksportowanie interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api import |
Importowanie interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api list |
Wyświetlanie listy interfejsów API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api operation |
Zarządzanie operacjami interfejsu API usługi Azure API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api operation create |
Tworzy nową operację w interfejsie API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api operation delete |
Usuwa określoną operację w interfejsie API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api operation list |
Wyświetlanie listy kolekcji operacji dla określonego interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api operation show |
Pobiera szczegóły operacji interfejsu API określonej przez jego identyfikator. |
Podstawowe funkcje | Ogólna dostępność |
az apim api operation update |
Aktualizacje szczegóły operacji w interfejsie API określonym przez jego identyfikator. |
Podstawowe funkcje | Ogólna dostępność |
az apim api release |
Zarządzanie wydaniem interfejsu API usługi Azure API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api release create |
Tworzy nową wersję dla interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api release delete |
Usuwa określoną wersję w interfejsie API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api release list |
Wyświetla listę wszystkich wydań interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api release show |
Zwraca szczegóły wydania interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api release update |
Aktualizacje szczegóły wydania interfejsu API określonego przez jego identyfikator. |
Podstawowe funkcje | Ogólna dostępność |
az apim api revision |
Zarządzanie poprawką interfejsu API usługi Azure API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api revision create |
Utwórz poprawkę interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api revision list |
Wyświetla listę wszystkich poprawek interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api schema |
Zarządzanie schematami interfejsu API usługi Azure API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api schema create |
Tworzenie schematu interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api schema delete |
Usuwanie schematu interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api schema get-etag |
Pobierz element etag schematu interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api schema list |
Wyświetlanie listy schematów interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api schema show |
Pokaż szczegóły schematu interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api schema wait |
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku schematu interfejsu API usługi APIm. |
Podstawowe funkcje | Ogólna dostępność |
az apim api show |
Pokaż szczegóły interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api update |
Aktualizowanie interfejsu API usługi API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api versionset |
Zarządzanie zestawem wersji interfejsu API usługi Azure API Management. |
Podstawowe funkcje | Ogólna dostępność |
az apim api versionset create |
Tworzy zestaw wersji interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api versionset delete |
Usuwa określony zestaw wersji interfejsu API. |
Podstawowe funkcje | Ogólna dostępność |
az apim api versionset list |
Wyświetla kolekcję zestawów wersji interfejsu API w określonym wystąpieniu usługi. |
Podstawowe funkcje | Ogólna dostępność |
az apim api versionset show |
Pobiera szczegóły zestawu wersji interfejsu API określonego przez jego identyfikator. |
Podstawowe funkcje | Ogólna dostępność |
az apim api versionset update |
Aktualizacje szczegóły zestawu wersji interfejsu API określonego przez jego identyfikator. |
Podstawowe funkcje | Ogólna dostępność |
az apim api wait |
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku interfejsu API apim. |
Podstawowe funkcje | Ogólna dostępność |
az apim api create
Tworzenie interfejsu API usługi API Management.
az apim api create --api-id
--display-name
--path
--resource-group
--service-name
[--api-type {graphql, http, soap, websocket}]
[--authorization-scope]
[--authorization-server-id]
[--bearer-token-sending-methods]
[--description]
[--no-wait]
[--open-id-provider-id]
[--protocols {http, https, ws, wss}]
[--service-url]
[--subscription-key-header-name]
[--subscription-key-query-param-name]
[--subscription-key-required]
[--subscription-required {false, true}]
Przykłady
Tworzenie podstawowego interfejsu API.
az apim api create --service-name MyApim -g MyResourceGroup --api-id MyApi --path '/myapi' --display-name 'My API'
Parametry wymagane
Unikatowa nazwa interfejsu API do utworzenia.
Identyfikator poprawki interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki.
Nazwa wyświetlana interfejsu API do utworzenia.
Ścieżka do interfejsu API.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Typ interfejsu API.
Określa zakres operacji OAuth.
Określa identyfikator serwera autoryzacji OAuth.
Określa metody wysyłania tokenu elementu nośnego.
Opis interfejsu API. Może zawierać tagi formatowania HTML.
Nie czekaj na zakończenie długotrwałej operacji.
Określa identyfikator openid w ustawieniu uwierzytelniania.
Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
Określa nazwę nagłówka klucza subskrypcji.
Określa nazwę parametru ciągu zapytania klucza subskrypcji.
Określa, czy klucz subskrypcji jest wymagany podczas wywoływania tego interfejsu API, prawda — interfejs API jest uwzględniany tylko w zamkniętych produktach, false — interfejs API jest uwzględniany tylko w otwartych produktach, wartość null — istnieje kombinacja produktów.
Jeśli to prawda, interfejs API wymaga klucza subskrypcji dla żądań.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az apim api delete
Usuwanie interfejsu API usługi API Management.
az apim api delete --api-id
--resource-group
--service-name
[--delete-revisions]
[--if-match]
[--no-wait]
[--yes]
Parametry wymagane
Identyfikator interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Usuń wszystkie poprawki interfejsu API.
Element ETag jednostki.
Nie czekaj na zakończenie długotrwałej operacji.
Nie monituj o potwierdzenie.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az apim api export
Eksportowanie interfejsu API usługi API Management.
az apim api export --api-id
--ef {OpenApiJsonFile, OpenApiJsonUrl, OpenApiYamlFile, OpenApiYamlUrl, SwaggerFile, SwaggerUrl, WadlFile, WadlUrl, WsdlFile, WsdlUrl}
--resource-group
--service-name
[--file-path]
Przykłady
Eksportowanie interfejsu API usługi API Management do pliku lub zwraca odpowiedź zawierającą link eksportu.
az apim api export -g MyResourceGroup --service-name MyApim --api-id MyApi --export-format OpenApiJson --file-path path
Parametry wymagane
Identyfikator interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki. Wzorzec wyrażenia regularnego: ^[^*#&+:<>?] +$.
Określ format eksportu interfejsu API.
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Ścieżka pliku określona do wyeksportowania interfejsu API.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az apim api import
Importowanie interfejsu API usługi API Management.
az apim api import --path
--resource-group
--service-name
--specification-format {GraphQL, OpenApi, OpenApiJson, Swagger, Wadl, Wsdl}
[--api-id]
[--api-revision]
[--api-type {graphql, http, soap, websocket}]
[--api-version]
[--api-version-set-id]
[--description]
[--display-name]
[--no-wait]
[--protocols {http, https, ws, wss}]
[--service-url]
[--soap-api-type]
[--specification-path]
[--specification-url]
[--subscription-key-header-name]
[--subscription-key-query-param-name]
[--subscription-required {false, true}]
[--wsdl-endpoint-name]
[--wsdl-service-name]
Przykłady
Importowanie interfejsu API usługi API Management z pliku lub adresu URL
az apim api import -g MyResourceGroup --service-name MyApim --path MyApi --specification-url https://MySpecificationURL --specification-format OpenApiJson
Parametry wymagane
Wymagany. Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa wystąpienia usługi API Management.
Określ format zaimportowanego interfejsu API.
Parametry opcjonalne
Identyfikator interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki.
Opisuje poprawkę interfejsu API. Jeśli nie podano żadnej wartości, zostanie utworzona domyślna wersja 1.
Typ interfejsu API.
Opisuje wersję interfejsu API. Jeśli dodasz wersję do interfejsu API innej niż wersja, oryginalna wersja zostanie automatycznie utworzona i odpowie na domyślny adres URL.
Opisuje zestaw wersji, który ma być używany z interfejsem API.
Opis interfejsu API. Może zawierać tagi formatowania HTML.
Nazwa wyświetlana tego interfejsu API.
Nie czekaj na zakończenie długotrwałej operacji.
Opisuje, które protokoły (co najmniej jeden) operacje w tym interfejsie API można wywołać.
Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
Typ interfejsu API, gdy format pliku to WSDL.
Ścieżka pliku określona do zaimportowania interfejsu API.
Adres URL określony do zaimportowania interfejsu API.
Określa nazwę nagłówka klucza subskrypcji.
Określa nazwę parametru ciągu zapytania klucza subskrypcji.
Jeśli to prawda, interfejs API wymaga klucza subskrypcji dla żądań.
Nazwa lokalna punktu końcowego WSDL (port) do zaimportowania.
Nazwa lokalna usługi WSDL do zaimportowania.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az apim api list
Wyświetlanie listy interfejsów API usługi API Management.
az apim api list --resource-group
--service-name
[--filter-display-name]
[--skip]
[--top]
Parametry wymagane
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Filtr interfejsów API według displayName.
Liczba rekordów do pominięcia.
Liczba rekordów do zwrócenia.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az apim api show
Pokaż szczegóły interfejsu API usługi API Management.
az apim api show --api-id
--resource-group
--service-name
Parametry wymagane
Identyfikator interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa wystąpienia usługi API Management.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az apim api update
Aktualizowanie interfejsu API usługi API Management.
az apim api update --api-id
--resource-group
--service-name
[--add]
[--api-type {graphql, http, soap, websocket}]
[--description]
[--display-name]
[--force-string]
[--if-match]
[--no-wait]
[--path]
[--protocols {http, https, ws, wss}]
[--remove]
[--service-url]
[--set]
[--subscription-key-header-name]
[--subscription-key-query-param-name]
[--subscription-required {false, true}]
[--tags]
Przykłady
Tworzenie podstawowego interfejsu API.
az apim api update --service-name MyApim -g MyResourceGroup --api-id MyApi --description foo
Parametry wymagane
Unikatowa nazwa interfejsu API do utworzenia.
Identyfikator poprawki interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>
.
Typ interfejsu API.
Opis interfejsu API. Może zawierać tagi formatowania HTML.
Nazwa interfejsu API. Musi mieć długość od 1 do 300 znaków.
W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.
Element ETag jednostki. Nie jest to wymagane podczas tworzenia jednostki, ale wymagane podczas aktualizowania jednostki. Wartość domyślna to Brak.
Nie czekaj na zakończenie długotrwałej operacji.
Wymagany. Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management.
Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>
.
Określa nazwę nagłówka klucza subskrypcji.
Określa nazwę parametru ciągu zapytania klucza subskrypcji.
Jeśli to prawda, interfejs API wymaga klucza subskrypcji dla żądań.
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az apim api wait
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku interfejsu API apim.
az apim api wait --api-id
--name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Przykłady
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku interfejsu APIm. (automatycznie wygenerowane)
az apim api wait --created --api-id MyApi --name MyApim --resource-group MyResourceGroup
Parametry wymagane
Identyfikator poprawki interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki. Wymagany.
Nazwa wystąpienia usługi API Management.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry opcjonalne
Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".
Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Poczekaj na usunięcie.
Zaczekaj, aż zasób istnieje.
Interwał sondowania w sekundach.
Maksymalny czas oczekiwania w sekundach.
Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.