Network Interfaces - List Effective Network Security Groups
Obtiene todos los grupos de seguridad de red aplicados a una interfaz de red.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}/effectiveNetworkSecurityGroups?api-version=2023-09-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
network
|
path | True |
string |
Nombre de la interfaz de red. |
resource
|
path | True |
string |
Nombre del grupo de recursos. |
subscription
|
path | True |
string |
Las credenciales de suscripción que identifican de forma exclusiva la suscripción a Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio. |
api-version
|
query | True |
string |
Versión de API del cliente. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Effective |
Solicite correctamente. La operación devuelve una lista de recursos networkSecurityGroup. |
202 Accepted |
Aceptado y la operación se completará de forma asincrónica. |
|
Other Status Codes |
Cloud |
Respuesta de error que describe el motivo del error de la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
List network interface effective network security groups
Sample Request
POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1/effectiveNetworkSecurityGroups?api-version=2023-09-01
Sample Response
{
"value": [
{
"networkSecurityGroup": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/test-nsg"
},
"association": {
"networkManager": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/nm1"
},
"subnet": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/rg1-vnet/subnets/default"
},
"networkInterface": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1"
}
},
"effectiveSecurityRules": [
{
"name": "securityRules/rule1",
"protocol": "Tcp",
"sourcePortRange": "456-456",
"destinationPortRange": "6579-6579",
"sourceAddressPrefix": "0.0.0.0/32",
"destinationAddressPrefix": "0.0.0.0/32",
"access": "Allow",
"priority": 234,
"direction": "Inbound"
},
{
"name": "securityRules/default-allow-rdp",
"protocol": "Tcp",
"sourcePortRange": "0-65535",
"destinationPortRange": "3389-3389",
"sourceAddressPrefix": "1.1.1.1/32",
"destinationAddressPrefix": "0.0.0.0/0",
"access": "Allow",
"priority": 1000,
"direction": "Inbound"
},
{
"name": "defaultSecurityRules/AllowInternetOutBound",
"protocol": "All",
"sourcePortRange": "0-65535",
"destinationPortRange": "0-65535",
"sourceAddressPrefix": "0.0.0.0/0",
"destinationAddressPrefix": "Internet",
"expandedDestinationAddressPrefix": [
"32.0.0.0/3",
"4.0.0.0/6",
"2.0.0.0/7",
"1.0.0.0/8"
],
"access": "Allow",
"priority": 65001,
"direction": "Outbound"
}
]
}
]
}
Location: https://management.azure.com//subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityGroups/test-nsg/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Definiciones
Nombre | Description |
---|---|
Cloud |
Respuesta de error del servicio. |
Cloud |
Respuesta de error del servicio. |
Effective |
Grupo de seguridad de red efectivo. |
Effective |
Asociación efectiva del grupo de seguridad de red. |
Effective |
Respuesta para enumerar la llamada efectiva del servicio api de grupos de seguridad de red. |
Effective |
Reglas de seguridad de red eficaces. |
Effective |
El protocolo de red al que se aplica esta regla. |
Security |
Si se permite o se deniega el tráfico de red. |
Security |
Dirección de la regla. La dirección especifica si la regla se evaluará en el tráfico entrante o saliente. |
Sub |
Referencia a otro subrecurso. |
CloudError
Respuesta de error del servicio.
Nombre | Tipo | Description |
---|---|---|
error |
Cloud |
Cuerpo del error en la nube. |
CloudErrorBody
Respuesta de error del servicio.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación. |
details |
Cloud |
Lista de detalles adicionales sobre el error. |
message |
string |
Mensaje que describe el error, diseñado para ser adecuado para su presentación en una interfaz de usuario. |
target |
string |
Destino del error determinado. Por ejemplo, el nombre de la propiedad en error. |
EffectiveNetworkSecurityGroup
Grupo de seguridad de red efectivo.
Nombre | Tipo | Description |
---|---|---|
association |
Effective |
Recursos asociados. |
effectiveSecurityRules |
Effective |
Colección de reglas de seguridad eficaces. |
networkSecurityGroup |
Sub |
Identificador del grupo de seguridad de red que se aplica. |
tagMap |
object |
Asignación de etiquetas a la lista de direcciones IP incluidas en la etiqueta. |
EffectiveNetworkSecurityGroupAssociation
Asociación efectiva del grupo de seguridad de red.
Nombre | Tipo | Description |
---|---|---|
networkInterface |
Sub |
Identificador de la interfaz de red si está asignado. |
networkManager |
Sub |
Identificador del administrador de red de Azure si está asignado. |
subnet |
Sub |
Identificador de la subred si está asignado. |
EffectiveNetworkSecurityGroupListResult
Respuesta para enumerar la llamada efectiva del servicio api de grupos de seguridad de red.
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
Dirección URL para obtener el siguiente conjunto de resultados. |
value |
Effective |
Lista de grupos de seguridad de red eficaces. |
EffectiveNetworkSecurityRule
Reglas de seguridad de red eficaces.
Nombre | Tipo | Description |
---|---|---|
access |
Security |
Si se permite o se deniega el tráfico de red. |
destinationAddressPrefix |
string |
Prefijo de dirección de destino. |
destinationAddressPrefixes |
string[] |
Prefijos de dirección de destino. Los valores esperados incluyen intervalos IP CIDR, Etiquetas predeterminadas (VirtualNetwork, AzureLoadBalancer, Internet), Etiquetas del sistema y el asterisco (*). |
destinationPortRange |
string |
Puerto o intervalo de destino. |
destinationPortRanges |
string[] |
Intervalos de puertos de destino. Los valores esperados incluyen un único entero entre 0 y 65535, un intervalo que usa "-" como separador (por ejemplo, 100-400) o un asterisco (*). |
direction |
Security |
Dirección de la regla. |
expandedDestinationAddressPrefix |
string[] |
Prefijo de dirección de destino expandido. |
expandedSourceAddressPrefix |
string[] |
Prefijo de dirección de origen expandido. |
name |
string |
Nombre de la regla de seguridad especificada por el usuario (si lo crea el usuario). |
priority |
integer |
Prioridad de la regla. |
protocol |
Effective |
El protocolo de red al que se aplica esta regla. |
sourceAddressPrefix |
string |
Prefijo de dirección de origen. |
sourceAddressPrefixes |
string[] |
Prefijos de dirección de origen. Los valores esperados incluyen intervalos IP CIDR, Etiquetas predeterminadas (VirtualNetwork, AzureLoadBalancer, Internet), Etiquetas del sistema y el asterisco (*). |
sourcePortRange |
string |
Puerto o intervalo de origen. |
sourcePortRanges |
string[] |
Intervalos de puertos de origen. Los valores esperados incluyen un único entero entre 0 y 65535, un intervalo que usa "-" como separador (por ejemplo, 100-400) o un asterisco (*). |
EffectiveSecurityRuleProtocol
El protocolo de red al que se aplica esta regla.
Nombre | Tipo | Description |
---|---|---|
All |
string |
|
Tcp |
string |
|
Udp |
string |
SecurityRuleAccess
Si se permite o se deniega el tráfico de red.
Nombre | Tipo | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
SecurityRuleDirection
Dirección de la regla. La dirección especifica si la regla se evaluará en el tráfico entrante o saliente.
Nombre | Tipo | Description |
---|---|---|
Inbound |
string |
|
Outbound |
string |
SubResource
Referencia a otro subrecurso.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador del recurso. |