Network Interfaces - List Effective Network Security Groups
네트워크 인터페이스에 적용된 모든 네트워크 보안 그룹을 가져옵니다.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}/effectiveNetworkSecurityGroups?api-version=2023-09-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
network
|
path | True |
string |
네트워크 인터페이스의 이름입니다. |
resource
|
path | True |
string |
리소스 그룹의 이름. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
Effective |
요청이 성공했습니다. 작업은 NetworkSecurityGroup 리소스 목록을 반환합니다. |
202 Accepted |
수락되고 작업이 비동기적으로 완료됩니다. |
|
Other Status Codes |
Cloud |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
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 | 사용자 계정 가장 |
예제
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
정의
Name | Description |
---|---|
Cloud |
서비스의 오류 응답입니다. |
Cloud |
서비스의 오류 응답입니다. |
Effective |
효과적인 네트워크 보안 그룹입니다. |
Effective |
효과적인 네트워크 보안 그룹 연결입니다. |
Effective |
효과적인 네트워크 보안 그룹 API 서비스 호출 목록에 대한 응답입니다. |
Effective |
효과적인 네트워크 보안 규칙. |
Effective |
이 규칙이 적용되는 네트워크 프로토콜입니다. |
Security |
네트워크 트래픽이 허용되는지 아니면 거부되는지 여부입니다. |
Security |
규칙의 방향입니다. direction은 규칙을 평가할 트래픽(들어오는 트래픽 또는 나가는 트래픽)을 지정합니다. |
Sub |
다른 하위 리소스에 대한 참조입니다. |
CloudError
서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
Cloud |
클라우드 오류 본문. |
CloudErrorBody
서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다. |
details |
Cloud |
오류에 대한 추가 세부 정보 목록입니다. |
message |
string |
사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다. |
target |
string |
특정 오류의 대상입니다. 예를 들어 오류에 있는 속성의 이름입니다. |
EffectiveNetworkSecurityGroup
효과적인 네트워크 보안 그룹입니다.
Name | 형식 | Description |
---|---|---|
association |
Effective |
연결된 리소스. |
effectiveSecurityRules |
Effective |
효과적인 보안 규칙의 컬렉션입니다. |
networkSecurityGroup |
Sub |
적용되는 네트워크 보안 그룹의 ID입니다. |
tagMap |
object |
태그를 태그에 포함된 IP 주소 목록에 매핑합니다. |
EffectiveNetworkSecurityGroupAssociation
효과적인 네트워크 보안 그룹 연결입니다.
Name | 형식 | Description |
---|---|---|
networkInterface |
Sub |
할당된 경우 네트워크 인터페이스의 ID입니다. |
networkManager |
Sub |
할당된 경우 Azure 네트워크 관리자의 ID입니다. |
subnet |
Sub |
할당된 경우 서브넷의 ID입니다. |
EffectiveNetworkSecurityGroupListResult
효과적인 네트워크 보안 그룹 API 서비스 호출 목록에 대한 응답입니다.
Name | 형식 | Description |
---|---|---|
nextLink |
string |
다음 결과 집합을 가져올 URL입니다. |
value |
Effective |
효과적인 네트워크 보안 그룹의 목록입니다. |
EffectiveNetworkSecurityRule
효과적인 네트워크 보안 규칙.
Name | 형식 | Description |
---|---|---|
access |
Security |
네트워크 트래픽이 허용되는지 아니면 거부되는지 여부입니다. |
destinationAddressPrefix |
string |
대상 주소 접두사입니다. |
destinationAddressPrefixes |
string[] |
대상 주소 접두사입니다. 예상 값에는 CIDR IP 범위, 기본 태그(VirtualNetwork, AzureLoadBalancer, 인터넷), 시스템 태그 및 별표(*)가 포함됩니다. |
destinationPortRange |
string |
대상 포트 또는 범위입니다. |
destinationPortRanges |
string[] |
대상 포트 범위입니다. 예상 값에는 0에서 65535 사이의 단일 정수, 구분 기호로 '-'를 사용하는 범위(예: 100-400) 또는 별표(*)가 포함됩니다. |
direction |
Security |
규칙의 방향입니다. |
expandedDestinationAddressPrefix |
string[] |
확장된 대상 주소 접두사입니다. |
expandedSourceAddressPrefix |
string[] |
확장된 원본 주소 접두사입니다. |
name |
string |
사용자가 지정한 보안 규칙의 이름입니다(사용자가 만든 경우). |
priority |
integer |
규칙의 우선 순위입니다. |
protocol |
Effective |
이 규칙이 적용되는 네트워크 프로토콜입니다. |
sourceAddressPrefix |
string |
원본 주소 접두사입니다. |
sourceAddressPrefixes |
string[] |
원본 주소 접두사입니다. 예상 값에는 CIDR IP 범위, 기본 태그(VirtualNetwork, AzureLoadBalancer, 인터넷), 시스템 태그 및 별표(*)가 포함됩니다. |
sourcePortRange |
string |
원본 포트 또는 범위입니다. |
sourcePortRanges |
string[] |
원본 포트 범위입니다. 예상 값에는 0에서 65535 사이의 단일 정수, 구분 기호로 '-'를 사용하는 범위(예: 100-400) 또는 별표(*)가 포함됩니다. |
EffectiveSecurityRuleProtocol
이 규칙이 적용되는 네트워크 프로토콜입니다.
Name | 형식 | Description |
---|---|---|
All |
string |
|
Tcp |
string |
|
Udp |
string |
SecurityRuleAccess
네트워크 트래픽이 허용되는지 아니면 거부되는지 여부입니다.
Name | 형식 | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
SecurityRuleDirection
규칙의 방향입니다. direction은 규칙을 평가할 트래픽(들어오는 트래픽 또는 나가는 트래픽)을 지정합니다.
Name | 형식 | Description |
---|---|---|
Inbound |
string |
|
Outbound |
string |
SubResource
다른 하위 리소스에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |