Network Interfaces - List Effective Network Security Groups
Ottiene tutti i gruppi di sicurezza di rete applicati a un'interfaccia di rete.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}/effectiveNetworkSecurityGroups?api-version=2023-09-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
network
|
path | True |
string |
Nome dell'interfaccia di rete. |
resource
|
path | True |
string |
Nome del gruppo di risorse. |
subscription
|
path | True |
string |
Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio. |
api-version
|
query | True |
string |
Versione API client. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Effective |
Richiesta riuscita. L'operazione restituisce un elenco di risorse NetworkSecurityGroup. |
202 Accepted |
Accettata e l'operazione verrà completata in modo asincrono. |
|
Other Status Codes |
Cloud |
Risposta di errore che descrive perché l'operazione non è riuscita. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
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
Definizioni
Nome | Descrizione |
---|---|
Cloud |
Risposta di errore dal servizio. |
Cloud |
Risposta di errore dal servizio. |
Effective |
Gruppo di sicurezza di rete efficace. |
Effective |
Associazione efficace del gruppo di sicurezza di rete. |
Effective |
Risposta per elencare la chiamata al servizio API gruppi di sicurezza di rete efficace. |
Effective |
Regole di sicurezza di rete efficaci. |
Effective |
Il protocollo di rete a cui si applica questa regola. |
Security |
Se il traffico di rete è consentito o negato. |
Security |
Direzione della regola. L'elemento direction specifica se la regola verrà valutata sul traffico in ingresso o in uscita. |
Sub |
Riferimento a un'altra sottoresource. |
CloudError
Risposta di errore dal servizio.
Nome | Tipo | Descrizione |
---|---|---|
error |
Cloud |
Corpo dell'errore cloud. |
CloudErrorBody
Risposta di errore dal servizio.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice. |
details |
Cloud |
Elenco di dettagli aggiuntivi sull'errore. |
message |
string |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
target |
string |
Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in caso di errore. |
EffectiveNetworkSecurityGroup
Gruppo di sicurezza di rete efficace.
Nome | Tipo | Descrizione |
---|---|---|
association |
Effective |
Risorse associate. |
effectiveSecurityRules |
Effective |
Raccolta di regole di sicurezza efficaci. |
networkSecurityGroup |
Sub |
ID del gruppo di sicurezza di rete applicato. |
tagMap |
object |
Mapping dei tag all'elenco di indirizzi IP inclusi nel tag. |
EffectiveNetworkSecurityGroupAssociation
Associazione efficace del gruppo di sicurezza di rete.
Nome | Tipo | Descrizione |
---|---|---|
networkInterface |
Sub |
ID dell'interfaccia di rete se assegnato. |
networkManager |
Sub |
ID del gestore di rete di Azure se assegnato. |
subnet |
Sub |
ID della subnet se assegnato. |
EffectiveNetworkSecurityGroupListResult
Risposta per elencare la chiamata al servizio API gruppi di sicurezza di rete efficace.
Nome | Tipo | Descrizione |
---|---|---|
nextLink |
string |
URL per ottenere il set successivo di risultati. |
value |
Effective |
Elenco di gruppi di sicurezza di rete efficaci. |
EffectiveNetworkSecurityRule
Regole di sicurezza di rete efficaci.
Nome | Tipo | Descrizione |
---|---|---|
access |
Security |
Se il traffico di rete è consentito o negato. |
destinationAddressPrefix |
string |
Prefisso dell'indirizzo di destinazione. |
destinationAddressPrefixes |
string[] |
Prefissi dell'indirizzo di destinazione. I valori previsti includono intervalli IP CIDR, Tag predefiniti (VirtualNetwork, AzureLoadBalancer, Internet), Tag di sistema e asterisco (*). |
destinationPortRange |
string |
Porta di destinazione o intervallo. |
destinationPortRanges |
string[] |
Intervalli di porte di destinazione. I valori previsti includono un singolo intero compreso tra 0 e 65535, un intervallo che usa '-' come separatore (ad esempio 100-400) o un asterisco (*). |
direction |
Security |
Direzione della regola. |
expandedDestinationAddressPrefix |
string[] |
Prefisso dell'indirizzo di destinazione espanso. |
expandedSourceAddressPrefix |
string[] |
Prefisso dell'indirizzo di origine espanso. |
name |
string |
Nome della regola di sicurezza specificata dall'utente (se creato dall'utente). |
priority |
integer |
Priorità della regola. |
protocol |
Effective |
Il protocollo di rete a cui si applica questa regola. |
sourceAddressPrefix |
string |
Prefisso dell'indirizzo di origine. |
sourceAddressPrefixes |
string[] |
Prefissi dell'indirizzo di origine. I valori previsti includono intervalli IP CIDR, Tag predefiniti (VirtualNetwork, AzureLoadBalancer, Internet), Tag di sistema e asterisco (*). |
sourcePortRange |
string |
Porta di origine o intervallo. |
sourcePortRanges |
string[] |
Intervalli di porte di origine. I valori previsti includono un singolo intero compreso tra 0 e 65535, un intervallo che usa '-' come separatore (ad esempio 100-400) o un asterisco (*). |
EffectiveSecurityRuleProtocol
Il protocollo di rete a cui si applica questa regola.
Nome | Tipo | Descrizione |
---|---|---|
All |
string |
|
Tcp |
string |
|
Udp |
string |
SecurityRuleAccess
Se il traffico di rete è consentito o negato.
Nome | Tipo | Descrizione |
---|---|---|
Allow |
string |
|
Deny |
string |
SecurityRuleDirection
Direzione della regola. L'elemento direction specifica se la regola verrà valutata sul traffico in ingresso o in uscita.
Nome | Tipo | Descrizione |
---|---|---|
Inbound |
string |
|
Outbound |
string |
SubResource
Riferimento a un'altra sottoresource.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |