Network Interfaces - List Effective Network Security Groups

Obtém todos os grupos de segurança de rede aplicados a uma interface de rede.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}/effectiveNetworkSecurityGroups?api-version=2022-11-01

Parâmetros do URI

Name Em Necessário Tipo Description
networkInterfaceName
path True

string

O nome da interface de rede.

resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

As credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API de Cliente.

Respostas

Name Tipo Description
200 OK

EffectiveNetworkSecurityGroupListResult

Pedido com êxito. A operação devolve uma lista de recursos NetworkSecurityGroup.

202 Accepted

Aceite e a operação será concluída de forma assíncrona.

Other Status Codes

CloudError

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

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=2022-11-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=2022-11-01

Definições

Name Description
CloudError

Uma resposta de erro do serviço.

CloudErrorBody

Uma resposta de erro do serviço.

EffectiveNetworkSecurityGroup

Grupo de segurança de rede eficaz.

EffectiveNetworkSecurityGroupAssociation

A associação eficaz do grupo de segurança de rede.

EffectiveNetworkSecurityGroupListResult

Resposta para listar chamada de serviço de API de grupos de segurança de rede eficazes.

EffectiveNetworkSecurityRule

Regras de segurança de rede eficazes.

EffectiveSecurityRuleProtocol

O protocolo de rede a que esta regra se aplica.

SecurityRuleAccess

Se o tráfego de rede é permitido ou negado.

SecurityRuleDirection

A direção da regra. A direção especifica se a regra será avaliada no tráfego de entrada ou saída.

SubResource

Referência a outra sub-origem.

CloudError

Uma resposta de erro do serviço.

Name Tipo Description
error

CloudErrorBody

Corpo do erro da cloud.

CloudErrorBody

Uma resposta de erro do serviço.

Name Tipo Description
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem que descreve o erro, que se destina a ser adequada para ser apresentada numa interface de utilizador.

target

string

O destino do erro específico. Por exemplo, o nome da propriedade em erro.

EffectiveNetworkSecurityGroup

Grupo de segurança de rede eficaz.

Name Tipo Description
association

EffectiveNetworkSecurityGroupAssociation

Recursos associados.

effectiveSecurityRules

EffectiveNetworkSecurityRule[]

Uma coleção de regras de segurança eficazes.

networkSecurityGroup

SubResource

O ID do grupo de segurança de rede que é aplicado.

tagMap

object

Mapeamento de etiquetas para a lista de Endereços IP incluídos na etiqueta.

EffectiveNetworkSecurityGroupAssociation

A associação eficaz do grupo de segurança de rede.

Name Tipo Description
networkInterface

SubResource

O ID da interface de rede, se atribuído.

networkManager

SubResource

O ID do gestor de rede do Azure, se atribuído.

subnet

SubResource

O ID da sub-rede, se atribuído.

EffectiveNetworkSecurityGroupListResult

Resposta para listar chamada de serviço de API de grupos de segurança de rede eficazes.

Name Tipo Description
nextLink

string

O URL para obter o próximo conjunto de resultados.

value

EffectiveNetworkSecurityGroup[]

Uma lista de grupos de segurança de rede eficazes.

EffectiveNetworkSecurityRule

Regras de segurança de rede eficazes.

Name Tipo Description
access

SecurityRuleAccess

Se o tráfego de rede é permitido ou negado.

destinationAddressPrefix

string

O prefixo do endereço de destino.

destinationAddressPrefixes

string[]

Os prefixos de endereço de destino. Os valores esperados incluem intervalos de IP CIDR, Etiquetas Predefinidas (VirtualNetwork, AzureLoadBalancer, Internet), Etiquetas de Sistema e o asterisco (*).

destinationPortRange

string

A porta ou intervalo de destino.

destinationPortRanges

string[]

Os intervalos de portas de destino. Os valores esperados incluem um único número inteiro entre 0 e 65535, um intervalo que utiliza "-" como separador (por exemplo, 100-400) ou um asterisco (*).

direction

SecurityRuleDirection

A direção da regra.

expandedDestinationAddressPrefix

string[]

Prefixo de endereço de destino expandido.

expandedSourceAddressPrefix

string[]

O prefixo de endereço de origem expandido.

name

string

O nome da regra de segurança especificada pelo utilizador (se criado pelo utilizador).

priority

integer

A prioridade da regra.

protocol

EffectiveSecurityRuleProtocol

O protocolo de rede a que esta regra se aplica.

sourceAddressPrefix

string

O prefixo do endereço de origem.

sourceAddressPrefixes

string[]

Os prefixos de endereço de origem. Os valores esperados incluem intervalos de IP CIDR, Etiquetas Predefinidas (VirtualNetwork, AzureLoadBalancer, Internet), Etiquetas de Sistema e o asterisco (*).

sourcePortRange

string

A porta ou intervalo de origem.

sourcePortRanges

string[]

Os intervalos de portas de origem. Os valores esperados incluem um único número inteiro entre 0 e 65535, um intervalo que utiliza "-" como separador (por exemplo, 100-400) ou um asterisco (*).

EffectiveSecurityRuleProtocol

O protocolo de rede a que esta regra se aplica.

Name Tipo Description
All

string

Tcp

string

Udp

string

SecurityRuleAccess

Se o tráfego de rede é permitido ou negado.

Name Tipo Description
Allow

string

Deny

string

SecurityRuleDirection

A direção da regra. A direção especifica se a regra será avaliada no tráfego de entrada ou saída.

Name Tipo Description
Inbound

string

Outbound

string

SubResource

Referência a outra sub-origem.

Name Tipo Description
id

string

ID do Recurso.