User Rules - Create Or Update

ユーザールールを作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityUserConfigurations/{configurationName}/ruleCollections/{ruleCollectionName}/rules/{ruleName}?api-version=2021-02-01-preview

URI パラメーター

Name In Required Type Description
configurationName
path True
  • string

ネットワークマネージャーのセキュリティ構成の名前。

networkManagerName
path True
  • string

ネットワークマネージャーの名前。

resourceGroupName
path True
  • string

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

ruleCollectionName
path True
  • string

ネットワークマネージャーのセキュリティ構成規則のコレクションの名前。

ruleName
path True
  • string

ルールの名前です。

subscriptionId
path True
  • string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプションの資格情報。 サブスクリプション ID は、全ての修理依頼についてURI の一部を生じさせます。

api-version
query True
  • string

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

要求本文

要求本文は、次のいずれかの可能性があります。

Name Description
DefaultUserRule

ネットワークセキュリティの既定のユーザールール。

UserRule

ネットワークセキュリティユーザールール。

DefaultUserRule

ネットワークセキュリティの既定のユーザールール。

Name Required Type Description
kind True string:
  • Default

規則がカスタムか既定か。

properties.flag
  • string

既定のルールフラグ。

UserRule

ネットワークセキュリティユーザールール。

Name Required Type Description
kind True string:
  • Custom

規則がカスタムか既定か。

properties.direction True

トラフィックが受信または送信の規則に一致したかどうかを示します。

properties.protocol True

この規則が適用されるネットワーク プロトコル。

properties.description
  • string

この規則の説明。

properties.destinationPortRanges
  • string[]

宛先ポート範囲。

properties.destinations

宛先アドレスのプレフィックス。 CIDR または宛先の IP 範囲。

properties.displayName
  • string

ルールのフレンドリ名。

properties.sourcePortRanges
  • string[]

ソースポート範囲。

properties.sources

CIDR またはソース IP の範囲。

応答

Name Type Description
200 OK BaseUserRule:

更新されたルール

201 Created BaseUserRule:

作成されたルール

Other Status Codes

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

セキュリティ

azure_auth

OAuth2 Flow を Azure Active Directory します。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation ユーザーアカウントの権限を借用する

Create a default user rule
Create a user rule

Create a default user rule

Sample Request

PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityUserConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection/rules/SampleDefaultUserRule?api-version=2021-02-01-preview
{
  "kind": "Default",
  "properties": {
    "flag": "AllowVnetInbound"
  }
}

Sample Response

{
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/SecurityUserConfigurations/Policy1/ruleCollections/testRuleCollection/rules/SampleUserRule",
  "type": "Microsoft.Network/networkManagers/securityUserConfigurations/ruleCollections/rules",
  "name": "SampleDefaultUserRule",
  "kind": "Default",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "flag": "AllowVnetInbound",
    "description": "Sample Default User Rule",
    "protocol": "Tcp",
    "sources": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "destinations": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "sourcePortRanges": [
      "0-65535"
    ],
    "destinationPortRanges": [
      "22"
    ],
    "direction": "Inbound",
    "provisioningState": "Succeeded"
  }
}
{
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityUserConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection/rules/SampleDefaultUserRule",
  "type": "Microsoft.Network/networkManagers/securityUserConfigurations/ruleCollections/rules",
  "name": "SampleDefaultUserRule",
  "kind": "Default",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "flag": "AllowVnetInbound",
    "description": "Sample User Rule",
    "protocol": "Tcp",
    "sources": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "destinations": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "sourcePortRanges": [
      "0-65535"
    ],
    "destinationPortRanges": [
      "22"
    ],
    "direction": "Inbound",
    "provisioningState": "Succeeded"
  }
}

Create a user rule

Sample Request

PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityUserConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection/rules/SampleUserRule?api-version=2021-02-01-preview
{
  "kind": "Custom",
  "properties": {
    "description": "Sample User Rule",
    "protocol": "Tcp",
    "sources": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "destinations": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "sourcePortRanges": [
      "0-65535"
    ],
    "destinationPortRanges": [
      "22"
    ],
    "direction": "Inbound"
  }
}

Sample Response

{
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/SecurityUserConfigurations/Policy1/ruleCollections/testRuleCollection/rules/SampleUserRule",
  "type": "Microsoft.Network/networkManagers/SecurityUserConfigurations/ruleCollections/rules",
  "name": "SampleUserRule",
  "kind": "Custom",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "Sample User Rule",
    "protocol": "Tcp",
    "sources": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "destinations": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "sourcePortRanges": [
      "0-65535"
    ],
    "destinationPortRanges": [
      "22"
    ],
    "direction": "Inbound",
    "provisioningState": "Succeeded"
  }
}
{
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityUserConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection/rules/SampleUserRule",
  "type": "Microsoft.Network/networkManagers/SecurityUserConfigurations/ruleCollections/rules",
  "name": "SampleUserRule",
  "kind": "Custom",
  "systemData": {
    "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "createdByType": "User",
    "createdAt": "2021-01-11T18:52:27Z",
    "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-01-11T18:52:27Z"
  },
  "properties": {
    "description": "Sample User Rule",
    "protocol": "Tcp",
    "sources": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "destinations": [
      {
        "addressPrefixType": "IPPrefix",
        "addressPrefix": "*"
      }
    ],
    "sourcePortRanges": [
      "0-65535"
    ],
    "destinationPortRanges": [
      "22"
    ],
    "direction": "Inbound",
    "provisioningState": "Succeeded"
  }
}

