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

Microsoft.ApiManagement 服务

项目
12/21/2024

Bicep 资源定义

可以使用目标操作部署服务资源类型：

资源组 - 请参阅资源组部署命令

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

资源格式

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

resource symbolicname 'Microsoft.ApiManagement/service@2024-06-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    additionalLocations: [
      {
        disableGateway: bool
        location: 'string'
        natGatewayState: 'string'
        publicIpAddressId: 'string'
        sku: {
          capacity: int
          name: 'string'
        }
        virtualNetworkConfiguration: {
          subnetResourceId: 'string'
        }
        zones: [
          'string'
        ]
      }
    ]
    apiVersionConstraint: {
      minApiVersion: 'string'
    }
    certificates: [
      {
        certificate: {
          expiry: 'string'
          subject: 'string'
          thumbprint: 'string'
        }
        certificatePassword: 'string'
        encodedCertificate: 'string'
        storeName: 'string'
      }
    ]
    configurationApi: {
      legacyApi: 'string'
    }
    customProperties: {
      {customized property}: 'string'
    }
    developerPortalStatus: 'string'
    disableGateway: bool
    enableClientCertificate: bool
    hostnameConfigurations: [
      {
        certificate: {
          expiry: 'string'
          subject: 'string'
          thumbprint: 'string'
        }
        certificatePassword: 'string'
        certificateSource: 'string'
        certificateStatus: 'string'
        defaultSslBinding: bool
        encodedCertificate: 'string'
        hostName: 'string'
        identityClientId: 'string'
        keyVaultId: 'string'
        negotiateClientCertificate: bool
        type: 'string'
      }
    ]
    legacyPortalStatus: 'string'
    natGatewayState: 'string'
    notificationSenderEmail: 'string'
    privateEndpointConnections: [
      {
        id: 'string'
        name: 'string'
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
        type: 'string'
      }
    ]
    publicIpAddressId: 'string'
    publicNetworkAccess: 'string'
    publisherEmail: 'string'
    publisherName: 'string'
    releaseChannel: 'string'
    restore: bool
    virtualNetworkConfiguration: {
      subnetResourceId: 'string'
    }
    virtualNetworkType: 'string'
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

属性值

AdditionalLocation

名字	描述	价值
disableGateway	属性仅适用于部署在多个位置的 Api 管理服务。这可用于在此附加位置中禁用网关。	bool
位置	Azure 数据中心区域中其他区域的位置名称。	string （必需）
natGatewayState	属性可用于为此 API 管理服务启用 NAT 网关。	“Disabled” “Enabled”
publicIpAddressId	要与位置中部署的虚拟网络服务关联的基于公共标准 SKU IP V4 的 IP 地址。仅支持在虚拟网络中部署高级 SKU。	字符串
sku	API 管理服务的 SKU 属性。	ApiManagementServiceSkuProperties（必需）
virtualNetworkConfiguration	位置的虚拟网络配置。	VirtualNetworkConfiguration
区	一个可用性区域列表，表示资源需要来自何处。	string[]

ApiManagementServiceBasePropertiesCustomProperties

名字	描述	价值

ApiManagementServiceIdentity

名字	描述	价值
类型	用于资源的标识类型。类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。类型“None”将从服务中删除任何标识。	“None” “SystemAssigned” “SystemAssigned，UserAssigned” “UserAssigned”（必需）
userAssignedIdentities	与资源关联的用户标识列表。用户标识字典键引用的格式为 ARM 资源 ID： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。	ApiManagementServiceIdentityUserAssignedIdentities

ApiManagementServiceIdentityUserAssignedIdentities

名字	描述	价值

ApiManagementServiceProperties

名字	描述	价值
additionalLocations	API 管理服务的其他数据中心位置。	AdditionalLocation[]
apiVersionConstraint	API 管理服务的控制平面 API 版本约束。	ApiVersionConstraint
证书	需要在 API 管理服务中安装的证书列表。可安装的最大支持证书为 10。	CertificateConfiguration[]
configurationApi	API 管理服务的配置 API 配置。	ConfigurationApi
customProperties	API 管理服务的自定义属性。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168` 将禁用所有 TLS（1.0、1.1 和 1.2）的密码TLS_RSA_WITH_3DES_EDE_CBC_SHA。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11` 可用于仅禁用 TLS 1.1。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10` 可用于在 API 管理服务上禁用 TLS 1.0。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11` 可用于仅禁用 TLS 1.1，以便与后端通信。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10` 可用于禁用 TLS 1.0 以便与后端通信。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2` 可用于在 API 管理服务上启用 HTTP2 协议。未在 PATCH 操作中指定这些属性中的任何一个将省略的属性的值重置为其默认值。对于除 Http2 之外的所有设置，如果服务是在 2018 年 4 月 1 日或之前创建的，则默认值 `True`，否则 `False`。 Http2 设置的默认值为 `False`。可以使用设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]`禁用以下任何密码：TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA、TLS_RSA_WITH_AES_128_GCM_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA256、 TLS_RSA_WITH_AES_128_CBC_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA、TLS_RSA_WITH_AES_128_CBC_SHA。例如，`Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256`：`false`。默认值为 `true`。注意：由于内部平台组件需要以下密码，因此无法禁用这些密码：TLS_AES_256_GCM_SHA384、TLS_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384，TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256，TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384，TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256	ApiManagementServiceBasePropertiesCustomProperties
developerPortalStatus	此 API 管理服务中开发人员门户的状态。	“Disabled” “Enabled”
disableGateway	属性仅适用于部署在多个位置的 Api 管理服务。这可用于禁用主区域中的网关。	bool
enableClientCertificate	仅用于消耗 SKU 服务的属性。这会强制在向网关的每个请求上显示客户端证书。这样，便可以在网关上的策略中对证书进行身份验证。	bool
hostnameConfigurations	API 管理服务的自定义主机名配置。	HostnameConfiguration[]
legacyPortalStatus	API 管理服务中旧门户的状态。	“Disabled” “Enabled”
natGatewayState	属性可用于为此 API 管理服务启用 NAT 网关。	“Disabled” “Enabled”
notificationSenderEmail	将从中发送通知的电子邮件地址。	字符串约束：最大长度 =
privateEndpointConnections	此服务的专用终结点连接列表。	RemotePrivateEndpointConnectionWrapper[]
publicIpAddressId	要与区域中部署的虚拟网络服务关联的基于公共标准 SKU IP V4 的 IP 地址。仅支持在虚拟网络中部署开发人员和高级 SKU。	字符串
publicNetworkAccess	是否允许此 API 管理服务访问公共终结点。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。默认值为“Enabled”	“Disabled” “Enabled”
publisherEmail	发布者电子邮件。	字符串约束：最大长度 = （必需）
publisherName	发布者名称。	字符串约束：最大长度 = （必需）
releaseChannel	此 API 管理服务的发布通道。	“Default” “预览” “稳定”
恢复	取消删除 Api 管理服务（如果以前是软删除的）。如果指定了此标志并设置为 True，将忽略所有其他属性。	bool
virtualNetworkConfiguration	API 管理服务的虚拟网络配置。	VirtualNetworkConfiguration
virtualNetworkType	需要在其中配置 API 管理服务的 VPN 类型。无（默认值）表示 API 管理服务不是任何虚拟网络的一部分，外部意味着 API 管理部署是在具有面向 Internet 的终结点的虚拟网络内设置的，内部意味着 API 管理部署仅在具有 Intranet 面向终结点的虚拟网络中进行设置。	“External” “Internal” “None”

ApiManagementServiceSkuProperties

名字	描述	价值
能力	SKU 的容量（SKU 的已部署单位数）。对于消耗 SKU 容量，必须指定为 0。	int （必需）
名字	Sku 的名称。	“Basic” “BasicV2” “消耗” “Developer” “独立” “Premium” “Standard” “StandardV2”（必需）

ApimResourceTags

名字	描述	价值

ApiVersionConstraint

名字	描述	价值
minApiVersion	限制对 API 管理服务的控制平面 API 调用，其版本等于或高于此值。	字符串

ArmIdWrapper

名字	描述	价值

CertificateConfiguration

名字	描述	价值
证书	证书信息。	CertificateInformation
certificatePassword	证书密码。	字符串
encodedCertificate	Base64 编码证书。	字符串
storeName	System.Security.Cryptography.x509certificates.StoreName 证书存储位置。只有 Root 和 CertificateAuthority 是有效位置。	“CertificateAuthority” “Root”（必需）

CertificateInformation

名字	描述	价值
满期	证书的到期日期。日期符合以下格式：按 ISO 8601 标准指定的 `yyyy-MM-ddTHH:mm:ssZ`。	string （必需）
主题	证书的使用者。	string （必需）
指纹	证书的指纹。	string （必需）

ConfigurationApi

名字	描述	价值
legacyApi	指示是否应在 API 管理服务上公开旧配置 API （v1）。值是可选的，但必须是“Enabled”或“Disabled”。如果“已禁用”，旧版配置 API（v1）将不适用于自承载网关。默认值为“Enabled”	“Disabled” “Enabled”

HostnameConfiguration

名字	描述	价值
证书	证书信息。	CertificateInformation
certificatePassword	证书密码。	字符串
certificateSource	证书源。	“BuiltIn” “Custom” “KeyVault” “Managed”
certificateStatus	证书状态。	“Completed” “Failed” “InProgress”
defaultSslBinding	指定 true 以设置与此主机名关联的证书作为默认 SSL 证书。如果客户端未发送 SNI 标头，则这是将质询的证书。如果某个服务启用了多个自定义主机名，并且需要确定默认 ssl 证书，则此属性非常有用。此设置仅适用于网关主机名类型。	bool
encodedCertificate	Base64 编码证书。	字符串
hostName	在 Api 管理服务上配置的主机名。	string （必需）
identityClientId	Azure AD 生成的系统或用户分配的托管标识 clientId，该客户端有权访问包含 SSL 证书的 keyVault。	字符串
keyVaultId	包含 Ssl 证书的 KeyVault 机密的 URL。如果提供了包含版本的绝对 URL，则 ssl 证书的自动更新将不起作用。这要求使用 aka.ms/apimmsi 配置 Api 管理服务。机密的类型应为 application/x-pkcs12	字符串
negotiateClientCertificate	指定 true 以始终协商主机名上的客户端证书。默认值为 false。	bool
类型	主机名类型。	“ConfigurationApi” “DeveloperPortal” “管理” “Portal” “Proxy” “Scm”（必需）

Microsoft.ApiManagement/service

名字	描述	价值
身份	Api 管理服务的托管服务标识。	ApiManagementServiceIdentity
位置	资源位置。	string （必需）
名字	资源名称	字符串约束：最小长度 = 1 最大长度 = 1 模式 = `^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$` （必需）
性能	API 管理服务的属性。	ApiManagementServiceProperties（必需）
sku	API 管理服务的 SKU 属性。	ApiManagementServiceSkuProperties（必需）
标签	资源标记	标记名称和值的字典。请参阅模板中的标记
区	一个可用性区域列表，表示资源需要来自何处。	string[]

PrivateEndpointConnectionWrapperProperties

名字	描述	价值
privateEndpoint	专用终结点的资源。	ArmIdWrapper
privateLinkServiceConnectionState	有关服务使用者与提供程序之间的连接状态的信息集合。	PrivateLinkServiceConnectionState （必需）

PrivateLinkServiceConnectionState

名字	描述	价值
actionsRequired	一条消息，指示服务提供商上的更改是否需要对使用者进行任何更新。	字符串
描述	批准/拒绝连接的原因。	字符串
地位	指示连接是否已被服务的所有者批准/拒绝/删除。	“已批准” “Pending” “已拒绝”

RemotePrivateEndpointConnectionWrapper

名字	描述	价值
id	专用终结点连接资源 ID	字符串
名字	专用终结点连接名称	字符串
性能	资源属性。	PrivateEndpointConnectionWrapperProperties
类型	专用终结点连接资源类型	字符串

UserIdentityProperties

名字	描述	价值
clientId	用户分配标识的客户端 ID。	字符串
principalId	用户分配标识的主体 ID。	字符串

VirtualNetworkConfiguration

名字	描述	价值
subnetResourceId	要在其中部署 API 管理服务的虚拟网络中子网的完整资源 ID。	字符串约束： Pattern = `^/subscriptions/[^/]/resourceGroups/[^/]/providers/Microsoft.(ClassicNetwork\|Network)/virtualNetworks/[^/]/subnets/[^/]$`

快速入门示例

以下快速入门示例部署此资源类型。

Bicep 文件	描述
使用内部 API 管理和 Web 应用应用程序网关	应用程序网关将 Internet 流量路由到虚拟网络（内部模式）API 管理实例，该实例服务 Azure Web 应用中托管的 Web API。
创建多区域高级层 API 管理实例	此模板演示如何创建具有其他位置的 API 管理实例。主要位置与资源组的位置相同。对于其他位置，模板显示 NorthCentralUs 和美国东部 2。主要位置应不同于其他位置。
创建具有 MSI 标识的 API 管理实例	此模板创建具有 MSI 标识的 Azure API 管理的开发人员实例
使用模板创建 API 管理实例	此模板创建 Azure API 管理的开发人员实例
使用专用终结点创建 API 管理服务	此模板将创建 API 管理服务、虚拟网络和专用终结点，向虚拟网络公开 API 管理服务。
从 KeyVault 使用 SSL 创建 API 管理服务	此模板部署配置有用户分配标识的 API 管理服务。它使用此标识从 KeyVault 提取 SSL 证书，并通过每隔 4 小时检查一次来更新它。
使用应用网关在内部 VNet 中创建 API 管理	此模板演示如何在受 Azure 应用程序网关保护的专用网络上创建 Azure API 管理的实例。
使用公共 IP 在外部 VNet 中部署 API 管理	此模板演示如何在虚拟网络子网的外部模式下的高级层中创建 Azure API 管理的实例，并在子网上配置建议的 NSG 规则。实例部署到两个可用性区域。该模板还配置订阅中的公共 IP 地址。
使用公共 IP 在内部 VNet 中部署 API 管理	此模板演示如何在虚拟网络子网内部的高级层中创建 Azure API 管理的实例，并在子网上配置建议的 NSG 规则。实例部署到两个可用性区域。该模板还配置订阅中的公共 IP 地址。
将 API 管理部署到可用性区域	此模板创建 Azure API 管理的高级实例，并将其部署到可用性区域
使用外部 Azure Redis 缓存部署 API 管理	此模板演示如何使用外部 Azure Redis 缓存实例作为 API 管理外部缓存在消耗层中创建 Azure API 管理的实例。
使用 API 管理源 Front Door 标准版/高级版	此模板创建 Front Door Premium 和 API 管理实例，并使用 NSG 和全局 API 管理策略来验证流量是否通过 Front Door 源。

ARM 模板资源定义

可以使用目标操作部署服务资源类型：

资源组 - 请参阅资源组部署命令

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

资源格式

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

{
  "type": "Microsoft.ApiManagement/service",
  "apiVersion": "2024-06-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "additionalLocations": [
      {
        "disableGateway": "bool",
        "location": "string",
        "natGatewayState": "string",
        "publicIpAddressId": "string",
        "sku": {
          "capacity": "int",
          "name": "string"
        },
        "virtualNetworkConfiguration": {
          "subnetResourceId": "string"
        },
        "zones": [ "string" ]
      }
    ],
    "apiVersionConstraint": {
      "minApiVersion": "string"
    },
    "certificates": [
      {
        "certificate": {
          "expiry": "string",
          "subject": "string",
          "thumbprint": "string"
        },
        "certificatePassword": "string",
        "encodedCertificate": "string",
        "storeName": "string"
      }
    ],
    "configurationApi": {
      "legacyApi": "string"
    },
    "customProperties": {
      "{customized property}": "string"
    },
    "developerPortalStatus": "string",
    "disableGateway": "bool",
    "enableClientCertificate": "bool",
    "hostnameConfigurations": [
      {
        "certificate": {
          "expiry": "string",
          "subject": "string",
          "thumbprint": "string"
        },
        "certificatePassword": "string",
        "certificateSource": "string",
        "certificateStatus": "string",
        "defaultSslBinding": "bool",
        "encodedCertificate": "string",
        "hostName": "string",
        "identityClientId": "string",
        "keyVaultId": "string",
        "negotiateClientCertificate": "bool",
        "type": "string"
      }
    ],
    "legacyPortalStatus": "string",
    "natGatewayState": "string",
    "notificationSenderEmail": "string",
    "privateEndpointConnections": [
      {
        "id": "string",
        "name": "string",
        "properties": {
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        },
        "type": "string"
      }
    ],
    "publicIpAddressId": "string",
    "publicNetworkAccess": "string",
    "publisherEmail": "string",
    "publisherName": "string",
    "releaseChannel": "string",
    "restore": "bool",
    "virtualNetworkConfiguration": {
      "subnetResourceId": "string"
    },
    "virtualNetworkType": "string"
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

属性值

AdditionalLocation

名字	描述	价值
disableGateway	属性仅适用于部署在多个位置的 Api 管理服务。这可用于在此附加位置中禁用网关。	bool
位置	Azure 数据中心区域中其他区域的位置名称。	string （必需）
natGatewayState	属性可用于为此 API 管理服务启用 NAT 网关。	“Disabled” “Enabled”
publicIpAddressId	要与位置中部署的虚拟网络服务关联的基于公共标准 SKU IP V4 的 IP 地址。仅支持在虚拟网络中部署高级 SKU。	字符串
sku	API 管理服务的 SKU 属性。	ApiManagementServiceSkuProperties（必需）
virtualNetworkConfiguration	位置的虚拟网络配置。	VirtualNetworkConfiguration
区	一个可用性区域列表，表示资源需要来自何处。	string[]

ApiManagementServiceBasePropertiesCustomProperties

名字	描述	价值

ApiManagementServiceIdentity

名字	描述	价值
类型	用于资源的标识类型。类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。类型“None”将从服务中删除任何标识。	“None” “SystemAssigned” “SystemAssigned，UserAssigned” “UserAssigned”（必需）
userAssignedIdentities	与资源关联的用户标识列表。用户标识字典键引用的格式为 ARM 资源 ID： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。	ApiManagementServiceIdentityUserAssignedIdentities

ApiManagementServiceIdentityUserAssignedIdentities

名字	描述	价值

ApiManagementServiceProperties

名字	描述	价值
additionalLocations	API 管理服务的其他数据中心位置。	AdditionalLocation[]
apiVersionConstraint	API 管理服务的控制平面 API 版本约束。	ApiVersionConstraint
证书	需要在 API 管理服务中安装的证书列表。可安装的最大支持证书为 10。	CertificateConfiguration[]
configurationApi	API 管理服务的配置 API 配置。	ConfigurationApi
customProperties	API 管理服务的自定义属性。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168` 将禁用所有 TLS（1.0、1.1 和 1.2）的密码TLS_RSA_WITH_3DES_EDE_CBC_SHA。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11` 可用于仅禁用 TLS 1.1。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10` 可用于在 API 管理服务上禁用 TLS 1.0。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11` 可用于仅禁用 TLS 1.1，以便与后端通信。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10` 可用于禁用 TLS 1.0 以便与后端通信。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2` 可用于在 API 管理服务上启用 HTTP2 协议。未在 PATCH 操作中指定这些属性中的任何一个将省略的属性的值重置为其默认值。对于除 Http2 之外的所有设置，如果服务是在 2018 年 4 月 1 日或之前创建的，则默认值 `True`，否则 `False`。 Http2 设置的默认值为 `False`。可以使用设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]`禁用以下任何密码：TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA、TLS_RSA_WITH_AES_128_GCM_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA256、 TLS_RSA_WITH_AES_128_CBC_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA、TLS_RSA_WITH_AES_128_CBC_SHA。例如，`Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256`：`false`。默认值为 `true`。注意：由于内部平台组件需要以下密码，因此无法禁用这些密码：TLS_AES_256_GCM_SHA384、TLS_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384，TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256，TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384，TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256	ApiManagementServiceBasePropertiesCustomProperties
developerPortalStatus	此 API 管理服务中开发人员门户的状态。	“Disabled” “Enabled”
disableGateway	属性仅适用于部署在多个位置的 Api 管理服务。这可用于禁用主区域中的网关。	bool
enableClientCertificate	仅用于消耗 SKU 服务的属性。这会强制在向网关的每个请求上显示客户端证书。这样，便可以在网关上的策略中对证书进行身份验证。	bool
hostnameConfigurations	API 管理服务的自定义主机名配置。	HostnameConfiguration[]
legacyPortalStatus	API 管理服务中旧门户的状态。	“Disabled” “Enabled”
natGatewayState	属性可用于为此 API 管理服务启用 NAT 网关。	“Disabled” “Enabled”
notificationSenderEmail	将从中发送通知的电子邮件地址。	字符串约束：最大长度 =
privateEndpointConnections	此服务的专用终结点连接列表。	RemotePrivateEndpointConnectionWrapper[]
publicIpAddressId	要与区域中部署的虚拟网络服务关联的基于公共标准 SKU IP V4 的 IP 地址。仅支持在虚拟网络中部署开发人员和高级 SKU。	字符串
publicNetworkAccess	是否允许此 API 管理服务访问公共终结点。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。默认值为“Enabled”	“Disabled” “Enabled”
publisherEmail	发布者电子邮件。	字符串约束：最大长度 = （必需）
publisherName	发布者名称。	字符串约束：最大长度 = （必需）
releaseChannel	此 API 管理服务的发布通道。	“Default” “预览” “稳定”
恢复	取消删除 Api 管理服务（如果以前是软删除的）。如果指定了此标志并设置为 True，将忽略所有其他属性。	bool
virtualNetworkConfiguration	API 管理服务的虚拟网络配置。	VirtualNetworkConfiguration
virtualNetworkType	需要在其中配置 API 管理服务的 VPN 类型。无（默认值）表示 API 管理服务不是任何虚拟网络的一部分，外部意味着 API 管理部署是在具有面向 Internet 的终结点的虚拟网络内设置的，内部意味着 API 管理部署仅在具有 Intranet 面向终结点的虚拟网络中进行设置。	“External” “Internal” “None”

ApiManagementServiceSkuProperties

名字	描述	价值
能力	SKU 的容量（SKU 的已部署单位数）。对于消耗 SKU 容量，必须指定为 0。	int （必需）
名字	Sku 的名称。	“Basic” “BasicV2” “消耗” “Developer” “独立” “Premium” “Standard” “StandardV2”（必需）

ApimResourceTags

名字	描述	价值

ApiVersionConstraint

名字	描述	价值
minApiVersion	限制对 API 管理服务的控制平面 API 调用，其版本等于或高于此值。	字符串

ArmIdWrapper

名字	描述	价值

CertificateConfiguration

名字	描述	价值
证书	证书信息。	CertificateInformation
certificatePassword	证书密码。	字符串
encodedCertificate	Base64 编码证书。	字符串
storeName	System.Security.Cryptography.x509certificates.StoreName 证书存储位置。只有 Root 和 CertificateAuthority 是有效位置。	“CertificateAuthority” “Root”（必需）

CertificateInformation

名字	描述	价值
满期	证书的到期日期。日期符合以下格式：按 ISO 8601 标准指定的 `yyyy-MM-ddTHH:mm:ssZ`。	string （必需）
主题	证书的使用者。	string （必需）
指纹	证书的指纹。	string （必需）

ConfigurationApi

