Api Management Service - Update

參考

服務:: API Management

API 版本:: 2024-05-01

更新現有的 API 管理服務。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}?api-version=2024-05-01

URI 參數

名稱	位於	必要	類型	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
serviceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$	API 管理服務的名稱。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	要用於這項作業的 API 版本。

要求本文

名稱	類型	Description
identity	ApiManagementServiceIdentity	Api 管理服務的受控服務識別。
properties.additionalLocations	AdditionalLocation[]	API 管理服務的其他數據中心位置。
properties.apiVersionConstraint	ApiVersionConstraint	API 管理服務的控制平面 API 版本條件約束。
properties.certificates	CertificateConfiguration[]	需要在 API 管理服務中安裝的憑證清單。可安裝的憑證數目上限為 10。
properties.configurationApi	ConfigurationApi	設定 API 管理服務的 API 組態。
properties.customProperties	object	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。設定 `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
properties.developerPortalStatus	developerPortalStatus	此 API 管理服務中的開發人員入口網站狀態。
properties.disableGateway	boolean	屬性僅適用於部署在多個位置的 Api 管理服務。這可用來停用主要區域中的閘道。
properties.enableClientCertificate	boolean	屬性僅供取用 SKU 服務使用。這會強制在閘道的每個要求上顯示客戶端憑證。這也可讓您在閘道的原則中驗證憑證。
properties.hostnameConfigurations	HostnameConfiguration[]	API 管理服務的自定義主機名組態。
properties.legacyPortalStatus	LegacyPortalStatus	API 管理服務中舊版入口網站的狀態。
properties.natGatewayState	NatGatewayState	屬性可用來啟用此 API 管理服務的 NAT 閘道。
properties.notificationSenderEmail	string maxLength: 100	將傳送通知的電子郵件位址。
properties.privateEndpointConnections	RemotePrivateEndpointConnectionWrapper[]	此服務的私人端點連線清單。
properties.publicIpAddressId	string	要與區域中部署的虛擬網路服務相關聯的公用標準 SKU IP V4 型 IP 位址。僅支援虛擬網路中部署的開發人員和進階 SKU。
properties.publicNetworkAccess	PublicNetworkAccess	此 API 管理服務是否允許公用端點存取。值為選擇性值，但如果傳入，則必須是『Enabled』或 'Disabled'。如果為『Disabled』，私人端點就是獨佔存取方法。預設值為 'Enabled'
properties.publisherEmail	string maxLength: 100	發行者電子郵件。
properties.publisherName	string maxLength: 100	發行者名稱。
properties.restore	boolean	如果先前已虛刪除，請取消刪除 Api 管理服務。如果指定此旗標，並將設定為 True，則會忽略所有其他屬性。
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration	API 管理服務的虛擬網路組態。
properties.virtualNetworkType	VirtualNetworkType	必須在其中設定 API 管理服務的 VPN 類型。無（預設值）表示 API 管理服務不屬於任何虛擬網路，外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定，而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。
sku	ApiManagementServiceSkuProperties	API 管理服務的 SKU 屬性。
tags	object	資源標籤。
zones	string[]	可用性區域清單，表示資源需要來自何處。

回應

名稱	類型	Description
200 OK	ApiManagementServiceResource	已成功更新服務。
202 Accepted		服務更新要求已接受。標題 location: string
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

名稱

類型

Description

200 OK

ApiManagementServiceResource

已成功更新服務。

202 Accepted

服務更新要求已接受。

標題

location: string

Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

ApiManagementUpdateServiceDisableTls10

ApiManagementUpdateServicePublisherDetails

ApiManagementUpdateServiceToNewVnetAndAvailabilityZones

ApiManagementUpdateServiceDisableTls10

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2024-05-01

{
  "properties": {
    "customProperties": {
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false"
    }
  }
}

範例回覆

狀態碼:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2024-05-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2024-05-01&asyncResponse

狀態碼:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
  "name": "apimService1",
  "type": "Microsoft.ApiManagement/service",
  "tags": {
    "Owner": "sasolank",
    "UID": "4f5025fe-0669-4e2e-8320-5199466e5eb3",
    "Reserved": "",
    "TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT",
    "Pool": "Manual",
    "TestSuiteExpiration": "Thu, 29 Jun 2017 18:51:46 GMT"
  },
  "location": "West US",
  "etag": "AAAAAAAYRPs=",
  "properties": {
    "publisherEmail": "admin@live.com",
    "publisherName": "Contoso",
    "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
    "provisioningState": "Succeeded",
    "targetProvisioningState": "",
    "createdAtUtc": "2017-06-29T17:50:42.3191122Z",
    "gatewayUrl": "https://apimService1.azure-api.net",
    "portalUrl": "https://apimService1.portal.azure-api.net",
    "managementApiUrl": "https://apimService1.management.azure-api.net",
    "scmUrl": "https://apimService1.scm.azure-api.net",
    "hostnameConfigurations": [],
    "publicIPAddresses": [
      "40.86.176.232"
    ],
    "customProperties": {
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
    },
    "virtualNetworkType": "None"
  },
  "sku": {
    "name": "Standard",
    "capacity": 1
  }
}

ApiManagementUpdateServicePublisherDetails

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2024-05-01

{
  "properties": {
    "publisherEmail": "foobar@live.com",
    "publisherName": "Contoso Vnext"
  }
}

範例回覆

狀態碼:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2024-05-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2024-05-01&asyncResponse

狀態碼:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
  "name": "apimService1",
  "type": "Microsoft.ApiManagement/service",
  "tags": {
    "Owner": "sasolank",
    "UID": "4f5025fe-0669-4e2e-8320-5199466e5eb3",
    "Reserved": "",
    "TestExpiration": "Thu, 29 Jun 2017 18:50:40 GMT",
    "Pool": "Manual",
    "TestSuiteExpiration": "Thu, 29 Jun 2017 18:51:46 GMT"
  },
  "location": "West US",
  "etag": "AAAAAAAYRPs=",
  "properties": {
    "publisherEmail": "foobar@live.com",
    "publisherName": "Contoso Vnext",
    "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
    "provisioningState": "Succeeded",
    "targetProvisioningState": "",
    "createdAtUtc": "2017-06-29T17:50:42.3191122Z",
    "gatewayUrl": "https://apimService1.azure-api.net",
    "portalUrl": "https://apimService1.portal.azure-api.net",
    "managementApiUrl": "https://apimService1.management.azure-api.net",
    "scmUrl": "https://apimService1.scm.azure-api.net",
    "hostnameConfigurations": [],
    "publicIPAddresses": [
      "40.86.176.232"
    ],
    "customProperties": {
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False"
    },
    "virtualNetworkType": "None"
  },
  "sku": {
    "name": "Standard",
    "capacity": 1
  }
}

ApiManagementUpdateServiceToNewVnetAndAvailabilityZones

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2024-05-01

{
  "properties": {
    "additionalLocations": [
      {
        "location": "Australia East",
        "sku": {
          "name": "Premium",
          "capacity": 3
        },
        "zones": [
          "1",
          "2",
          "3"
        ],
        "virtualNetworkConfiguration": {
          "subnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apimaeavnet/subnets/default"
        },
        "publicIpAddressId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/apim-australia-east-publicip"
      }
    ],
    "virtualNetworkConfiguration": {
      "subnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet-apim-japaneast/subnets/apim2"
    },
    "virtualNetworkType": "External",
    "publicIpAddressId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/publicip-apim-japan-east"
  },
  "sku": {
    "name": "Premium",
    "capacity": 3
  },
  "zones": [
    "1",
    "2",
    "3"
  ]
}

範例回覆

狀態碼:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2024-05-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2024-05-01&asyncResponse

狀態碼:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
  "name": "apimService1",
  "type": "Microsoft.ApiManagement/service",
  "location": "Japan East",
  "etag": "AAAAAAAWBIU=",
  "properties": {
    "publisherEmail": "contoso@microsoft.com",
    "publisherName": "apimPublisher",
    "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
    "provisioningState": "Succeeded",
    "targetProvisioningState": "",
    "createdAtUtc": "2021-04-08T23:41:35.6447381Z",
    "gatewayUrl": "https://apimService1.azure-api.net",
    "gatewayRegionalUrl": "https://apimService1-japaneast-01.regional.azure-api.net",
    "portalUrl": "https://apimService1.portal.azure-api.net",
    "developerPortalUrl": "https://apimService1.developer.azure-api.net",
    "managementApiUrl": "https://apimService1.management.azure-api.net",
    "scmUrl": "https://apimService1.scm.azure-api.net",
    "hostnameConfigurations": [
      {
        "type": "Proxy",
        "hostName": "apimService1.azure-api.net",
        "negotiateClientCertificate": false,
        "defaultSslBinding": false,
        "certificateSource": "BuiltIn"
      },
      {
        "type": "Proxy",
        "hostName": "mycustomdomain.int-azure-api.net",
        "negotiateClientCertificate": false,
        "certificate": {
          "expiry": "2022-06-09T23:59:59+00:00",
          "thumbprint": "2994B5FFB8F76B3C687D324A8DEE0432C1ED18CD",
          "subject": "CN=mycustomdomain.int-azure-api.net"
        },
        "defaultSslBinding": true,
        "certificateSource": "Managed"
      }
    ],
    "publicIPAddresses": [
      "20.78.248.217"
    ],
    "additionalLocations": [
      {
        "location": "Australia East",
        "sku": {
          "name": "Premium",
          "capacity": 3
        },
        "zones": [
          "1",
          "2",
          "3"
        ],
        "publicIPAddresses": [
          "20.213.1.35"
        ],
        "virtualNetworkConfiguration": {
          "subnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apimaeavnet/subnets/default"
        },
        "gatewayRegionalUrl": "https://apimService1-australiaeast-01.regional.azure-api.net",
        "disableGateway": false,
        "publicIpAddressId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/apim-australia-east-publicip",
        "platformVersion": "stv2"
      }
    ],
    "virtualNetworkConfiguration": {
      "subnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet-apim-japaneast/subnets/apim2"
    },
    "customProperties": {
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_GCM_SHA256": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_256_CBC_SHA256": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA256": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_256_CBC_SHA": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_RSA_WITH_AES_128_CBC_SHA": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "false",
      "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "false"
    },
    "virtualNetworkType": "Internal",
    "disableGateway": false,
    "publicIpAddressId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/publicip-apim-japan-east",
    "publicNetworkAccess": "Enabled",
    "platformVersion": "stv2"
  },
  "sku": {
    "name": "Premium",
    "capacity": 3
  },
  "zones": [
    "1",
    "2",
    "3"
  ],
  "systemData": {
    "lastModifiedBy": "contoso@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-01-21T20:04:21.6108974Z"
  }
}

定義

名稱	Description
AdditionalLocation	其他 API 管理資源位置的描述。
ApiManagementServiceIdentity	Api 管理服務資源的識別屬性。
ApiManagementServiceResource	List 或 Get 回應中的單一 API 管理服務資源。
ApiManagementServiceSkuProperties	API 管理服務資源 SKU 屬性。
ApiManagementServiceUpdateParameters	提供給更新 Api 管理服務的參數。
ApimIdentityType	用於資源的身分識別類型。類型 'SystemAssigned， UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。類型『None』會從服務中移除任何身分識別。
ApiVersionConstraint	API 管理服務的控制平面 API 版本條件約束。
ArmIdWrapper	ARM 資源標識碼的包裝函式
CertificateConfiguration	包含非受信任中繼和跟證書的憑證組態。
CertificateInformation	SSL 憑證資訊。
CertificateSource	憑證來源。
CertificateStatus	憑證狀態。
ConfigurationApi	API 管理服務之設定 API 的相關信息。
createdByType	建立資源的身分識別類型。
developerPortalStatus	此 API 管理服務中的開發人員入口網站狀態。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
HostnameConfiguration	自定義主機名組態。
HostnameType	主機名類型。
LegacyApiState	指示是否應該在 API 管理服務上公開舊版組態 API （v1）。值為選擇性值，但必須是『Enabled』或『Disabled』。如果「已停用」，舊版設定 API （v1）將無法用於自我裝載閘道。預設值為 'Enabled'
LegacyPortalStatus	API 管理服務中舊版入口網站的狀態。
NatGatewayState	屬性可用來啟用此 API 管理服務的 NAT 閘道。
PlatformVersion	執行服務的計算平臺版本。
PrivateEndpointServiceConnectionStatus	私人端點連線狀態。
PrivateLinkServiceConnectionState	服務取用者與提供者之間連線狀態的相關信息集合。
PublicNetworkAccess	此 API 管理服務是否允許公用端點存取。值為選擇性值，但如果傳入，則必須是『Enabled』或 'Disabled'。如果為『Disabled』，私人端點就是獨佔存取方法。預設值為 'Enabled'
RemotePrivateEndpointConnectionWrapper	遠端私人端點連線資源。
SkuType	Sku 的名稱。
systemData	與建立和上次修改資源相關的元數據。
UserIdentityProperties
VirtualNetworkConfiguration	設定部署 API 管理服務的虛擬網路。
VirtualNetworkType	必須在其中設定 API 管理服務的 VPN 類型。無（預設值）表示 API 管理服務不屬於任何虛擬網路，外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定，而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。

AdditionalLocation

Object

其他 API 管理資源位置的描述。

名稱	類型	預設值	Description
disableGateway	boolean	False	屬性僅適用於部署在多個位置的 Api 管理服務。這可用來停用此額外位置中的閘道。
gatewayRegionalUrl	string		區域中 API 管理服務的閘道 URL。
location	string		Azure 資料中心區域之間其他區域的位置名稱。
natGatewayState	NatGatewayState	Disabled	屬性可用來啟用此 API 管理服務的 NAT 閘道。
outboundPublicIPAddresses	string[]		與 NAT 閘道部署服務相關聯的輸出公用 IPV4 位址前綴。僅適用於 stv2 平臺上的進階 SKU。
platformVersion	PlatformVersion		執行服務的計算平臺版本。
privateIPAddresses	string[]		API 管理服務的私人靜態負載平衡 IP 位址，此位址部署在特定額外位置的內部虛擬網路中。僅適用於基本、標準、進階和隔離 SKU。
publicIPAddresses	string[]		其他位置中 API 管理服務的公用靜態負載平衡 IP 位址。僅適用於基本、標準、進階和隔離 SKU。
publicIpAddressId	string		要與位置中部署的虛擬網路服務相關聯的公用標準 SKU IP V4 型 IP 位址。僅支援虛擬網路中部署的進階 SKU。
sku	ApiManagementServiceSkuProperties		API 管理服務的 SKU 屬性。
virtualNetworkConfiguration	VirtualNetworkConfiguration		位置的虛擬網路組態。
zones	string[]		可用性區域清單，表示資源需要來自何處。

ApiManagementServiceIdentity

Object

Api 管理服務資源的識別屬性。

名稱	類型	Description
principalId	string (uuid)	身分識別的主體標識碼。
tenantId	string (uuid)	身分識別的用戶端租用戶標識碼。
type	ApimIdentityType	用於資源的身分識別類型。類型 'SystemAssigned， UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。類型『None』會從服務中移除任何身分識別。
userAssignedIdentities	<string, UserIdentityProperties>	與資源相關聯的使用者身分識別清單。使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。

ApiManagementServiceResource

Object

List 或 Get 回應中的單一 API 管理服務資源。

名稱	類型	預設值	Description
etag	string		資源的 ETag。
id	string		資源標識碼。
identity	ApiManagementServiceIdentity		Api 管理服務的受控服務識別。
location	string		資源位置。
name	string		資源名稱。
properties.additionalLocations	AdditionalLocation[]		API 管理服務的其他數據中心位置。
properties.apiVersionConstraint	ApiVersionConstraint		API 管理服務的控制平面 API 版本條件約束。
properties.certificates	CertificateConfiguration[]		需要在 API 管理服務中安裝的憑證清單。可安裝的憑證數目上限為 10。
properties.configurationApi	ConfigurationApi		設定 API 管理服務的 API 組態。
properties.createdAtUtc	string (date-time)		建立 API 管理服務的 UTC 日期。日期符合下列格式：`yyyy-MM-ddTHH:mm:ssZ` ISO 8601 標準所指定。
properties.customProperties	object		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。設定 `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
properties.developerPortalStatus	developerPortalStatus	Enabled	此 API 管理服務中的開發人員入口網站狀態。
properties.developerPortalUrl	string		API 管理服務的 DEveloper 入口網站端點 URL。
properties.disableGateway	boolean	False	屬性僅適用於部署在多個位置的 Api 管理服務。這可用來停用主要區域中的閘道。
properties.enableClientCertificate	boolean	False	屬性僅供取用 SKU 服務使用。這會強制在閘道的每個要求上顯示客戶端憑證。這也可讓您在閘道的原則中驗證憑證。
properties.gatewayRegionalUrl	string		默認區域中 API 管理服務的閘道 URL。
properties.gatewayUrl	string		API 管理服務的閘道 URL。
properties.hostnameConfigurations	HostnameConfiguration[]		API 管理服務的自定義主機名組態。
properties.legacyPortalStatus	LegacyPortalStatus	Enabled	API 管理服務中舊版入口網站的狀態。
properties.managementApiUrl	string		API 管理服務的管理 API 端點 URL。
properties.natGatewayState	NatGatewayState	Disabled	屬性可用來啟用此 API 管理服務的 NAT 閘道。
properties.notificationSenderEmail	string maxLength: 100		將傳送通知的電子郵件位址。
properties.outboundPublicIPAddresses	string[]		與 NAT 閘道部署服務相關聯的輸出公用 IPV4 位址前綴。僅適用於 stv2 平臺上的進階 SKU。
properties.platformVersion	PlatformVersion		在此位置中執行服務的計算平臺版本。
properties.portalUrl	string		API 管理服務的發行者入口網站端點 URL。
properties.privateEndpointConnections	RemotePrivateEndpointConnectionWrapper[]		此服務的私人端點連線清單。
properties.privateIPAddresses	string[]		在內部虛擬網路中部署的主要區域中 API 管理服務的私人靜態負載平衡 IP 位址。僅適用於基本、標準、進階和隔離 SKU。
properties.provisioningState	string		API 管理服務目前的布建狀態，可以是下列其中一項：Created/Activating/Succeeded/Updateing/Failed/Stopped/Terminating/TerminationFailed/Deleted。
properties.publicIPAddresses	string[]		主要區域中 API 管理服務的公用靜態負載平衡 IP 位址。僅適用於基本、標準、進階和隔離 SKU。
properties.publicIpAddressId	string		要與區域中部署的虛擬網路服務相關聯的公用標準 SKU IP V4 型 IP 位址。僅支援虛擬網路中部署的開發人員和進階 SKU。
properties.publicNetworkAccess	PublicNetworkAccess		此 API 管理服務是否允許公用端點存取。值為選擇性值，但如果傳入，則必須是『Enabled』或 'Disabled'。如果為『Disabled』，私人端點就是獨佔存取方法。預設值為 'Enabled'
properties.publisherEmail	string maxLength: 100		發行者電子郵件。
properties.publisherName	string maxLength: 100		發行者名稱。
properties.restore	boolean	False	如果先前已虛刪除，請取消刪除 Api 管理服務。如果指定此旗標，並將設定為 True，則會忽略所有其他屬性。
properties.scmUrl	string		API 管理服務的 SCM 端點 URL。
properties.targetProvisioningState	string		API 管理服務的布建狀態，由服務上啟動的長時間執行作業為目標。
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		API 管理服務的虛擬網路組態。
properties.virtualNetworkType	VirtualNetworkType	None	必須在其中設定 API 管理服務的 VPN 類型。無（預設值）表示 API 管理服務不屬於任何虛擬網路，外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定，而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。
sku	ApiManagementServiceSkuProperties		API 管理服務的 SKU 屬性。
systemData	systemData		與建立和上次修改資源相關的元數據。
tags	object		資源標籤。
type	string		API 管理資源的資源類型會設定為 Microsoft.ApiManagement。
zones	string[]		可用性區域清單，表示資源需要來自何處。

