Skip to main content

application_gateways

Creates, updates, deletes, gets or lists an application_gateways resource.

Overview

Nameapplication_gateways
TypeResource
Idazure.network.application_gateways

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringResource ID.
namestringResource name.
authenticationCertificatesarrayAuthentication certificates of the application gateway resource. For default limits, see Application Gateway limits _.
autoscaleConfigurationobjectAutoscale Configuration.
backendAddressPoolsarrayBackend address pool of the application gateway resource. For default limits, see Application Gateway limits _.
backendHttpSettingsCollectionarrayBackend http settings of the application gateway resource. For default limits, see Application Gateway limits _.
backendSettingsCollectionarrayBackend settings of the application gateway resource. For default limits, see Application Gateway limits _.
customErrorConfigurationsarrayCustom error configurations of the application gateway resource.
defaultPredefinedSslPolicystringThe default predefined SSL Policy applied on the application gateway resource. Known values are: "AppGwSslPolicy20150501", "AppGwSslPolicy20170401", "AppGwSslPolicy20170401S", "AppGwSslPolicy20220101", and "AppGwSslPolicy20220101S". (AppGwSslPolicy20150501, AppGwSslPolicy20170401, AppGwSslPolicy20170401S, AppGwSslPolicy20220101, AppGwSslPolicy20220101S)
enableFipsbooleanWhether FIPS is enabled on the application gateway resource.
enableHttp2booleanWhether HTTP2 is enabled on the application gateway resource.
entraJWTValidationConfigsarrayEntra JWT validation configurations for the application gateway resource. For default limits, see Application Gateway limits _.
etagstringA unique read-only string that changes whenever the resource is updated.
firewallPolicyobjectReference to another subresource.
forceFirewallPolicyAssociationbooleanIf true, associates a firewall policy with an application gateway regardless whether the policy differs from the WAF Config.
frontendIPConfigurationsarrayFrontend IP addresses of the application gateway resource. For default limits, see Application Gateway limits _.
frontendPortsarrayFrontend ports of the application gateway resource. For default limits, see Application Gateway limits _.
gatewayIPConfigurationsarraySubnets of the application gateway resource. For default limits, see Application Gateway limits _.
globalConfigurationobjectGlobal Configuration.
httpListenersarrayHttp listeners of the application gateway resource. For default limits, see Application Gateway limits _.
identityobjectThe identity of the application gateway, if configured.
listenersarrayListeners of the application gateway resource. For default limits, see Application Gateway limits _.
loadDistributionPoliciesarrayLoad distribution policies of the application gateway resource.
locationstringResource location.
operationalStatestringOperational state of the application gateway resource. Known values are: "Stopped", "Starting", "Running", and "Stopping". (Stopped, Starting, Running, Stopping)
privateEndpointConnectionsarrayPrivate Endpoint connections on application gateway.
privateLinkConfigurationsarrayPrivateLink configurations on application gateway.
probesarrayProbes of the application gateway resource.
provisioningStatestringThe provisioning state of the application gateway resource. Known values are: "Failed", "Succeeded", "Canceled", "Creating", "Updating", and "Deleting". (Failed, Succeeded, Canceled, Creating, Updating, Deleting)
redirectConfigurationsarrayRedirect configurations of the application gateway resource. For default limits, see Application Gateway limits _.
requestRoutingRulesarrayRequest routing rules of the application gateway resource.
resourceGuidstringThe resource GUID property of the application gateway resource.
rewriteRuleSetsarrayRewrite rules for the application gateway resource.
routingRulesarrayRouting rules of the application gateway resource.
skuobjectSKU of the application gateway resource.
sslCertificatesarraySSL certificates of the application gateway resource. For default limits, see Application Gateway limits _.
sslPolicyobjectSSL policy of the application gateway resource.
sslProfilesarraySSL profiles of the application gateway resource. For default limits, see Application Gateway limits _.
tagsobjectResource tags.
trustedClientCertificatesarrayTrusted client certificates of the application gateway resource. For default limits, see Application Gateway limits _.
trustedRootCertificatesarrayTrusted Root certificates of the application gateway resource. For default limits, see Application Gateway limits _.
typestringResource type.
urlPathMapsarrayURL path map of the application gateway resource. For default limits, see Application Gateway limits _.
webApplicationFirewallConfigurationobjectWeb application firewall configuration.
zonesarrayA list of availability zones denoting where the resource needs to come from.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresource_group_name, application_gateway_name, subscription_idGets the specified application gateway.
listselectresource_group_name, subscription_idLists all application gateways in a resource group.
get_ssl_predefined_policyselectpredefined_policy_name, subscription_idGets Ssl predefined policy with the specified policy name.
list_allselectsubscription_idGets all the application gateways in a subscription.
create_or_updateinsertresource_group_name, application_gateway_name, subscription_idCreates or updates the specified application gateway.
update_tagsupdateresource_group_name, application_gateway_name, subscription_idUpdates the specified application gateway tags.
create_or_updatereplaceresource_group_name, application_gateway_name, subscription_idCreates or updates the specified application gateway.
deletedeleteresource_group_name, application_gateway_name, subscription_idDeletes the specified application gateway.
list_available_ssl_optionsexecsubscription_idLists available Ssl options for configuring Ssl policy.
list_available_ssl_predefined_policiesexecsubscription_idLists all SSL predefined policies for configuring Ssl policy.
list_available_server_variablesexecsubscription_idLists all available server variables.
list_available_request_headersexecsubscription_idLists all available request headers.
list_available_response_headersexecsubscription_idLists all available response headers.
list_available_waf_rule_setsexecsubscription_idLists all available web application firewall rule sets.
startexecresource_group_name, application_gateway_name, subscription_idStarts the specified application gateway.
stopexecresource_group_name, application_gateway_name, subscription_idStops the specified application gateway in a resource group.
backend_healthexecresource_group_name, application_gateway_name, subscription_id$expandGets the backend health of the specified application gateway in a resource group.
backend_health_on_demandexecresource_group_name, application_gateway_name, subscription_id$expandGets the backend health for given combination of backend pool and http setting of the specified application gateway in a resource group.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
application_gateway_namestringThe name of the application gateway. Required.
predefined_policy_namestringThe name of the ssl predefined policy. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
subscription_idstring
$expandstringExpands BackendAddressPool and BackendHttpSettings referenced in backend health. Default value is None.

