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. |
Core | ogólna dostępność |
| az apim api delete |
Usuwanie interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api export |
Eksportowanie interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api import |
Importowanie interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api list |
Wyświetlanie listy interfejsów API usługi API Management. |
Core | ogólna dostępność |
| az apim api operation |
Zarządzanie operacjami interfejsu API usługi Azure API Management. |
Core | ogólna dostępność |
| az apim api operation create |
Tworzy nową operację w interfejsie API. |
Core | ogólna dostępność |
| az apim api operation delete |
Usuwa określoną operację w interfejsie API. |
Core | ogólna dostępność |
| az apim api operation list |
Wyświetlanie listy kolekcji operacji dla określonego interfejsu API. |
Core | ogólna dostępność |
| az apim api operation show |
Pobiera szczegóły operacji interfejsu API określonej przez jego identyfikator. |
Core | ogólna dostępność |
| az apim api operation update |
Aktualizuje szczegóły operacji w interfejsie API określonym przez jego identyfikator. |
Core | ogólna dostępność |
| az apim api release |
Zarządzanie wydaniem interfejsu API usługi Azure API Management. |
Core | ogólna dostępność |
| az apim api release create |
Tworzy nową wersję dla interfejsu API. |
Core | ogólna dostępność |
| az apim api release delete |
Usuwa określoną wersję w interfejsie API. |
Core | ogólna dostępność |
| az apim api release list |
Wyświetla listę wszystkich wydań interfejsu API. |
Core | ogólna dostępność |
| az apim api release show |
Zwraca szczegóły wydania interfejsu API. |
Core | ogólna dostępność |
| az apim api release update |
Aktualizuje szczegóły wydania interfejsu API określonego przez jego identyfikator. |
Core | ogólna dostępność |
| az apim api revision |
Zarządzanie poprawką interfejsu API usługi Azure API Management. |
Core | ogólna dostępność |
| az apim api revision create |
Utwórz poprawkę interfejsu API. |
Core | ogólna dostępność |
| az apim api revision list |
Wyświetla listę wszystkich poprawek interfejsu API. |
Core | ogólna dostępność |
| az apim api schema |
Zarządzanie schematami interfejsu API usługi Azure API Management. |
Core | ogólna dostępność |
| az apim api schema create |
Tworzenie schematu interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api schema delete |
Usuwanie schematu interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api schema get-etag |
Pobierz element etag schematu interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api schema list |
Wyświetlanie listy schematów interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api schema show |
Pokaż szczegóły schematu interfejsu API usługi API Management. |
Core | 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. |
Core | ogólna dostępność |
| az apim api show |
Pokaż szczegóły interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api update |
Aktualizowanie interfejsu API usługi API Management. |
Core | ogólna dostępność |
| az apim api versionset |
Zarządzanie zestawem wersji interfejsu API usługi Azure API Management. |
Core | ogólna dostępność |
| az apim api versionset create |
Tworzy zestaw wersji interfejsu API. |
Core | ogólna dostępność |
| az apim api versionset delete |
Usuwa określony zestaw wersji interfejsu API. |
Core | ogólna dostępność |
| az apim api versionset list |
Wyświetla kolekcję zestawów wersji interfejsu API w określonym wystąpieniu usługi. |
Core | ogólna dostępność |
| az apim api versionset show |
Pobiera szczegóły zestawu wersji interfejsu API określonego przez jego identyfikator. |
Core | ogólna dostępność |
| az apim api versionset update |
Aktualizuje szczegóły zestawu wersji interfejsu API określonego przez jego identyfikator. |
Core | ogólna dostępność |
| az apim api wait |
Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku interfejsu API apim. |
Core | 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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa wyświetlana interfejsu API do utworzenia.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Ścieżka do interfejsu API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Typ interfejsu API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | graphql, http, soap, websocket |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nie czekaj na zakończenie długotrwałej operacji.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Określa identyfikator openid w ustawieniu uwierzytelniania.
Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | http, https, ws, wss |
Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Określa nazwę nagłówka klucza subskrypcji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Określa nazwę parametru ciągu zapytania klucza subskrypcji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
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ń.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Domyślna wartość: | False |
| Dopuszczalne wartości: | false, true |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Usuń wszystkie poprawki interfejsu API.
Element ETag jednostki.
Nie czekaj na zakończenie długotrwałej operacji.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Nie monituj o potwierdzenie.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az apim api export
Eksportowanie interfejsu API usługi API Management.
az apim api export --api-id
--ef --export-format {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: ^[^*#&+:<>?]+$.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Określ format eksportu interfejsu API.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | OpenApiJsonFile, OpenApiJsonUrl, OpenApiYamlFile, OpenApiYamlUrl, SwaggerFile, SwaggerUrl, WadlFile, WadlUrl, WsdlFile, WsdlUrl |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Ścieżka pliku określona do wyeksportowania interfejsu API.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
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
Required. Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Nazwa wystąpienia usługi API Management.
Określ format zaimportowanego interfejsu API.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | GraphQL, OpenApi, OpenApiJson, Swagger, Wadl, Wsdl |
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Opisuje poprawkę interfejsu API. Jeśli nie podano żadnej wartości, zostanie utworzona domyślna wersja 1.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Typ interfejsu API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | graphql, http, soap, websocket |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Opisuje zestaw wersji, który ma być używany z interfejsem API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Opis interfejsu API. Może zawierać tagi formatowania HTML.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa wyświetlana tego interfejsu API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nie czekaj na zakończenie długotrwałej operacji.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Opisuje, które protokoły (co najmniej jeden) operacje w tym interfejsie API można wywołać.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | http, https, ws, wss |
Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Określa nazwę parametru ciągu zapytania klucza subskrypcji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Jeśli to prawda, interfejs API wymaga klucza subskrypcji dla żądań.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | false, true |
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.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
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 az configure --defaults group=<name>.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Filtr interfejsów API według displayName.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
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.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu 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.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
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.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Nazwa wystąpienia usługi API Management.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
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>.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Generic Update Arguments |
| Domyślna wartość: | [] |
Typ interfejsu API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | graphql, http, soap, websocket |
Opis interfejsu API. Może zawierać tagi formatowania HTML.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Nazwa interfejsu API. Musi mieć długość od 1 do 300 znaków.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Generic Update Arguments |
| Domyślna wartość: | False |
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.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Required. Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | http, https, ws, wss |
Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Generic Update Arguments |
| Domyślna wartość: | [] |
Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Generic Update Arguments |
| Domyślna wartość: | [] |
Określa nazwę nagłówka klucza subskrypcji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Określa nazwę parametru ciągu zapytania klucza subskrypcji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
Jeśli to prawda, interfejs API wymaga klucza subskrypcji dla żądań.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | API Arguments |
| Dopuszczalne wartości: | false, true |
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.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
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. (autogenerated)
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. Required.
Nazwa wystąpienia usługi API Management.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
Poczekaj na usunięcie.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
Zaczekaj, aż zasób istnieje.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
Interwał sondowania w sekundach.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | 30 |
Maksymalny czas oczekiwania w sekundach.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | 3600 |
Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |