Microsoft. Network Network Managers/securityAdminConfigurations/ruleCollections/rules 2023-09-01

Définition de ressource Bicep

Le type de ressource networkManagers/securityAdminConfigurations/ruleCollections/rules peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Exemples d’utilisation

Exemples Bicep

Exemple de base de déploiement de la règle d’administration du gestionnaire de réseau.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource networkManager 'Microsoft.Network/networkManagers@2022-09-01' = {
  name: resourceName
  location: location
  properties: {
    description: ''
    networkManagerScopeAccesses: [
      'SecurityAdmin'
    ]
    networkManagerScopes: {
      managementGroups: []
      subscriptions: [
        subscription().id
      ]
    }
  }
}

resource securityAdminConfiguration 'Microsoft.Network/networkManagers/securityAdminConfigurations@2022-09-01' = {
  name: resourceName
  parent: networkManager
  properties: {
    applyOnNetworkIntentPolicyBasedServices: []
  }
}

resource ruleCollection 'Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections@2022-09-01' = {
  name: resourceName
  parent: securityAdminConfiguration
  properties: {
    appliesToGroups: [
      {
        networkGroupId: networkGroup.id
      }
    ]
  }
}

resource rule 'Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules@2022-09-01' = {
  name: resourceName
  parent: ruleCollection
  kind: 'Custom'
  properties: {
    access: 'Deny'
    destinationPortRanges: []
    destinations: []
    direction: 'Outbound'
    priority: 1
    protocol: 'Tcp'
    sourcePortRanges: []
    sources: []
  }
}

resource networkGroup 'Microsoft.Network/networkManagers/networkGroups@2022-09-01' = {
  name: resourceName
  parent: networkManager
  properties: {}
}

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
Gestionnaire réseau - Configuration de l’administrateur sécurité - Coll de règles - Règle AVM Child Module pour Network Manager - Configuration de l’administration de la sécurité - Rule Coll - Rule

Format de ressource

Pour créer une ressource Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules@2023-09-01' = {
  name: 'string'
  kind: 'string'
  // For remaining properties, see Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules objects
}

Objets Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules

Définissez le type propriété pour spécifier le type d’objet.

Pour personnalisé, utilisez :

{
  kind: 'Custom'
  properties: {
    access: 'string'
    description: 'string'
    destinationPortRanges: [
      'string'
    ]
    destinations: [
      {
        addressPrefix: 'string'
        addressPrefixType: 'string'
      }
    ]
    direction: 'string'
    priority: int
    protocol: 'string'
    sourcePortRanges: [
      'string'
    ]
    sources: [
      {
        addressPrefix: 'string'
        addressPrefixType: 'string'
      }
    ]
  }
}

Pour par défaut, utilisez :

{
  kind: 'Default'
  properties: {
    flag: 'string'
  }
}

Valeurs de propriété

Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules

Nom Descriptif Valeur
gentil Défini sur « Personnalisé » pour le type AdminRule. Défini sur « Default » pour le type DefaultAdminRule. 'Coutume'
'Default' (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : networkManagers/securityAdminConfigurations/ruleCollections

AddressPrefixItem

Nom Descriptif Valeur
adressePréfixe Préfixe d’adresse. corde
addressPrefixType Type de préfixe d’adresse. « IPPrefix »
'ServiceTag'

AdminPropertiesFormat

Nom Descriptif Valeur
accès Indique l’accès autorisé pour cette règle particulière 'Autoriser'
« Toujours permettre »
'Deny' (obligatoire)
descriptif Description de cette règle. Limité à 140 chars. corde
destinationPortRanges Plages de ports de destination. chaîne de caractères[]
Destinations Préfixes d’adresse de destination. PLAGES d’adresses IP CIDR ou de destination. AddressPrefixItem[]
direction Indique si le trafic correspond à la règle entrante ou sortante. 'Entrant'
'Sortant' (obligatoire)
priorité Priorité de la règle. La valeur peut être comprise entre 1 et 4096. Le numéro de priorité doit être unique pour chaque règle de la collection. Plus le numéro de priorité est inférieur, plus la priorité de la règle est élevée. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4096 (obligatoire)
protocole Protocole réseau auquel cette règle s’applique. « Ah ! »
'N’importe lequel''
'Esp'
« ICMP »
'Tcp'
'Udp' (obligatoire)
sourcePortRanges Plages de ports sources. chaîne de caractères[]
Sources Plages d’adresses IP CIDR ou sources. AddressPrefixItem[]

Règle d’administration

Nom Descriptif Valeur
gentil Indique si la règle est personnalisée ou par défaut. 'Custom' (obligatoire)
Propriétés Indique les propriétés de la règle d’administration de sécurité AdminPropertiesFormat

DefaultAdminPropertiesFormat

Nom Descriptif Valeur
drapeau Indicateur de règle par défaut. corde

DefaultAdminRule

Nom Descriptif Valeur
gentil Indique si la règle est personnalisée ou par défaut. 'Default' (obligatoire)
Propriétés Indique les propriétés de la règle d’administration de sécurité DefaultAdminPropertiesFormat

Définition de ressource de modèle ARM

Le type de ressource networkManagers/securityAdminConfigurations/ruleCollections/rules peut être déployé avec des opérations qui ciblent :

Exemples d’utilisation

Format de ressource

Pour créer une ressource Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules, ajoutez le code JSON suivant à votre modèle.

{
  "name": "string",
  "kind": "string"
  // For remaining properties, see Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules objects
}

Objets Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules

Définissez le type propriété pour spécifier le type d’objet.

Pour personnalisé, utilisez :

{
  "kind": "Custom",
  "properties": {
    "access": "string",
    "description": "string",
    "destinationPortRanges": [ "string" ],
    "destinations": [
      {
        "addressPrefix": "string",
        "addressPrefixType": "string"
      }
    ],
    "direction": "string",
    "priority": "int",
    "protocol": "string",
    "sourcePortRanges": [ "string" ],
    "sources": [
      {
        "addressPrefix": "string",
        "addressPrefixType": "string"
      }
    ]
  }
}

Pour par défaut, utilisez :

{
  "kind": "Default",
  "properties": {
    "flag": "string"
  }
}

Valeurs de propriété

Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules

Nom Descriptif Valeur
apiVersion Version de l’API '2023-09-01'
gentil Défini sur « Personnalisé » pour le type AdminRule. Défini sur « Default » pour le type DefaultAdminRule. 'Coutume'
'Default' (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
type Type de ressource 'Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules'

AddressPrefixItem

Nom Descriptif Valeur
adressePréfixe Préfixe d’adresse. corde
addressPrefixType Type de préfixe d’adresse. « IPPrefix »
'ServiceTag'

AdminPropertiesFormat

Nom Descriptif Valeur
accès Indique l’accès autorisé pour cette règle particulière 'Autoriser'
« Toujours permettre »
'Deny' (obligatoire)
descriptif Description de cette règle. Limité à 140 chars. corde
destinationPortRanges Plages de ports de destination. chaîne de caractères[]
Destinations Préfixes d’adresse de destination. PLAGES d’adresses IP CIDR ou de destination. AddressPrefixItem[]
direction Indique si le trafic correspond à la règle entrante ou sortante. 'Entrant'
'Sortant' (obligatoire)
priorité Priorité de la règle. La valeur peut être comprise entre 1 et 4096. Le numéro de priorité doit être unique pour chaque règle de la collection. Plus le numéro de priorité est inférieur, plus la priorité de la règle est élevée. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4096 (obligatoire)
protocole Protocole réseau auquel cette règle s’applique. « Ah ! »
'N’importe lequel''
'Esp'
« ICMP »
'Tcp'
'Udp' (obligatoire)
sourcePortRanges Plages de ports sources. chaîne de caractères[]
Sources Plages d’adresses IP CIDR ou sources. AddressPrefixItem[]

Règle d’administration

Nom Descriptif Valeur
gentil Indique si la règle est personnalisée ou par défaut. 'Custom' (obligatoire)
Propriétés Indique les propriétés de la règle d’administration de sécurité AdminPropertiesFormat

DefaultAdminPropertiesFormat

Nom Descriptif Valeur
drapeau Indicateur de règle par défaut. corde

DefaultAdminRule

Nom Descriptif Valeur
gentil Indique si la règle est personnalisée ou par défaut. 'Default' (obligatoire)
Propriétés Indique les propriétés de la règle d’administration de sécurité DefaultAdminPropertiesFormat

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource networkManagers/securityAdminConfigurations/ruleCollections/rules peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources Pour une liste des propriétés modifiées dans chaque version d’API, voir journal des modifications.

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement de la règle d’administration du gestionnaire de réseau.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

data "azurerm_client_config" "current" {
}

data "azapi_resource" "subscription" {
  type                   = "Microsoft.Resources/subscriptions@2021-01-01"
  resource_id            = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  response_export_values = ["*"]
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "networkManager" {
  type      = "Microsoft.Network/networkManagers@2022-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      description = ""
      networkManagerScopeAccesses = [
        "SecurityAdmin",
      ]
      networkManagerScopes = {
        managementGroups = [
        ]
        subscriptions = [
          data.azapi_resource.subscription.id,
        ]
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "securityAdminConfiguration" {
  type      = "Microsoft.Network/networkManagers/securityAdminConfigurations@2022-09-01"
  parent_id = azapi_resource.networkManager.id
  name      = var.resource_name
  body = {
    properties = {
      applyOnNetworkIntentPolicyBasedServices = []
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "networkGroup" {
  type      = "Microsoft.Network/networkManagers/networkGroups@2022-09-01"
  parent_id = azapi_resource.networkManager.id
  name      = var.resource_name
  body = {
    properties = {
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "ruleCollection" {
  type      = "Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections@2022-09-01"
  parent_id = azapi_resource.securityAdminConfiguration.id
  name      = var.resource_name
  body = {
    properties = {
      appliesToGroups = [
        {
          networkGroupId = azapi_resource.networkGroup.id
        },
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "rule" {
  type      = "Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules@2022-09-01"
  parent_id = azapi_resource.ruleCollection.id
  name      = var.resource_name
  body = {
    kind = "Custom"
    properties = {
      access                = "Deny"
      destinationPortRanges = []
      destinations          = []
      direction             = "Outbound"
      priority              = 1
      protocol              = "Tcp"
      sourcePortRanges      = []
      sources               = []
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Format de ressource

Pour créer une ressource Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  name = "string"
  kind = "string"
  // For remaining properties, see Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules objects
}

Objets Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules

Définissez le type propriété pour spécifier le type d’objet.

Pour personnalisé, utilisez :

{
  kind = "Custom"
  properties = {
    access = "string"
    description = "string"
    destinationPortRanges = [
      "string"
    ]
    destinations = [
      {
        addressPrefix = "string"
        addressPrefixType = "string"
      }
    ]
    direction = "string"
    priority = int
    protocol = "string"
    sourcePortRanges = [
      "string"
    ]
    sources = [
      {
        addressPrefix = "string"
        addressPrefixType = "string"
      }
    ]
  }
}

Pour par défaut, utilisez :

{
  kind = "Default"
  properties = {
    flag = "string"
  }
}

Valeurs de propriété

Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules

Nom Descriptif Valeur
gentil Défini sur « Personnalisé » pour le type AdminRule. Défini sur « Default » pour le type DefaultAdminRule. 'Coutume'
'Default' (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : networkManagers/securityAdminConfigurations/ruleCollections
type Type de ressource « Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules@2023-09-01 »

AddressPrefixItem

Nom Descriptif Valeur
adressePréfixe Préfixe d’adresse. corde
addressPrefixType Type de préfixe d’adresse. « IPPrefix »
'ServiceTag'

AdminPropertiesFormat

Nom Descriptif Valeur
accès Indique l’accès autorisé pour cette règle particulière 'Autoriser'
« Toujours permettre »
'Deny' (obligatoire)
descriptif Description de cette règle. Limité à 140 chars. corde
destinationPortRanges Plages de ports de destination. chaîne de caractères[]
Destinations Préfixes d’adresse de destination. PLAGES d’adresses IP CIDR ou de destination. AddressPrefixItem[]
direction Indique si le trafic correspond à la règle entrante ou sortante. 'Entrant'
'Sortant' (obligatoire)
priorité Priorité de la règle. La valeur peut être comprise entre 1 et 4096. Le numéro de priorité doit être unique pour chaque règle de la collection. Plus le numéro de priorité est inférieur, plus la priorité de la règle est élevée. Int

Contraintes:
Valeur minimale = 1
Valeur maximale = 4096 (obligatoire)
protocole Protocole réseau auquel cette règle s’applique. « Ah ! »
'N’importe lequel''
'Esp'
« ICMP »
'Tcp'
'Udp' (obligatoire)
sourcePortRanges Plages de ports sources. chaîne de caractères[]
Sources Plages d’adresses IP CIDR ou sources. AddressPrefixItem[]

Règle d’administration

Nom Descriptif Valeur
gentil Indique si la règle est personnalisée ou par défaut. 'Custom' (obligatoire)
Propriétés Indique les propriétés de la règle d’administration de sécurité AdminPropertiesFormat

DefaultAdminPropertiesFormat

Nom Descriptif Valeur
drapeau Indicateur de règle par défaut. corde

DefaultAdminRule

Nom Descriptif Valeur
gentil Indique si la règle est personnalisée ou par défaut. 'Default' (obligatoire)
Propriétés Indique les propriétés de la règle d’administration de sécurité DefaultAdminPropertiesFormat