名字	描述	价值
legacyApi	指示是否应在 API 管理服务上公开旧配置 API （v1）。值是可选的，但必须是“Enabled”或“Disabled”。如果“已禁用”，旧版配置 API（v1）将不适用于自承载网关。默认值为“Enabled”	“Disabled” “Enabled”

HostnameConfiguration

名字	描述	价值
证书	证书信息。	CertificateInformation
certificatePassword	证书密码。	字符串
certificateSource	证书源。	“BuiltIn” “Custom” “KeyVault” “Managed”
certificateStatus	证书状态。	“Completed” “Failed” “InProgress”
defaultSslBinding	指定 true 以设置与此主机名关联的证书作为默认 SSL 证书。如果客户端未发送 SNI 标头，则这是将质询的证书。如果某个服务启用了多个自定义主机名，并且需要确定默认 ssl 证书，则此属性非常有用。此设置仅适用于网关主机名类型。	bool
encodedCertificate	Base64 编码证书。	字符串
hostName	在 Api 管理服务上配置的主机名。	string （必需）
identityClientId	Azure AD 生成的系统或用户分配的托管标识 clientId，该客户端有权访问包含 SSL 证书的 keyVault。	字符串
keyVaultId	包含 Ssl 证书的 KeyVault 机密的 URL。如果提供了包含版本的绝对 URL，则 ssl 证书的自动更新将不起作用。这要求使用 aka.ms/apimmsi 配置 Api 管理服务。机密的类型应为 application/x-pkcs12	字符串
negotiateClientCertificate	指定 true 以始终协商主机名上的客户端证书。默认值为 false。	bool
类型	主机名类型。	“ConfigurationApi” “DeveloperPortal” “管理” “Portal” “Proxy” “Scm”（必需）

