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

Microsoft.ApiManagement service/apis/operations 2016-07-07

Bicep 资源定义

可以使用目标操作部署服务/apis/operations 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.ApiManagement/service/apis/operations 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.ApiManagement/service/apis/operations@2016-07-07' = {
  parent: resourceSymbolicName
  description: 'string'
  method: 'string'
  name: 'string'
  request: {
    description: 'string'
    headers: [
      {
        defaultValue: 'string'
        description: 'string'
        name: 'string'
        required: bool
        type: 'string'
        values: [
          'string'
        ]
      }
    ]
    queryParameters: [
      {
        defaultValue: 'string'
        description: 'string'
        name: 'string'
        required: bool
        type: 'string'
        values: [
          'string'
        ]
      }
    ]
    representations: [
      {
        contentType: 'string'
        sample: 'string'
      }
    ]
  }
  responses: [
    {
      description: 'string'
      representations: [
        {
          contentType: 'string'
          sample: 'string'
        }
      ]
      statusCode: int
    }
  ]
  templateParameters: [
    {
      defaultValue: 'string'
      description: 'string'
      name: 'string'
      required: bool
      type: 'string'
      values: [
        'string'
      ]
    }
  ]
  urlTemplate: 'string'
}

属性值

Microsoft.ApiManagement/service/apis/operations

名字 描述 价值
描述 操作的说明。 可能包括 HTML 格式标记。 字符串

约束:
最大长度 =
方法 有效的 HTTP 操作方法。 典型的 Http 方法,如 GET、PUT、POST,但不仅限于它们。 string (必需)
名字 资源名称 字符串

约束:
最小长度 = 1
最大长度 = 1
模式 = ^[^*#&+:<>?]+$ (必需)
父母 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源外部的子资源
类型资源的符号名称:服务/apis
请求 包含请求详细信息的实体。 RequestContract
反应 操作响应数组。 ResultContract[]
templateParameters URL 模板参数的集合。 ParameterContract[]
urlTemplate 标识此操作的目标资源的相对 URL 模板。 可能包括参数。 示例:/customers/{cid}/orders/{oid}/?date={date} 字符串

约束:
最小长度 = 1
最大长度 = 1 (必需)

ParameterContract

名字 描述 价值
defaultValue 默认参数值。 字符串
描述 参数说明。 字符串
名字 参数名称。 string (必需)
必填 参数是否是必需的。 bool
类型 参数类型。 string (必需)
参数值。 string[]

RepresentationContract

名字 描述 价值
contentType 为此表示形式指定已注册或自定义内容类型,例如 application/xml。 string (必需)
样本 表示形式的示例。 字符串

RequestContract

名字 描述 价值
描述 操作请求说明。 字符串
操作请求标头的集合。 ParameterContract[]
queryParameters 操作请求查询参数的集合。 ParameterContract[]
交涉 操作请求表示形式的集合。 RepresentationContract[]

ResultContract

名字 描述 价值
描述 操作响应说明。 字符串
交涉 操作响应表示形式的集合。 RepresentationContract[]
statusCode 操作响应 HTTP 状态代码。 int

约束:
最小值 = 100
最大值 = 599 (必需)

ARM 模板资源定义

可以使用目标操作部署服务/apis/operations 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.ApiManagement/service/apis/operations 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.ApiManagement/service/apis/operations",
  "apiVersion": "2016-07-07",
  "name": "string",
  "description": "string",
  "method": "string",
  "request": {
    "description": "string",
    "headers": [
      {
        "defaultValue": "string",
        "description": "string",
        "name": "string",
        "required": "bool",
        "type": "string",
        "values": [ "string" ]
      }
    ],
    "queryParameters": [
      {
        "defaultValue": "string",
        "description": "string",
        "name": "string",
        "required": "bool",
        "type": "string",
        "values": [ "string" ]
      }
    ],
    "representations": [
      {
        "contentType": "string",
        "sample": "string"
      }
    ]
  },
  "responses": [
    {
      "description": "string",
      "representations": [
        {
          "contentType": "string",
          "sample": "string"
        }
      ],
      "statusCode": "int"
    }
  ],
  "templateParameters": [
    {
      "defaultValue": "string",
      "description": "string",
      "name": "string",
      "required": "bool",
      "type": "string",
      "values": [ "string" ]
    }
  ],
  "urlTemplate": "string"
}

属性值

Microsoft.ApiManagement/service/apis/operations

名字 描述 价值
apiVersion API 版本 '2016-07-07'
描述 操作的说明。 可能包括 HTML 格式标记。 字符串

约束:
最大长度 =
方法 有效的 HTTP 操作方法。 典型的 Http 方法,如 GET、PUT、POST,但不仅限于它们。 string (必需)
名字 资源名称 字符串

