Udostępnij przez


Microsoft.DocumentDB mongoClusters/firewallRules 2025-09-01

Definicja zasobu Bicep

Typ zasobu mongoClusters/firewallRules można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/mongoClusters/firewallRules, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.DocumentDB/mongoClusters/firewallRules

Name Description Wartość
nazwa Nazwa zasobu string

Constraints:
Minimalna długość = 1
Maksymalna długość = 80
Wzorzec = ^[a-zA-Z0-9][-_.a-zA-Z0-9]* (wymagane)
nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: mongoClusters
properties Właściwości specyficzne dla zasobu dla tego zasobu. FirewallRuleProperties (Właściwości reguły zapory)

FirewallRuleProperties (Właściwości reguły zapory)

Name Description Wartość
endIpAddress (adres_końcowy) Końcowy adres IP reguły zapory klastra mongo. Musi mieć format IPv4. string

Constraints:
Wzorzec = ^(([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])$ (wymagane)
startIpAddress (adres_początkowy) Początkowy adres IP reguły zapory klastra mongo. Musi mieć format IPv4. string

Constraints:
Wzorzec = ^(([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])$ (wymagane)

Definicja zasobu szablonu usługi ARM

Typ zasobu mongoClusters/firewallRules można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/mongoClusters/firewallRules, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.DocumentDB/mongoClusters/firewallRules

Name Description Wartość
apiVersion Wersja interfejsu API '2025-09-01'
nazwa Nazwa zasobu string

Constraints:
Minimalna długość = 1
Maksymalna długość = 80
Wzorzec = ^[a-zA-Z0-9][-_.a-zA-Z0-9]* (wymagane)
properties Właściwości specyficzne dla zasobu dla tego zasobu. FirewallRuleProperties (Właściwości reguły zapory)
typ Typ zasobu "Microsoft.DocumentDB/mongoClusters/firewallRules"

FirewallRuleProperties (Właściwości reguły zapory)

Name Description Wartość
endIpAddress (adres_końcowy) Końcowy adres IP reguły zapory klastra mongo. Musi mieć format IPv4. string

Constraints:
Wzorzec = ^(([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])$ (wymagane)
startIpAddress (adres_początkowy) Początkowy adres IP reguły zapory klastra mongo. Musi mieć format IPv4. string

Constraints:
Wzorzec = ^(([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])$ (wymagane)

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu mongoClusters/firewallRules można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/mongoClusters/firewallRules, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.DocumentDB/mongoClusters/firewallRules

Name Description Wartość
nazwa Nazwa zasobu string

Constraints:
Minimalna długość = 1
Maksymalna długość = 80
Wzorzec = ^[a-zA-Z0-9][-_.a-zA-Z0-9]* (wymagane)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: mongoClusters
properties Właściwości specyficzne dla zasobu dla tego zasobu. FirewallRuleProperties (Właściwości reguły zapory)
typ Typ zasobu "Microsoft.DocumentDB/mongoClusters/firewallRules@2025-09-01"

FirewallRuleProperties (Właściwości reguły zapory)

Name Description Wartość
endIpAddress (adres_końcowy) Końcowy adres IP reguły zapory klastra mongo. Musi mieć format IPv4. string

Constraints:
Wzorzec = ^(([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])$ (wymagane)
startIpAddress (adres_początkowy) Początkowy adres IP reguły zapory klastra mongo. Musi mieć format IPv4. string

Constraints:
Wzorzec = ^(([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])$ (wymagane)

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania Azure Cosmos DB dla reguły zapory 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    = ["*"]
}