次の方法で共有


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 パラメーター

名前 / 必須 説明
accessRuleName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

NSP アクセス規則の名前。

networkSecurityPerimeterName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

ネットワーク セキュリティ境界の名前。

profileName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

NSP プロファイルの名前。

resourceGroupName
path True

string

リソース グループの名前。

subscriptionId
path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。

api-version
query True

string

クライアント API のバージョン。

要求本文

名前 説明
properties.addressPrefixes

string[]

受信アドレス プレフィックス (IPv4/IPv6)

properties.direction

AccessRuleDirection

アクセス規則が受信/送信であるかどうかを指定する方向。

properties.emailAddresses

string[]

電子メール アドレス形式の送信規則。 このアクセス規則の種類は、現在使用できません。

properties.fullyQualifiedDomainNames

string[]

完全修飾ドメイン名形式の送信規則。

properties.phoneNumbers

string[]

電話番号形式の送信規則。 このアクセス規則の種類は、現在使用できません。

properties.serviceTags

string[]

サービス タグ型の受信規則。 このアクセス規則の種類は、現在使用できません。

properties.subscriptions

SubscriptionId[]

サブスクリプション ID の一覧

応答

名前 説明
200 OK

NspAccessRule

更新済み - 既存のアクセス ルールが更新されます。 リソースを返します。

201 Created

NspAccessRule

作成 - 作成されたNspAccessRuleリソースを返します。

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

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"
  }
}

定義

名前 説明
AccessRuleDirection

アクセス規則が受信/送信であるかどうかを指定する方向。

CloudError

サービスからのエラー応答。

CloudErrorBody

サービスからのエラー応答。

createdByType

リソースを作成した ID の種類。

NspAccessRule

NSP アクセス規則リソース

nspProvisioningState

スコープ割り当てリソースのプロビジョニング状態。

PerimeterBasedAccessRule
SubscriptionId
systemData

リソースの作成と最後の変更に関連するメタデータ。

AccessRuleDirection

アクセス規則が受信/送信であるかどうかを指定する方向。

説明
Inbound
Outbound

CloudError

サービスからのエラー応答。

名前 説明
error

CloudErrorBody

クラウド エラー本文。

CloudErrorBody

サービスからのエラー応答。

名前 説明
code

string

エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。

details

CloudErrorBody[]

エラーに関する追加の詳細のリスト。

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

AccessRuleDirection

アクセス規則が受信/送信であるかどうかを指定する方向。

properties.emailAddresses

string[]

電子メール アドレス形式の送信規則。 このアクセス規則の種類は、現在使用できません。

properties.fullyQualifiedDomainNames

string[]

完全修飾ドメイン名形式の送信規則。

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

境界 ID で指定されたルール。

properties.phoneNumbers

string[]

電話番号形式の送信規則。 このアクセス規則の種類は、現在使用できません。

properties.provisioningState

nspProvisioningState

スコープ割り当てリソースのプロビジョニング状態。

properties.serviceTags

string[]

サービス タグ型の受信規則。 このアクセス規則の種類は、現在使用できません。

properties.subscriptions

SubscriptionId[]

サブスクリプション ID の一覧

systemData

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

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。