Microsoft. DocumentDB mongoClusters/firewallRules 2026-06-01

Definizione della risorsa Bicep

Il tipo di risorsa mongoClusters/firewallRules può essere distribuito con operazioni destinate a:

  • Resource groups - Vedi resource group

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi di Bicep

Un esempio base di implementazione di Azure Cosmos DB per la regola firewall di MongoDB (vCore).

param resourceName string = 'acctest0001'
param location string = 'westus3'

resource mongoCluster 'Microsoft.DocumentDB/mongoClusters@2025-09-01' = {
  name: resourceName
  location: location
  properties: {
    authConfig: {
      allowedModes: [
        'MicrosoftEntraID'
      ]
    }
    compute: {
      tier: 'M40'
    }
    highAvailability: {
      targetMode: 'Disabled'
    }
    previewFeatures: [
      'ShardRebalancer'
    ]
    publicNetworkAccess: 'Enabled'
    serverVersion: '5.0'
    sharding: {
      shardCount: 1
    }
    storage: {
      sizeGb: 32
    }
  }
}

resource firewallRule 'Microsoft.DocumentDB/mongoClusters/firewallRules@2025-09-01' = {
  name: resourceName
  parent: mongoCluster
  properties: {
    endIpAddress: '0.0.0.0'
    startIpAddress: '0.0.0.0'
  }
}

Formato di risorsa

Per creare una risorsa Microsoft.DocumentDB/mongoClusters/firewallRules, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.DocumentDB/mongoClusters/firewallRules@2026-06-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    endIpAddress: 'string'
    startIpAddress: 'string'
  }
}

Valori delle proprietà

Microsoft.DocumentDB/mongoClusters/firewallRules

Name Description Value
nome Nome della risorsa string

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 80
Pattern = ^[a-zA-Z0-9][-_.a-zA-Z0-9]* (obbligatorio)
parent In Bicep, puoi specificare la risorsa genitore per una risorsa figlia. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per ulteriori informazioni, vedi Risorsa figlio esterna risorsa genitore.		 Nome simbolico per la risorsa di tipo: mongoClusters
properties Proprietà specifiche della risorsa. Proprietà FirewallRule

Proprietà FirewallRule

Name Description Value
endIpAddress Indirizzo IP finale della regola del firewall del cluster mongo. Deve essere formato IPv4. string

Vincoli:
Pattern = ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ (obbligatorio)
startIpAddress Indirizzo IP iniziale della regola del firewall del cluster mongo. Deve essere formato IPv4. string

Vincoli:
Pattern = ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ (obbligatorio)

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa mongoClusters/firewallRules può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Formato di risorsa

Per creare una risorsa Microsoft.DocumentDB/mongoClusters/firewallRules, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.DocumentDB/mongoClusters/firewallRules",
  "apiVersion": "2026-06-01",
  "name": "string",
  "properties": {
    "endIpAddress": "string",
    "startIpAddress": "string"
  }
}

Valori delle proprietà

Microsoft.DocumentDB/mongoClusters/firewallRules

Name Description Value
apiVersion Versione dell'API '2026-06-01'
nome Nome della risorsa string

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 80
Pattern = ^[a-zA-Z0-9][-_.a-zA-Z0-9]* (obbligatorio)
properties Proprietà specifiche della risorsa. Proprietà FirewallRule
type Tipo di risorsa 'Microsoft.DocumentDB/mongoClusters/firewallRules'

Proprietà FirewallRule

Name Description Value
endIpAddress Indirizzo IP finale della regola del firewall del cluster mongo. Deve essere formato IPv4. string

Vincoli:
Pattern = ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ (obbligatorio)
startIpAddress Indirizzo IP iniziale della regola del firewall del cluster mongo. Deve essere formato IPv4. string

Vincoli:
Pattern = ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ (obbligatorio)

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa mongoClusters/firewallRules può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Un esempio base di implementazione di Azure Cosmos DB per la regola firewall di MongoDB (vCore).

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

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

data "azapi_client_config" "current" {}

resource "azapi_resource" "mongoCluster" {
  type      = "Microsoft.DocumentDB/mongoClusters@2025-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      authConfig = {
        allowedModes = ["MicrosoftEntraID"]
      }
      compute = {
        tier = "M40"
      }
      highAvailability = {
        targetMode = "Disabled"
      }
      previewFeatures = [
        "ShardRebalancer"
      ]
      publicNetworkAccess = "Enabled"
      serverVersion       = "5.0"
      sharding = {
        shardCount = 1
      }
      storage = {
        sizeGb = 32
      }
    }
  }
  tags = {
    Environment = "Test"
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "firewallRule" {
  type      = "Microsoft.DocumentDB/mongoClusters/firewallRules@2025-09-01"
  parent_id = azapi_resource.mongoCluster.id
  name      = var.resource_name
  body = {
    properties = {
      endIpAddress   = "0.0.0.0"
      startIpAddress = "0.0.0.0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Formato di risorsa

Per creare una risorsa Microsoft.DocumentDB/mongoClusters/firewallRules, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/mongoClusters/firewallRules@2026-06-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      endIpAddress = "string"
      startIpAddress = "string"
    }
  }
}

Valori delle proprietà

Microsoft.DocumentDB/mongoClusters/firewallRules

Name Description Value
nome Nome della risorsa string

Vincoli:
Lunghezza minima = 1
Lunghezza massima = 80
Pattern = ^[a-zA-Z0-9][-_.a-zA-Z0-9]* (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: mongoClusters
properties Proprietà specifiche della risorsa. Proprietà FirewallRule
type Tipo di risorsa "Microsoft. DocumentDB/mongoClusters/firewallRules@2026-06-01"

Proprietà FirewallRule

Name Description Value
endIpAddress Indirizzo IP finale della regola del firewall del cluster mongo. Deve essere formato IPv4. string

Vincoli:
Pattern = ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ (obbligatorio)
startIpAddress Indirizzo IP iniziale della regola del firewall del cluster mongo. Deve essere formato IPv4. string

Vincoli:
Pattern = ^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$ (obbligatorio)
  • Last updated on