ApiManagementServiceSkuProperties

Object

API 管理服務資源 SKU 屬性。

名稱	類型	Description
capacity	integer (int32)	SKU 的容量（SKU 的部署單位數目）。針對 [取用 SKU 容量] 必須指定為 0。
name	SkuType	Sku 的名稱。

ApiManagementServiceUpdateParameters

Object

提供給更新 Api 管理服務的參數。

名稱	類型	預設值	Description
etag	string		資源的 ETag。
id	string		資源標識碼。
identity	ApiManagementServiceIdentity		Api 管理服務的受控服務識別。
name	string		資源名稱。
properties.additionalLocations	AdditionalLocation[]		API 管理服務的其他數據中心位置。
properties.apiVersionConstraint	ApiVersionConstraint		API 管理服務的控制平面 API 版本條件約束。
properties.certificates	CertificateConfiguration[]		需要在 API 管理服務中安裝的憑證清單。可安裝的憑證數目上限為 10。
properties.configurationApi	ConfigurationApi		設定 API 管理服務的 API 組態。
properties.createdAtUtc	string (date-time)		建立 API 管理服務的 UTC 日期。日期符合下列格式：`yyyy-MM-ddTHH:mm:ssZ` ISO 8601 標準所指定。
properties.customProperties	object		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。設定 `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
properties.developerPortalStatus	developerPortalStatus	Enabled	此 API 管理服務中的開發人員入口網站狀態。
properties.developerPortalUrl	string		API 管理服務的 DEveloper 入口網站端點 URL。
properties.disableGateway	boolean	False	屬性僅適用於部署在多個位置的 Api 管理服務。這可用來停用主要區域中的閘道。
properties.enableClientCertificate	boolean	False	屬性僅供取用 SKU 服務使用。這會強制在閘道的每個要求上顯示客戶端憑證。這也可讓您在閘道的原則中驗證憑證。
properties.gatewayRegionalUrl	string		默認區域中 API 管理服務的閘道 URL。
properties.gatewayUrl	string		API 管理服務的閘道 URL。
properties.hostnameConfigurations	HostnameConfiguration[]		API 管理服務的自定義主機名組態。
properties.legacyPortalStatus	LegacyPortalStatus	Enabled	API 管理服務中舊版入口網站的狀態。
properties.managementApiUrl	string		API 管理服務的管理 API 端點 URL。
properties.natGatewayState	NatGatewayState	Disabled	屬性可用來啟用此 API 管理服務的 NAT 閘道。
properties.notificationSenderEmail	string maxLength: 100		將傳送通知的電子郵件位址。
properties.outboundPublicIPAddresses	string[]		與 NAT 閘道部署服務相關聯的輸出公用 IPV4 位址前綴。僅適用於 stv2 平臺上的進階 SKU。
properties.platformVersion	PlatformVersion		在此位置中執行服務的計算平臺版本。
properties.portalUrl	string		API 管理服務的發行者入口網站端點 URL。
properties.privateEndpointConnections	RemotePrivateEndpointConnectionWrapper[]		此服務的私人端點連線清單。
properties.privateIPAddresses	string[]		在內部虛擬網路中部署的主要區域中 API 管理服務的私人靜態負載平衡 IP 位址。僅適用於基本、標準、進階和隔離 SKU。
properties.provisioningState	string		API 管理服務目前的布建狀態，可以是下列其中一項：Created/Activating/Succeeded/Updateing/Failed/Stopped/Terminating/TerminationFailed/Deleted。
properties.publicIPAddresses	string[]		主要區域中 API 管理服務的公用靜態負載平衡 IP 位址。僅適用於基本、標準、進階和隔離 SKU。
properties.publicIpAddressId	string		要與區域中部署的虛擬網路服務相關聯的公用標準 SKU IP V4 型 IP 位址。僅支援虛擬網路中部署的開發人員和進階 SKU。
properties.publicNetworkAccess	PublicNetworkAccess		此 API 管理服務是否允許公用端點存取。值為選擇性值，但如果傳入，則必須是『Enabled』或 'Disabled'。如果為『Disabled』，私人端點就是獨佔存取方法。預設值為 'Enabled'
properties.publisherEmail	string maxLength: 100		發行者電子郵件。
properties.publisherName	string maxLength: 100		發行者名稱。
properties.restore	boolean	False	如果先前已虛刪除，請取消刪除 Api 管理服務。如果指定此旗標，並將設定為 True，則會忽略所有其他屬性。
properties.scmUrl	string		API 管理服務的 SCM 端點 URL。
properties.targetProvisioningState	string		API 管理服務的布建狀態，由服務上啟動的長時間執行作業為目標。
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		API 管理服務的虛擬網路組態。
properties.virtualNetworkType	VirtualNetworkType	None	必須在其中設定 API 管理服務的 VPN 類型。無（預設值）表示 API 管理服務不屬於任何虛擬網路，外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定，而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。
sku	ApiManagementServiceSkuProperties		API 管理服務的 SKU 屬性。
tags	object		資源標籤。
type	string		API 管理資源的資源類型會設定為 Microsoft.ApiManagement。
zones	string[]		可用性區域清單，表示資源需要來自何處。

ApimIdentityType

列舉型別

用於資源的身分識別類型。類型 'SystemAssigned， UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。類型『None』會從服務中移除任何身分識別。

值	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

ApiVersionConstraint

Object

API 管理服務的控制平面 API 版本條件約束。

名稱	類型	Description
minApiVersion	string	限制對 API 管理服務的控制平面 API 呼叫，其版本等於或大於此值。

ArmIdWrapper

Object

ARM 資源標識碼的包裝函式

名稱	類型	Description
id	string

CertificateConfiguration

Object

包含非受信任中繼和跟證書的憑證組態。

名稱	類型	Description
certificate	CertificateInformation	憑證資訊。
certificatePassword	string	憑證密碼。
encodedCertificate	string	Base64 編碼憑證。
storeName	enum: CertificateAuthority Root	System.Security.Cryptography.x509certificates.StoreName 證書存儲位置。只有 Root 和 CertificateAuthority 是有效的位置。

CertificateInformation

Object

SSL 憑證資訊。

名稱	類型	Description
expiry	string (date-time)	憑證的到期日。日期符合下列格式：`yyyy-MM-ddTHH:mm:ssZ` ISO 8601 標準所指定。
subject	string	憑證的主體。
thumbprint	string	憑證的指紋。

CertificateSource

列舉型別

憑證來源。

值	Description
BuiltIn
Custom
KeyVault
Managed

CertificateStatus

列舉型別

憑證狀態。

值	Description
Completed
Failed
InProgress

ConfigurationApi

Object

API 管理服務之設定 API 的相關信息。

名稱	類型	預設值	Description
legacyApi	LegacyApiState	Enabled	指示是否應該在 API 管理服務上公開舊版組態 API （v1）。值為選擇性值，但必須是『Enabled』或『Disabled』。如果「已停用」，舊版設定 API （v1）將無法用於自我裝載閘道。預設值為 'Enabled'

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
Application
Key
ManagedIdentity
User

developerPortalStatus

列舉型別

此 API 管理服務中的開發人員入口網站狀態。

值	Description
Disabled	服務已停用開發人員入口網站。
Enabled	已針對服務啟用開發人員入口網站。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

HostnameConfiguration

Object

自定義主機名組態。

名稱	類型	預設值	Description
certificate	CertificateInformation		憑證資訊。
certificatePassword	string		憑證密碼。
certificateSource	CertificateSource		憑證來源。
certificateStatus	CertificateStatus		憑證狀態。
defaultSslBinding	boolean	False	指定 true，將與此主機名相關聯的憑證設定為預設 SSL 憑證。如果用戶端未傳送 SNI 標頭，則這會是將會受到挑戰的憑證。如果服務已啟用多個自定義主機名，且必須決定預設ssl憑證，則屬性會很有用。僅套用至閘道主機名稱類型的設定。
encodedCertificate	string		Base64 編碼憑證。
hostName	string		在 Api 管理服務上設定的主機名。
identityClientId	string		Azure AD 所產生的系統或使用者指派受控識別 clientId，其具有包含 SSL 憑證之 keyVault 的 GET 存取權。
keyVaultId	string		包含 Ssl 憑證之 KeyVault 秘密的 URL。如果提供包含版本的絕對 URL，SSL 憑證的自動更新將無法運作。這需要使用 aka.ms/apimmsi 來設定 Api 管理服務。秘密的類型應為 application/x-pkcs12
negotiateClientCertificate	boolean	False	指定 true 以一律交涉主機名上的客戶端憑證。默認值為 false。
type	HostnameType		主機名類型。

HostnameType

列舉型別

主機名類型。

值	Description
ConfigurationApi
DeveloperPortal
Management
Portal
Proxy
Scm

LegacyApiState

列舉型別

指示是否應該在 API 管理服務上公開舊版組態 API （v1）。值為選擇性值，但必須是『Enabled』或『Disabled』。如果「已停用」，舊版設定 API （v1）將無法用於自我裝載閘道。預設值為 'Enabled'

值	Description
Disabled	舊版設定 API （v1）已針對服務停用，且自我裝載網關無法連線。
Enabled	已針對服務啟用舊版設定 API（v1），且自我裝載閘道可以連線到它。

LegacyPortalStatus

列舉型別

API 管理服務中舊版入口網站的狀態。

值	Description
Disabled	服務已停用舊版入口網站。
Enabled	已針對服務啟用舊版入口網站。

NatGatewayState

列舉型別

屬性可用來啟用此 API 管理服務的 NAT 閘道。

值	Description
Disabled	服務已停用 Nat 閘道。
Enabled	已針對服務啟用 Nat 閘道。

PlatformVersion

列舉型別

執行服務的計算平臺版本。

值	Description
mtv1	在多租使用者 V1 平台上執行服務的平臺。
stv1	在單一租使用者 V1 平台上執行服務的平臺。
stv2	在單一租使用者 V2 平台上執行服務的平臺。
stv2.1	在較新的硬體上，在單一租使用者 V2 平台上執行服務的平臺。
undetermined	無法判斷平臺版本，因為未部署計算平臺。

PrivateEndpointServiceConnectionStatus

列舉型別

私人端點連線狀態。

值	Description
Approved
Pending
Rejected

PrivateLinkServiceConnectionState

Object

服務取用者與提供者之間連線狀態的相關信息集合。

名稱	類型	Description
actionsRequired	string	訊息，指出服務提供者上的變更是否需要取用者的任何更新。
description	string	核准/拒絕連線的原因。
status	PrivateEndpointServiceConnectionStatus	指出服務擁有者是否已核准/拒絕/移除連線。

PublicNetworkAccess

列舉型別

此 API 管理服務是否允許公用端點存取。值為選擇性值，但如果傳入，則必須是『Enabled』或 'Disabled'。如果為『Disabled』，私人端點就是獨佔存取方法。預設值為 'Enabled'

值	Description
Disabled
Enabled

RemotePrivateEndpointConnectionWrapper

Object

遠端私人端點連線資源。

名稱	類型	Description
id	string	私人端點聯機資源標識碼
name	string	私人端點連線名稱
properties.groupIds	string[]	所有群組標識碼。
properties.privateEndpoint	ArmIdWrapper	私人端點的資源。
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	服務取用者與提供者之間連線狀態的相關信息集合。
properties.provisioningState	string	私人端點聯機資源的布建狀態。
type	string	私人端點連線資源類型

SkuType

列舉型別

Sku 的名稱。

值	Description
Basic	Api 管理的基本 SKU。
BasicV2	Api 管理的基本V2 SKU。
Consumption	Api 管理的取用 SKU。
Developer	Api 管理的開發人員 SKU。
Isolated	Api 管理的隔離 SKU。
Premium	Api 管理的進階 SKU。
Standard	Api 管理的標準 SKU。
StandardV2	Api 管理的 StandardV2 SKU。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

UserIdentityProperties

Object

名稱	類型	Description
clientId	string	使用者指派身分識別的用戶端標識碼。
principalId	string	使用者指派身分識別的主體標識碼。

VirtualNetworkConfiguration

Object

設定部署 API 管理服務的虛擬網路。

名稱	類型	Description
subnetResourceId	string pattern: ^/subscriptions/[^/]/resourceGroups/[^/]/providers/Microsoft.(ClassicNetwork\|Network)/virtualNetworks/[^/]/subnets/[^/]$	虛擬網路中要部署 API 管理服務之子網的完整資源識別碼。
subnetname	string	子網的名稱。
vnetid	string	虛擬網路識別碼。這通常是 GUID。預設會預期 Null GUID。

VirtualNetworkType

列舉型別

必須在其中設定 API 管理服務的 VPN 類型。無（預設值）表示 API 管理服務不屬於任何虛擬網路，外部表示 API 管理部署是在具有因特網面向端點的虛擬網路內設定，而內部表示 API 管理部署只會在具有內部網路對向端點的虛擬網路內進行設定。

值	Description
External	此服務是虛擬網路的一部分，可從因特網存取。
Internal	此服務是虛擬網路的一部分，它只能從虛擬網路記憶體取。
None	此服務不屬於任何虛擬網路。

共用方式為

Api Management Service - Update

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

ApiManagementUpdateServiceDisableTls10

範例要求

範例回覆

ApiManagementUpdateServicePublisherDetails

範例要求

範例回覆

ApiManagementUpdateServiceToNewVnetAndAvailabilityZones

範例要求

範例回覆

定義

AdditionalLocation

ApiManagementServiceIdentity

ApiManagementServiceResource

ApiManagementServiceSkuProperties

ApiManagementServiceUpdateParameters

ApimIdentityType

ApiVersionConstraint

ArmIdWrapper

CertificateConfiguration

CertificateInformation

CertificateSource

CertificateStatus

ConfigurationApi

createdByType

developerPortalStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HostnameConfiguration

HostnameType

LegacyApiState

LegacyPortalStatus

NatGatewayState

PlatformVersion

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

PublicNetworkAccess

RemotePrivateEndpointConnectionWrapper

SkuType

systemData

UserIdentityProperties

VirtualNetworkConfiguration

VirtualNetworkType

其他資源