Microsoft.ApiManagement/service

名字	描述	价值
apiVersion	API 版本	'2024-06-01-preview'
身份	Api 管理服务的托管服务标识。	ApiManagementServiceIdentity
位置	资源位置。	string （必需）
名字	资源名称	字符串约束：最小长度 = 1 最大长度 = 1 模式 = `^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$` （必需）
性能	API 管理服务的属性。	ApiManagementServiceProperties（必需）
sku	API 管理服务的 SKU 属性。	ApiManagementServiceSkuProperties（必需）
标签	资源标记	标记名称和值的字典。请参阅模板中的标记
类型	资源类型	“Microsoft.ApiManagement/service”
区	一个可用性区域列表，表示资源需要来自何处。	string[]

PrivateEndpointConnectionWrapperProperties

名字	描述	价值
privateEndpoint	专用终结点的资源。	ArmIdWrapper
privateLinkServiceConnectionState	有关服务使用者与提供程序之间的连接状态的信息集合。	PrivateLinkServiceConnectionState （必需）

PrivateLinkServiceConnectionState

名字	描述	价值
actionsRequired	一条消息，指示服务提供商上的更改是否需要对使用者进行任何更新。	字符串
描述	批准/拒绝连接的原因。	字符串
地位	指示连接是否已被服务的所有者批准/拒绝/删除。	“已批准” “Pending” “已拒绝”

RemotePrivateEndpointConnectionWrapper

名字	描述	价值
id	专用终结点连接资源 ID	字符串
名字	专用终结点连接名称	字符串
性能	资源属性。	PrivateEndpointConnectionWrapperProperties
类型	专用终结点连接资源类型	字符串

UserIdentityProperties

名字	描述	价值
clientId	用户分配标识的客户端 ID。	字符串
principalId	用户分配标识的主体 ID。	字符串

VirtualNetworkConfiguration

名字	描述	价值
subnetResourceId	要在其中部署 API 管理服务的虚拟网络中子网的完整资源 ID。	字符串约束： Pattern = `^/subscriptions/[^/]/resourceGroups/[^/]/providers/Microsoft.(ClassicNetwork\|Network)/virtualNetworks/[^/]/subnets/[^/]$`

快速入门模板

以下快速入门模板部署此资源类型。