定義

AddressPrefixItem

アドレスプレフィックス項目。

AddressPrefixType

アドレスプレフィックスの種類。

CloudError

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

CloudErrorBody

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

createdByType

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

DefaultUserRule

ネットワークセキュリティの既定のユーザールール。

ProvisioningState

現在のプロビジョニング状態。

SecurityConfigurationRuleDirection

ルールの方向。 方向は、受信トラフィックまたは送信トラフィックでルールを評価するかどうかを指定します。

SecurityConfigurationRuleProtocol

この規則が適用されるネットワーク プロトコル。

SystemData

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

UserRule

ネットワークセキュリティユーザールール。

AddressPrefixItem

アドレスプレフィックス項目。

Name Type Description
addressPrefix
  • string

アドレスプレフィックス。

addressPrefixType

アドレスプレフィックスの種類。

AddressPrefixType

アドレスプレフィックスの種類。

Name Type Description
IPPrefix
  • string
ServiceTag
  • string

CloudError

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

Name Type Description
error

クラウドエラーの本文。

CloudErrorBody

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

Name Type Description
code
  • string

エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。

details

エラーに関する追加情報の一覧。

message
  • string

エラーを説明するメッセージ。ユーザーインターフェイスに表示するのに適しています。

target
  • string

特定のエラーの対象。 たとえば、エラーのプロパティの名前です。

createdByType

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

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DefaultUserRule

ネットワークセキュリティの既定のユーザールール。

Name Type Description
etag
  • string

リソースが更新されるたびに変更される、一意の読み取り専用の文字列。

id
  • string

リソースの ID

kind string:
  • Default

規則がカスタムか既定か。

name
  • string

リソース名。

properties.description
  • string

この規則の説明。 文字数は140文字に制限されています。

properties.destinationPortRanges
  • string[]

宛先ポート範囲。

properties.destinations

宛先アドレスのプレフィックス。 CIDR または宛先の IP 範囲。

properties.direction

トラフィックが受信または送信の規則に一致したかどうかを示します。

properties.displayName
  • string

ルールのフレンドリ名。

properties.flag
  • string

既定のルールフラグ。

properties.protocol

この規則が適用されるネットワーク プロトコル。

properties.provisioningState

セキュリティ構成ユーザールールリソースのプロビジョニングの状態。

properties.sourcePortRanges
  • string[]

ソースポート範囲。

properties.sources

CIDR またはソース IP の範囲。

systemData

このリソースに関連付けられているシステムメタデータ。

type
  • string

リソースの種類。

ProvisioningState

現在のプロビジョニング状態。

Name Type Description
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

SecurityConfigurationRuleDirection

ルールの方向。 方向は、受信トラフィックまたは送信トラフィックでルールを評価するかどうかを指定します。

Name Type Description
Inbound
  • string
Outbound
  • string

SecurityConfigurationRuleProtocol

この規則が適用されるネットワーク プロトコル。

Name Type Description
Ah
  • string
Any
  • string
Esp
  • string
Icmp
  • string
Tcp
  • string
Udp
  • string

SystemData

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

Name Type Description
createdAt
  • string

リソース作成のタイムスタンプ (UTC)。

createdBy
  • string

リソースを作成した id。

createdByType

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

lastModifiedAt
  • string

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

lastModifiedBy
  • string

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

lastModifiedByType

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

UserRule

ネットワークセキュリティユーザールール。

Name Type Description
etag
  • string

リソースが更新されるたびに変更される、一意の読み取り専用の文字列。

id
  • string

リソースの ID

kind string:
  • Custom

規則がカスタムか既定か。

name
  • string

リソース名。

properties.description
  • string

この規則の説明。

properties.destinationPortRanges
  • string[]

宛先ポート範囲。

properties.destinations

宛先アドレスのプレフィックス。 CIDR または宛先の IP 範囲。

properties.direction

トラフィックが受信または送信の規則に一致したかどうかを示します。

properties.displayName
  • string

ルールのフレンドリ名。

properties.protocol

この規則が適用されるネットワーク プロトコル。

properties.provisioningState

セキュリティ構成ユーザールールリソースのプロビジョニングの状態。

properties.sourcePortRanges
  • string[]

ソースポート範囲。

properties.sources

CIDR またはソース IP の範囲。

systemData

このリソースに関連付けられているシステムメタデータ。

type
  • string

リソースの種類。