通过

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

Api Operation - Get

  • 参考
服务:
API Management
API 版本:
2022-08-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}?api-version=2022-08-01

URI 参数

名称 在 必需 类型 说明
apiId
 path True

string

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

正则表达式模式: ^[^*#&+:<>?]+$
operationId
 path True

string

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

string

资源组的名称。 此名称不区分大小写。
serviceName
 path True

string

API 管理服务的名称。

正则表达式模式: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$
subscriptionId
 path True

string

目标订阅的 ID。
api-version
 query True

string

要用于此操作的 API 版本。

响应

名称 类型 说明
200 OK

OperationContract

响应正文包含指定的 Operation 实体。

标头

ETag: string
Other Status Codes

ErrorResponse

描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

ApiManagementGetApiOperation
ApiManagementGetApiOperationPetStore

ApiManagementGetApiOperation

示例请求

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cdc?api-version=2022-08-01

示例响应

状态代码:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/operations/57d2ef278aa04f0ad01d6cdc",
  "type": "Microsoft.ApiManagement/service/apis/operations",
  "name": "57d2ef278aa04f0ad01d6cdc",
  "properties": {
    "displayName": "CancelOrder",
    "method": "POST",
    "urlTemplate": "/?soapAction=http://tempuri.org/IFazioService/CancelOrder",
    "templateParameters": [],
    "request": {
      "description": "IFazioService_CancelOrder_InputMessage",
      "queryParameters": [],
      "headers": [],
      "representations": [
        {
          "contentType": "text/xml",
          "schemaId": "6980a395-f08b-4a59-8295-1440cbd909b8",
          "typeName": "CancelOrder"
        }
      ]
    },
    "responses": [
      {
        "statusCode": 200,
        "description": "IFazioService_CancelOrder_OutputMessage",
        "representations": [
          {
            "contentType": "text/xml",
            "schemaId": "6980a395-f08b-4a59-8295-1440cbd909b8",
            "typeName": "CancelOrderResponse"
          }
        ],
        "headers": []
      }
    ]
  }
}

ApiManagementGetApiOperationPetStore

示例请求

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/swagger-petstore/operations/loginUser?api-version=2022-08-01

示例响应

状态代码:
200 
{
  "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/swagger-petstore/operations/loginUser",
  "type": "Microsoft.ApiManagement/service/apis/operations",
  "name": "loginUser",
  "properties": {
    "displayName": "Logs user into the system",
    "method": "GET",
    "urlTemplate": "/user/login?username={username}&password={password}",
    "templateParameters": [
      {
        "name": "username",
        "description": "The user name for login",
        "type": "string",
        "required": true,
        "values": []
      },
      {
        "name": "password",
        "description": "The password for login in clear text",
        "type": "string",
        "required": true,
        "values": []
      }
    ],
    "description": "",
    "request": {
      "queryParameters": [],
      "headers": [],
      "representations": []
    },
    "responses": [
      {
        "statusCode": 200,
        "description": "successful operation",
        "representations": [
          {
            "contentType": "application/xml",
            "schemaId": "5ba91a35f373b513a0bf31c6",
            "typeName": "UserLoginGet200ApplicationXmlResponse"
          },
          {
            "contentType": "application/json",
            "schemaId": "5ba91a35f373b513a0bf31c6",
            "typeName": "UserLoginGet200ApplicationJsonResponse"
          }
        ],
        "headers": [
          {
            "name": "X-Rate-Limit",
            "description": "calls per hour allowed by the user",
            "type": "integer",
            "values": []
          },
          {
            "name": "X-Expires-After",
            "description": "date in UTC when token expires",
            "type": "string",
            "values": []
          }
        ]
      },
      {
        "statusCode": 400,
        "description": "Invalid username/password supplied",
        "representations": [
          {
            "contentType": "application/xml"
          },
          {
            "contentType": "application/json"
          }
        ],
        "headers": []
      }
    ]
  }
}

定义

名称 说明
ErrorFieldContract

错误字段协定。
ErrorResponse

错误响应。
OperationContract

API 操作详细信息。
ParameterContract

操作参数详细信息。
ParameterExampleContract

参数示例。
RepresentationContract

操作请求/响应表示形式详细信息。
RequestContract

操作请求详细信息。
ResponseContract

操作响应详细信息。

ErrorFieldContract

错误字段协定。

名称 类型 说明
code

string

属性级错误代码。
message

string

属性级错误的可读表示形式。
target

string

属性名称。

ErrorResponse

错误响应。

名称 类型 说明
error.code

string

服务定义的错误代码。 此代码用作响应中指定的 HTTP 错误代码的子状态。
error.details

ErrorFieldContract[]

在发生验证错误的情况下，在请求中发送的无效字段列表。
error.message

string

错误的用户可读表示形式。

OperationContract

API 操作详细信息。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

资源的名称
properties.description

string

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

string

操作名称。
properties.method

string

有效的 HTTP 操作方法。 典型的 Http 方法（如 GET、PUT、POST），但不仅限于它们。
properties.policies

string

操作策略
properties.request

RequestContract

一个实体，包含请求详细信息。
properties.responses

ResponseContract[]

操作响应数组。
properties.templateParameters

ParameterContract[]

URL 模板参数的集合。
properties.urlTemplate

string

相对 URL 模板，标识此操作的目标资源。 可以包括参数。 示例：/customers/{cid}/orders/{oid}/？date={date}
type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ParameterContract

操作参数详细信息。

名称 类型 说明
defaultValue

string

默认参数值。
description

string

参数说明。
examples

<string,  ParameterExampleContract>

为 参数定义的示例。
name

string

参数名称。
required

boolean

指定参数是否为必需。
schemaId

string

架构标识符。
type

string

参数类型。
typeName

string

由架构定义的类型名称。
values

string[]

参数值。

ParameterExampleContract

参数示例。

名称 类型 说明
description

string

示例的长说明
externalValue

string

指向文本示例的 URL
summary

string

示例的简短说明
value

示例值。 可以是基元值，也可以是 对象。

RepresentationContract

操作请求/响应表示形式详细信息。

名称 类型 说明
contentType

string

指定此表示形式的已注册或自定义内容类型，例如 application/xml。
examples

<string,  ParameterExampleContract>

为表示形式定义的示例。
formParameters

ParameterContract[]

表单参数的集合。 如果“contentType”值为“application/x-www-form-urlencoded”或“multipart/form-data”，则是必需的。
schemaId

string

架构标识符。 仅当“contentType”值既不是“application/x-www-form-urlencoded”也不是“multipart/form-data”时适用。
typeName

string

由架构定义的类型名称。 仅当“contentType”值既不是“application/x-www-form-urlencoded”也不是“multipart/form-data”时适用。

RequestContract

操作请求详细信息。

名称 类型 说明
description

string

操作请求说明。
headers

ParameterContract[]

操作请求标头的集合。
queryParameters

ParameterContract[]

操作请求查询参数的集合。
representations

RepresentationContract[]

操作请求表示形式的集合。

ResponseContract

操作响应详细信息。

名称 类型 说明
description

string

操作响应说明。
headers

ParameterContract[]

操作响应标头的集合。
representations

RepresentationContract[]

操作响应表示形式的集合。
statusCode

integer

操作响应 HTTP 状态代码。