Api Management Service - Update
Uppdateringar en befintlig API Management-tjänst.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}?api-version=2022-08-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
service
|
path | True |
string |
Namnet på API Management-tjänsten. Reguljärt uttrycksmönster: |
subscription
|
path | True |
string |
ID för målprenumerationen. |
api-version
|
query | True |
string |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
Name | Typ | Description |
---|---|---|
identity |
Hanterad tjänstidentitet för Api Management-tjänsten. |
|
properties.additionalLocations |
Ytterligare datacenterplatser för API Management-tjänsten. |
|
properties.apiVersionConstraint |
Kontrollplans-API:ets versionsbegränsning för API Management-tjänsten. |
|
properties.certificates |
Lista över certifikat som måste installeras i API Management-tjänsten. Maximalt antal certifikat som stöds och som kan installeras är 10. |
|
properties.customProperties |
object |
Anpassade egenskaper för API Management-tjänsten. |
properties.disableGateway |
boolean |
Egenskapen är endast giltig för en Api Management-tjänst som distribuerats på flera platser. Detta kan användas för att inaktivera gatewayen i huvudregionen. |
properties.enableClientCertificate |
boolean |
Egenskapen är endast avsedd att användas för förbruknings-SKU-tjänsten. Detta framtvingar att ett klientcertifikat visas på varje begäran till gatewayen. Detta gör det också möjligt att autentisera certifikatet i principen på gatewayen. |
properties.hostnameConfigurations |
Anpassad värdnamnskonfiguration för API Management-tjänsten. |
|
properties.natGatewayState |
Egenskapen kan användas för att aktivera NAT Gateway för den här API Management-tjänsten. |
|
properties.notificationSenderEmail |
string |
Email adress som meddelandet ska skickas från. |
properties.privateEndpointConnections |
Lista över privata slutpunktsanslutningar för den här tjänsten. |
|
properties.publicIpAddressId |
string |
Public Standard SKU IP V4-baserad IP-adress som ska associeras med Virtual Network distribuerade tjänsten i regionen. Stöds endast för utvecklare och Premium SKU som distribueras i Virtual Network. |
properties.publicNetworkAccess |
Om offentlig slutpunktsåtkomst tillåts för den här API Management tjänsten eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat. Om "Inaktiverad" är privata slutpunkter den exklusiva åtkomstmetoden. Standardvärdet är "Aktiverat" |
|
properties.publisherEmail |
string |
E-postutfärdare. |
properties.publisherName |
string |
Utgivarens namn. |
properties.restore |
boolean |
Ta bort Api Management-tjänsten om den tidigare har tagits bort mjukt. Om den här flaggan har angetts och angetts till Sant ignoreras alla andra egenskaper. |
properties.virtualNetworkConfiguration |
Konfiguration av virtuellt nätverk för API Management-tjänsten. |
|
properties.virtualNetworkType |
Den typ av VPN som API Management-tjänsten måste konfigureras i. Ingen (standardvärde) innebär att API Management-tjänsten inte ingår i någon Virtual Network, extern innebär att API Management-distributionen har konfigurerats i en Virtual Network med en Internetuppkopplad slutpunkt och intern innebär att API Management distributionen konfigureras i en Virtual Network endast har en intranätuppkopplad slutpunkt. |
|
sku |
SKU-egenskaper för API Management-tjänsten. |
|
tags |
object |
Resurstaggar. |
zones |
string[] |
En lista över tillgänglighetszoner som anger var resursen måste komma ifrån. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Tjänsten har uppdaterats. |
|
202 Accepted |
Begäran om tjänstuppdatering accepterades. |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
Api |
Api |
Api |
ApiManagementUpdateServiceDisableTls10
Exempelbegäran
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
{
"properties": {
"customProperties": {
"Microsoft.WindowsAzure.ApiManagement.Gateway.Security.Protocols.Tls10": "false"
}
}
}
Exempelsvar
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
{
"id": "/subscriptions/subid/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
Exempelbegäran
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
{
"properties": {
"publisherEmail": "foobar@live.com",
"publisherName": "Contoso Vnext"
}
}
Exempelsvar
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
{
"id": "/subscriptions/subid/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
Exempelbegäran
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1?api-version=2022-08-01
{
"properties": {
"additionalLocations": [
{
"location": "Australia East",
"sku": {
"name": "Premium",
"capacity": 3
},
"zones": [
"1",
"2",
"3"
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apimaeavnet/subnets/default"
},
"publicIpAddressId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/apim-australia-east-publicip"
}
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/vnet-apim-japaneast/subnets/apim2"
},
"virtualNetworkType": "External",
"publicIpAddressId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/publicip-apim-japan-east"
},
"sku": {
"name": "Premium",
"capacity": 3
},
"zones": [
"1",
"2",
"3"
]
}
Exempelsvar
Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/ZWFzdHVzOmFuZHktdGVzdGluZy0yMDIyLTA0LTAxLXByZXZpZXctNF9BY3RfODQ2ZWE4Ng==?api-version=2022-08-01&asyncResponse
{
"id": "/subscriptions/subid/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/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/apimaeavnet/subnets/default"
},
"gatewayRegionalUrl": "https://apimService1-australiaeast-01.regional.azure-api.net",
"disableGateway": false,
"publicIpAddressId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/apim-australia-east-publicip",
"platformVersion": "stv2"
}
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/subid/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/subid/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"
}
}
Definitioner
Name | Description |
---|---|
Additional |
Beskrivning av ytterligare en API Management resursplats. |
Api |
Identitetsegenskaper för Api Management-tjänstresursen. |
Api |
En enda API Management tjänstresurs i Lista eller Hämta svar. |
Api |
API Management SKU-egenskaper för tjänstresurser. |
Api |
Parameter som anges i Uppdatera API Management-tjänsten. |
Apim |
Den typ av identitet som används för resursen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter från tjänsten. |
Api |
Kontrollplans-API:ets versionsbegränsning för API Management-tjänsten. |
Arm |
En adapter för ett ARM-resurs-ID |
Certificate |
Certifikatkonfiguration som består av icke-betrodda intermediärer och rotcertifikat. |
Certificate |
SSL-certifikatinformation. |
Certificate |
Certifikatkälla. |
Certificate |
Certifikatstatus. |
created |
Den typ av identitet som skapade resursen. |
Error |
Fel fältkontrakt. |
Error |
Felsvar. |
Hostname |
Konfiguration av anpassat värdnamn. |
Hostname |
Typ av värdnamn. |
Nat |
Egenskapen kan användas för att aktivera NAT Gateway för den här API Management-tjänsten. |
Platform |
Compute Platform Version som kör tjänsten. |
Private |
Anslutningsstatus för privat slutpunkt. |
Private |
En samling information om tillståndet för anslutningen mellan tjänstkonsumenten och leverantören. |
Public |
Om offentlig slutpunktsåtkomst tillåts för den här API Management tjänsten eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat. Om "Inaktiverad" är privata slutpunkter den exklusiva åtkomstmetoden. Standardvärdet är "Aktiverat" |
Remote |
Fjärrresurs för privat slutpunktsanslutning. |
Sku |
Namnet på SKU:n. |
system |
Metadata som rör skapande och senaste ändring av resursen. |
User |
|
Virtual |
Konfiguration av ett virtuellt nätverk som API Management tjänsten distribueras till. |
Virtual |
Den typ av VPN som API Management-tjänsten måste konfigureras i. Ingen (standardvärde) innebär att API Management-tjänsten inte ingår i någon Virtual Network, extern innebär att API Management-distributionen har konfigurerats i en Virtual Network med en Internetuppkopplad slutpunkt och intern innebär att API Management distributionen konfigureras i en Virtual Network endast har en intranätuppkopplad slutpunkt. |
AdditionalLocation
Beskrivning av ytterligare en API Management resursplats.
Name | Typ | Standardvärde | Description |
---|---|---|---|
disableGateway |
boolean |
False |
Egenskapen är endast giltig för en Api Management-tjänst som distribuerats på flera platser. Detta kan användas för att inaktivera gatewayen på den här ytterligare platsen. |
gatewayRegionalUrl |
string |
Gateway-URL för API Management-tjänsten i regionen. |
|
location |
string |
Platsnamnet för den ytterligare regionen mellan Azure Data Center-regioner. |
|
natGatewayState | Disabled |
Egenskapen kan användas för att aktivera NAT Gateway för den här API Management-tjänsten. |
|
outboundPublicIPAddresses |
string[] |
Utgående offentliga IPV4-adressprefix som är associerade med DEN NAT Gateway-distribuerade tjänsten. Endast tillgängligt för Premium SKU på stv2-plattformen. |
|
platformVersion |
Beräkningsplattformsversion som kör tjänsten. |
||
privateIPAddresses |
string[] |
Privata statiska lastbalanserade IP-adresser för API Management-tjänsten som distribueras i en intern Virtual Network på en viss ytterligare plats. Endast tillgängligt för Basic, Standard, Premium och Isolerad SKU. |
|
publicIPAddresses |
string[] |
Offentliga statiska belastningsutjämnings-IP-adresser för API Management-tjänsten på den ytterligare platsen. Endast tillgängligt för Basic, Standard, Premium och Isolerad SKU. |
|
publicIpAddressId |
string |
Public Standard SKU IP V4-baserad IP-adress som ska associeras med Virtual Network distribuerad tjänst på platsen. Stöds endast för Premium SKU som distribueras i Virtual Network. |
|
sku |
SKU-egenskaper för API Management-tjänsten. |
||
virtualNetworkConfiguration |
Konfiguration av virtuellt nätverk för platsen. |
||
zones |
string[] |
En lista över tillgänglighetszoner som anger var resursen behöver komma ifrån. |
ApiManagementServiceIdentity
Identitetsegenskaper för Api Management-tjänstresursen.
Name | Typ | Description |
---|---|---|
principalId |
string |
Identitetens huvud-ID. |
tenantId |
string |
Klientklient-ID:t för identiteten. |
type |
Den typ av identitet som används för resursen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort eventuella identiteter från tjänsten. |
|
userAssignedIdentities |
<string,
User |
Listan över användaridentiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formatet: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ApiManagementServiceResource
En enda API Management tjänstresurs i Lista eller Hämta svar.
Name | Typ | Standardvärde | Description |
---|---|---|---|
etag |
string |
ETag för resursen. |
|
id |
string |
Resurs-ID. |
|
identity |
Hanterad tjänstidentitet för API Management-tjänsten. |
||
location |
string |
Resursplats. |
|
name |
string |
Resursnamn. |
|
properties.additionalLocations |
Ytterligare datacenterplatser för API Management-tjänsten. |
||
properties.apiVersionConstraint |
Kontrollplans-API:ets versionsbegränsning för API Management-tjänsten. |
||
properties.certificates |
Lista över certifikat som måste installeras i API Management-tjänsten. Maximalt antal certifikat som stöds och som kan installeras är 10. |
||
properties.createdAtUtc |
string |
Skapa UTC-datum för API Management-tjänsten. Datumet överensstämmer med följande format: |
|
properties.customProperties |
object |
Anpassade egenskaper för API Management-tjänsten. |
|
properties.developerPortalUrl |
string |
DEveloper-portalens slutpunkts-URL för API Management-tjänsten. |
|
properties.disableGateway |
boolean |
False |
Egenskapen är endast giltig för en Api Management-tjänst som distribuerats på flera platser. Detta kan användas för att inaktivera gatewayen i huvudregionen. |
properties.enableClientCertificate |
boolean |
False |
Egenskapen är endast avsedd att användas för förbruknings-SKU-tjänsten. Detta framtvingar att ett klientcertifikat visas på varje begäran till gatewayen. Detta gör det också möjligt att autentisera certifikatet i principen på gatewayen. |
properties.gatewayRegionalUrl |
string |
Gateway-URL för API Management-tjänsten i standardregionen. |
|
properties.gatewayUrl |
string |
Gateway-URL för API Management-tjänsten. |
|
properties.hostnameConfigurations |
Konfiguration av anpassat värdnamn för API Management-tjänsten. |
||
properties.managementApiUrl |
string |
API-slutpunkts-URL för hantering av API Management-tjänsten. |
|
properties.natGatewayState | Disabled |
Egenskapen kan användas för att aktivera NAT Gateway för den här API Management-tjänsten. |
|
properties.notificationSenderEmail |
string |
Email adress som meddelandet ska skickas från. |
|
properties.outboundPublicIPAddresses |
string[] |
Utgående offentliga IPV4-adressprefix som är associerade med DEN NAT Gateway-distribuerade tjänsten. Endast tillgängligt för Premium SKU på stv2-plattformen. |
|
properties.platformVersion |
Compute Platform Version som kör tjänsten på den här platsen. |
||
properties.portalUrl |
string |
Slutpunkts-URL för utgivarportalen för API Management-tjänsten. |
|
properties.privateEndpointConnections |
Lista över privata slutpunktsanslutningar för den här tjänsten. |
||
properties.privateIPAddresses |
string[] |
Privata statiska lastbalanserade IP-adresser för API Management-tjänsten i den primära regionen som distribueras i en intern Virtual Network. Endast tillgängligt för Basic, Standard, Premium och Isolerad SKU. |
|
properties.provisioningState |
string |
Det aktuella etableringstillståndet för API Management-tjänsten som kan vara något av följande: Skapad/Aktivera/Lyckades/Uppdatera/Misslyckades/Stoppad/Avslutande/TerminationFailed/Borttagen. |
|
properties.publicIPAddresses |
string[] |
Offentliga statiska belastningsutjämnings-IP-adresser för API Management-tjänsten i den primära regionen. Endast tillgängligt för Basic, Standard, Premium och Isolerad SKU. |
|
properties.publicIpAddressId |
string |
Public Standard SKU IP V4-baserad IP-adress som ska associeras med Virtual Network distribuerade tjänsten i regionen. Stöds endast för utvecklare och Premium SKU som distribueras i Virtual Network. |
|
properties.publicNetworkAccess |
Om offentlig slutpunktsåtkomst tillåts för den här API Management tjänsten eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat. Om "Inaktiverad" är privata slutpunkter den exklusiva åtkomstmetoden. Standardvärdet är "Aktiverat" |
||
properties.publisherEmail |
string |
E-post för utgivare. |
|
properties.publisherName |
string |
Utgivarens namn. |
|
properties.restore |
boolean |
False |
Ta bort Api Management-tjänsten om den tidigare har tagits bort mjukt. Om den här flaggan har angetts och angetts till Sant ignoreras alla andra egenskaper. |
properties.scmUrl |
string |
SCM-slutpunkts-URL för API Management-tjänsten. |
|
properties.targetProvisioningState |
string |
Etableringstillståndet för API Management-tjänsten, som är mål för den långvariga åtgärden som startades på tjänsten. |
|
properties.virtualNetworkConfiguration |
Konfiguration av virtuellt nätverk för API Management-tjänsten. |
||
properties.virtualNetworkType | None |
Den typ av VPN som API Management-tjänsten måste konfigureras i. Ingen (standardvärde) innebär att API Management-tjänsten inte ingår i någon Virtual Network, extern innebär att API Management-distributionen har konfigurerats i en Virtual Network med en Internetuppkopplad slutpunkt och intern innebär att API Management distributionen konfigureras i en Virtual Network endast har en intranätuppkopplad slutpunkt. |
|
sku |
SKU-egenskaper för API Management-tjänsten. |
||
systemData |
Metadata som rör skapande och senaste ändring av resursen. |
||
tags |
object |
Resurstaggar. |
|
type |
string |
Resurstyp för API Management resurs anges till Microsoft.ApiManagement. |
|
zones |
string[] |
En lista över tillgänglighetszoner som anger var resursen behöver komma ifrån. |
ApiManagementServiceSkuProperties
API Management SKU-egenskaper för tjänstresurser.
Name | Typ | Description |
---|---|---|
capacity |
integer |
SKU:ns kapacitet (antalet distribuerade enheter i SKU:n). För förbrukning måste SKU-kapaciteten anges som 0. |
name |
Namnet på SKU:n. |
ApiManagementServiceUpdateParameters
Parameter som anges i Uppdatera API Management-tjänsten.
Name | Typ | Standardvärde | Description |
---|---|---|---|
etag |
string |
ETag för resursen. |
|
id |
string |
Resurs-ID. |
|
identity |
Hanterad tjänstidentitet för Api Management-tjänsten. |
||
name |
string |
Resursnamn. |
|
properties.additionalLocations |
Ytterligare datacenterplatser för API Management-tjänsten. |
||
properties.apiVersionConstraint |
Kontrollplans-API:ets versionsbegränsning för API Management-tjänsten. |
||
properties.certificates |
Lista över certifikat som måste installeras i API Management-tjänsten. Maximalt antal certifikat som stöds och som kan installeras är 10. |
||
properties.createdAtUtc |
string |
Skapa UTC-datum för API Management-tjänsten. Datumet överensstämmer med följande format: |
|
properties.customProperties |
object |
Anpassade egenskaper för API Management-tjänsten. |
|
properties.developerPortalUrl |
string |
DEveloper-portalens slutpunkts-URL för API Management-tjänsten. |
|
properties.disableGateway |
boolean |
False |
Egenskapen är endast giltig för en Api Management-tjänst som distribuerats på flera platser. Detta kan användas för att inaktivera gatewayen i huvudregionen. |
properties.enableClientCertificate |
boolean |
False |
Egenskapen är endast avsedd att användas för förbruknings-SKU-tjänsten. Detta framtvingar att ett klientcertifikat visas på varje begäran till gatewayen. Detta gör det också möjligt att autentisera certifikatet i principen på gatewayen. |
properties.gatewayRegionalUrl |
string |
Gateway-URL för API Management-tjänsten i standardregionen. |
|
properties.gatewayUrl |
string |
Gateway-URL för API Management-tjänsten. |
|
properties.hostnameConfigurations |
Anpassad värdnamnskonfiguration för API Management-tjänsten. |
||
properties.managementApiUrl |
string |
API-slutpunkts-URL för hantering av API Management-tjänsten. |
|
properties.natGatewayState | Disabled |
Egenskapen kan användas för att aktivera NAT Gateway för den här API Management-tjänsten. |
|
properties.notificationSenderEmail |
string |
Email adress som meddelandet ska skickas från. |
|
properties.outboundPublicIPAddresses |
string[] |
Utgående offentliga IPV4-adressprefix som är associerade med DEN NAT Gateway-distribuerade tjänsten. Endast tillgängligt för Premium SKU på stv2-plattformen. |
|
properties.platformVersion |
Compute Platform Version som kör tjänsten på den här platsen. |
||
properties.portalUrl |
string |
Slutpunkts-URL för utgivarportalen för API Management-tjänsten. |
|
properties.privateEndpointConnections |
Lista över privata slutpunktsanslutningar för den här tjänsten. |
||
properties.privateIPAddresses |
string[] |
Privata statiska belastningsutjämnings-IP-adresser för API Management-tjänsten i den primära regionen som distribueras i en intern Virtual Network. Endast tillgängligt för SKU:n Basic, Standard, Premium och Isolerad. |
|
properties.provisioningState |
string |
Det aktuella etableringstillståndet för API Management-tjänsten som kan vara något av följande: Skapad/Aktivera/Lyckades/Uppdatera/Misslyckades/Stoppad/Avslutande/AvslutningFel/Borttaget. |
|
properties.publicIPAddresses |
string[] |
Offentliga statiska belastningsutjämnings-IP-adresser för API Management-tjänsten i den primära regionen. Endast tillgängligt för SKU:n Basic, Standard, Premium och Isolerad. |
|
properties.publicIpAddressId |
string |
Public Standard SKU IP V4-baserad IP-adress som ska associeras med Virtual Network distribuerade tjänsten i regionen. Stöds endast för utvecklare och Premium SKU som distribueras i Virtual Network. |
|
properties.publicNetworkAccess |
Om offentlig slutpunktsåtkomst tillåts för den här API Management tjänsten eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat. Om "Inaktiverad" är privata slutpunkter den exklusiva åtkomstmetoden. Standardvärdet är "Aktiverat" |
||
properties.publisherEmail |
string |
E-postutfärdare. |
|
properties.publisherName |
string |
Utgivarens namn. |
|
properties.restore |
boolean |
False |
Ta bort Api Management-tjänsten om den tidigare har tagits bort mjukt. Om den här flaggan har angetts och angetts till Sant ignoreras alla andra egenskaper. |
properties.scmUrl |
string |
SCM-slutpunkts-URL för API Management-tjänsten. |
|
properties.targetProvisioningState |
string |
Etableringstillståndet för API Management-tjänsten, som är mål för den långvariga åtgärd som startades på tjänsten. |
|
properties.virtualNetworkConfiguration |
Konfiguration av virtuellt nätverk för API Management-tjänsten. |
||
properties.virtualNetworkType | None |
Den typ av VPN som API Management-tjänsten måste konfigureras i. Ingen (standardvärde) innebär att API Management-tjänsten inte ingår i någon Virtual Network, extern innebär att API Management-distributionen har konfigurerats i en Virtual Network med en Internetuppkopplad slutpunkt och intern innebär att API Management distributionen konfigureras i en Virtual Network endast har en intranätuppkopplad slutpunkt. |
|
sku |
SKU-egenskaper för API Management-tjänsten. |
||
tags |
object |
Resurstaggar. |
|
type |
string |
Resurstypen för API Management resurs är inställd på Microsoft.ApiManagement. |
|
zones |
string[] |
En lista över tillgänglighetszoner som anger var resursen måste komma ifrån. |
ApimIdentityType
Den typ av identitet som används för resursen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter från tjänsten.
Name | Typ | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
ApiVersionConstraint
Kontrollplans-API:ets versionsbegränsning för API Management-tjänsten.
Name | Typ | Description |
---|---|---|
minApiVersion |
string |
Begränsa API-anrop för kontrollplan till API Management tjänst med en version som är lika med eller nyare än det här värdet. |
ArmIdWrapper
En adapter för ett ARM-resurs-ID
Name | Typ | Description |
---|---|---|
id |
string |
CertificateConfiguration
Certifikatkonfiguration som består av icke-betrodda intermediärer och rotcertifikat.
Name | Typ | Description |
---|---|---|
certificate |
Certifikatinformation. |
|
certificatePassword |
string |
Certifikatlösenord. |
encodedCertificate |
string |
Base64-kodat certifikat. |
storeName |
enum:
|
Certifikatarkivet System.Security.Cryptography.x509certificates.StoreName. Endast Rot- och CertificateAuthority är giltiga platser. |
CertificateInformation
SSL-certifikatinformation.
Name | Typ | Description |
---|---|---|
expiry |
string |
Certifikatets förfallodatum. Datumet överensstämmer med följande format: |
subject |
string |
Certifikatets ämne. |
thumbprint |
string |
Tumavtryck för certifikatet. |
CertificateSource
Certifikatkälla.
Name | Typ | Description |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
KeyVault |
string |
|
Managed |
string |
CertificateStatus
Certifikatstatus.
Name | Typ | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
InProgress |
string |
createdByType
Den typ av identitet som skapade resursen.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorFieldContract
Fel fältkontrakt.
Name | Typ | Description |
---|---|---|
code |
string |
Felkod på egenskapsnivå. |
message |
string |
Mänsklig läsbar representation av fel på egenskapsnivå. |
target |
string |
Egenskapsnamn. |
ErrorResponse
Felsvar.
Name | Typ | Description |
---|---|---|
error.code |
string |
Tjänstdefinierad felkod. Den här koden fungerar som en understatus för HTTP-felkoden som anges i svaret. |
error.details |
Listan över ogiltiga fält som skickas i begäran, vid valideringsfel. |
|
error.message |
string |
Mänsklig läsbar representation av felet. |
HostnameConfiguration
Konfiguration av anpassat värdnamn.
Name | Typ | Standardvärde | Description |
---|---|---|---|
certificate |
Certifikatinformation. |
||
certificatePassword |
string |
Certifikatlösenord. |
|
certificateSource |
Certifikatkälla. |
||
certificateStatus |
Certifikatstatus. |
||
defaultSslBinding |
boolean |
False |
Ange true för att konfigurera certifikatet som är associerat med det här värdnamnet som standard-SSL-certifikat. Om en klient inte skickar SNI-huvudet är detta certifikatet som kommer att utmanas. Egenskapen är användbar om en tjänst har flera anpassade värdnamn aktiverade och måste bestämma standard-SSL-certifikatet. Inställningen tillämpas endast på gatewayens värdnamnstyp. |
encodedCertificate |
string |
Base64-kodat certifikat. |
|
hostName |
string |
Värdnamn som ska konfigureras på Api Management-tjänsten. |
|
identityClientId |
string |
ClientId för system- eller användartilldelad hanterad identitet som genereras av Azure AD, som har GET-åtkomst till keyVault som innehåller SSL-certifikatet. |
|
keyVaultId |
string |
Url till KeyVault-hemligheten som innehåller Ssl-certifikatet. Om absolut URL som innehåller version tillhandahålls fungerar inte automatisk uppdatering av SSL-certifikatet. Detta kräver att Api Management-tjänsten konfigureras med aka.ms/apimmsi. Hemligheten ska vara av typen application/x-pkcs12 |
|
negotiateClientCertificate |
boolean |
False |
Ange true för att alltid förhandla om klientcertifikatet på värdnamnet. Standardvärdet är falskt. |
type |
Typ av värdnamn. |
HostnameType
Typ av värdnamn.
Name | Typ | Description |
---|---|---|
DeveloperPortal |
string |
|
Management |
string |
|
Portal |
string |
|
Proxy |
string |
|
Scm |
string |
NatGatewayState
Egenskapen kan användas för att aktivera NAT Gateway för den här API Management-tjänsten.
Name | Typ | Description |
---|---|---|
Disabled |
string |
Nat Gateway är inaktiverat för tjänsten. |
Enabled |
string |
Nat Gateway är aktiverat för tjänsten. |
PlatformVersion
Compute Platform Version som kör tjänsten.
Name | Typ | Description |
---|---|---|
mtv1 |
string |
Plattform som kör tjänsten på V1-plattformen för flera innehavare. |
stv1 |
string |
Plattform som kör tjänsten på V1-plattformen för enskild klientorganisation. |
stv2 |
string |
Plattform som kör tjänsten på V2-plattformen för enskild klientorganisation. |
undetermined |
string |
Det går inte att fastställa plattformsversionen eftersom beräkningsplattformen inte distribueras. |
PrivateEndpointServiceConnectionStatus
Anslutningsstatus för privat slutpunkt.
Name | Typ | Description |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
En samling information om tillståndet för anslutningen mellan tjänstkonsumenten och leverantören.
Name | Typ | Description |
---|---|---|
actionsRequired |
string |
Ett meddelande som anger om ändringar i tjänstleverantören kräver uppdateringar på konsumenten. |
description |
string |
Anledningen till att anslutningen godkänns/avvisas. |
status |
Anger om anslutningen har godkänts/avvisats/tagits bort av tjänstens ägare. |
PublicNetworkAccess
Om offentlig slutpunktsåtkomst tillåts för den här API Management tjänsten eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat. Om "Inaktiverad" är privata slutpunkter den exklusiva åtkomstmetoden. Standardvärdet är "Aktiverat"
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
RemotePrivateEndpointConnectionWrapper
Fjärrresurs för privat slutpunktsanslutning.
Name | Typ | Description |
---|---|---|
id |
string |
Resurs-ID för privat slutpunktsanslutning |
name |
string |
Anslutningsnamn för privat slutpunkt |
properties.groupIds |
string[] |
Alla grupp-ID:t. |
properties.privateEndpoint |
Resursen för den privata slutpunkten. |
|
properties.privateLinkServiceConnectionState |
En samling med information om tillståndet för anslutningen mellan tjänstekonsumenten och leverantören. |
|
properties.provisioningState |
string |
Etableringstillståndet för den privata slutpunktsanslutningsresursen. |
type |
string |
Resurstyp för privat slutpunktsanslutning |
SkuType
Namnet på SKU:n.
Name | Typ | Description |
---|---|---|
Basic |
string |
Grundläggande SKU för Api Management. |
Consumption |
string |
Förbruknings-SKU för Api Management. |
Developer |
string |
Utvecklar-SKU för Api Management. |
Isolated |
string |
Isolerad SKU för Api Management. |
Premium |
string |
Premium-SKU för Api Management. |
Standard |
string |
Standard-SKU för Api Management. |
systemData
Metadata som rör skapande och senaste ändring av resursen.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Tidsstämpeln för resursskapande (UTC). |
createdBy |
string |
Identiteten som skapade resursen. |
createdByType |
Den typ av identitet som skapade resursen. |
|
lastModifiedAt |
string |
Tidsstämpeln för resursens senaste ändring (UTC) |
lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |
UserIdentityProperties
Name | Typ | Description |
---|---|---|
clientId |
string |
Klient-ID för användartilldelad identitet. |
principalId |
string |
Huvud-ID för användartilldelad identitet. |
VirtualNetworkConfiguration
Konfiguration av ett virtuellt nätverk som API Management tjänsten distribueras till.
Name | Typ | Description |
---|---|---|
subnetResourceId |
string |
Det fullständiga resurs-ID:t för ett undernät i ett virtuellt nätverk för att distribuera API Management-tjänsten i. |
subnetname |
string |
Namnet på undernätet. |
vnetid |
string |
Det virtuella nätverks-ID:t. Detta är vanligtvis ett GUID. Förvänta dig ett null-GUID som standard. |
VirtualNetworkType
Den typ av VPN som API Management-tjänsten måste konfigureras i. Ingen (standardvärde) innebär att API Management-tjänsten inte ingår i någon Virtual Network, extern innebär att API Management-distributionen har konfigurerats i en Virtual Network med en Internetuppkopplad slutpunkt och intern innebär att API Management distributionen konfigureras i en Virtual Network endast har en intranätuppkopplad slutpunkt.
Name | Typ | Description |
---|---|---|
External |
string |
Tjänsten är en del av Virtual Network och är tillgänglig från Internet. |
Internal |
string |
Tjänsten är en del av Virtual Network och är endast tillgänglig inifrån det virtuella nätverket. |
None |
string |
Tjänsten ingår inte i någon Virtual Network. |