az apic api definition
Note
This reference is part of the apic-extension extension for the Azure CLI (version 2.57.0 or higher). The extension will automatically install the first time you run an az apic api definition command. Learn more about extensions.
Commands to manage API definitions in API Center.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az apic api definition create |
Create a new API definition or update an existing API definition. |
Extension | GA |
| az apic api definition delete |
Delete specified API definition. |
Extension | GA |
| az apic api definition export-specification |
Exports the API specification. |
Extension | GA |
| az apic api definition import-specification |
Imports the API specification. |
Extension | GA |
| az apic api definition list |
List a collection of API definitions. |
Extension | GA |
| az apic api definition show |
Get details of the API definition. |
Extension | GA |
| az apic api definition update |
Update existing API definition. |
Extension | GA |
az apic api definition create
Create a new API definition or update an existing API definition.
az apic api definition create --api-id
--definition-id
--resource-group
--service
--title
--version-id
[--description]Examples
Create API definition
az apic api definition create -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi" --title "OpenAPI"Required Parameters
The id of the API.
The id of the API definition.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the API Center service.
API version.
The id of the API version.
Optional Parameters
API definition description.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az apic api definition delete
Delete specified API definition.
az apic api definition delete [--api-id]
[--definition-id]
[--ids]
[--resource-group]
[--service]
[--subscription]
[--version-id]
[--yes]Examples
Delete API definition
az apic api definition delete -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi"Optional Parameters
The id of the API.
The id of the API definition.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the API Center service.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
The id of the API version.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az apic api definition export-specification
Exports the API specification.
az apic api definition export-specification --file-name
[--api-id]
[--definition-id]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--service]
[--subscription]
[--version-id]Examples
Export Specification
az apic api version definition export-specification -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id defaultRequired Parameters
Name of the file where to export the spec to.
Optional Parameters
The id of the API.
The id of the API definition.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Do not wait for the long-running operation to finish.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the API Center service.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
The id of the API version.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az apic api definition import-specification
Imports the API specification.
az apic api definition import-specification [--api-id]
[--definition-id]
[--file-name]
[--format {inline, link}]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--service]
[--specification]
[--subscription]
[--value]
[--version-id]Examples
Import specification example 1
az apic api definition import-specification -g api-center-test -s contosoeuap --api-id echo-api-2 --version-id 2023-08-01 --definition-id openapi3 --format "inline" --value '{"openapi":"3.0.1","info":{"title":"httpbin.org","description":"API Management facade for a very handy and free online HTTP tool.","version":"1.0"}}' --specification '{"name":"openapi","version":"3.0.0"}'Import specification example 2
az apic api definition import-specification -g api-center-test -s contoso --api-id echo-api --version-id 2023-11-01 --definition-id openapi --format "link" --value 'https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.json' --specification '{"name":"openapi","version":"3.0.0"}'Optional Parameters
The id of the API.
The id of the API definition.
Name of the file from where to import the spec from.
Format of the API specification source.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Do not wait for the long-running operation to finish.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the API Center service.
API specification details. Support shorthand-syntax, json-file and yaml-file. Try "??" to show more.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Value of the API specification source.
The id of the API version.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az apic api definition list
List a collection of API definitions.
az apic api definition list --api-id
--resource-group
--service
--version-id
[--filter]
[--max-items]
[--next-token]Examples
List API definitions
az apic api definition list -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01Required Parameters
The id of the API.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the API Center service.
The id of the API version.
Optional Parameters
OData filter parameter.
Total number of items to return in the command's output. If the total number of items available is more than the value specified, a token is provided in the command's output. To resume pagination, provide the token value in --next-token argument of a subsequent command.
Token to specify where to start paginating. This is the token value from a previously truncated response.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az apic api definition show
Get details of the API definition.
az apic api definition show [--api-id]
[--definition-id]
[--ids]
[--resource-group]
[--service]
[--subscription]
[--version-id]Examples
Show API definition details
az apic api definition show -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi"Optional Parameters
The id of the API.
The id of the API definition.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the API Center service.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
The id of the API version.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
az apic api definition update
Update existing API definition.
az apic api definition update [--add]
[--api-id]
[--definition-id]
[--description]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--remove]
[--resource-group]
[--service]
[--set]
[--subscription]
[--title]
[--version-id]Examples
Update API definition
az apic api definition update -g api-center-test -s contosoeuap --api-id echo-api --version-id 2023-01-01 --definition-id "openapi" --title "OpenAPI"Optional Parameters
Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.
The id of the API.
The id of the API definition.
API definition description.
When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
The name of the API Center service.
Update an object by specifying a property path and value to set. Example: --set property1.property2=.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
API version title.
The id of the API version.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for