你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Api Management Service - Apply Network Configuration Updates
Updates the Microsoft.ApiManagement resource running in the Virtual network to pick the updated DNS changes.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/applynetworkconfigurationupdates?api-version=2024-05-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
The name of the resource group. The name is case insensitive. |
service
|
path | True |
string |
The name of the API Management service. Regex pattern: |
subscription
|
path | True |
string uuid |
The ID of the target subscription. The value must be an UUID. |
api-version
|
query | True |
string |
The API version to use for this operation. |
Request Body
Name | Type | Description |
---|---|---|
location |
string |
Location of the Api Management service to update for a multi-region service. For a service deployed in a single region, this parameter is not required. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Network configuration updates were successfully applied on the Api Management service. |
|
202 Accepted |
Accepted: Location header contains the URL where the status of the long running operation can be checked. Headers location: string |
|
Other Status Codes |
Error response describing why the operation failed. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
ApiManagementApplyNetworkConfigurationUpdates
Sample request
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/applynetworkconfigurationupdates?api-version=2024-05-01
{
"location": "west us"
}
Sample response
location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2024-05-01
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
"name": "apimService1",
"type": "Microsoft.ApiManagement/service",
"tags": {
"UID": "52ed5986-717b-45b4-b17c-3df8db372cff"
},
"location": "East Asia",
"etag": "AAAAAAAXX6Y=",
"properties": {
"publisherEmail": "admin@live.com",
"publisherName": "Contoso",
"provisioningState": "Succeeded",
"targetProvisioningState": "",
"createdAtUtc": "2015-09-22T01:50:34.7921566Z",
"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": [
"207.46.155.24"
],
"virtualNetworkConfiguration": {
"subnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/eastUsVirtualNetwork/subnets/apimSubnet"
},
"virtualNetworkType": "External"
},
"sku": {
"name": "Premium",
"capacity": 1
}
}
Definitions
Name | Description |
---|---|
Additional |
Description of an additional API Management resource location. |
Api |
Parameter supplied to the Apply Network configuration operation. |
Api |
Identity properties of the Api Management service resource. |
Api |
A single API Management service resource in List or Get response. |
Api |
API Management service resource SKU properties. |
Apim |
The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the service. |
Api |
Control Plane Apis version constraint for the API Management service. |
Arm |
A wrapper for an ARM resource id |
Certificate |
Certificate configuration which consist of non-trusted intermediates and root certificates. |
Certificate |
SSL certificate information. |
Certificate |
Certificate Source. |
Certificate |
Certificate Status. |
Configuration |
Information regarding the Configuration API of the API Management service. |
created |
The type of identity that created the resource. |
developer |
Status of developer portal in this API Management service. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Hostname |
Custom hostname configuration. |
Hostname |
Hostname type. |
Legacy |
Indication whether or not the legacy Configuration API (v1) should be exposed on the API Management service. Value is optional but must be 'Enabled' or 'Disabled'. If 'Disabled', legacy Configuration API (v1) will not be available for self-hosted gateways. Default value is 'Enabled' |
Legacy |
Status of legacy portal in the API Management service. |
Nat |
Property can be used to enable NAT Gateway for this API Management service. |
Platform |
Compute Platform Version running the service. |
Private |
The private endpoint connection status. |
Private |
A collection of information about the state of the connection between service consumer and provider. |
Public |
Whether or not public endpoint access is allowed for this API Management service. Value is optional but if passed in, must be 'Enabled' or 'Disabled'. If 'Disabled', private endpoints are the exclusive access method. Default value is 'Enabled' |
Remote |
Remote Private Endpoint Connection resource. |
Sku |
Name of the Sku. |
system |
Metadata pertaining to creation and last modification of the resource. |
User |
|
Virtual |
Configuration of a virtual network to which API Management service is deployed. |
Virtual |
The type of VPN in which API Management service needs to be configured in. None (Default Value) means the API Management service is not part of any Virtual Network, External means the API Management deployment is set up inside a Virtual Network having an Internet Facing Endpoint, and Internal means that API Management deployment is setup inside a Virtual Network having an Intranet Facing Endpoint only. |
AdditionalLocation
Description of an additional API Management resource location.
Name | Type | Default value | Description |
---|---|---|---|
disableGateway |
boolean |
False |
Property only valid for an Api Management service deployed in multiple locations. This can be used to disable the gateway in this additional location. |
gatewayRegionalUrl |
string |
Gateway URL of the API Management service in the Region. |
|
location |
string |
The location name of the additional region among Azure Data center regions. |
|
natGatewayState | Disabled |
Property can be used to enable NAT Gateway for this API Management service. |
|
outboundPublicIPAddresses |
string[] |
Outbound public IPV4 address prefixes associated with NAT Gateway deployed service. Available only for Premium SKU on stv2 platform. |
|
platformVersion |
Compute Platform Version running the service. |
||
privateIPAddresses |
string[] |
Private Static Load Balanced IP addresses of the API Management service which is deployed in an Internal Virtual Network in a particular additional location. Available only for Basic, Standard, Premium and Isolated SKU. |
|
publicIPAddresses |
string[] |
Public Static Load Balanced IP addresses of the API Management service in the additional location. Available only for Basic, Standard, Premium and Isolated SKU. |
|
publicIpAddressId |
string |
Public Standard SKU IP V4 based IP address to be associated with Virtual Network deployed service in the location. Supported only for Premium SKU being deployed in Virtual Network. |
|
sku |
SKU properties of the API Management service. |
||
virtualNetworkConfiguration |
Virtual network configuration for the location. |
||
zones |
string[] |
A list of availability zones denoting where the resource needs to come from. |
ApiManagementServiceApplyNetworkConfigurationParameters
Parameter supplied to the Apply Network configuration operation.
Name | Type | Description |
---|---|---|
location |
string |
Location of the Api Management service to update for a multi-region service. For a service deployed in a single region, this parameter is not required. |
ApiManagementServiceIdentity
Identity properties of the Api Management service resource.
Name | Type | Description |
---|---|---|
principalId |
string |
The principal id of the identity. |
tenantId |
string |
The client tenant id of the identity. |
type |
The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the service. |
|
userAssignedIdentities |
<string,
User |
The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ApiManagementServiceResource
A single API Management service resource in List or Get response.
Name | Type | Default value | Description |
---|---|---|---|
etag |
string |
ETag of the resource. |
|
id |
string |
Resource ID. |
|
identity |
Managed service identity of the Api Management service. |
||
location |
string |
Resource location. |
|
name |
string |
Resource name. |
|
properties.additionalLocations |
Additional datacenter locations of the API Management service. |
||
properties.apiVersionConstraint |
Control Plane Apis version constraint for the API Management service. |
||
properties.certificates |
List of Certificates that need to be installed in the API Management service. Max supported certificates that can be installed is 10. |
||
properties.configurationApi |
Configuration API configuration of the API Management service. |
||
properties.createdAtUtc |
string |
Creation UTC date of the API Management service.The date conforms to the following format: |
|
properties.customProperties |
object |
Custom properties of the API Management service. |
|
properties.developerPortalStatus | Enabled |
Status of developer portal in this API Management service. |
|
properties.developerPortalUrl |
string |
DEveloper Portal endpoint URL of the API Management service. |
|
properties.disableGateway |
boolean |
False |
Property only valid for an Api Management service deployed in multiple locations. This can be used to disable the gateway in master region. |
properties.enableClientCertificate |
boolean |
False |
Property only meant to be used for Consumption SKU Service. This enforces a client certificate to be presented on each request to the gateway. This also enables the ability to authenticate the certificate in the policy on the gateway. |
properties.gatewayRegionalUrl |
string |
Gateway URL of the API Management service in the Default Region. |
|
properties.gatewayUrl |
string |
Gateway URL of the API Management service. |
|
properties.hostnameConfigurations |
Custom hostname configuration of the API Management service. |
||
properties.legacyPortalStatus | Enabled |
Status of legacy portal in the API Management service. |
|
properties.managementApiUrl |
string |
Management API endpoint URL of the API Management service. |
|
properties.natGatewayState | Disabled |
Property can be used to enable NAT Gateway for this API Management service. |
|
properties.notificationSenderEmail |
string |
Email address from which the notification will be sent. |
|
properties.outboundPublicIPAddresses |
string[] |
Outbound public IPV4 address prefixes associated with NAT Gateway deployed service. Available only for Premium SKU on stv2 platform. |
|
properties.platformVersion |
Compute Platform Version running the service in this location. |
||
properties.portalUrl |
string |
Publisher portal endpoint Url of the API Management service. |
|
properties.privateEndpointConnections |
List of Private Endpoint Connections of this service. |
||
properties.privateIPAddresses |
string[] |
Private Static Load Balanced IP addresses of the API Management service in Primary region which is deployed in an Internal Virtual Network. Available only for Basic, Standard, Premium and Isolated SKU. |
|
properties.provisioningState |
string |
The current provisioning state of the API Management service which can be one of the following: Created/Activating/Succeeded/Updating/Failed/Stopped/Terminating/TerminationFailed/Deleted. |
|
properties.publicIPAddresses |
string[] |
Public Static Load Balanced IP addresses of the API Management service in Primary region. Available only for Basic, Standard, Premium and Isolated SKU. |
|
properties.publicIpAddressId |
string |
Public Standard SKU IP V4 based IP address to be associated with Virtual Network deployed service in the region. Supported only for Developer and Premium SKU being deployed in Virtual Network. |
|
properties.publicNetworkAccess |
Whether or not public endpoint access is allowed for this API Management service. Value is optional but if passed in, must be 'Enabled' or 'Disabled'. If 'Disabled', private endpoints are the exclusive access method. Default value is 'Enabled' |
||
properties.publisherEmail |
string |
Publisher email. |
|
properties.publisherName |
string |
Publisher name. |
|
properties.restore |
boolean |
False |
Undelete Api Management Service if it was previously soft-deleted. If this flag is specified and set to True all other properties will be ignored. |
properties.scmUrl |
string |
SCM endpoint URL of the API Management service. |
|
properties.targetProvisioningState |
string |
The provisioning state of the API Management service, which is targeted by the long running operation started on the service. |
|
properties.virtualNetworkConfiguration |
Virtual network configuration of the API Management service. |
||
properties.virtualNetworkType | None |
The type of VPN in which API Management service needs to be configured in. None (Default Value) means the API Management service is not part of any Virtual Network, External means the API Management deployment is set up inside a Virtual Network having an Internet Facing Endpoint, and Internal means that API Management deployment is setup inside a Virtual Network having an Intranet Facing Endpoint only. |
|
sku |
SKU properties of the API Management service. |
||
systemData |
Metadata pertaining to creation and last modification of the resource. |
||
tags |
object |
Resource tags. |
|
type |
string |
Resource type for API Management resource is set to Microsoft.ApiManagement. |
|
zones |
string[] |
A list of availability zones denoting where the resource needs to come from. |
ApiManagementServiceSkuProperties
API Management service resource SKU properties.
Name | Type | Description |
---|---|---|
capacity |
integer |
Capacity of the SKU (number of deployed units of the SKU). For Consumption SKU capacity must be specified as 0. |
name |
Name of the Sku. |
ApimIdentityType
The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the service.
Name | Type | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
ApiVersionConstraint
Control Plane Apis version constraint for the API Management service.
Name | Type | Description |
---|---|---|
minApiVersion |
string |
Limit control plane API calls to API Management service with version equal to or newer than this value. |
ArmIdWrapper
A wrapper for an ARM resource id
Name | Type | Description |
---|---|---|
id |
string |
CertificateConfiguration
Certificate configuration which consist of non-trusted intermediates and root certificates.
Name | Type | Description |
---|---|---|
certificate |
Certificate information. |
|
certificatePassword |
string |
Certificate Password. |
encodedCertificate |
string |
Base64 Encoded certificate. |
storeName |
enum:
|
The System.Security.Cryptography.x509certificates.StoreName certificate store location. Only Root and CertificateAuthority are valid locations. |
CertificateInformation
SSL certificate information.
Name | Type | Description |
---|---|---|
expiry |
string |
Expiration date of the certificate. The date conforms to the following format: |
subject |
string |
Subject of the certificate. |
thumbprint |
string |
Thumbprint of the certificate. |
CertificateSource
Certificate Source.
Name | Type | Description |
---|---|---|
BuiltIn |
string |
|
Custom |
string |
|
KeyVault |
string |
|
Managed |
string |
CertificateStatus
Certificate Status.
Name | Type | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
InProgress |
string |
ConfigurationApi
Information regarding the Configuration API of the API Management service.
Name | Type | Default value | Description |
---|---|---|---|
legacyApi | Enabled |
Indication whether or not the legacy Configuration API (v1) should be exposed on the API Management service. Value is optional but must be 'Enabled' or 'Disabled'. If 'Disabled', legacy Configuration API (v1) will not be available for self-hosted gateways. Default value is 'Enabled' |
createdByType
The type of identity that created the resource.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
developerPortalStatus
Status of developer portal in this API Management service.
Name | Type | Description |
---|---|---|
Disabled |
string |
Developer Portal is disabled for the service. |
Enabled |
string |
Developer Portal is enabled for the service. |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
HostnameConfiguration
Custom hostname configuration.
Name | Type | Default value | Description |
---|---|---|---|
certificate |
Certificate information. |
||
certificatePassword |
string |
Certificate Password. |
|
certificateSource |
Certificate Source. |
||
certificateStatus |
Certificate Status. |
||
defaultSslBinding |
boolean |
False |
Specify true to setup the certificate associated with this Hostname as the Default SSL Certificate. If a client does not send the SNI header, then this will be the certificate that will be challenged. The property is useful if a service has multiple custom hostname enabled and it needs to decide on the default ssl certificate. The setting only applied to gateway Hostname Type. |
encodedCertificate |
string |
Base64 Encoded certificate. |
|
hostName |
string |
Hostname to configure on the Api Management service. |
|
identityClientId |
string |
System or User Assigned Managed identity clientId as generated by Azure AD, which has GET access to the keyVault containing the SSL certificate. |
|
keyVaultId |
string |
Url to the KeyVault Secret containing the Ssl Certificate. If absolute Url containing version is provided, auto-update of ssl certificate will not work. This requires Api Management service to be configured with aka.ms/apimmsi. The secret should be of type application/x-pkcs12 |
|
negotiateClientCertificate |
boolean |
False |
Specify true to always negotiate client certificate on the hostname. Default Value is false. |
type |
Hostname type. |
HostnameType
Hostname type.
Name | Type | Description |
---|---|---|
ConfigurationApi |
string |
|
DeveloperPortal |
string |
|
Management |
string |
|
Portal |
string |
|
Proxy |
string |
|
Scm |
string |
LegacyApiState
Indication whether or not the legacy Configuration API (v1) should be exposed on the API Management service. Value is optional but must be 'Enabled' or 'Disabled'. If 'Disabled', legacy Configuration API (v1) will not be available for self-hosted gateways. Default value is 'Enabled'
Name | Type | Description |
---|---|---|
Disabled |
string |
Legacy Configuration API (v1) is disabled for the service and self-hosted gateways can not connect to it. |
Enabled |
string |
Legacy Configuration API (v1) is enabled for the service and self-hosted gateways can connect to it. |
LegacyPortalStatus
Status of legacy portal in the API Management service.
Name | Type | Description |
---|---|---|
Disabled |
string |
Legacy Portal is disabled for the service. |
Enabled |
string |
Legacy Portal is enabled for the service. |
NatGatewayState
Property can be used to enable NAT Gateway for this API Management service.
Name | Type | Description |
---|---|---|
Disabled |
string |
Nat Gateway is disabled for the service. |
Enabled |
string |
Nat Gateway is enabled for the service. |
PlatformVersion
Compute Platform Version running the service.
Name | Type | Description |
---|---|---|
mtv1 |
string |
Platform running the service on Multi Tenant V1 platform. |
stv1 |
string |
Platform running the service on Single Tenant V1 platform. |
stv2 |
string |
Platform running the service on Single Tenant V2 platform. |
stv2.1 |
string |
Platform running the service on Single Tenant V2 platform on newer Hardware. |
undetermined |
string |
Platform version cannot be determined, as compute platform is not deployed. |
PrivateEndpointServiceConnectionStatus
The private endpoint connection status.
Name | Type | Description |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
A collection of information about the state of the connection between service consumer and provider.
Name | Type | Description |
---|---|---|
actionsRequired |
string |
A message indicating if changes on the service provider require any updates on the consumer. |
description |
string |
The reason for approval/rejection of the connection. |
status |
Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. |
PublicNetworkAccess
Whether or not public endpoint access is allowed for this API Management service. Value is optional but if passed in, must be 'Enabled' or 'Disabled'. If 'Disabled', private endpoints are the exclusive access method. Default value is 'Enabled'
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
RemotePrivateEndpointConnectionWrapper
Remote Private Endpoint Connection resource.
Name | Type | Description |
---|---|---|
id |
string |
Private Endpoint connection resource id |
name |
string |
Private Endpoint Connection Name |
properties.groupIds |
string[] |
All the Group ids. |
properties.privateEndpoint |
The resource of private end point. |
|
properties.privateLinkServiceConnectionState |
A collection of information about the state of the connection between service consumer and provider. |
|
properties.provisioningState |
string |
The provisioning state of the private endpoint connection resource. |
type |
string |
Private Endpoint Connection Resource Type |
SkuType
Name of the Sku.
Name | Type | Description |
---|---|---|
Basic |
string |
Basic SKU of Api Management. |
BasicV2 |
string |
BasicV2 SKU of Api Management. |
Consumption |
string |
Consumption SKU of Api Management. |
Developer |
string |
Developer SKU of Api Management. |
Isolated |
string |
Isolated SKU of Api Management. |
Premium |
string |
Premium SKU of Api Management. |
Standard |
string |
Standard SKU of Api Management. |
StandardV2 |
string |
StandardV2 SKU of Api Management. |
systemData
Metadata pertaining to creation and last modification of the resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
The timestamp of resource creation (UTC). |
createdBy |
string |
The identity that created the resource. |
createdByType |
The type of identity that created the resource. |
|
lastModifiedAt |
string |
The timestamp of resource last modification (UTC) |
lastModifiedBy |
string |
The identity that last modified the resource. |
lastModifiedByType |
The type of identity that last modified the resource. |
UserIdentityProperties
Name | Type | Description |
---|---|---|
clientId |
string |
The client id of user assigned identity. |
principalId |
string |
The principal id of user assigned identity. |
VirtualNetworkConfiguration
Configuration of a virtual network to which API Management service is deployed.
Name | Type | Description |
---|---|---|
subnetResourceId |
string |
The full resource ID of a subnet in a virtual network to deploy the API Management service in. |
subnetname |
string |
The name of the subnet. |
vnetid |
string |
The virtual network ID. This is typically a GUID. Expect a null GUID by default. |
VirtualNetworkType
The type of VPN in which API Management service needs to be configured in. None (Default Value) means the API Management service is not part of any Virtual Network, External means the API Management deployment is set up inside a Virtual Network having an Internet Facing Endpoint, and Internal means that API Management deployment is setup inside a Virtual Network having an Intranet Facing Endpoint only.
Name | Type | Description |
---|---|---|
External |
string |
The service is part of Virtual Network and it is accessible from Internet. |
Internal |
string |
The service is part of Virtual Network and it is only accessible from within the virtual network. |
None |
string |
The service is not part of any Virtual Network. |