SELECT examples

Gets the specified application gateway.

SELECT
id,
name,
authenticationCertificates,
autoscaleConfiguration,
backendAddressPools,
backendHttpSettingsCollection,
backendSettingsCollection,
customErrorConfigurations,
defaultPredefinedSslPolicy,
enableFips,
enableHttp2,
entraJWTValidationConfigs,
etag,
firewallPolicy,
forceFirewallPolicyAssociation,
frontendIPConfigurations,
frontendPorts,
gatewayIPConfigurations,
globalConfiguration,
httpListeners,
identity,
listeners,
loadDistributionPolicies,
location,
operationalState,
privateEndpointConnections,
privateLinkConfigurations,
probes,
provisioningState,
redirectConfigurations,
requestRoutingRules,
resourceGuid,
rewriteRuleSets,
routingRules,
sku,
sslCertificates,
sslPolicy,
sslProfiles,
tags,
trustedClientCertificates,
trustedRootCertificates,
type,
urlPathMaps,
webApplicationFirewallConfiguration,
zones
FROM azure.network.application_gateways
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND application_gateway_name = '{{ application_gateway_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;

INSERT examples

Creates or updates the specified application gateway.

INSERT INTO azure.network.application_gateways (
id,
location,
tags,
properties,
zones,
identity,
resource_group_name,
application_gateway_name,
subscription_id
)
SELECT
'{{ id }}',
'{{ location }}',
'{{ tags }}',
'{{ properties }}',
'{{ zones }}',
'{{ identity }}',
'{{ resource_group_name }}',
'{{ application_gateway_name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
etag,
identity,
location,
properties,
tags,
type,
zones
;

UPDATE examples

Updates the specified application gateway tags.

UPDATE azure.network.application_gateways
SET
tags = '{{ tags }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND application_gateway_name = '{{ application_gateway_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
identity,
location,
properties,
tags,
type,
zones;

REPLACE examples

Creates or updates the specified application gateway.

REPLACE azure.network.application_gateways
SET
id = '{{ id }}',
location = '{{ location }}',
tags = '{{ tags }}',
properties = '{{ properties }}',
zones = '{{ zones }}',
identity = '{{ identity }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND application_gateway_name = '{{ application_gateway_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
identity,
location,
properties,
tags,
type,
zones;

DELETE examples

Deletes the specified application gateway.

DELETE FROM azure.network.application_gateways
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND application_gateway_name = '{{ application_gateway_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
;

Lifecycle Methods

Lists available Ssl options for configuring Ssl policy.

EXEC azure.network.application_gateways.list_available_ssl_options 
@subscription_id='{{ subscription_id }}' --required
;