Network Interfaces - List Effective Network Security Groups
Lekéri a hálózati adapterre alkalmazott összes hálózati biztonsági csoportot.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}/effectiveNetworkSecurityGroups?api-version=2023-09-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
network
|
path | True |
string |
A hálózati adapter neve. |
resource
|
path | True |
string |
Az erőforráscsoport neve. |
subscription
|
path | True |
string |
Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz. |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
Effective |
A kérés sikeres. A művelet a NetworkSecurityGroup-erőforrások listáját adja vissza. |
202 Accepted |
Elfogadva, és a művelet aszinkron módon fejeződik be. |
|
Other Status Codes |
Cloud |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
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
Definíciók
Name | Description |
---|---|
Cloud |
Hibaválasz a szolgáltatástól. |
Cloud |
Hibaválasz a szolgáltatástól. |
Effective |
Érvényes hálózati biztonsági csoport. |
Effective |
Az érvényes hálózati biztonsági csoport társítása. |
Effective |
Válasz az érvényes hálózati biztonsági csoportok API-szolgáltatáshívásainak listázásakor. |
Effective |
Érvényes hálózati biztonsági szabályok. |
Effective |
Arra a hálózati protokollra vonatkozik, amelyre ez a szabály vonatkozik. |
Security |
Azt jelzi, hogy a hálózati forgalom engedélyezve van-e vagy megtagadva. |
Security |
A szabály iránya. Az irány határozza meg, hogy a rendszer kiértékeli-e a szabályt a bejövő vagy kimenő forgalomon. |
Sub |
Hivatkozás másik alforrásra. |
CloudError
Hibaválasz a szolgáltatástól.
Name | Típus | Description |
---|---|---|
error |
Cloud |
Felhőbeli hibatörzs. |
CloudErrorBody
Hibaválasz a szolgáltatástól.
Name | Típus | Description |
---|---|---|
code |
string |
A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók. |
details |
Cloud |
A hibával kapcsolatos további részletek listája. |
message |
string |
A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre. |
target |
string |
Az adott hiba célja. Például a hibás tulajdonság neve. |
EffectiveNetworkSecurityGroup
Érvényes hálózati biztonsági csoport.
Name | Típus | Description |
---|---|---|
association |
Effective |
Társított erőforrások. |
effectiveSecurityRules |
Effective |
A hatályos biztonsági szabályok gyűjteménye. |
networkSecurityGroup |
Sub |
Az alkalmazott hálózati biztonsági csoport azonosítója. |
tagMap |
object |
Címkék leképezése a címkében szereplő IP-címek listájára. |
EffectiveNetworkSecurityGroupAssociation
Az érvényes hálózati biztonsági csoport társítása.
Name | Típus | Description |
---|---|---|
networkInterface |
Sub |
A hálózati adapter azonosítója, ha hozzá van rendelve. |
networkManager |
Sub |
Az Azure-hálózatkezelő azonosítója, ha hozzá van rendelve. |
subnet |
Sub |
Az alhálózat azonosítója, ha hozzá van rendelve. |
EffectiveNetworkSecurityGroupListResult
Válasz az érvényes hálózati biztonsági csoportok API-szolgáltatáshívásainak listázásakor.
Name | Típus | Description |
---|---|---|
nextLink |
string |
A következő találatkészlet lekéréséhez tartozó URL-cím. |
value |
Effective |
A hatályos hálózati biztonsági csoportok listája. |
EffectiveNetworkSecurityRule
Érvényes hálózati biztonsági szabályok.
Name | Típus | Description |
---|---|---|
access |
Security |
Azt jelzi, hogy a hálózati forgalom engedélyezve van-e vagy megtagadva. |
destinationAddressPrefix |
string |
A célcím előtagja. |
destinationAddressPrefixes |
string[] |
A célcímelőtagok. A várt értékek közé tartoznak a CIDR IP-tartományok, az alapértelmezett címkék (VirtualNetwork, AzureLoadBalancer, internet), a rendszercímkék és a csillag (*). |
destinationPortRange |
string |
A célport vagy tartomány. |
destinationPortRanges |
string[] |
A célporttartományok. A várt értékek közé tartozik egy 0 és 65535 közötti egész szám, egy "-" elválasztójelet (például 100-400) vagy csillagot (*) használó tartomány. |
direction |
Security |
A szabály iránya. |
expandedDestinationAddressPrefix |
string[] |
Bővített célcímelőtag. |
expandedSourceAddressPrefix |
string[] |
A kibontott forráscímelőtag. |
name |
string |
A felhasználó által megadott biztonsági szabály neve (ha a felhasználó hozta létre). |
priority |
integer |
A szabály prioritása. |
protocol |
Effective |
Arra a hálózati protokollra vonatkozik, amelyre ez a szabály vonatkozik. |
sourceAddressPrefix |
string |
A forráscím előtagja. |
sourceAddressPrefixes |
string[] |
A forráscím előtagja. A várt értékek közé tartoznak a CIDR IP-tartományok, az alapértelmezett címkék (VirtualNetwork, AzureLoadBalancer, internet), a rendszercímkék és a csillag (*). |
sourcePortRange |
string |
A forrásport vagy tartomány. |
sourcePortRanges |
string[] |
A forrásporttartományok. A várt értékek közé tartozik egy 0 és 65535 közötti egész szám, egy "-" elválasztójelet (például 100-400) vagy csillagot (*) használó tartomány. |
EffectiveSecurityRuleProtocol
Arra a hálózati protokollra vonatkozik, amelyre ez a szabály vonatkozik.
Name | Típus | Description |
---|---|---|
All |
string |
|
Tcp |
string |
|
Udp |
string |
SecurityRuleAccess
Azt jelzi, hogy a hálózati forgalom engedélyezve van-e vagy megtagadva.
Name | Típus | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
SecurityRuleDirection
A szabály iránya. Az irány határozza meg, hogy a rendszer kiértékeli-e a szabályt a bejövő vagy kimenő forgalomon.
Name | Típus | Description |
---|---|---|
Inbound |
string |
|
Outbound |
string |
SubResource
Hivatkozás másik alforrásra.
Name | Típus | Description |
---|---|---|
id |
string |
Erőforrás-azonosító. |