模板	描述
使用内部 API 管理和 Web 应用应用程序网关	应用程序网关将 Internet 流量路由到虚拟网络（内部模式）API 管理实例，该实例服务 Azure Web 应用中托管的 Web API。
创建多区域高级层 API 管理实例	此模板演示如何创建具有其他位置的 API 管理实例。主要位置与资源组的位置相同。对于其他位置，模板显示 NorthCentralUs 和美国东部 2。主要位置应不同于其他位置。
使用模板创建 API 管理实例和所有子资源	此模板演示如何创建 API 管理服务并配置子实体
创建具有 MSI 标识的 API 管理实例	此模板创建具有 MSI 标识的 Azure API 管理的开发人员实例
使用模板创建 API 管理实例	此模板创建 Azure API 管理的开发人员实例
使用自定义主机名创建 API 管理实例	此模板演示如何使用门户的自定义主机名和代理的多个自定义主机名创建 Azure API 管理的实例
使用专用终结点创建 API 管理服务	此模板将创建 API 管理服务、虚拟网络和专用终结点，向虚拟网络公开 API 管理服务。
从 KeyVault 使用 SSL 创建 API 管理服务	此模板部署配置有用户分配标识的 API 管理服务。它使用此标识从 KeyVault 提取 SSL 证书，并通过每隔 4 小时检查一次来更新它。
创建和监视 API 管理实例	此模板创建 Azure API 管理服务和 Log Analytics 工作区的实例，并使用 Log Analytics 为 API 管理服务设置监视
使用应用网关在内部 VNet 中创建 API 管理	此模板演示如何在受 Azure 应用程序网关保护的专用网络上创建 Azure API 管理的实例。
使用 KeyVault 使用自定义代理 ssl 创建 API 管理	此模板演示如何使用 keyvault 中的 ssl 证书为代理创建 Azure API 管理的实例和配置自定义主机名。
在 Azure API 管理前创建 Azure Front Door	此示例演示如何在 Azure API 管理之前将 Azure Front Door 用作全局负载均衡器。
使用公共 IP 在外部 VNet 中部署 API 管理	此模板演示如何在虚拟网络子网的外部模式下的高级层中创建 Azure API 管理的实例，并在子网上配置建议的 NSG 规则。实例部署到两个可用性区域。该模板还配置订阅中的公共 IP 地址。
使用公共 IP 在内部 VNet 中部署 API 管理	此模板演示如何在虚拟网络子网内部的高级层中创建 Azure API 管理的实例，并在子网上配置建议的 NSG 规则。实例部署到两个可用性区域。该模板还配置订阅中的公共 IP 地址。
将 API 管理部署到可用性区域	此模板创建 Azure API 管理的高级实例，并将其部署到可用性区域
使用外部 Azure Redis 缓存部署 API 管理	此模板演示如何使用外部 Azure Redis 缓存实例作为 API 管理外部缓存在消耗层中创建 Azure API 管理的实例。
使用 API 管理源 Front Door 标准版/高级版	此模板创建 Front Door Premium 和 API 管理实例，并使用 NSG 和全局 API 管理策略来验证流量是否通过 Front Door 源。

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署服务资源类型：

资源组

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

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service@2024-06-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  zones = [
    "string"
  ]
  body = jsonencode({
    properties = {
      additionalLocations = [
        {
          disableGateway = bool
          location = "string"
          natGatewayState = "string"
          publicIpAddressId = "string"
          sku = {
            capacity = int
            name = "string"
          }
          virtualNetworkConfiguration = {
            subnetResourceId = "string"
          }
          zones = [
            "string"
          ]
        }
      ]
      apiVersionConstraint = {
        minApiVersion = "string"
      }
      certificates = [
        {
          certificate = {
            expiry = "string"
            subject = "string"
            thumbprint = "string"
          }
          certificatePassword = "string"
          encodedCertificate = "string"
          storeName = "string"
        }
      ]
      configurationApi = {
        legacyApi = "string"
      }
      customProperties = {
        {customized property} = "string"
      }
      developerPortalStatus = "string"
      disableGateway = bool
      enableClientCertificate = bool
      hostnameConfigurations = [
        {
          certificate = {
            expiry = "string"
            subject = "string"
            thumbprint = "string"
          }
          certificatePassword = "string"
          certificateSource = "string"
          certificateStatus = "string"
          defaultSslBinding = bool
          encodedCertificate = "string"
          hostName = "string"
          identityClientId = "string"
          keyVaultId = "string"
          negotiateClientCertificate = bool
          type = "string"
        }
      ]
      legacyPortalStatus = "string"
      natGatewayState = "string"
      notificationSenderEmail = "string"
      privateEndpointConnections = [
        {
          id = "string"
          name = "string"
          properties = {
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
          type = "string"
        }
      ]
      publicIpAddressId = "string"
      publicNetworkAccess = "string"
      publisherEmail = "string"
      publisherName = "string"
      releaseChannel = "string"
      restore = bool
      virtualNetworkConfiguration = {
        subnetResourceId = "string"
      }
      virtualNetworkType = "string"
    }
  })
}

属性值

AdditionalLocation

名字	描述	价值
disableGateway	属性仅适用于部署在多个位置的 Api 管理服务。这可用于在此附加位置中禁用网关。	bool
位置	Azure 数据中心区域中其他区域的位置名称。	string （必需）
natGatewayState	属性可用于为此 API 管理服务启用 NAT 网关。	“Disabled” “Enabled”
publicIpAddressId	要与位置中部署的虚拟网络服务关联的基于公共标准 SKU IP V4 的 IP 地址。仅支持在虚拟网络中部署高级 SKU。	字符串
sku	API 管理服务的 SKU 属性。	ApiManagementServiceSkuProperties（必需）
virtualNetworkConfiguration	位置的虚拟网络配置。	VirtualNetworkConfiguration
区	一个可用性区域列表，表示资源需要来自何处。	string[]

ApiManagementServiceBasePropertiesCustomProperties

名字	描述	价值

ApiManagementServiceIdentity

名字	描述	价值
类型	用于资源的标识类型。类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。类型“None”将从服务中删除任何标识。	“None” “SystemAssigned” “SystemAssigned，UserAssigned” “UserAssigned”（必需）
userAssignedIdentities	与资源关联的用户标识列表。用户标识字典键引用的格式为 ARM 资源 ID： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。	ApiManagementServiceIdentityUserAssignedIdentities

ApiManagementServiceIdentityUserAssignedIdentities

名字	描述	价值

ApiManagementServiceProperties

名字	描述	价值
additionalLocations	API 管理服务的其他数据中心位置。	AdditionalLocation[]
apiVersionConstraint	API 管理服务的控制平面 API 版本约束。	ApiVersionConstraint
证书	需要在 API 管理服务中安装的证书列表。可安装的最大支持证书为 10。	CertificateConfiguration[]
configurationApi	API 管理服务的配置 API 配置。	ConfigurationApi
customProperties	API 管理服务的自定义属性。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168` 将禁用所有 TLS（1.0、1.1 和 1.2）的密码TLS_RSA_WITH_3DES_EDE_CBC_SHA。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11` 可用于仅禁用 TLS 1.1。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10` 可用于在 API 管理服务上禁用 TLS 1.0。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11` 可用于仅禁用 TLS 1.1，以便与后端通信。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10` 可用于禁用 TLS 1.0 以便与后端通信。设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2` 可用于在 API 管理服务上启用 HTTP2 协议。未在 PATCH 操作中指定这些属性中的任何一个将省略的属性的值重置为其默认值。对于除 Http2 之外的所有设置，如果服务是在 2018 年 4 月 1 日或之前创建的，则默认值 `True`，否则 `False`。 Http2 设置的默认值为 `False`。可以使用设置 `Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.[cipher_name]`禁用以下任何密码：TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA、TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA、TLS_RSA_WITH_AES_128_GCM_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA256、 TLS_RSA_WITH_AES_128_CBC_SHA256、TLS_RSA_WITH_AES_256_CBC_SHA、TLS_RSA_WITH_AES_128_CBC_SHA。例如，`Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256`：`false`。默认值为 `true`。注意：由于内部平台组件需要以下密码，因此无法禁用这些密码：TLS_AES_256_GCM_SHA384、TLS_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384、TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256、TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384，TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256，TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384，TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256	ApiManagementServiceBasePropertiesCustomProperties
developerPortalStatus	此 API 管理服务中开发人员门户的状态。	“Disabled” “Enabled”
disableGateway	属性仅适用于部署在多个位置的 Api 管理服务。这可用于禁用主区域中的网关。	bool
enableClientCertificate	仅用于消耗 SKU 服务的属性。这会强制在向网关的每个请求上显示客户端证书。这样，便可以在网关上的策略中对证书进行身份验证。	bool
hostnameConfigurations	API 管理服务的自定义主机名配置。	HostnameConfiguration[]
legacyPortalStatus	API 管理服务中旧门户的状态。	“Disabled” “Enabled”
natGatewayState	属性可用于为此 API 管理服务启用 NAT 网关。	“Disabled” “Enabled”
notificationSenderEmail	将从中发送通知的电子邮件地址。	字符串约束：最大长度 =
privateEndpointConnections	此服务的专用终结点连接列表。	RemotePrivateEndpointConnectionWrapper[]
publicIpAddressId	要与区域中部署的虚拟网络服务关联的基于公共标准 SKU IP V4 的 IP 地址。仅支持在虚拟网络中部署开发人员和高级 SKU。	字符串
publicNetworkAccess	是否允许此 API 管理服务访问公共终结点。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”。如果为“Disabled”，则专用终结点是独占访问方法。默认值为“Enabled”	“Disabled” “Enabled”
publisherEmail	发布者电子邮件。	字符串约束：最大长度 = （必需）
publisherName	发布者名称。	字符串约束：最大长度 = （必需）
releaseChannel	此 API 管理服务的发布通道。	“Default” “预览” “稳定”
恢复	取消删除 Api 管理服务（如果以前是软删除的）。如果指定了此标志并设置为 True，将忽略所有其他属性。	bool
virtualNetworkConfiguration	API 管理服务的虚拟网络配置。	VirtualNetworkConfiguration
virtualNetworkType	需要在其中配置 API 管理服务的 VPN 类型。无（默认值）表示 API 管理服务不是任何虚拟网络的一部分，外部意味着 API 管理部署是在具有面向 Internet 的终结点的虚拟网络内设置的，内部意味着 API 管理部署仅在具有 Intranet 面向终结点的虚拟网络中进行设置。	“External” “Internal” “None”

ApiManagementServiceSkuProperties

名字	描述	价值
能力	SKU 的容量（SKU 的已部署单位数）。对于消耗 SKU 容量，必须指定为 0。	int （必需）
名字	Sku 的名称。	“Basic” “BasicV2” “消耗” “Developer” “独立” “Premium” “Standard” “StandardV2”（必需）

ApimResourceTags

名字	描述	价值

ApiVersionConstraint

名字	描述	价值
minApiVersion	限制对 API 管理服务的控制平面 API 调用，其版本等于或高于此值。	字符串

ArmIdWrapper

名字	描述	价值

CertificateConfiguration

名字	描述	价值
证书	证书信息。	CertificateInformation
certificatePassword	证书密码。	字符串
encodedCertificate	Base64 编码证书。	字符串
storeName	System.Security.Cryptography.x509certificates.StoreName 证书存储位置。只有 Root 和 CertificateAuthority 是有效位置。	“CertificateAuthority” “Root”（必需）

CertificateInformation

名字	描述	价值
满期	证书的到期日期。日期符合以下格式：按 ISO 8601 标准指定的 `yyyy-MM-ddTHH:mm:ssZ`。	string （必需）
主题	证书的使用者。	string （必需）
指纹	证书的指纹。	string （必需）

ConfigurationApi

名字	描述	价值
legacyApi	指示是否应在 API 管理服务上公开旧配置 API （v1）。值是可选的，但必须是“Enabled”或“Disabled”。如果“已禁用”，旧版配置 API（v1）将不适用于自承载网关。默认值为“Enabled”	“Disabled” “Enabled”

HostnameConfiguration

