Api Management Service - List

服務:

API Management

API 版本:

2024-05-01

列出 Azure 訂用帳戶內的所有 API 管理服務。

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

URI 參數

名稱	位於	必要	類型	Description
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。 此值必須是 UUID。
api-version	query	True	string minLength: 1	要用於這項作業的 API 版本。

回應

名稱	類型	Description
200 OK	ApiManagementServiceListResult	API 管理服務清單。
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	模擬您的用戶帳戶

範例

ApiManagementListServiceBySubscription

範例要求

HTTP

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

範例回覆

狀態碼:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/OGF-Z3-06162021-Premium",
      "name": "OGF-Z3-06162021-Premium",
      "type": "Microsoft.ApiManagement/service",
      "tags": {
        "owner": "v-aswmoh",
        "ReleaseName": "Z3"
      },
      "location": "East US",
      "etag": "AAAAAAAWN/4=",
      "properties": {
        "publisherEmail": "bar@contoso.com",
        "publisherName": "Test Premium",
        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
        "provisioningState": "Succeeded",
        "targetProvisioningState": "",
        "createdAtUtc": "2021-06-16T09:40:00.9453556Z",
        "gatewayUrl": "https://ogf-z3-06162021-premium.azure-api.net",
        "gatewayRegionalUrl": "https://ogf-z3-06162021-premium-eastus-01.regional.azure-api.net",
        "portalUrl": "https://ogf-z3-06162021-premium.portal.azure-api.net",
        "developerPortalUrl": "https://ogf-z3-06162021-premium.developer.azure-api.net",
        "managementApiUrl": "https://ogf-z3-06162021-premium.management.azure-api.net",
        "scmUrl": "https://ogf-z3-06162021-premium.scm.azure-api.net",
        "hostnameConfigurations": [
          {
            "type": "Proxy",
            "hostName": "ogf-z3-06162021-premium.azure-api.net",
            "negotiateClientCertificate": false,
            "defaultSslBinding": false,
            "certificateSource": "BuiltIn"
          },
          {
            "type": "Proxy",
            "hostName": "gateway.current.int-azure-api.net",
            "keyVaultId": "https://ogf-testing.vault-int.azure-int.net/secrets/current-ssl",
            "negotiateClientCertificate": true,
            "certificate": {
              "expiry": "2022-01-08T22:32:32+00:00",
              "thumbprint": "BA0C286F71AF3B6A01BDB240C58A4A507E3DBD51",
              "subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
            },
            "defaultSslBinding": true,
            "certificateSource": "Custom"
          },
          {
            "type": "DeveloperPortal",
            "hostName": "developer.current.int-azure-api.net",
            "keyVaultId": "https://ogf-testing.vault-int.azure-int.net/secrets/current-ssl",
            "negotiateClientCertificate": false,
            "certificate": {
              "expiry": "2022-01-08T22:32:32+00:00",
              "thumbprint": "BA0C286F71AF3B6A01BDB240C58A4A507E3DBD51",
              "subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
            },
            "defaultSslBinding": false,
            "certificateSource": "Custom"
          },
          {
            "type": "Management",
            "hostName": "mgmt.current.int-azure-api.net",
            "keyVaultId": "https://ogf-testing.vault-int.azure-int.net/secrets/current-ssl",
            "negotiateClientCertificate": false,
            "certificate": {
              "expiry": "2022-01-08T22:32:32+00:00",
              "thumbprint": "BA0C286F71AF3B6A01BDB240C58A4A507E3DBD51",
              "subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
            },
            "defaultSslBinding": false,
            "certificateSource": "Custom"
          },
          {
            "type": "ConfigurationApi",
            "hostName": "configuration-api.current.int-azure-api.net",
            "keyVaultId": "https://ogf-testing.vault-int.azure-int.net/secrets/current-ssl",
            "negotiateClientCertificate": false,
            "certificate": {
              "expiry": "2022-01-08T22:32:32+00:00",
              "thumbprint": "BA0C286F71AF3B6A01BDB240C58A4A507E3DBD51",
              "subject": "CN=*.current.int-azure-api.net, O=Microsoft Corporation, L=Redmond, S=WA, C=US"
            },
            "defaultSslBinding": false,
            "certificateSource": "Custom"
          }
        ],
        "publicIPAddresses": [
          "13.92.130.49"
        ],
        "additionalLocations": [
          {
            "location": "East US 2",
            "sku": {
              "name": "Premium",
              "capacity": 1
            },
            "zones": [],
            "publicIPAddresses": [
              "40.70.24.106"
            ],
            "gatewayRegionalUrl": "https://ogf-z3-06162021-premium-eastus2-01.regional.azure-api.net",
            "disableGateway": false
          }
        ],
        "customProperties": {
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "false"
        },
        "virtualNetworkType": "None",
        "certificates": [],
        "disableGateway": false,
        "apiVersionConstraint": {
          "minApiVersion": "2019-12-01"
        },
        "configurationApi": {
          "legacyApi": "Enabled"
        },
        "publicNetworkAccess": "Enabled"
      },
      "sku": {
        "name": "Premium",
        "capacity": 1
      },
      "identity": {
        "type": "SystemAssigned, UserAssigned",
        "principalId": "306205e7-b21a-41bf-92e2-3e28af30041e",
        "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
        "userAssignedIdentities": {
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ogf-identity": {
            "principalId": "713784d2-ee37-412a-95f0-3768f397f82d",
            "clientId": "8d9791f2-0cdf-41f4-9e66-cdc39b496789"
          }
        }
      },
      "systemData": {
        "createdBy": "bar@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-06-16T09:40:00.7106733Z",
        "lastModifiedBy": "foo@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-20T06:33:09.6159006Z"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/vvktestcons",
      "name": "vvktestcons",
      "type": "Microsoft.ApiManagement/service",
      "tags": {
        "Owner": "vitaliik"
      },
      "location": "East US",
      "etag": "AAAAAAAWKwo=",
      "properties": {
        "publisherEmail": "bar@contoso.com",
        "publisherName": "vvktestcons",
        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
        "provisioningState": "Succeeded",
        "targetProvisioningState": "",
        "createdAtUtc": "2020-08-10T18:07:23.4565211Z",
        "gatewayUrl": "https://vvktestcons.azure-api.net",
        "hostnameConfigurations": [
          {
            "type": "Proxy",
            "hostName": "vvktestcons.azure-api.net",
            "negotiateClientCertificate": false,
            "defaultSslBinding": true,
            "certificateSource": "BuiltIn"
          }
        ],
        "customProperties": {
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "False",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "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": "None",
        "enableClientCertificate": false,
        "disableGateway": false,
        "publicNetworkAccess": "Enabled"
      },
      "sku": {
        "name": "Consumption",
        "capacity": 0
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/OGF-Z3-06162021-Standard",
      "name": "OGF-Z3-06162021-Standard",
      "type": "Microsoft.ApiManagement/service",
      "tags": {},
      "location": "East US",
      "etag": "AAAAAAAWF7M=",
      "properties": {
        "publisherEmail": "bar@contoso.com",
        "publisherName": "Test Standard",
        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
        "provisioningState": "Succeeded",
        "targetProvisioningState": "",
        "createdAtUtc": "2021-06-16T09:39:58.6555759Z",
        "gatewayUrl": "https://ogf-z3-06162021-standard.azure-api.net",
        "gatewayRegionalUrl": "https://ogf-z3-06162021-standard-eastus-01.regional.azure-api.net",
        "portalUrl": "https://ogf-z3-06162021-standard.portal.azure-api.net",
        "developerPortalUrl": "https://ogf-z3-06162021-standard.developer.azure-api.net",
        "managementApiUrl": "https://ogf-z3-06162021-standard.management.azure-api.net",
        "scmUrl": "https://ogf-z3-06162021-standard.scm.azure-api.net",
        "hostnameConfigurations": [
          {
            "type": "Proxy",
            "hostName": "ogf-z3-06162021-standard.azure-api.net",
            "negotiateClientCertificate": false,
            "defaultSslBinding": true,
            "certificateSource": "BuiltIn"
          }
        ],
        "publicIPAddresses": [
          "13.82.208.32"
        ],
        "customProperties": {
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA": "true",
          "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.Ciphers.TripleDes168": "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"
        },
        "virtualNetworkType": "None",
        "disableGateway": false,
        "apiVersionConstraint": {
          "minApiVersion": "2019-12-01"
        },
        "configurationApi": {
          "legacyApi": "Enabled"
        },
        "publicNetworkAccess": "Enabled"
      },
      "sku": {
        "name": "Standard",
        "capacity": 2
      },
      "identity": {
        "type": "SystemAssigned, UserAssigned",
        "principalId": "347a5800-ca99-475a-9202-fe38ca79ee41",
        "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
        "userAssignedIdentities": {
          "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ogf-identity": {
            "principalId": "713784d2-ee37-412a-95f0-3768f397f82d",
            "clientId": "8d9791f2-0cdf-41f4-9e66-cdc39b496789"
          }
        }
      },
      "systemData": {
        "createdBy": "bar@contoso.com",
        "createdByType": "User",
        "createdAt": "2021-06-16T09:39:58.4591834Z",
        "lastModifiedBy": "bar@contoso.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-17T15:05:13.5494721Z"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/ogf-dev-060921",
      "name": "ogf-dev-060921",
      "type": "Microsoft.ApiManagement/service",
      "tags": {},
      "location": "East US",
      "etag": "AAAAAAAWEFg=",
      "properties": {
        "publisherEmail": "v-ssaiprasan@microsoft.com",
        "publisherName": "TechM",
        "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
        "provisioningState": "Succeeded",
        "targetProvisioningState": "",
        "createdAtUtc": "2021-06-09T10:06:22.2133978Z",
        "gatewayUrl": "https://ogf-dev-060921.azure-api.net",
        "gatewayRegionalUrl": "https://ogf-dev-060921-eastus-01.regional.azure-api.net",
        "portalUrl": "https://ogf-dev-060921.portal.azure-api.net",
        "developerPortalUrl": "https://ogf-dev-060921.developer.azure-api.net",
        "managementApiUrl": "https://ogf-dev-060921.management.azure-api.net",
        "scmUrl": "https://ogf-dev-060921.scm.azure-api.net",
        "hostnameConfigurations": [
          {
            "type": "Proxy",
            "hostName": "ogf-dev-060921.azure-api.net",
            "negotiateClientCertificate": false,
            "defaultSslBinding": true,
            "certificateSource": "BuiltIn"
          }
        ],
        "publicIPAddresses": [
          "168.62.39.172"
        ],
        "additionalLocations": [
          {
            "location": "South Central US",
            "sku": {
              "name": "Premium",
              "capacity": 9
            },
            "zones": [],
            "publicIPAddresses": [
              "13.84.208.29"
            ],
            "gatewayRegionalUrl": "https://ogf-dev-060921-southcentralus-01.regional.azure-api.net",
            "disableGateway": false
          }
        ],
        "customProperties": {
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Ciphers.TripleDes168": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls11": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Ssl30": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls11": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Tls10": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Backend.Protocols.Ssl30": "false",
          "Microsoft.WindowsAzure.ApiManagement.Gateway.Protocols.Server.Http2": "false"
        },
        "virtualNetworkType": "None",
        "certificates": [
          {
            "storeName": "Root",
            "certificate": {
              "expiry": "2021-11-25T22:51:47+00:00",
              "thumbprint": "4E8234312EC69245D1AE296C4882D46FB84076A3",
              "subject": "CN=*.apim.net"
            }
          }
        ],
        "disableGateway": false,
        "apiVersionConstraint": {
          "minApiVersion": "2019-12-01"
        },
        "configurationApi": {
          "legacyApi": "Enabled"
        },
        "publicNetworkAccess": "Enabled"
      },
      "sku": {
        "name": "Premium",
        "capacity": 3
      },
      "identity": {
        "type": "SystemAssigned",
        "principalId": "c9bd4c05-205e-4431-b232-112cf2e9e0aa",
        "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd"
      },
      "systemData": {
        "createdBy": "v-ssaiprasan@microsoft.com",
        "createdByType": "User",
        "createdAt": "2021-06-09T10:06:21.7336597Z",
        "lastModifiedBy": "v-ssaiprasan@microsoft.com",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-06-10T14:27:05.546816Z"
      }
    }
  ]
}

定義

名稱	Description
AdditionalLocation	其他 API 管理資源位置的描述。
ApiManagementServiceIdentity	Api 管理服務資源的識別屬性。
ApiManagementServiceListResult	清單 API 管理服務作業的回應。
ApiManagementServiceResource	List 或 Get 回應中的單一 API 管理服務資源。
ApiManagementServiceSkuProperties	API 管理服務資源 SKU 屬性。
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}'。

ApiManagementServiceListResult

Object

清單 API 管理服務作業的回應。

名稱	類型	Description
nextLink	string	連結到下一組結果。 如果 Value 包含 API 管理服務的不完整清單，則為空白。
value	ApiManagementServiceResource[]	列出 API 管理服務作業的結果。

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 的名稱。

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	此服務不屬於任何虛擬網路。