Network Security Perimeter Access Rules - Create Or Update
네트워크 액세스 규칙을 만들거나 업데이트합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}/accessRules/{accessRuleName}?api-version=2025-03-01
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
access
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
NSP 액세스 규칙의 이름입니다. |
|
network
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
네트워크 보안 경계의 이름입니다. |
|
profile
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
NSP 프로필의 이름입니다. |
|
resource
|
path | True |
string |
리소스 그룹의 이름입니다. |
|
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다. |
|
api-version
|
query | True |
string |
클라이언트 API 버전. |
요청 본문
| Name | 형식 | Description |
|---|---|---|
| properties.addressPrefixes |
string[] |
인바운드 주소 접두사(IPv4/IPv6) |
| properties.direction |
액세스 규칙이 인바운드/아웃바운드인지 여부를 지정하는 방향입니다. |
|
| properties.emailAddresses |
string[] |
이메일 주소 형식의 아웃바운드 규칙입니다. 이 액세스 규칙 유형은 현재 사용할 수 없습니다. |
| properties.fullyQualifiedDomainNames |
string[] |
정규화된 도메인 이름 형식의 아웃바운드 규칙입니다. |
| properties.phoneNumbers |
string[] |
전화 번호 형식의 아웃바운드 규칙입니다. 이 액세스 규칙 유형은 현재 사용할 수 없습니다. |
| properties.serviceTags |
string[] |
서비스 태그 형식의 인바운드 규칙입니다. 이 액세스 규칙 유형은 현재 사용할 수 없습니다. |
| properties.subscriptions |
구독 ID 목록 |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
업데이트됨 - 기존 액세스 규칙이 업데이트됩니다. 리소스를 반환합니다. |
|
| 201 Created |
만들기 - 생성된 NspAccessRule 리소스를 반환합니다. |
|
| Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
| Name | Description |
|---|---|
| user_impersonation | 사용자 계정 가장 |
예제
NspAccessRulePut
샘플 요청
PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1?api-version=2025-03-01
{
"properties": {
"direction": "Inbound",
"addressPrefixes": [
"10.11.0.0/16",
"10.10.1.0/24"
]
}
}
샘플 응답
{
"name": "accessRule1",
"id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
"type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
"properties": {
"provisioningState": "Succeeded",
"direction": "Inbound",
"addressPrefixes": [
"10.11.0.0/16",
"10.10.1.0/24"
],
"fullyQualifiedDomainNames": [],
"subscriptions": [],
"networkSecurityPerimeters": [],
"emailAddresses": [],
"phoneNumbers": [],
"serviceTags": []
},
"systemData": {
"createdBy": "user",
"createdByType": "User",
"createdAt": "2024-02-07T18:07:36.3446713Z",
"lastModifiedBy": "user",
"lastModifiedByType": "User",
"lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
}
}
{
"name": "accessRule1",
"id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
"type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
"properties": {
"provisioningState": "Succeeded",
"direction": "Inbound",
"addressPrefixes": [
"10.11.0.0/16",
"10.10.1.0/24"
],
"fullyQualifiedDomainNames": [],
"subscriptions": [],
"networkSecurityPerimeters": [],
"emailAddresses": [],
"phoneNumbers": [],
"serviceTags": []
},
"systemData": {
"createdBy": "user",
"createdByType": "User",
"createdAt": "2024-02-07T18:07:36.3446713Z",
"lastModifiedBy": "user",
"lastModifiedByType": "User",
"lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
}
}
정의
| Name | Description |
|---|---|
|
Access |
액세스 규칙이 인바운드/아웃바운드인지 여부를 지정하는 방향입니다. |
|
Cloud |
서비스의 오류 응답입니다. |
|
Cloud |
서비스의 오류 응답입니다. |
|
created |
리소스를 만든 ID의 형식입니다. |
|
Nsp |
NSP 액세스 규칙 리소스 |
|
nsp |
범위 할당 리소스의 프로비저닝 상태입니다. |
|
Perimeter |
|
|
Subscription |
|
|
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
AccessRuleDirection
액세스 규칙이 인바운드/아웃바운드인지 여부를 지정하는 방향입니다.
| 값 | Description |
|---|---|
| Inbound | |
| Outbound |
CloudError
서비스의 오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| error |
클라우드 오류 본문. |
CloudErrorBody
서비스의 오류 응답입니다.
| Name | 형식 | Description |
|---|---|---|
| code |
string |
오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다. |
| details |
오류에 대한 추가 세부 정보 목록입니다. |
|
| message |
string |
사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다. |
| target |
string |
특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다. |
createdByType
리소스를 만든 ID의 형식입니다.
| 값 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
NspAccessRule
NSP 액세스 규칙 리소스
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
리소스의 이름 |
| properties.addressPrefixes |
string[] |
인바운드 주소 접두사(IPv4/IPv6) |
| properties.direction |
액세스 규칙이 인바운드/아웃바운드인지 여부를 지정하는 방향입니다. |
|
| properties.emailAddresses |
string[] |
이메일 주소 형식의 아웃바운드 규칙입니다. 이 액세스 규칙 유형은 현재 사용할 수 없습니다. |
| properties.fullyQualifiedDomainNames |
string[] |
정규화된 도메인 이름 형식의 아웃바운드 규칙입니다. |
| properties.networkSecurityPerimeters |
경계 ID로 지정된 규칙입니다. |
|
| properties.phoneNumbers |
string[] |
전화 번호 형식의 아웃바운드 규칙입니다. 이 액세스 규칙 유형은 현재 사용할 수 없습니다. |
| properties.provisioningState |
범위 할당 리소스의 프로비저닝 상태입니다. |
|
| properties.serviceTags |
string[] |
서비스 태그 형식의 인바운드 규칙입니다. 이 액세스 규칙 유형은 현재 사용할 수 없습니다. |
| properties.subscriptions |
구독 ID 목록 |
|
| systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
|
| type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
nspProvisioningState
범위 할당 리소스의 프로비저닝 상태입니다.
| 값 | Description |
|---|---|
| Succeeded | |
| Creating | |
| Updating | |
| Deleting | |
| Accepted | |
| Failed |
PerimeterBasedAccessRule
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
ARM ID 형식의 NSP ID입니다. |
| location |
string |
제공된 NSP의 위치입니다. |
| perimeterGuid |
string |
제공된 NSP의 리소스 guid입니다. |
SubscriptionId
| Name | 형식 | Description |
|---|---|---|
| id |
string (arm-id) |
ARM ID 형식의 구독 ID입니다. |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
| Name | 형식 | Description |
|---|---|---|
| createdAt |
string (date-time) |
리소스 만들기의 타임스탬프(UTC)입니다. |
| createdBy |
string |
리소스를 만든 ID입니다. |
| createdByType |
리소스를 만든 ID의 형식입니다. |
|
| lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
| lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
| lastModifiedByType |
리소스를 마지막으로 수정한 ID의 형식입니다. |