Partilhar via


HSMs gerenciados Microsoft.KeyVault 2021-10-01

Definição de recursos do bíceps

O tipo de recurso managedHSMs 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.KeyVault/managedHSMs, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.KeyVault/managedHSMs@2021-10-01' = {
  location: 'string'
  name: 'string'
  properties: {
    createMode: 'string'
    enablePurgeProtection: bool
    enableSoftDelete: bool
    initialAdminObjectIds: [
      'string'
    ]
    networkAcls: {
      bypass: 'string'
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
        }
      ]
    }
    publicNetworkAccess: 'string'
    softDeleteRetentionInDays: int
    tenantId: 'string'
  }
  sku: {
    family: 'string'
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

ManagedHsmProperties

Designação Descrição Valor
createMode O modo de criação para indicar se o recurso está sendo criado ou está sendo recuperado de um recurso excluído. 'Padrão'
'Recuperar'
enablePurgeProtection Propriedade que especifica se a proteção contra limpeza está habilitada para esse pool de HSM gerenciado. Definir essa propriedade como true ativa a proteção contra limpeza para esse pool de HSM gerenciado e seu conteúdo - somente o serviço HSM gerenciado pode iniciar uma exclusão rígida e irrecuperável. Ativar esta funcionalidade é irreversível. Bool
enableSoftDelete Propriedade para especificar se a funcionalidade 'exclusão suave' está habilitada para esse pool de HSM gerenciado. A exclusão suave é habilitada por padrão para todos os HSMs gerenciados e é imutável. Bool
initialAdminObjectIds Matriz de ids de objeto de administradores iniciais para este pool hsm gerenciado. string[]
networkAcls Regras que regem a acessibilidade do cofre de chaves a partir de locais de rede específicos. MhsmNetworkRuleSet
publicNetworkAccess Controle a permissão para o HSM gerenciado a partir de redes públicas. 'Desativado'
'Habilitado'
softDeleteRetentionInDays Dias de retenção de dados apagados suavemente. Quando você exclui um HSM ou uma chave, ele permanecerá recuperável pelo período de retenção configurado ou por um período padrão de 90 dias. Aceita valores entre 7 e 90. Int
inquilinoId A ID de locatário do Azure Ative Directory que deve ser usada para autenticar solicitações para o pool de HSM gerenciado. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedHsmResourceTags

Designação Descrição Valor

ManagedHsmSku

Designação Descrição Valor
Família Família SKU do pool HSM gerenciado 'B' (obrigatório)
Designação SKU do pool de HSM gerenciado 'Custom_B32'
'Custom_B6'
'Standard_B1' (obrigatório)

MhsmipRule

Designação Descrição Valor
valor Um intervalo de endereços IPv4 na notação CIDR, como '124.56.78.91' (endereço IP simples) ou '124.56.78.0/24' (todos os endereços que começam com 124.56.78). string (obrigatório)

MhsmNetworkRuleSet

Designação Descrição Valor
Desvio Informa qual tráfego pode ignorar as regras de rede. Isso pode ser 'AzureServices' ou 'None'. Se não for especificado, o padrão será 'AzureServices'. 'AzureServices'
'Nenhuma'
defaultAction A ação padrão quando nenhuma regra de ipRules e de virtualNetworkRules corresponder. Isso só é usado depois que a propriedade bypass foi avaliada. 'Permitir'
'Negar'
ipRegras A lista de regras de endereço IP. MhsmipRule[]
virtualNetworkRules A lista de regras de rede virtual. MhsmVirtualNetworkRule[]

MhsmVirtualNetworkRule

Designação Descrição Valor
ID ID de recurso completo de uma sub-rede vnet, como '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'. string (obrigatório)

Microsoft.KeyVault/managedHSMs

Designação Descrição Valor
Localização O local do Azure com suporte onde o Pool HSM gerenciado deve ser criado. string
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do HSM gerenciado ManagedHsmProperties
SKU Detalhes do SKU ManagedHsmSku
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Criar um HSM gerenciado do Azure Key Vault Este modelo cria um HSM gerenciado do Azure Key Vault.

Definição de recurso de modelo ARM

O tipo de recurso managedHSMs 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.KeyVault/managedHSMs, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.KeyVault/managedHSMs",
  "apiVersion": "2021-10-01",
  "name": "string",
  "location": "string",
  "properties": {
    "createMode": "string",
    "enablePurgeProtection": "bool",
    "enableSoftDelete": "bool",
    "initialAdminObjectIds": [ "string" ],
    "networkAcls": {
      "bypass": "string",
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "id": "string"
        }
      ]
    },
    "publicNetworkAccess": "string",
    "softDeleteRetentionInDays": "int",
    "tenantId": "string"
  },
  "sku": {
    "family": "string",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

ManagedHsmProperties

Designação Descrição Valor
createMode O modo de criação para indicar se o recurso está sendo criado ou está sendo recuperado de um recurso excluído. 'Padrão'
'Recuperar'
enablePurgeProtection Propriedade que especifica se a proteção contra limpeza está habilitada para esse pool de HSM gerenciado. Definir essa propriedade como true ativa a proteção contra limpeza para esse pool de HSM gerenciado e seu conteúdo - somente o serviço HSM gerenciado pode iniciar uma exclusão rígida e irrecuperável. Ativar esta funcionalidade é irreversível. Bool
enableSoftDelete Propriedade para especificar se a funcionalidade 'exclusão suave' está habilitada para esse pool de HSM gerenciado. A exclusão suave é habilitada por padrão para todos os HSMs gerenciados e é imutável. Bool
initialAdminObjectIds Matriz de ids de objeto de administradores iniciais para este pool hsm gerenciado. string[]
networkAcls Regras que regem a acessibilidade do cofre de chaves a partir de locais de rede específicos. MhsmNetworkRuleSet
publicNetworkAccess Controle a permissão para o HSM gerenciado a partir de redes públicas. 'Desativado'
'Habilitado'
softDeleteRetentionInDays Dias de retenção de dados apagados suavemente. Quando você exclui um HSM ou uma chave, ele permanecerá recuperável pelo período de retenção configurado ou por um período padrão de 90 dias. Aceita valores entre 7 e 90. Int
inquilinoId A ID de locatário do Azure Ative Directory que deve ser usada para autenticar solicitações para o pool de HSM gerenciado. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedHsmResourceTags

Designação Descrição Valor

ManagedHsmSku

Designação Descrição Valor
Família Família SKU do pool HSM gerenciado 'B' (obrigatório)
Designação SKU do pool de HSM gerenciado 'Custom_B32'
'Custom_B6'
'Standard_B1' (obrigatório)

MhsmipRule

Designação Descrição Valor
valor Um intervalo de endereços IPv4 na notação CIDR, como '124.56.78.91' (endereço IP simples) ou '124.56.78.0/24' (todos os endereços que começam com 124.56.78). string (obrigatório)

MhsmNetworkRuleSet

Designação Descrição Valor
Desvio Informa qual tráfego pode ignorar as regras de rede. Isso pode ser 'AzureServices' ou 'None'. Se não for especificado, o padrão será 'AzureServices'. 'AzureServices'
'Nenhuma'
defaultAction A ação padrão quando nenhuma regra de ipRules e de virtualNetworkRules corresponder. Isso só é usado depois que a propriedade bypass foi avaliada. 'Permitir'
'Negar'
ipRegras A lista de regras de endereço IP. MhsmipRule[]
virtualNetworkRules A lista de regras de rede virtual. MhsmVirtualNetworkRule[]

MhsmVirtualNetworkRule

Designação Descrição Valor
ID ID de recurso completo de uma sub-rede vnet, como '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'. string (obrigatório)

Microsoft.KeyVault/managedHSMs

Designação Descrição Valor
apiVersion A versão api '2021-10-01'
Localização O local do Azure com suporte onde o Pool HSM gerenciado deve ser criado. string
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do HSM gerenciado ManagedHsmProperties
SKU Detalhes do SKU ManagedHsmSku
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.KeyVault/managedHSMs'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar um HSM gerenciado do Azure Key Vault

Implantar no Azure
Este modelo cria um HSM gerenciado do Azure Key Vault.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso managedHSMs 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.KeyVault/managedHSMs, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.KeyVault/managedHSMs@2021-10-01"
  name = "string"
  location = "string"
  sku = {
    family = "string"
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      createMode = "string"
      enablePurgeProtection = bool
      enableSoftDelete = bool
      initialAdminObjectIds = [
        "string"
      ]
      networkAcls = {
        bypass = "string"
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            id = "string"
          }
        ]
      }
      publicNetworkAccess = "string"
      softDeleteRetentionInDays = int
      tenantId = "string"
    }
  })
}

Valores de propriedade

ManagedHsmProperties

Designação Descrição Valor
createMode O modo de criação para indicar se o recurso está sendo criado ou está sendo recuperado de um recurso excluído. 'Padrão'
'Recuperar'
enablePurgeProtection Propriedade que especifica se a proteção contra limpeza está habilitada para esse pool de HSM gerenciado. Definir essa propriedade como true ativa a proteção contra limpeza para esse pool de HSM gerenciado e seu conteúdo - somente o serviço HSM gerenciado pode iniciar uma exclusão rígida e irrecuperável. Ativar esta funcionalidade é irreversível. Bool
enableSoftDelete Propriedade para especificar se a funcionalidade 'exclusão suave' está habilitada para esse pool de HSM gerenciado. A exclusão suave é habilitada por padrão para todos os HSMs gerenciados e é imutável. Bool
initialAdminObjectIds Matriz de ids de objeto de administradores iniciais para este pool hsm gerenciado. string[]
networkAcls Regras que regem a acessibilidade do cofre de chaves a partir de locais de rede específicos. MhsmNetworkRuleSet
publicNetworkAccess Controle a permissão para o HSM gerenciado a partir de redes públicas. 'Desativado'
'Habilitado'
softDeleteRetentionInDays Dias de retenção de dados apagados suavemente. Quando você exclui um HSM ou uma chave, ele permanecerá recuperável pelo período de retenção configurado ou por um período padrão de 90 dias. Aceita valores entre 7 e 90. Int
inquilinoId A ID de locatário do Azure Ative Directory que deve ser usada para autenticar solicitações para o pool de HSM gerenciado. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

ManagedHsmResourceTags

Designação Descrição Valor

ManagedHsmSku

Designação Descrição Valor
Família Família SKU do pool HSM gerenciado 'B' (obrigatório)
Designação SKU do pool de HSM gerenciado 'Custom_B32'
'Custom_B6'
'Standard_B1' (obrigatório)

MhsmipRule

Designação Descrição Valor
valor Um intervalo de endereços IPv4 na notação CIDR, como '124.56.78.91' (endereço IP simples) ou '124.56.78.0/24' (todos os endereços que começam com 124.56.78). string (obrigatório)

MhsmNetworkRuleSet

Designação Descrição Valor
Desvio Informa qual tráfego pode ignorar as regras de rede. Isso pode ser 'AzureServices' ou 'None'. Se não for especificado, o padrão será 'AzureServices'. 'AzureServices'
'Nenhuma'
defaultAction A ação padrão quando nenhuma regra de ipRules e de virtualNetworkRules corresponder. Isso só é usado depois que a propriedade bypass foi avaliada. 'Permitir'
'Negar'
ipRegras A lista de regras de endereço IP. MhsmipRule[]
virtualNetworkRules A lista de regras de rede virtual. MhsmVirtualNetworkRule[]

MhsmVirtualNetworkRule

Designação Descrição Valor
ID ID de recurso completo de uma sub-rede vnet, como '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'. string (obrigatório)

Microsoft.KeyVault/managedHSMs

Designação Descrição Valor
Localização O local do Azure com suporte onde o Pool HSM gerenciado deve ser criado. string
Designação O nome do recurso string (obrigatório)
propriedades Propriedades do HSM gerenciado ManagedHsmProperties
SKU Detalhes do SKU ManagedHsmSku
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.KeyVault/managedHSMs@2021-10-01"