az apim api operation

Verwalten von Azure API Management API-Vorgängen

Befehle

az apim api operation create	Erstellt einen neuen Vorgang in der API.
az apim api operation delete	Löscht den angegebenen Vorgang aus der API
az apim api operation list	Listet eine Auflistung der Vorgänge für die angegebene API auf.
az apim api operation show	Ruft die Details des API-Vorgangs ab, der durch den Bezeichner angegeben wird.
az apim api operation update	Aktualisierungen die Details des Vorgangs in der API, die durch den Bezeichner angegeben wird.

az apim api operation create

Erstellt einen neuen Vorgang in der API.

az apim api operation create --api-id
                             --display-name
                             --method
                             --resource-group
                             --service-name
                             --url-template
                             [--description]
                             [--if-match]
                             [--operation-id]
                             [--params]

Beispiele

Erstellt einen neuen Vorgang in der API mit mehreren Parametern

az apim api operation create --resource-group MyResourceGroup --service-name MyServiceName --api-id MyApiId --url-template "/session/{param1}/{param2}" --method "GET" --display-name MyOperationName --description MyDescription --template-parameters name=param1 description=descriptionContent type=paramType required="true" --template-parameters name=param2 required="false" type="string"

Erforderliche Parameter

--api-id

API-Bezeichner. Muss in der aktuellen API Management Dienstinstanz eindeutig sein. Die nicht aktuelle Überarbeitung hat ;rev=n als Suffix, wobei n die Revisionsnummer ist.

--display-name

Erforderlich. Vorgangsname.

--method

Erforderlich. Eine gültige HTTP-Operationsmethode. Typische Http-Methoden wie GET, PUT, POST, aber nicht nur durch sie beschränkt.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--service-name -n

Der Name der API Management Dienstinstanz.

--url-template

Relative URL-Vorlage, die die Zielressource für diesen Vorgang identifiziert. Kann Parameter enthalten.

Optionale Parameter

--description

Beschreibung des Vorgangs. Kann HTML-Formatierungstags umfassen.

--if-match

ETag der Entität.

--operation-id

Vorgangsbezeichner innerhalb einer API. Muss in der aktuellen API Management Dienstinstanz eindeutig sein.

--params --template-parameters -p

Sammlung von URL-Vorlagenparametern.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az apim api operation delete

Löscht den angegebenen Vorgang aus der API

az apim api operation delete --api-id
                             --operation-id
                             --resource-group
                             --service-name
                             [--if-match]

Beispiele

Löscht den angegebenen Vorgang aus der API

az apim api operation delete --resource-group MyResourceGroup --service-name MyServiceName --api-id MyApiId --operation-id MyOperationId

Erforderliche Parameter

--api-id

API-Bezeichner. Muss in der aktuellen API Management Dienstinstanz eindeutig sein. Die nicht aktuelle Überarbeitung hat ;rev=n als Suffix, wobei n die Revisionsnummer ist.

--operation-id

Vorgangsbezeichner innerhalb einer API. Muss in der aktuellen API Management Dienstinstanz eindeutig sein.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--service-name -n

Der Name der API Management Dienstinstanz.

Optionale Parameter

--if-match

ETag der Entität.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az apim api operation list

Listet eine Auflistung der Vorgänge für die angegebene API auf.

az apim api operation list --api-id
                           --resource-group
                           --service-name

Beispiele

Listet eine Auflistung der Vorgänge für die angegebene API auf.

az apim api operation list --resource-group MyResourceGroup --service-name MyServiceName --api-id MyApiId

Erforderliche Parameter

--api-id

API-Bezeichner. Muss in der aktuellen API Management Dienstinstanz eindeutig sein. Die nicht aktuelle Überarbeitung hat ;rev=n als Suffix, wobei n die Revisionsnummer ist.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--service-name -n

Der Name der API Management Dienstinstanz.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az apim api operation show

Ruft die Details des API-Vorgangs ab, der durch den Bezeichner angegeben wird.

az apim api operation show --api-id
                           --operation-id
                           --resource-group
                           --service-name

Beispiele

Ruft die Details des API-Vorgangs ab, der durch den Bezeichner angegeben wird.

az apim api operation show --resource-group MyResourceGroup --service-name MyServiceName --api-id MyApiId --operation-id MyOperationId

Erforderliche Parameter

--api-id

API-Bezeichner. Muss in der aktuellen API Management Dienstinstanz eindeutig sein. Die nicht aktuelle Überarbeitung hat ;rev=n als Suffix, wobei n die Revisionsnummer ist.

--operation-id

Vorgangsbezeichner innerhalb einer API. Muss in der aktuellen API Management Dienstinstanz eindeutig sein.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--service-name -n

Der Name der API Management Dienstinstanz.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az apim api operation update

Aktualisierungen die Details des Vorgangs in der API, die durch den Bezeichner angegeben wird.

az apim api operation update --api-id
                             --operation-id
                             --resource-group
                             --service-name
                             [--add]
                             [--description]
                             [--display-name]
                             [--force-string]
                             [--if-match]
                             [--method]
                             [--remove]
                             [--set]
                             [--url-template]

Beispiele

Aktualisierungen Methode, Anzeigename, Beschreibung des Vorgangs in der API, die durch den Bezeichner angegeben wird.

az apim api operation update --resource-group MyResourceGroup --service-name MyServiceName --api-id MyApiId --operation-id MyOperationId --method "PUT" --display-name NewDisplayName --description NewDescription

Erforderliche Parameter

--api-id

API-Bezeichner. Muss in der aktuellen API Management Dienstinstanz eindeutig sein. Die nicht aktuelle Überarbeitung hat ;rev=n als Suffix, wobei n die Revisionsnummer ist.

--operation-id

Vorgangsbezeichner innerhalb einer API. Muss in der aktuellen API Management Dienstinstanz eindeutig sein.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--service-name -n

Der Name der API Management Dienstinstanz.

Optionale Parameter

--add

Fügen Sie einem Objekt eine Liste von Objekten hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--description

Beschreibung des Vorgangs. Kann HTML-Formatierungstags umfassen.

--display-name

Erforderlich. Vorgangsname.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.

--if-match

ETag der Entität.

--method

Erforderlich. Eine gültige HTTP-Operationsmethode. Typische Http-Methoden wie GET, PUT, POST, aber nicht nur durch sie beschränkt.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.

--url-template

Relative URL-Vorlage, die die Zielressource für diesen Vorgang identifiziert. Kann Parameter enthalten.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.