名字	描述	价值
证书	证书信息。	CertificateInformation
certificatePassword	证书密码。	字符串
certificateSource	证书源。	“BuiltIn” “Custom” “KeyVault” “Managed”
certificateStatus	证书状态。	“Completed” “Failed” “InProgress”
defaultSslBinding	指定 true 以设置与此主机名关联的证书作为默认 SSL 证书。如果客户端未发送 SNI 标头，则这是将质询的证书。如果某个服务启用了多个自定义主机名，并且需要确定默认 ssl 证书，则此属性非常有用。此设置仅适用于网关主机名类型。	bool
encodedCertificate	Base64 编码证书。	字符串
hostName	在 Api 管理服务上配置的主机名。	string （必需）
identityClientId	Azure AD 生成的系统或用户分配的托管标识 clientId，该客户端有权访问包含 SSL 证书的 keyVault。	字符串
keyVaultId	包含 Ssl 证书的 KeyVault 机密的 URL。如果提供了包含版本的绝对 URL，则 ssl 证书的自动更新将不起作用。这要求使用 aka.ms/apimmsi 配置 Api 管理服务。机密的类型应为 application/x-pkcs12	字符串
negotiateClientCertificate	指定 true 以始终协商主机名上的客户端证书。默认值为 false。	bool
类型	主机名类型。	“ConfigurationApi” “DeveloperPortal” “管理” “Portal” “Proxy” “Scm”（必需）

Microsoft.ApiManagement/service

名字	描述	价值
身份	Api 管理服务的托管服务标识。	ApiManagementServiceIdentity
位置	资源位置。	string （必需）
名字	资源名称	字符串约束：最小长度 = 1 最大长度 = 1 模式 = `^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$` （必需）
性能	API 管理服务的属性。	ApiManagementServiceProperties（必需）
sku	API 管理服务的 SKU 属性。	ApiManagementServiceSkuProperties（必需）
标签	资源标记	标记名称和值的字典。
类型	资源类型	“Microsoft.ApiManagement/service@2024-06-01-preview”
区	一个可用性区域列表，表示资源需要来自何处。	string[]

PrivateEndpointConnectionWrapperProperties

名字	描述	价值
privateEndpoint	专用终结点的资源。	ArmIdWrapper
privateLinkServiceConnectionState	有关服务使用者与提供程序之间的连接状态的信息集合。	PrivateLinkServiceConnectionState （必需）

PrivateLinkServiceConnectionState

名字	描述	价值
actionsRequired	一条消息，指示服务提供商上的更改是否需要对使用者进行任何更新。	字符串
描述	批准/拒绝连接的原因。	字符串
地位	指示连接是否已被服务的所有者批准/拒绝/删除。	“已批准” “Pending” “已拒绝”

RemotePrivateEndpointConnectionWrapper

名字	描述	价值
id	专用终结点连接资源 ID	字符串
名字	专用终结点连接名称	字符串
性能	资源属性。	PrivateEndpointConnectionWrapperProperties
类型	专用终结点连接资源类型	字符串

UserIdentityProperties

名字	描述	价值
clientId	用户分配标识的客户端 ID。	字符串
principalId	用户分配标识的主体 ID。	字符串

VirtualNetworkConfiguration

名字	描述	价值
subnetResourceId	要在其中部署 API 管理服务的虚拟网络中子网的完整资源 ID。	字符串约束： Pattern = `^/subscriptions/[^/]/resourceGroups/[^/]/providers/Microsoft.(ClassicNetwork\|Network)/virtualNetworks/[^/]/subnets/[^/]$`

通过

Microsoft.ApiManagement 服务

Bicep 资源定义

资源格式

属性值

AdditionalLocation

ApiManagementServiceBasePropertiesCustomProperties

ApiManagementServiceIdentity

ApiManagementServiceIdentityUserAssignedIdentities

ApiManagementServiceProperties

ApiManagementServiceSkuProperties

ApimResourceTags

ApiVersionConstraint

ArmIdWrapper

CertificateConfiguration

CertificateInformation

ConfigurationApi

HostnameConfiguration

Microsoft.ApiManagement/service

PrivateEndpointConnectionWrapperProperties

PrivateLinkServiceConnectionState

RemotePrivateEndpointConnectionWrapper

UserIdentityProperties

VirtualNetworkConfiguration

快速入门示例

ARM 模板资源定义

资源格式

属性值

AdditionalLocation

ApiManagementServiceBasePropertiesCustomProperties

ApiManagementServiceIdentity

ApiManagementServiceIdentityUserAssignedIdentities

ApiManagementServiceProperties

ApiManagementServiceSkuProperties

ApimResourceTags

ApiVersionConstraint

ArmIdWrapper

CertificateConfiguration

CertificateInformation

ConfigurationApi

HostnameConfiguration

Microsoft.ApiManagement/service

PrivateEndpointConnectionWrapperProperties

PrivateLinkServiceConnectionState

RemotePrivateEndpointConnectionWrapper

UserIdentityProperties

VirtualNetworkConfiguration

快速入门模板

Terraform （AzAPI 提供程序）资源定义

资源格式

属性值

AdditionalLocation

ApiManagementServiceBasePropertiesCustomProperties

ApiManagementServiceIdentity

ApiManagementServiceIdentityUserAssignedIdentities

ApiManagementServiceProperties

ApiManagementServiceSkuProperties

ApimResourceTags

ApiVersionConstraint

ArmIdWrapper

CertificateConfiguration

CertificateInformation

ConfigurationApi

HostnameConfiguration

Microsoft.ApiManagement/service

PrivateEndpointConnectionWrapperProperties

PrivateLinkServiceConnectionState

RemotePrivateEndpointConnectionWrapper

UserIdentityProperties

VirtualNetworkConfiguration

反馈

其他资源