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 パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
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 のバージョン。 |
要求本文
| 名前 | 型 | 説明 |
|---|---|---|
| properties.addressPrefixes |
string[] |
受信アドレス プレフィックス (IPv4/IPv6) |
| properties.direction |
アクセス規則が受信/送信であるかどうかを指定する方向。 |
|
| properties.emailAddresses |
string[] |
電子メール アドレス形式の送信規則。 このアクセス規則の種類は、現在使用できません。 |
| properties.fullyQualifiedDomainNames |
string[] |
完全修飾ドメイン名形式の送信規則。 |
| properties.phoneNumbers |
string[] |
電話番号形式の送信規則。 このアクセス規則の種類は、現在使用できません。 |
| properties.serviceTags |
string[] |
サービス タグ型の受信規則。 このアクセス規則の種類は、現在使用できません。 |
| properties.subscriptions |
サブスクリプション ID の一覧 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
更新済み - 既存のアクセス ルールが更新されます。 リソースを返します。 |
|
| 201 Created |
作成 - 作成されたNspAccessRuleリソースを返します。 |
|
| Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| 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"
}
}
定義
| 名前 | 説明 |
|---|---|
|
Access |
アクセス規則が受信/送信であるかどうかを指定する方向。 |
|
Cloud |
サービスからのエラー応答。 |
|
Cloud |
サービスからのエラー応答。 |
|
created |
リソースを作成した ID の種類。 |
|
Nsp |
NSP アクセス規則リソース |
|
nsp |
スコープ割り当てリソースのプロビジョニング状態。 |
|
Perimeter |
|
|
Subscription |
|
|
system |
リソースの作成と最後の変更に関連するメタデータ。 |
AccessRuleDirection
アクセス規則が受信/送信であるかどうかを指定する方向。
| 値 | 説明 |
|---|---|
| Inbound | |
| Outbound |
CloudError
サービスからのエラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| error |
クラウド エラー本文。 |
CloudErrorBody
サービスからのエラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
| details |
エラーに関する追加の詳細のリスト。 |
|
| message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
| target |
string |
特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。 |
createdByType
リソースを作成した ID の種類。
| 値 | 説明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
NspAccessRule
NSP アクセス規則リソース
| 名前 | 型 | 説明 |
|---|---|---|
| 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
スコープ割り当てリソースのプロビジョニング状態。
| 値 | 説明 |
|---|---|
| Succeeded | |
| Creating | |
| Updating | |
| Deleting | |
| Accepted | |
| Failed |
PerimeterBasedAccessRule
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (arm-id) |
ARM ID 形式の NSP ID。 |
| location |
string |
提供されたNSPの場所。 |
| perimeterGuid |
string |
提供される NSP のリソース guid。 |
SubscriptionId
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (arm-id) |
ARM ID 形式のサブスクリプション ID。 |
systemData
リソースの作成と最後の変更に関連するメタデータ。
| 名前 | 型 | 説明 |
|---|---|---|
| createdAt |
string (date-time) |
リソース作成のタイムスタンプ (UTC)。 |
| createdBy |
string |
リソースを作成した ID。 |
| createdByType |
リソースを作成した ID の種類。 |
|
| lastModifiedAt |
string (date-time) |
リソースの最終変更のタイムスタンプ (UTC) |
| lastModifiedBy |
string |
リソースを最後に変更した ID。 |
| lastModifiedByType |
リソースを最後に変更した ID の種類。 |