你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Microsoft.ApiManagement 服务/apis 2021-08-01
Bicep 资源定义
可以使用目标操作部署服务/apis 资源类型:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.ApiManagement/service/apis 资源,请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.ApiManagement/service/apis@2021-08-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
apiRevision: 'string'
apiRevisionDescription: 'string'
apiType: 'string'
apiVersion: 'string'
apiVersionDescription: 'string'
apiVersionSet: {
description: 'string'
id: 'string'
name: 'string'
versionHeaderName: 'string'
versioningScheme: 'string'
versionQueryName: 'string'
}
apiVersionSetId: 'string'
authenticationSettings: {
oAuth2: {
authorizationServerId: 'string'
scope: 'string'
}
openid: {
bearerTokenSendingMethods: [
'string'
]
openidProviderId: 'string'
}
}
contact: {
email: 'string'
name: 'string'
url: 'string'
}
description: 'string'
displayName: 'string'
format: 'string'
isCurrent: bool
license: {
name: 'string'
url: 'string'
}
path: 'string'
protocols: [
'string'
]
serviceUrl: 'string'
sourceApiId: 'string'
subscriptionKeyParameterNames: {
header: 'string'
query: 'string'
}
subscriptionRequired: bool
termsOfServiceUrl: 'string'
type: 'string'
value: 'string'
wsdlSelector: {
wsdlEndpointName: 'string'
wsdlServiceName: 'string'
}
}
}
属性值
service/apis
名字 | 描述 | 价值 |
---|---|---|
名字 | 资源名称 了解如何在 Bicep中设置子资源的名称和类型。 |
string (必需) 字符限制:1-80 有效字符: 字母数字和连字符。 以字母开头,以字母数字结尾。 |
父母 | 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。 有关详细信息,请参阅 父资源外部的子资源。 |
类型资源的符号名称:服务 |
性能 | API 实体创建更新属性。 | ApiCreateOrUpdatePropertiesOrApiContractProperties |
ApiCreateOrUpdatePropertiesOrApiContractProperties
名字 | 描述 | 价值 |
---|---|---|
apiRevision | 描述 API 的修订。 如果未提供任何值,则会创建默认修订版 1 | 字符串 约束: 最小长度 = 1 最大长度 = 100 |
apiRevisionDescription | API 修订的说明。 | 字符串 约束: 最大长度 = 256 |
apiType | 要创建的 API 的类型。 * http 创建 REST API* soap 创建 SOAP 直通 API* websocket 创建 websocket API* graphql 创建 GraphQL API。 |
“graphql” “ http ”“soap” “websocket” |
apiVersion | 指示 API 的版本标识符(如果 API 已进行版本控制) | 字符串 约束: 最大长度 = 100 |
apiVersionDescription | API 版本的说明。 | 字符串 约束: 最大长度 = 256 |
apiVersionSet | 版本集详细信息 | ApiVersionSetContractDetails |
apiVersionSetId | 相关 ApiVersionSet 的资源标识符。 | 字符串 |
authenticationSettings | 此 API 中包含的身份验证设置的集合。 | AuthenticationSettingsContract |
联系 | API 的联系信息。 | ApiContactInformation |
描述 | API 的说明。 可能包括 HTML 格式标记。 | 字符串 |
displayName | API 名称。 长度必须为 1 到 300 个字符。 | 字符串 约束: 最小长度 = 1 最大长度 = 300 |
格式 | 导入 API 的内容的格式。 | “graphql-link” “openapi” “openapi+json” “openapi+json-link” “openapi-link” “swagger-json” 'swagger-link-json' “wadl-link-json” “wadl-xml” “wsdl” “wsdl-link” |
isCurrent | 指示 API 修订是否为当前 API 修订版。 | bool |
许可证 | API 的许可证信息。 | ApiLicenseInformation |
路径 | 相对 URL 唯一标识此 API 及其所有资源路径在 API 管理服务实例中。 它追加到服务实例创建期间指定的 API 终结点基 URL,以形成此 API 的公共 URL。 | string (必需) 约束: 最大长度 = 400 |
协议 | 描述可以调用此 API 中的操作的协议。 | 包含任一项的字符串数组: “ http ”“ https ”“ws” “wss” |
serviceUrl | 实现此 API 的后端服务的绝对 URL。 长度不能超过 2000 个字符。 | 字符串 约束: 最大长度 = 2000 |
sourceApiId | 源 API 的 API 标识符。 | 字符串 |
subscriptionKeyParameterNames | 提供 API 的协议。 | SubscriptionKeyParameterNamesContract |
subscriptionRequired | 指定访问 API 是否需要 API 或产品订阅。 | bool |
termsOfServiceUrl | API 服务条款的 URL。 必须采用 URL 格式。 | 字符串 |
类型 | API 的类型。 | “graphql” “ http ”“soap” “websocket” |
价值 | 导入 API 时的内容值。 | 字符串 |
wsdlSelector | 将 WSDL 导入限制为文档子集的条件。 | ApiCreateOrUpdatePropertiesWsdlSelector |
ApiVersionSetContractDetails
名字 | 描述 | 价值 |
---|---|---|
描述 | API 版本集的说明。 | 字符串 |
id | 现有 API 版本集的标识符。 省略此值以创建新的版本集。 | 字符串 |
名字 | API 版本集的显示名称。 | 字符串 |
versionHeaderName | 如果 versioningScheme 设置为 header ,则表示 API 版本的 HTTP 标头参数的名称。 |
字符串 |
versioningScheme | 一个值,该值确定 API 版本标识符将位于 HTTP 请求中的位置。 | “Header” “Query” “Segment” |
versionQueryName | 如果 versioningScheme 设置为 query ,则指示 API 版本的查询参数的名称。 |
字符串 |
AuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
oAuth2 | OAuth2 身份验证设置 | OAuth2AuthenticationSettingsContract |
openid | OpenID Connect 身份验证设置 | OpenIdAuthenticationSettingsContract |
OAuth2AuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
authorizationServerId | OAuth 授权服务器标识符。 | 字符串 |
范围 | 操作范围。 | 字符串 |
OpenIdAuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
bearerTokenSendingMethods | 如何将令牌发送到服务器。 | 包含任一项的字符串数组: “authorizationHeader” “query” |
openidProviderId | OAuth 授权服务器标识符。 | 字符串 |
ApiContactInformation
名字 | 描述 | 价值 |
---|---|---|
电子邮件 | 联系人/组织的电子邮件地址。 必须采用电子邮件地址格式 | 字符串 |
名字 | 联系人/组织的标识名称 | 字符串 |
url | 指向联系信息的 URL。 必须采用 URL 格式 | 字符串 |
ApiLicenseInformation
名字 | 描述 | 价值 |
---|---|---|
名字 | 用于 API 的许可证名称 | 字符串 |
url | 用于 API 的许可证的 URL。 必须采用 URL 格式 | 字符串 |
SubscriptionKeyParameterNamesContract
名字 | 描述 | 价值 |
---|---|---|
页眉 | 订阅密钥标头名称。 | 字符串 |
查询 | 订阅密钥查询字符串参数名称。 | 字符串 |
ApiCreateOrUpdatePropertiesWsdlSelector
名字 | 描述 | 价值 |
---|---|---|
wsdlEndpointName | 要从 WSDL 导入的终结点的名称(端口) | 字符串 |
wsdlServiceName | 要从 WSDL 导入的服务的名称 | 字符串 |
快速入门模板
以下快速入门模板部署此资源类型。
模板 | 描述 |
---|---|
使用模板 创建 API 管理实例和所有子资源 |
此模板演示如何创建 API 管理服务并配置子实体 |
在 Azure API 管理 前创建 Azure Front Door |
此示例演示如何在 Azure API 管理之前将 Azure Front Door 用作全局负载均衡器。 |
ARM 模板资源定义
可以使用目标操作部署服务/apis 资源类型:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.ApiManagement/service/apis 资源,请将以下 JSON 添加到模板。
{
"type": "Microsoft.ApiManagement/service/apis",
"apiVersion": "2021-08-01",
"name": "string",
"properties": {
"apiRevision": "string",
"apiRevisionDescription": "string",
"apiType": "string",
"apiVersion": "string",
"apiVersionDescription": "string",
"apiVersionSet": {
"description": "string",
"id": "string",
"name": "string",
"versionHeaderName": "string",
"versioningScheme": "string",
"versionQueryName": "string"
},
"apiVersionSetId": "string",
"authenticationSettings": {
"oAuth2": {
"authorizationServerId": "string",
"scope": "string"
},
"openid": {
"bearerTokenSendingMethods": [ "string" ],
"openidProviderId": "string"
}
},
"contact": {
"email": "string",
"name": "string",
"url": "string"
},
"description": "string",
"displayName": "string",
"format": "string",
"isCurrent": "bool",
"license": {
"name": "string",
"url": "string"
},
"path": "string",
"protocols": [ "string" ],
"serviceUrl": "string",
"sourceApiId": "string",
"subscriptionKeyParameterNames": {
"header": "string",
"query": "string"
},
"subscriptionRequired": "bool",
"termsOfServiceUrl": "string",
"type": "string",
"value": "string",
"wsdlSelector": {
"wsdlEndpointName": "string",
"wsdlServiceName": "string"
}
}
}
属性值
service/apis
名字 | 描述 | 价值 |
---|---|---|
类型 | 资源类型 | “Microsoft.ApiManagement/service/apis” |
apiVersion | 资源 API 版本 | '2021-08-01' |
名字 | 资源名称 了解如何在 JSON ARM 模板中设置子资源的名称和类型。 |
string (必需) 字符限制:1-80 有效字符: 字母数字和连字符。 以字母开头,以字母数字结尾。 |
性能 | API 实体创建更新属性。 | ApiCreateOrUpdatePropertiesOrApiContractProperties |
ApiCreateOrUpdatePropertiesOrApiContractProperties
名字 | 描述 | 价值 |
---|---|---|
apiRevision | 描述 API 的修订。 如果未提供任何值,则会创建默认修订版 1 | 字符串 约束: 最小长度 = 1 最大长度 = 100 |
apiRevisionDescription | API 修订的说明。 | 字符串 约束: 最大长度 = 256 |
apiType | 要创建的 API 的类型。 * http 创建 REST API* soap 创建 SOAP 直通 API* websocket 创建 websocket API* graphql 创建 GraphQL API。 |
“graphql” “ http ”“soap” “websocket” |
apiVersion | 指示 API 的版本标识符(如果 API 已进行版本控制) | 字符串 约束: 最大长度 = 100 |
apiVersionDescription | API 版本的说明。 | 字符串 约束: 最大长度 = 256 |
apiVersionSet | 版本集详细信息 | ApiVersionSetContractDetails |
apiVersionSetId | 相关 ApiVersionSet 的资源标识符。 | 字符串 |
authenticationSettings | 此 API 中包含的身份验证设置的集合。 | AuthenticationSettingsContract |
联系 | API 的联系信息。 | ApiContactInformation |
描述 | API 的说明。 可能包括 HTML 格式标记。 | 字符串 |
displayName | API 名称。 长度必须为 1 到 300 个字符。 | 字符串 约束: 最小长度 = 1 最大长度 = 300 |
格式 | 导入 API 的内容的格式。 | “graphql-link” “openapi” “openapi+json” “openapi+json-link” “openapi-link” “swagger-json” 'swagger-link-json' “wadl-link-json” “wadl-xml” “wsdl” “wsdl-link” |
isCurrent | 指示 API 修订是否为当前 API 修订版。 | bool |
许可证 | API 的许可证信息。 | ApiLicenseInformation |
路径 | 相对 URL 唯一标识此 API 及其所有资源路径在 API 管理服务实例中。 它追加到服务实例创建期间指定的 API 终结点基 URL,以形成此 API 的公共 URL。 | string (必需) 约束: 最大长度 = 400 |
协议 | 描述可以调用此 API 中的操作的协议。 | 包含任一项的字符串数组: “ http ”“ https ”“ws” “wss” |
serviceUrl | 实现此 API 的后端服务的绝对 URL。 长度不能超过 2000 个字符。 | 字符串 约束: 最大长度 = 2000 |
sourceApiId | 源 API 的 API 标识符。 | 字符串 |
subscriptionKeyParameterNames | 提供 API 的协议。 | SubscriptionKeyParameterNamesContract |
subscriptionRequired | 指定访问 API 是否需要 API 或产品订阅。 | bool |
termsOfServiceUrl | API 服务条款的 URL。 必须采用 URL 格式。 | 字符串 |
类型 | API 的类型。 | “graphql” “ http ”“soap” “websocket” |
价值 | 导入 API 时的内容值。 | 字符串 |
wsdlSelector | 将 WSDL 导入限制为文档子集的条件。 | ApiCreateOrUpdatePropertiesWsdlSelector |
ApiVersionSetContractDetails
名字 | 描述 | 价值 |
---|---|---|
描述 | API 版本集的说明。 | 字符串 |
id | 现有 API 版本集的标识符。 省略此值以创建新的版本集。 | 字符串 |
名字 | API 版本集的显示名称。 | 字符串 |
versionHeaderName | 如果 versioningScheme 设置为 header ,则表示 API 版本的 HTTP 标头参数的名称。 |
字符串 |
versioningScheme | 一个值,该值确定 API 版本标识符将位于 HTTP 请求中的位置。 | “Header” “Query” “Segment” |
versionQueryName | 如果 versioningScheme 设置为 query ,则指示 API 版本的查询参数的名称。 |
字符串 |
AuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
oAuth2 | OAuth2 身份验证设置 | OAuth2AuthenticationSettingsContract |
openid | OpenID Connect 身份验证设置 | OpenIdAuthenticationSettingsContract |
OAuth2AuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
authorizationServerId | OAuth 授权服务器标识符。 | 字符串 |
范围 | 操作范围。 | 字符串 |
OpenIdAuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
bearerTokenSendingMethods | 如何将令牌发送到服务器。 | 包含任一项的字符串数组: “authorizationHeader” “query” |
openidProviderId | OAuth 授权服务器标识符。 | 字符串 |
ApiContactInformation
名字 | 描述 | 价值 |
---|---|---|
电子邮件 | 联系人/组织的电子邮件地址。 必须采用电子邮件地址格式 | 字符串 |
名字 | 联系人/组织的标识名称 | 字符串 |
url | 指向联系信息的 URL。 必须采用 URL 格式 | 字符串 |
ApiLicenseInformation
名字 | 描述 | 价值 |
---|---|---|
名字 | 用于 API 的许可证名称 | 字符串 |
url | 用于 API 的许可证的 URL。 必须采用 URL 格式 | 字符串 |
SubscriptionKeyParameterNamesContract
名字 | 描述 | 价值 |
---|---|---|
页眉 | 订阅密钥标头名称。 | 字符串 |
查询 | 订阅密钥查询字符串参数名称。 | 字符串 |
ApiCreateOrUpdatePropertiesWsdlSelector
名字 | 描述 | 价值 |
---|---|---|
wsdlEndpointName | 要从 WSDL 导入的终结点的名称(端口) | 字符串 |
wsdlServiceName | 要从 WSDL 导入的服务的名称 | 字符串 |
快速入门模板
以下快速入门模板部署此资源类型。
模板 | 描述 |
---|---|
使用模板 创建 API 管理实例和所有子资源 |
此模板演示如何创建 API 管理服务并配置子实体 |
在 Azure API 管理 前创建 Azure Front Door |
此示例演示如何在 Azure API 管理之前将 Azure Front Door 用作全局负载均衡器。 |
Terraform (AzAPI 提供程序)资源定义
可以使用目标操作部署服务/apis 资源类型:
- 资源组
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.ApiManagement/service/apis 资源,请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service/apis@2021-08-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
apiRevision = "string"
apiRevisionDescription = "string"
apiType = "string"
apiVersion = "string"
apiVersionDescription = "string"
apiVersionSet = {
description = "string"
id = "string"
name = "string"
versionHeaderName = "string"
versioningScheme = "string"
versionQueryName = "string"
}
apiVersionSetId = "string"
authenticationSettings = {
oAuth2 = {
authorizationServerId = "string"
scope = "string"
}
openid = {
bearerTokenSendingMethods = [
"string"
]
openidProviderId = "string"
}
}
contact = {
email = "string"
name = "string"
url = "string"
}
description = "string"
displayName = "string"
format = "string"
isCurrent = bool
license = {
name = "string"
url = "string"
}
path = "string"
protocols = [
"string"
]
serviceUrl = "string"
sourceApiId = "string"
subscriptionKeyParameterNames = {
header = "string"
query = "string"
}
subscriptionRequired = bool
termsOfServiceUrl = "string"
type = "string"
value = "string"
wsdlSelector = {
wsdlEndpointName = "string"
wsdlServiceName = "string"
}
}
})
}
属性值
service/apis
名字 | 描述 | 价值 |
---|---|---|
类型 | 资源类型 | “Microsoft.ApiManagement/service/apis@2021-08-01” |
名字 | 资源名称 | string (必需) 字符限制:1-80 有效字符: 字母数字和连字符。 以字母开头,以字母数字结尾。 |
parent_id | 此资源的父资源的 ID。 | 类型资源的 ID:服务 |
性能 | API 实体创建更新属性。 | ApiCreateOrUpdatePropertiesOrApiContractProperties |
ApiCreateOrUpdatePropertiesOrApiContractProperties
名字 | 描述 | 价值 |
---|---|---|
apiRevision | 描述 API 的修订。 如果未提供任何值,则会创建默认修订版 1 | 字符串 约束: 最小长度 = 1 最大长度 = 100 |
apiRevisionDescription | API 修订的说明。 | 字符串 约束: 最大长度 = 256 |
apiType | 要创建的 API 的类型。 * http 创建 REST API* soap 创建 SOAP 直通 API* websocket 创建 websocket API* graphql 创建 GraphQL API。 |
“graphql” “ http ”“soap” “websocket” |
apiVersion | 指示 API 的版本标识符(如果 API 已进行版本控制) | 字符串 约束: 最大长度 = 100 |
apiVersionDescription | API 版本的说明。 | 字符串 约束: 最大长度 = 256 |
apiVersionSet | 版本集详细信息 | ApiVersionSetContractDetails |
apiVersionSetId | 相关 ApiVersionSet 的资源标识符。 | 字符串 |
authenticationSettings | 此 API 中包含的身份验证设置的集合。 | AuthenticationSettingsContract |
联系 | API 的联系信息。 | ApiContactInformation |
描述 | API 的说明。 可能包括 HTML 格式标记。 | 字符串 |
displayName | API 名称。 长度必须为 1 到 300 个字符。 | 字符串 约束: 最小长度 = 1 最大长度 = 300 |
格式 | 导入 API 的内容的格式。 | “graphql-link” “openapi” “openapi+json” “openapi+json-link” “openapi-link” “swagger-json” “swagger-link-json” “wadl-link-json” “wadl-xml” “wsdl” “wsdl-link” |
isCurrent | 指示 API 修订是否为当前 API 修订版。 | bool |
许可证 | API 的许可证信息。 | ApiLicenseInformation |
路径 | 相对 URL 唯一标识此 API 及其所有资源路径在 API 管理服务实例中。 它追加到服务实例创建期间指定的 API 终结点基 URL,以形成此 API 的公共 URL。 | string (必需) 约束: 最大长度 = 400 |
协议 | 描述可以调用此 API 中的操作的协议。 | 包含任一项的字符串数组: “ http ”“ https ”“ws” “wss” |
serviceUrl | 实现此 API 的后端服务的绝对 URL。 长度不能超过 2000 个字符。 | 字符串 约束: 最大长度 = 2000 |
sourceApiId | 源 API 的 API 标识符。 | 字符串 |
subscriptionKeyParameterNames | 提供 API 的协议。 | SubscriptionKeyParameterNamesContract |
subscriptionRequired | 指定访问 API 是否需要 API 或产品订阅。 | bool |
termsOfServiceUrl | API 服务条款的 URL。 必须采用 URL 格式。 | 字符串 |
类型 | API 的类型。 | “graphql” “ http ”“soap” “websocket” |
价值 | 导入 API 时的内容值。 | 字符串 |
wsdlSelector | 将 WSDL 导入限制为文档子集的条件。 | ApiCreateOrUpdatePropertiesWsdlSelector |
ApiVersionSetContractDetails
名字 | 描述 | 价值 |
---|---|---|
描述 | API 版本集的说明。 | 字符串 |
id | 现有 API 版本集的标识符。 省略此值以创建新的版本集。 | 字符串 |
名字 | API 版本集的显示名称。 | 字符串 |
versionHeaderName | 如果 versioningScheme 设置为 header ,则表示 API 版本的 HTTP 标头参数的名称。 |
字符串 |
versioningScheme | 一个值,该值确定 API 版本标识符将位于 HTTP 请求中的位置。 | “Header” “Query” “Segment” |
versionQueryName | 如果 versioningScheme 设置为 query ,则指示 API 版本的查询参数的名称。 |
字符串 |
AuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
oAuth2 | OAuth2 身份验证设置 | OAuth2AuthenticationSettingsContract |
openid | OpenID Connect 身份验证设置 | OpenIdAuthenticationSettingsContract |
OAuth2AuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
authorizationServerId | OAuth 授权服务器标识符。 | 字符串 |
范围 | 操作范围。 | 字符串 |
OpenIdAuthenticationSettingsContract
名字 | 描述 | 价值 |
---|---|---|
bearerTokenSendingMethods | 如何将令牌发送到服务器。 | 包含任一项的字符串数组: “authorizationHeader” “query” |
openidProviderId | OAuth 授权服务器标识符。 | 字符串 |
ApiContactInformation
名字 | 描述 | 价值 |
---|---|---|
电子邮件 | 联系人/组织的电子邮件地址。 必须采用电子邮件地址格式 | 字符串 |
名字 | 联系人/组织的标识名称 | 字符串 |
url | 指向联系信息的 URL。 必须采用 URL 格式 | 字符串 |
ApiLicenseInformation
名字 | 描述 | 价值 |
---|---|---|
名字 | 用于 API 的许可证名称 | 字符串 |
url | 用于 API 的许可证的 URL。 必须采用 URL 格式 | 字符串 |
SubscriptionKeyParameterNamesContract
名字 | 描述 | 价值 |
---|---|---|
页眉 | 订阅密钥标头名称。 | 字符串 |
查询 | 订阅密钥查询字符串参数名称。 | 字符串 |
ApiCreateOrUpdatePropertiesWsdlSelector
名字 | 描述 | 价值 |
---|---|---|
wsdlEndpointName | 要从 WSDL 导入的终结点的名称(端口) | 字符串 |
wsdlServiceName | 要从 WSDL 导入的服务的名称 | 字符串 |