Skip to main content

network_interfaces

Creates, updates, deletes, gets or lists a network_interfaces resource.

Overview

Namenetwork_interfaces
TypeResource
Idazure.network.network_interfaces

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringResource ID.
namestringName of the resource.
applicationGatewayBackendAddressPoolsarrayThe reference to ApplicationGatewayBackendAddressPool resource.
applicationSecurityGroupsarrayApplication security groups in which the IP configuration is included.
etagstringA unique read-only string that changes whenever the resource is updated.
gatewayLoadBalancerobjectReference to another subresource.
loadBalancerBackendAddressPoolsarrayThe reference to LoadBalancerBackendAddressPool resource.
loadBalancerInboundNatRulesarrayA list of references of LoadBalancerInboundNatRules.
primarybooleanWhether this is a primary customer address on the network interface.
privateIPAddressstringPrivate IP address of the IP configuration. It can be a single IP address or a CIDR block in the format /.
privateIPAddressPrefixLengthintegerThe private IP address prefix length. If specified and the allocation method is dynamic, the service will allocate a CIDR block instead of a single IP address.
privateIPAddressVersionstringWhether the specific IP configuration is IPv4 or IPv6. Default is IPv4. Known values are: "IPv4" and "IPv6". (IPv4, IPv6)
privateIPAllocationMethodstringThe private IP address allocation method. Known values are: "Static" and "Dynamic". (Static, Dynamic)
privateLinkConnectionPropertiesobjectPrivateLinkConnection properties for the network interface.
provisioningStatestringThe provisioning state of the network interface IP configuration. Known values are: "Failed", "Succeeded", "Canceled", "Creating", "Updating", and "Deleting". (Failed, Succeeded, Canceled, Creating, Updating, Deleting)
publicIPAddressobjectPublic IP address bound to the IP configuration.
subnetobjectSubnet in a virtual network resource.
typestringResource type.
virtualNetworkTapsarrayThe reference to Virtual Network Taps.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_virtual_machine_scale_set_ip_configurationselectresource_group_name, virtual_machine_scale_set_name, virtualmachine_index, network_interface_name, ip_configuration_name, subscription_id$expandGet the specified network interface ip configuration in a virtual machine scale set.
list_virtual_machine_scale_set_ip_configurationsselectresource_group_name, virtual_machine_scale_set_name, virtualmachine_index, network_interface_name, subscription_id$expandGet the specified network interface ip configuration in a virtual machine scale set.
get_cloud_service_network_interfaceselectresource_group_name, cloud_service_name, role_instance_name, network_interface_name, subscription_id$expandGet the specified network interface in a cloud service.
list_cloud_service_role_instance_network_interfacesselectresource_group_name, cloud_service_name, role_instance_name, subscription_idGets information about all network interfaces in a role instance in a cloud service.
list_virtual_machine_scale_set_vm_network_interfacesselectresource_group_name, virtual_machine_scale_set_name, virtualmachine_index, subscription_idGets information about all network interfaces in a virtual machine in a virtual machine scale set.
getselectresource_group_name, network_interface_name, subscription_id$expandGets information about the specified network interface.
list_cloud_service_network_interfacesselectresource_group_name, cloud_service_name, subscription_idGets all network interfaces in a cloud service.
list_virtual_machine_scale_set_network_interfacesselectresource_group_name, virtual_machine_scale_set_name, subscription_idGets all network interfaces in a virtual machine scale set.
listselectresource_group_name, subscription_idGets all network interfaces in a resource group.
list_allselectsubscription_idGets all network interfaces in a subscription.
create_or_updateinsertresource_group_name, network_interface_name, subscription_idCreates or updates a network interface.
update_tagsupdateresource_group_name, network_interface_name, subscription_idUpdates a network interface tags.
create_or_updatereplaceresource_group_name, network_interface_name, subscription_idCreates or updates a network interface.
deletedeleteresource_group_name, network_interface_name, subscription_idDeletes the specified network interface.
list_effective_network_security_groupsexecresource_group_name, network_interface_name, subscription_idGets all network security groups applied to a network interface.
get_virtual_machine_scale_set_network_interfaceexecresource_group_name, virtual_machine_scale_set_name, virtualmachine_index, network_interface_name, subscription_id$expandGet the specified network interface in a virtual machine scale set.
get_effective_route_tableexecresource_group_name, network_interface_name, subscription_idGets all route tables applied to a network interface.

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
cloud_service_namestringThe name of the cloud service. Required.
ip_configuration_namestringRequired.
network_interface_namestringThe name of the network interface. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
role_instance_namestringThe name of role instance. Required.
subscription_idstring
virtual_machine_scale_set_namestringRequired.
virtualmachine_indexstringRequired.
$expandstringExpands referenced resources. Default value is None.

SELECT examples

Get the specified network interface ip configuration in a virtual machine scale set.

SELECT
id,
name,
applicationGatewayBackendAddressPools,
applicationSecurityGroups,
etag,
gatewayLoadBalancer,
loadBalancerBackendAddressPools,
loadBalancerInboundNatRules,
primary,
privateIPAddress,
privateIPAddressPrefixLength,
privateIPAddressVersion,
privateIPAllocationMethod,
privateLinkConnectionProperties,
provisioningState,
publicIPAddress,
subnet,
type,
virtualNetworkTaps
FROM azure.network.network_interfaces
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND virtual_machine_scale_set_name = '{{ virtual_machine_scale_set_name }}' -- required
AND virtualmachine_index = '{{ virtualmachine_index }}' -- required
AND network_interface_name = '{{ network_interface_name }}' -- required
AND ip_configuration_name = '{{ ip_configuration_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $expand = '{{ $expand }}'
;

INSERT examples

Creates or updates a network interface.

INSERT INTO azure.network.network_interfaces (
id,
location,
tags,
properties,
extendedLocation,
resource_group_name,
network_interface_name,
subscription_id
)
SELECT
'{{ id }}',
'{{ location }}',
'{{ tags }}',
'{{ properties }}',
'{{ extendedLocation }}',
'{{ resource_group_name }}',
'{{ network_interface_name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
etag,
extendedLocation,
location,
properties,
tags,
type
;

UPDATE examples

Updates a network interface tags.

UPDATE azure.network.network_interfaces
SET
tags = '{{ tags }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND network_interface_name = '{{ network_interface_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
extendedLocation,
location,
properties,
tags,
type;

REPLACE examples

Creates or updates a network interface.

REPLACE azure.network.network_interfaces
SET
id = '{{ id }}',
location = '{{ location }}',
tags = '{{ tags }}',
properties = '{{ properties }}',
extendedLocation = '{{ extendedLocation }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND network_interface_name = '{{ network_interface_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
extendedLocation,
location,
properties,
tags,
type;

DELETE examples

Deletes the specified network interface.

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

Lifecycle Methods

Gets all network security groups applied to a network interface.

EXEC azure.network.network_interfaces.list_effective_network_security_groups 
@resource_group_name='{{ resource_group_name }}' --required,
@network_interface_name='{{ network_interface_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
;