az apic api version
Note
Den här referensen är en del av tillägget apic-extension för Azure CLI (version 2.57.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az apic api version kommando. Läs mer om tillägg.
Kommandon för att hantera API-versioner i API Center.
Kommandon
| Name | Description | Typ | Status |
|---|---|---|---|
| az apic api version create |
Skapa en ny API-version eller uppdatera en befintlig API-version. |
Extension | GA |
| az apic api version delete |
Ta bort angiven API-version. |
Extension | GA |
| az apic api version list |
Visa en lista över en samling API-versioner. |
Extension | GA |
| az apic api version show |
Hämta information om API-versionen. |
Extension | GA |
| az apic api version update |
Uppdatera befintlig API-version. |
Extension | GA |
az apic api version create
Skapa en ny API-version eller uppdatera en befintlig API-version.
az apic api version create --api-id
--lifecycle-stage {deprecated, design, development, preview, production, retired, testing}
--resource-group
--service-name
--title
--version-id
Exempel
Skapa API-version
az apic api version create -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --title "2023-01-01" --lifecycle-stage production
Obligatoriska parametrar
ID:t för API:et.
Aktuell livscykelfas för API:et.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Properties Arguments |
| Godkända värden: | deprecated, design, development, preview, production, retired, testing |
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
Namnet på Azure API Center-tjänsten.
API-version.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Properties Arguments |
ID:t för API-versionen.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az apic api version delete
Ta bort angiven API-version.
az apic api version delete [--api-id]
[--ids]
[--resource-group]
[--service-name]
[--subscription]
[--version-id]
[--yes]
Exempel
Ta bort API-version
az apic api version delete -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01
Valfria parametrar
Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.
ID:t för API:et.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Namnet på Azure API Center-tjänsten.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
ID:t för API-versionen.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Fråga inte efter bekräftelse.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az apic api version list
Visa en lista över en samling API-versioner.
az apic api version list --api-id
--resource-group
--service-name
[--filter]
[--max-items]
[--next-token]
Exempel
Lista API-versioner
az apic api version list -g api-center-test -n contosoeuap --api-id echo-api
Obligatoriska parametrar
ID:t för API:et.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
Namnet på Azure API Center-tjänsten.
Valfria parametrar
Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.
OData-filterparameter.
Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argument för ett efterföljande kommando.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Pagination Arguments |
Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Pagination Arguments |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az apic api version show
Hämta information om API-versionen.
az apic api version show [--api-id]
[--ids]
[--resource-group]
[--service-name]
[--subscription]
[--version-id]
Exempel
Visa information om API-version
az apic api version show -g api-center-test -n contoso --api-id echo-api --version-id 2023-01-01
Valfria parametrar
Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.
ID:t för API:et.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Namnet på Azure API Center-tjänsten.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
ID:t för API-versionen.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az apic api version update
Uppdatera befintlig API-version.
az apic api version update [--add]
[--api-id]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--lifecycle-stage {deprecated, design, development, preview, production, retired, testing}]
[--remove]
[--resource-group]
[--service-name]
[--set]
[--subscription]
[--title]
[--version-id]
Exempel
Uppdatera API-version
az apic api version update -g api-center-test -n contosoeuap --api-id echo-api --version-id 2023-01-01 --title "2023-01-01"
Valfria parametrar
Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.
Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Generic Update Arguments |
ID:t för API:et.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Generic Update Arguments |
| Godkända värden: | 0, 1, f, false, n, no, t, true, y, yes |
Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Aktuell livscykelfas för API:et.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Properties Arguments |
| Godkända värden: | deprecated, design, development, preview, production, retired, testing |
Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Generic Update Arguments |
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Namnet på Azure API Center-tjänsten.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Generic Update Arguments |
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
API-version.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Properties Arguments |
ID:t för API-versionen.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Resource Id Arguments |
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |