Partilhar via


Microsoft.AzureStackHCI networkInterfaces 2025-02-01-preview

Definição de recursos do bíceps

O tipo de recurso networkInterfaces pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.AzureStackHCI/networkInterfaces, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.AzureStackHCI/networkInterfaces@2025-02-01-preview' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    createFromLocal: bool
    dnsSettings: {
      dnsServers: [
        'string'
      ]
    }
    ipConfigurations: [
      {
        name: 'string'
        properties: {
          privateIPAddress: 'string'
          subnet: {
            id: 'string'
          }
        }
      }
    ]
    macAddress: 'string'
    networkSecurityGroup: {
      id: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.AzureStackHCI/networkInterfaces

Nome Descrição Valor
extendedLocalização O extendedLocation do recurso. Localização Estendida
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. NetworkInterfaceProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Localização Estendida

Nome Descrição Valor
nome O nome do local estendido. cadeia (de caracteres)
tipo O tipo de localização ampliada. 'Localização personalizada'

InterfaceDNSSettings

Nome Descrição Valor
dnsServers Lista de endereços IP do servidor DNS para a interface string[]

IPConfiguração

Nome Descrição Valor
nome Nome - O nome do recurso que é exclusivo dentro de um grupo de recursos. Esse nome pode ser usado para acessar o recurso. cadeia de caracteres

Restrições:
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$
propriedades InterfaceIPConfigurationPropertiesFormat propriedades de configuração IP. IPConfigurationPropriedades

IPConfigurationPropriedades

Nome Descrição Valor
privateIPAddress PrivateIPAddress - Endereço IP privado da configuração IP. cadeia (de caracteres)
sub-rede Sub-rede - Nome da sub-rede vinculada à configuração IP. LogicalNetworkArmReference

LogicalNetworkArmReference

Nome Descrição Valor
ID O ARM ID para uma rede lógica. cadeia (de caracteres)

NetworkInterfaceProperties

Nome Descrição Valor
createFromLocal Booleano indicando se esta é uma interface de rede local existente ou se uma deve ser criada. Bool
dnsConfigurações Configurações de DNS para a interface InterfaceDNSSettings
ipConfigurations IPConfigurations - Uma lista de IPConfigurations da interface de rede. IPConfiguração[]
MacEndereço MacAddress - O endereço MAC da interface de rede. cadeia (de caracteres)
networkSecurityGroup NetworkSecurityGroup - Grupo de Segurança de Rede conectado à interface de rede. NetworkSecurityGroupArmReference

NetworkSecurityGroupArmReference

Nome Descrição Valor
ID A ID ARM para um Grupo de Segurança de Rede. cadeia (de caracteres)

TrackedResourceTags

Nome Descrição Valor

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
de Interface de Rede HCI do Azure Stack Módulo de recursos AVM para interface de rede HCI do Azure Stack

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
Criar uma VM Linux a partir de uma imagem de galeria no Azure Stack HCI Este modelo cria uma VM Linux simples a partir da imagem personalizada referenciada no Azure Stack HCI versão 23H2+
Criar uma VM a partir da imagem referenciada no Azure Stack HCI Este modelo cria uma VM simples do Windows a partir da imagem referenciada do Azure Marketplace no Azure Stack HCI versão 23H2+

Definição de recurso de modelo ARM

O tipo de recurso networkInterfaces pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.AzureStackHCI/networkInterfaces, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.AzureStackHCI/networkInterfaces",
  "apiVersion": "2025-02-01-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "createFromLocal": "bool",
    "dnsSettings": {
      "dnsServers": [ "string" ]
    },
    "ipConfigurations": [
      {
        "name": "string",
        "properties": {
          "privateIPAddress": "string",
          "subnet": {
            "id": "string"
          }
        }
      }
    ],
    "macAddress": "string",
    "networkSecurityGroup": {
      "id": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.AzureStackHCI/networkInterfaces

Nome Descrição Valor
Versão da API A versão api '2025-02-01-pré-visualização'
extendedLocalização O extendedLocation do recurso. Localização Estendida
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. NetworkInterfaceProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.AzureStackHCI/networkInterfaces'

Localização Estendida

Nome Descrição Valor
nome O nome do local estendido. cadeia (de caracteres)
tipo O tipo de localização ampliada. 'Localização personalizada'

InterfaceDNSSettings

Nome Descrição Valor
dnsServers Lista de endereços IP do servidor DNS para a interface string[]

IPConfiguração

Nome Descrição Valor
nome Nome - O nome do recurso que é exclusivo dentro de um grupo de recursos. Esse nome pode ser usado para acessar o recurso. cadeia de caracteres

Restrições:
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$
propriedades InterfaceIPConfigurationPropertiesFormat propriedades de configuração IP. IPConfigurationPropriedades

IPConfigurationPropriedades

Nome Descrição Valor
privateIPAddress PrivateIPAddress - Endereço IP privado da configuração IP. cadeia (de caracteres)
sub-rede Sub-rede - Nome da sub-rede vinculada à configuração IP. LogicalNetworkArmReference

LogicalNetworkArmReference

Nome Descrição Valor
ID O ARM ID para uma rede lógica. cadeia (de caracteres)

NetworkInterfaceProperties

Nome Descrição Valor
createFromLocal Booleano indicando se esta é uma interface de rede local existente ou se uma deve ser criada. Bool
dnsConfigurações Configurações de DNS para a interface InterfaceDNSSettings
ipConfigurations IPConfigurations - Uma lista de IPConfigurations da interface de rede. IPConfiguração[]
MacEndereço MacAddress - O endereço MAC da interface de rede. cadeia (de caracteres)
networkSecurityGroup NetworkSecurityGroup - Grupo de Segurança de Rede conectado à interface de rede. NetworkSecurityGroupArmReference

NetworkSecurityGroupArmReference

Nome Descrição Valor
ID A ID ARM para um Grupo de Segurança de Rede. cadeia (de caracteres)

TrackedResourceTags

Nome Descrição Valor

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Modelo Descrição
Criar uma VM Linux a partir de uma imagem de galeria no Azure Stack HCI

Implantar no Azure
Este modelo cria uma VM Linux simples a partir da imagem personalizada referenciada no Azure Stack HCI versão 23H2+
Criar uma VM a partir da imagem referenciada no Azure Stack HCI

Implantar no Azure
Este modelo cria uma VM simples do Windows a partir da imagem referenciada do Azure Marketplace no Azure Stack HCI versão 23H2+

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso networkInterfaces pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.AzureStackHCI/networkInterfaces, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AzureStackHCI/networkInterfaces@2025-02-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      createFromLocal = bool
      dnsSettings = {
        dnsServers = [
          "string"
        ]
      }
      ipConfigurations = [
        {
          name = "string"
          properties = {
            privateIPAddress = "string"
            subnet = {
              id = "string"
            }
          }
        }
      ]
      macAddress = "string"
      networkSecurityGroup = {
        id = "string"
      }
    }
  }
}

Valores de propriedade

Microsoft.AzureStackHCI/networkInterfaces

Nome Descrição Valor
extendedLocalização O extendedLocation do recurso. Localização Estendida
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso cadeia de caracteres

Restrições:
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. NetworkInterfaceProperties
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.AzureStackHCI/networkInterfaces@2025-02-01-preview"

Localização Estendida

Nome Descrição Valor
nome O nome do local estendido. cadeia (de caracteres)
tipo O tipo de localização ampliada. 'Localização personalizada'

InterfaceDNSSettings

Nome Descrição Valor
dnsServers Lista de endereços IP do servidor DNS para a interface string[]

IPConfiguração

Nome Descrição Valor
nome Nome - O nome do recurso que é exclusivo dentro de um grupo de recursos. Esse nome pode ser usado para acessar o recurso. cadeia de caracteres

Restrições:
Padrão = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$
propriedades InterfaceIPConfigurationPropertiesFormat propriedades de configuração IP. IPConfigurationPropriedades

IPConfigurationPropriedades

Nome Descrição Valor
privateIPAddress PrivateIPAddress - Endereço IP privado da configuração IP. cadeia (de caracteres)
sub-rede Sub-rede - Nome da sub-rede vinculada à configuração IP. LogicalNetworkArmReference

LogicalNetworkArmReference

Nome Descrição Valor
ID O ARM ID para uma rede lógica. cadeia (de caracteres)

NetworkInterfaceProperties

Nome Descrição Valor
createFromLocal Booleano indicando se esta é uma interface de rede local existente ou se uma deve ser criada. Bool
dnsConfigurações Configurações de DNS para a interface InterfaceDNSSettings
ipConfigurations IPConfigurations - Uma lista de IPConfigurations da interface de rede. IPConfiguração[]
MacEndereço MacAddress - O endereço MAC da interface de rede. cadeia (de caracteres)
networkSecurityGroup NetworkSecurityGroup - Grupo de Segurança de Rede conectado à interface de rede. NetworkSecurityGroupArmReference

NetworkSecurityGroupArmReference

Nome Descrição Valor
ID A ID ARM para um Grupo de Segurança de Rede. cadeia (de caracteres)

TrackedResourceTags

Nome Descrição Valor