Microsoft.ApiManagement 服務 2018-01-01
- 最新
- 2024-06-01-preview
- 2024-05-01
- 2023-09-01-preview
- 2023-05-01-preview
- 2023-03-01-preview
- 2022-09-01-preview
- 2022-08-01
- 2022-04-01-preview
- 2021-12-01-preview
- 2021-08-01
- 2021-04-01-preview
- 2021-01-01-preview
- 2020-12-01
- 2020-06-01-preview
- 2019-12-01
- 2019-12-01-preview
- 2019-01-01
- 2018-06-01-preview
- 2018-01-01
- 2017-03-01
- 2016-10-10
- 2016-07-07
Bicep 資源定義
服務資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ApiManagement/service 資源,請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.ApiManagement/service@2018-01-01' = {
identity: {
type: 'string'
}
location: 'string'
name: 'string'
properties: {
additionalLocations: [
{
location: 'string'
sku: {
capacity: int
name: 'string'
}
virtualNetworkConfiguration: {
subnetResourceId: 'string'
}
}
]
certificates: [
{
certificate: {
expiry: 'string'
subject: 'string'
thumbprint: 'string'
}
certificatePassword: 'string'
encodedCertificate: 'string'
storeName: 'string'
}
]
customProperties: {
{customized property}: 'string'
}
hostnameConfigurations: [
{
certificate: {
expiry: 'string'
subject: 'string'
thumbprint: 'string'
}
certificatePassword: 'string'
defaultSslBinding: bool
encodedCertificate: 'string'
hostName: 'string'
keyVaultId: 'string'
negotiateClientCertificate: bool
type: 'string'
}
]
notificationSenderEmail: 'string'
publisherEmail: 'string'
publisherName: 'string'
virtualNetworkConfiguration: {
subnetResourceId: 'string'
}
virtualNetworkType: 'string'
}
sku: {
capacity: int
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
屬性值
AdditionalLocation
名字 | 描述 | 價值 |
---|---|---|
位置 | Azure 資料中心區域之間其他區域的位置名稱。 | 字串 (必要) |
sku | API 管理服務的 SKU 屬性。 | ApiManagementServiceSkuProperties (必要) |
virtualNetworkConfiguration | 位置的虛擬網路組態。 | VirtualNetworkConfiguration |
ApiManagementServiceBasePropertiesCustomProperties
名字 | 描述 | 價值 |
---|
ApiManagementServiceIdentity
名字 | 描述 | 價值 |
---|---|---|
類型 | 識別類型。 目前唯一支持的類型是 『SystemAssigned』。 | 'SystemAssigned' (必要) |
ApiManagementServiceProperties
名字 | 描述 | 價值 |
---|---|---|
additionalLocations | API 管理服務的其他數據中心位置。 | AdditionalLocation[] |
證書 | 需要在 API 管理服務中安裝的憑證清單。 可安裝的憑證數目上限為 10。 | CertificateConfiguration[] |
customProperties | API 管理服務的自定義屬性。 設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168 會停用所有 TLS 的加密TLS_RSA_WITH_3DES_EDE_CBC_SHA(1.0、1.1 和 1.2)。 設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11 可用來只停用 TLS 1.1,而設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10 可用來停用 API 管理服務上的 TLS 1.0。 |
ApiManagementServiceBasePropertiesCustomProperties |
hostnameConfigurations | API 管理服務的自定義主機名組態。 | HostnameConfiguration[] |
notificationSenderEmail | 將傳送通知的電子郵件位址。 | 字串 約束: 最大長度 = |
publisherEmail | 發行者電子郵件。 | 字串 約束: 最大長度 = (必要) |
publisherName | 發行者名稱。 | 字串 約束: 最大長度 = (必要) |
virtualNetworkConfiguration | API 管理服務的虛擬網路組態。 | VirtualNetworkConfiguration |
virtualNetworkType | 必須在其中設定 API 管理服務的 VPN 類型。 無 (預設值) 表示 API 管理服務不屬於任何虛擬網路,外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定,而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。 | 'External' 'Internal' 'None' |
ApiManagementServiceSkuProperties
名字 | 描述 | 價值 |
---|---|---|
能力 | SKU 的容量(SKU 的部署單位數目)。 預設值為 1。 | int |
名字 | Sku 的名稱。 | 'Basic' 'Developer' 'Premium' 'Standard' (必要) |
ApimResourceTags
名字 | 描述 | 價值 |
---|
CertificateConfiguration
名字 | 描述 | 價值 |
---|---|---|
證書 | 憑證資訊。 | CertificateInformation |
certificatePassword | 憑證密碼。 | 字串 |
encodedCertificate | Base64 編碼憑證。 | 字串 |
storeName | System.Security.Cryptography.x509certificates.StoreName 證書存儲位置。 只有 Root 和 CertificateAuthority 是有效的位置。 | 'CertificateAuthority' 'Root' (必要) |
CertificateInformation
名字 | 描述 | 價值 |
---|---|---|
滿期 | 憑證的到期日。 日期符合下列格式:yyyy-MM-ddTHH:mm:ssZ ISO 8601 標準所指定。 |
字串 (必要) |
主題 | 憑證的主體。 | 字串 (必要) |
指紋 | 憑證的指紋。 | 字串 (必要) |
HostnameConfiguration
名字 | 描述 | 價值 |
---|---|---|
證書 | 憑證資訊。 | CertificateInformation |
certificatePassword | 憑證密碼。 | 字串 |
defaultSslBinding | 指定 true,將與此主機名相關聯的憑證設定為預設 SSL 憑證。 如果用戶端未傳送 SNI 標頭,則這會是將會受到挑戰的憑證。 如果服務已啟用多個自定義主機名,且必須決定預設ssl憑證,則屬性會很有用。 此設定只會套用至 Proxy 主機名類型。 | bool |
encodedCertificate | Base64 編碼憑證。 | 字串 |
hostName | 在 Api 管理服務上設定的主機名。 | 字串 (必要) |
keyVaultId | 包含 Ssl 憑證之 KeyVault 秘密的 URL。 如果提供包含版本的絕對 URL,SSL 憑證的自動更新將無法運作。 這需要 API 管理服務以 MSI 進行設定。 秘密的類型應 為 application/x-pkcs12 | 字串 |
negotiateClientCertificate | 指定 true 以一律交涉主機名上的客戶端憑證。 默認值為 false。 | bool |
類型 | 主機名類型。 | 'Management' 'Portal' 'Proxy' 'Scm' (必要) |
Microsoft.ApiManagement/service
名字 | 描述 | 價值 |
---|---|---|
身份 | Api 管理服務的受控服務識別。 | ApiManagementServiceIdentity |
位置 | 資源位置。 | 字串 (必要) |
名字 | 資源名稱 | 字串 約束: 最小長度 = 1 最大長度 = 1 模式 = ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$ (必要) |
性能 | API 管理服務的屬性。 | ApiManagementServiceProperties (必要) |
sku | API 管理服務的 SKU 屬性。 | ApiManagementServiceSkuProperties (必要) |
標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
VirtualNetworkConfiguration
名字 | 描述 | 價值 |
---|---|---|
subnetResourceId | 虛擬網路中要部署 API 管理服務之子網的完整資源識別碼。 | 字串 約束: Pattern = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
快速入門範例
下列快速入門範例會部署此資源類型。
Bicep 檔案 | 描述 |
---|---|
使用內部 API 管理和 Web 應用程式 |
應用程式閘道會將因特網流量路由傳送至虛擬網路(內部模式)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 Cache for Redis 部署 API 管理 | 此範本示範如何使用外部 Azure Cache for Redis 實例作為 API 管理外部快取,在取用層中建立 Azure API 管理的實例。 |
使用 API 管理來源 Front Door Standard/Premium | 此範本會建立 Front Door Premium 和 API 管理實例,並使用 NSG 和全域 API 管理原則來驗證流量是否通過 Front Door 來源。 |
ARM 樣本資源定義
服務資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ApiManagement/服務資源,請將下列 JSON 新增至您的範本。
{
"type": "Microsoft.ApiManagement/service",
"apiVersion": "2018-01-01",
"name": "string",
"identity": {
"type": "string"
},
"location": "string",
"properties": {
"additionalLocations": [
{
"location": "string",
"sku": {
"capacity": "int",
"name": "string"
},
"virtualNetworkConfiguration": {
"subnetResourceId": "string"
}
}
],
"certificates": [
{
"certificate": {
"expiry": "string",
"subject": "string",
"thumbprint": "string"
},
"certificatePassword": "string",
"encodedCertificate": "string",
"storeName": "string"
}
],
"customProperties": {
"{customized property}": "string"
},
"hostnameConfigurations": [
{
"certificate": {
"expiry": "string",
"subject": "string",
"thumbprint": "string"
},
"certificatePassword": "string",
"defaultSslBinding": "bool",
"encodedCertificate": "string",
"hostName": "string",
"keyVaultId": "string",
"negotiateClientCertificate": "bool",
"type": "string"
}
],
"notificationSenderEmail": "string",
"publisherEmail": "string",
"publisherName": "string",
"virtualNetworkConfiguration": {
"subnetResourceId": "string"
},
"virtualNetworkType": "string"
},
"sku": {
"capacity": "int",
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
屬性值
AdditionalLocation
名字 | 描述 | 價值 |
---|---|---|
位置 | Azure 資料中心區域之間其他區域的位置名稱。 | 字串 (必要) |
sku | API 管理服務的 SKU 屬性。 | ApiManagementServiceSkuProperties (必要) |
virtualNetworkConfiguration | 位置的虛擬網路組態。 | VirtualNetworkConfiguration |
ApiManagementServiceBasePropertiesCustomProperties
名字 | 描述 | 價值 |
---|
ApiManagementServiceIdentity
名字 | 描述 | 價值 |
---|---|---|
類型 | 識別類型。 目前唯一支持的類型是 『SystemAssigned』。 | 'SystemAssigned' (必要) |
ApiManagementServiceProperties
名字 | 描述 | 價值 |
---|---|---|
additionalLocations | API 管理服務的其他數據中心位置。 | AdditionalLocation[] |
證書 | 需要在 API 管理服務中安裝的憑證清單。 可安裝的憑證數目上限為 10。 | CertificateConfiguration[] |
customProperties | API 管理服務的自定義屬性。 設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168 會停用所有 TLS 的加密TLS_RSA_WITH_3DES_EDE_CBC_SHA(1.0、1.1 和 1.2)。 設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11 可用來只停用 TLS 1.1,而設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10 可用來停用 API 管理服務上的 TLS 1.0。 |
ApiManagementServiceBasePropertiesCustomProperties |
hostnameConfigurations | API 管理服務的自定義主機名組態。 | HostnameConfiguration[] |
notificationSenderEmail | 將傳送通知的電子郵件位址。 | 字串 約束: 最大長度 = |
publisherEmail | 發行者電子郵件。 | 字串 約束: 最大長度 = (必要) |
publisherName | 發行者名稱。 | 字串 約束: 最大長度 = (必要) |
virtualNetworkConfiguration | API 管理服務的虛擬網路組態。 | VirtualNetworkConfiguration |
virtualNetworkType | 必須在其中設定 API 管理服務的 VPN 類型。 無 (預設值) 表示 API 管理服務不屬於任何虛擬網路,外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定,而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。 | 'External' 'Internal' 'None' |
ApiManagementServiceSkuProperties
名字 | 描述 | 價值 |
---|---|---|
能力 | SKU 的容量(SKU 的部署單位數目)。 預設值為 1。 | int |
名字 | Sku 的名稱。 | 'Basic' 'Developer' 'Premium' 'Standard' (必要) |
ApimResourceTags
名字 | 描述 | 價值 |
---|
CertificateConfiguration
名字 | 描述 | 價值 |
---|---|---|
證書 | 憑證資訊。 | CertificateInformation |
certificatePassword | 憑證密碼。 | 字串 |
encodedCertificate | Base64 編碼憑證。 | 字串 |
storeName | System.Security.Cryptography.x509certificates.StoreName 證書存儲位置。 只有 Root 和 CertificateAuthority 是有效的位置。 | 'CertificateAuthority' 'Root' (必要) |
CertificateInformation
名字 | 描述 | 價值 |
---|---|---|
滿期 | 憑證的到期日。 日期符合下列格式:yyyy-MM-ddTHH:mm:ssZ ISO 8601 標準所指定。 |
字串 (必要) |
主題 | 憑證的主體。 | 字串 (必要) |
指紋 | 憑證的指紋。 | 字串 (必要) |
HostnameConfiguration
名字 | 描述 | 價值 |
---|---|---|
證書 | 憑證資訊。 | CertificateInformation |
certificatePassword | 憑證密碼。 | 字串 |
defaultSslBinding | 指定 true,將與此主機名相關聯的憑證設定為預設 SSL 憑證。 如果用戶端未傳送 SNI 標頭,則這會是將會受到挑戰的憑證。 如果服務已啟用多個自定義主機名,且必須決定預設ssl憑證,則屬性會很有用。 此設定只會套用至 Proxy 主機名類型。 | bool |
encodedCertificate | Base64 編碼憑證。 | 字串 |
hostName | 在 Api 管理服務上設定的主機名。 | 字串 (必要) |
keyVaultId | 包含 Ssl 憑證之 KeyVault 秘密的 URL。 如果提供包含版本的絕對 URL,SSL 憑證的自動更新將無法運作。 這需要 API 管理服務以 MSI 進行設定。 秘密的類型應 為 application/x-pkcs12 | 字串 |
negotiateClientCertificate | 指定 true 以一律交涉主機名上的客戶端憑證。 默認值為 false。 | bool |
類型 | 主機名類型。 | 'Management' 'Portal' 'Proxy' 'Scm' (必要) |
Microsoft.ApiManagement/service
名字 | 描述 | 價值 |
---|---|---|
apiVersion | API 版本 | '2018-01-01' |
身份 | Api 管理服務的受控服務識別。 | ApiManagementServiceIdentity |
位置 | 資源位置。 | 字串 (必要) |
名字 | 資源名稱 | 字串 約束: 最小長度 = 1 最大長度 = 1 模式 = ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$ (必要) |
性能 | API 管理服務的屬性。 | ApiManagementServiceProperties (必要) |
sku | API 管理服務的 SKU 屬性。 | ApiManagementServiceSkuProperties (必要) |
標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
類型 | 資源類型 | 'Microsoft.ApiManagement/service' |
VirtualNetworkConfiguration
名字 | 描述 | 價值 |
---|---|---|
subnetResourceId | 虛擬網路中要部署 API 管理服務之子網的完整資源識別碼。 | 字串 約束: Pattern = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |
快速入門範本
下列快速入門範本會部署此資源類型。
範本 | 描述 |
---|---|
使用內部 API 管理和 Web 應用程式 |
應用程式閘道會將因特網流量路由傳送至虛擬網路(內部模式)API 管理實例,此實例會服務裝載於 Azure Web 應用程式中的 Web API。 |
建立多區域進階層 API 管理實例 |
此範本示範如何使用其他位置建立 API 管理實例。 主要位置與資源群組的位置相同。 針對其他位置,範本會顯示 NorthCentralUs 和美國東部 2。 主要位置應該不同於其他位置。 |
使用範本 建立 API 管理實例和所有子資源 |
此範本示範如何建立 API 管理服務及設定子實體 |
建立具有 MSI 身分識別 的 API 管理實例 |
此範本會建立具有 MSI 身分識別的 Azure API 管理的開發人員實例 |
使用範本建立 API 管理實例 |
此範本會建立 Azure API 管理的開發人員實例 |
使用自定義主機名建立 API 管理實例 |
此範本示範如何使用入口網站的自定義主機名和 Proxy 的多個自定義主機名來建立 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 使用自定義 Proxy ssl 建立 API 管理 |
此範本示範如何建立 Azure API 管理的實例,並使用keyvault的ssl憑證來設定 Proxy 的自定義主機名。 |
在 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 Cache for Redis 部署 API 管理 |
此範本示範如何使用外部 Azure Cache for Redis 實例作為 API 管理外部快取,在取用層中建立 Azure API 管理的實例。 |
使用 API 管理來源 Front Door Standard/Premium |
此範本會建立 Front Door Premium 和 API 管理實例,並使用 NSG 和全域 API 管理原則來驗證流量是否通過 Front Door 來源。 |
Terraform (AzAPI 提供者) 資源定義
服務資源類型可以使用目標作業來部署:
- 資源群組
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.ApiManagement/service 資源,請將下列 Terraform 新增至您的範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service@2018-01-01"
name = "string"
identity = {
type = "string"
}
location = "string"
sku = {
capacity = int
name = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
additionalLocations = [
{
location = "string"
sku = {
capacity = int
name = "string"
}
virtualNetworkConfiguration = {
subnetResourceId = "string"
}
}
]
certificates = [
{
certificate = {
expiry = "string"
subject = "string"
thumbprint = "string"
}
certificatePassword = "string"
encodedCertificate = "string"
storeName = "string"
}
]
customProperties = {
{customized property} = "string"
}
hostnameConfigurations = [
{
certificate = {
expiry = "string"
subject = "string"
thumbprint = "string"
}
certificatePassword = "string"
defaultSslBinding = bool
encodedCertificate = "string"
hostName = "string"
keyVaultId = "string"
negotiateClientCertificate = bool
type = "string"
}
]
notificationSenderEmail = "string"
publisherEmail = "string"
publisherName = "string"
virtualNetworkConfiguration = {
subnetResourceId = "string"
}
virtualNetworkType = "string"
}
})
}
屬性值
AdditionalLocation
名字 | 描述 | 價值 |
---|---|---|
位置 | Azure 資料中心區域之間其他區域的位置名稱。 | 字串 (必要) |
sku | API 管理服務的 SKU 屬性。 | ApiManagementServiceSkuProperties (必要) |
virtualNetworkConfiguration | 位置的虛擬網路組態。 | VirtualNetworkConfiguration |
ApiManagementServiceBasePropertiesCustomProperties
名字 | 描述 | 價值 |
---|
ApiManagementServiceIdentity
名字 | 描述 | 價值 |
---|---|---|
類型 | 識別類型。 目前唯一支持的類型是 『SystemAssigned』。 | 'SystemAssigned' (必要) |
ApiManagementServiceProperties
名字 | 描述 | 價值 |
---|---|---|
additionalLocations | API 管理服務的其他數據中心位置。 | AdditionalLocation[] |
證書 | 需要在 API 管理服務中安裝的憑證清單。 可安裝的憑證數目上限為 10。 | CertificateConfiguration[] |
customProperties | API 管理服務的自定義屬性。 設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168 會停用所有 TLS 的加密TLS_RSA_WITH_3DES_EDE_CBC_SHA(1.0、1.1 和 1.2)。 設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11 可用來只停用 TLS 1.1,而設定 Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10 可用來停用 API 管理服務上的 TLS 1.0。 |
ApiManagementServiceBasePropertiesCustomProperties |
hostnameConfigurations | API 管理服務的自定義主機名組態。 | HostnameConfiguration[] |
notificationSenderEmail | 將傳送通知的電子郵件位址。 | 字串 約束: 最大長度 = |
publisherEmail | 發行者電子郵件。 | 字串 約束: 最大長度 = (必要) |
publisherName | 發行者名稱。 | 字串 約束: 最大長度 = (必要) |
virtualNetworkConfiguration | API 管理服務的虛擬網路組態。 | VirtualNetworkConfiguration |
virtualNetworkType | 必須在其中設定 API 管理服務的 VPN 類型。 無 (預設值) 表示 API 管理服務不屬於任何虛擬網路,外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定,而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。 | 'External' 'Internal' 'None' |
ApiManagementServiceSkuProperties
名字 | 描述 | 價值 |
---|---|---|
能力 | SKU 的容量(SKU 的部署單位數目)。 預設值為 1。 | int |
名字 | Sku 的名稱。 | 'Basic' 'Developer' 'Premium' 'Standard' (必要) |
ApimResourceTags
名字 | 描述 | 價值 |
---|
CertificateConfiguration
名字 | 描述 | 價值 |
---|---|---|
證書 | 憑證資訊。 | CertificateInformation |
certificatePassword | 憑證密碼。 | 字串 |
encodedCertificate | Base64 編碼憑證。 | 字串 |
storeName | System.Security.Cryptography.x509certificates.StoreName 證書存儲位置。 只有 Root 和 CertificateAuthority 是有效的位置。 | 'CertificateAuthority' 'Root' (必要) |
CertificateInformation
名字 | 描述 | 價值 |
---|---|---|
滿期 | 憑證的到期日。 日期符合下列格式:yyyy-MM-ddTHH:mm:ssZ ISO 8601 標準所指定。 |
字串 (必要) |
主題 | 憑證的主體。 | 字串 (必要) |
指紋 | 憑證的指紋。 | 字串 (必要) |
HostnameConfiguration
名字 | 描述 | 價值 |
---|---|---|
證書 | 憑證資訊。 | CertificateInformation |
certificatePassword | 憑證密碼。 | 字串 |
defaultSslBinding | 指定 true,將與此主機名相關聯的憑證設定為預設 SSL 憑證。 如果用戶端未傳送 SNI 標頭,則這會是將會受到挑戰的憑證。 如果服務已啟用多個自定義主機名,且必須決定預設ssl憑證,則屬性會很有用。 此設定只會套用至 Proxy 主機名類型。 | bool |
encodedCertificate | Base64 編碼憑證。 | 字串 |
hostName | 在 Api 管理服務上設定的主機名。 | 字串 (必要) |
keyVaultId | 包含 Ssl 憑證之 KeyVault 秘密的 URL。 如果提供包含版本的絕對 URL,SSL 憑證的自動更新將無法運作。 這需要 API 管理服務以 MSI 進行設定。 秘密的類型應 為 application/x-pkcs12 | 字串 |
negotiateClientCertificate | 指定 true 以一律交涉主機名上的客戶端憑證。 默認值為 false。 | bool |
類型 | 主機名類型。 | 'Management' 'Portal' 'Proxy' 'Scm' (必要) |
Microsoft.ApiManagement/service
名字 | 描述 | 價值 |
---|---|---|
身份 | Api 管理服務的受控服務識別。 | ApiManagementServiceIdentity |
位置 | 資源位置。 | 字串 (必要) |
名字 | 資源名稱 | 字串 約束: 最小長度 = 1 最大長度 = 1 模式 = ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$ (必要) |
性能 | API 管理服務的屬性。 | ApiManagementServiceProperties (必要) |
sku | API 管理服務的 SKU 屬性。 | ApiManagementServiceSkuProperties (必要) |
標籤 | 資源標籤 | 標記名稱和值的字典。 |
類型 | 資源類型 | “Microsoft.ApiManagement/service@2018-01-01” |
VirtualNetworkConfiguration
名字 | 描述 | 價值 |
---|---|---|
subnetResourceId | 虛擬網路中要部署 API 管理服務之子網的完整資源識別碼。 | 字串 約束: Pattern = ^/subscriptions/[^/]*/resourceGroups/[^/]*/providers/Microsoft.(ClassicNetwork|Network)/virtualNetworks/[^/]*/subnets/[^/]*$ |