你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az apim api operation

参考

管理 Azure API 管理 API 操作。

命令

名称	说明	类型	状态
az apim api operation create	在 API 中创建一个新操作。	核心	GA
az apim api operation delete	删除 API 中的指定操作。	核心	GA
az apim api operation list	列出指定 API 的操作的集合。	核心	GA
az apim api operation show	获取由其标识符指定的 API 操作的详细信息。	核心	GA
az apim api operation update	汇报 API 中由其标识符指定的操作的详细信息。	核心	GA

az apim api operation create

编辑

在 API 中创建一个新操作。

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

示例

使用多个参数在 API 中创建新操作

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"

必需参数

--api-id

API 标识符。在当前API 管理服务实例中必须是唯一的。非当前修订有;rev=n 作为后缀，其中 n 是修订号。

--display-name

必需。操作名称。

--method

必需。有效的 HTTP 操作方法。典型的 Http 方法，如 GET、PUT、POST，但不仅限于它们。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--service-name -n

API 管理服务实例的名称。

--url-template

相对 URL 模板，标识此操作的目标资源。可以包括参数。

可选参数

--description

操作说明。可以包含 HTML 格式标记。

--if-match

实体的 ETag。

--operation-id

API 中的操作标识符。在当前API 管理服务实例中必须是唯一的。

--params --template-parameters -p

URL 模板参数的集合。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az apim api operation delete

编辑

删除 API 中的指定操作。

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

示例

删除 API 中的指定操作。

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

必需参数

--api-id

API 标识符。在当前API 管理服务实例中必须是唯一的。非当前修订有;rev=n 作为后缀，其中 n 是修订号。

--operation-id

API 中的操作标识符。在当前API 管理服务实例中必须是唯一的。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--service-name -n

API 管理服务实例的名称。

可选参数

--if-match

实体的 ETag。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az apim api operation list

编辑

列出指定 API 的操作的集合。

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

示例

列出指定 API 的操作的集合。

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

必需参数

--api-id

API 标识符。在当前API 管理服务实例中必须是唯一的。非当前修订有;rev=n 作为后缀，其中 n 是修订号。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--service-name -n

API 管理服务实例的名称。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az apim api operation show

编辑

获取由其标识符指定的 API 操作的详细信息。

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

示例

获取由其标识符指定的 API 操作的详细信息。

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

必需参数

--api-id

API 标识符。在当前API 管理服务实例中必须是唯一的。非当前修订有;rev=n 作为后缀，其中 n 是修订号。

--operation-id

API 中的操作标识符。在当前API 管理服务实例中必须是唯一的。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--service-name -n

API 管理服务实例的名称。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

az apim api operation update

编辑

汇报 API 中由其标识符指定的操作的详细信息。

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]

示例

汇报方法、displayname、API 中由其标识符指定的操作说明。

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

必需参数

--api-id

API 标识符。在当前API 管理服务实例中必须是唯一的。非当前修订有;rev=n 作为后缀，其中 n 是修订号。

--operation-id

API 中的操作标识符。在当前API 管理服务实例中必须是唯一的。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name> 配置默认组。

--service-name -n

API 管理服务实例的名称。

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。示例：--add property.listProperty <key=value, string or JSON string>。

默认值: []

--description

操作说明。可以包含 HTML 格式标记。

--display-name

必需。操作名称。

--force-string

使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。

默认值: False

--if-match

实体的 ETag。

--method

必需。有效的 HTTP 操作方法。典型的 Http 方法，如 GET、PUT、POST，但不仅限于它们。

--remove

从列表中删除属性或元素。示例： --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []

--set

通过指定要设置的属性路径和值来更新对象。示例：--set property1.property2=<value>。

默认值: []

--url-template

相对 URL 模板，标识此操作的目标资源。可以包括参数。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

通过

az apim api operation

命令

az apim api operation create

示例

必需参数

可选参数

az apim api operation delete

示例

必需参数

可选参数

az apim api operation list

示例

必需参数

az apim api operation show

示例

必需参数

az apim api operation update

示例

必需参数

可选参数

其他资源