约束:
最小长度 = 1
最大长度 = 1
模式 = ^[^*#&+:<>?]+$ (必需)
请求 包含请求详细信息的实体。 RequestContract
反应 操作响应数组。 ResultContract[]
templateParameters URL 模板参数的集合。 ParameterContract[]
类型 资源类型 “Microsoft.ApiManagement/service/apis/operations”
urlTemplate 标识此操作的目标资源的相对 URL 模板。 可能包括参数。 示例:/customers/{cid}/orders/{oid}/?date={date} 字符串

约束:
最小长度 = 1
最大长度 = 1 (必需)

ParameterContract

名字 描述 价值
defaultValue 默认参数值。 字符串
描述 参数说明。 字符串
名字 参数名称。 string (必需)
必填 参数是否是必需的。 bool
类型 参数类型。 string (必需)
参数值。 string[]

RepresentationContract

名字 描述 价值
contentType 为此表示形式指定已注册或自定义内容类型,例如 application/xml。 string (必需)
样本 表示形式的示例。 字符串

RequestContract

名字 描述 价值
描述 操作请求说明。 字符串
操作请求标头的集合。 ParameterContract[]
queryParameters 操作请求查询参数的集合。 ParameterContract[]
交涉 操作请求表示形式的集合。 RepresentationContract[]

ResultContract

名字 描述 价值
描述 操作响应说明。 字符串
交涉 操作响应表示形式的集合。 RepresentationContract[]
statusCode 操作响应 HTTP 状态代码。 int

约束:
最小值 = 100
最大值 = 599 (必需)

Terraform (AzAPI 提供程序)资源定义

可以使用目标操作部署服务/apis/operations 资源类型:

  • 资源组

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.ApiManagement/service/apis/operations 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/operations@2016-07-07"
  name = "string"
  description = "string"
  method = "string"
  request = {
    description = "string"
    headers = [
      {
        defaultValue = "string"
        description = "string"
        name = "string"
        required = bool
        type = "string"
        values = [
          "string"
        ]
      }
    ]
    queryParameters = [
      {
        defaultValue = "string"
        description = "string"
        name = "string"
        required = bool
        type = "string"
        values = [
          "string"
        ]
      }
    ]
    representations = [
      {
        contentType = "string"
        sample = "string"
      }
    ]
  }
  responses = [
    {
      description = "string"
      representations = [
        {
          contentType = "string"
          sample = "string"
        }
      ]
      statusCode = int
    }
  ]
  templateParameters = [
    {
      defaultValue = "string"
      description = "string"
      name = "string"
      required = bool
      type = "string"
      values = [
        "string"
      ]
    }
  ]
  urlTemplate = "string"
}

属性值

Microsoft.ApiManagement/service/apis/operations

名字 描述 价值
描述 操作的说明。 可能包括 HTML 格式标记。 字符串

约束:
最大长度 =
方法 有效的 HTTP 操作方法。 典型的 Http 方法,如 GET、PUT、POST,但不仅限于它们。 string (必需)
名字 资源名称 字符串

约束:
最小长度 = 1
最大长度 = 1
模式 = ^[^*#&+:<>?]+$ (必需)
parent_id 此资源的父资源的 ID。 类型资源的 ID:服务/apis
请求 包含请求详细信息的实体。 RequestContract
反应 操作响应数组。 ResultContract[]
templateParameters URL 模板参数的集合。 ParameterContract[]
类型 资源类型 “Microsoft.ApiManagement/service/apis/operations@2016-07-07”
urlTemplate 标识此操作的目标资源的相对 URL 模板。 可能包括参数。 示例:/customers/{cid}/orders/{oid}/?date={date} 字符串

约束:
最小长度 = 1
最大长度 = 1 (必需)

ParameterContract

名字 描述 价值
defaultValue 默认参数值。 字符串
描述 参数说明。 字符串
名字 参数名称。 string (必需)
必填 参数是否是必需的。 bool
类型 参数类型。 string (必需)
参数值。 string[]

RepresentationContract

名字 描述 价值
contentType 为此表示形式指定已注册或自定义内容类型,例如 application/xml。 string (必需)
样本 表示形式的示例。 字符串

RequestContract

名字 描述 价值
描述 操作请求说明。 字符串
操作请求标头的集合。 ParameterContract[]
queryParameters 操作请求查询参数的集合。 ParameterContract[]
交涉 操作请求表示形式的集合。 RepresentationContract[]

ResultContract

名字 描述 价值
描述 操作响应说明。 字符串
交涉 操作响应表示形式的集合。 RepresentationContract[]
statusCode 操作响应 HTTP 状态代码。 int

约束:
最小值 = 100
最大值 = 599 (必需)