Partilhar via

Início Rápido: criar um espaço de trabalho de Descoberta de Armazenamento com um modelo Bicep

Este guia de início rápido mostra como usar um arquivo Bicep para implantar um espaço de trabalho de Descoberta de Armazenamento no Azure.

Bicep é uma linguagem de domínio específico (DSL) que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece uma sintaxe concisa, segurança de tipos confiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Pré-requisitos

  • Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Revise o arquivo Bicep

O arquivo Bicep utilizado neste início rápido é dos Modelos de Início Rápido do Azure.

    @description('Storage Discovery Workspace name')
    param workspaceName string
    
    @description('Storage Discovery Workspace location')
    param workspaceLocation string = resourceGroup().location
    
    @description('Storage Discovery Workspace SKU')
    param workspaceSku string
    
    @description('Storage Discovery Workspace description')
    param workspaceDescription string = ''
    
    @description('Storage Discovery Workspace roots')
    param workspaceRoots array = []
    
    @description('Storage Discovery Workspace scopes')
    param workspaceScopes array = []
    
    @description('Storage Discovery Workspace tags')
    param tags object
    
    resource storageDiscoveryResource 'Microsoft.StorageDiscovery/storageDiscoveryWorkspaces@2025-09-01' = {
      name: workspaceName
      location: workspaceLocation
      properties: {
        sku: workspaceSku
        workspaceRoots: workspaceRoots
        description: workspaceDescription
        scopes: workspaceScopes
      }
      tags: (empty(tags) ? {} : tags)
    }

Parâmetros

O modelo lista as propriedades do espaço de trabalho Descoberta que exigem objetos extras:

Nome Description
workspaceRoots A raiz do espaço de trabalho designa os recursos de armazenamento para os quais obter informações. Este string[] pode conter uma combinação de identificadores de subscrição e identificadores de grupos de recursos. Você pode misturar e combinar esses tipos de recursos. A identidade sob a qual você implanta esse modelo deve ter permissões para todos os recursos listados no momento da implantação.
scopes Você pode criar vários escopos em um espaço de trabalho. Um escopo permite filtrar os recursos de armazenamento cobertos pelo espaço de trabalho e obter relatórios diferentes para cada um desses escopos. A filtragem é baseada em tags de recursos ARM em seus recursos de armazenamento. Esta propriedade espera um objeto JSON que contenha secções para combinações tag key name : value ou apenas tag key names. Quando seus recursos de armazenamento têm tags de recursos ARM correspondentes, eles são incluídos nesse escopo.

Veja um exemplo da estrutura que define JSON um único escopo num espaço de trabalho de Discovery. Os recursos de armazenamento são incluídos neste escopo quando têm ambas as tags de recurso ARM:

  • A chave de etiqueta Department ou department com valor de correspondência de maiúsculas e minúsculas Marketing.
  • A tag da chave App ou app, independentemente do seu valor.
    "scopes": [ 
        { 
        
            "displayName": "Marketing App Resources", 
        
            "resourceTypes": [ 
        
                "Microsoft.Storage/storageAccounts" 
        
            ], 
        
            "tags": { 
        
                "Department": "Marketing" 
        
            }, 
        
            "tagsKeyOnly": [ 
        
                "App" 
        
            ] 
        
        }

Observação

No Azure, os nomes (chaves) das tags não diferenciam maiúsculas de minúsculas para operações. Os valores das etiquetas são sensíveis às maiúsculas e minúsculas.

Desdobrar o arquivo Bicep

  1. Salve o arquivo Bicep como main.bicep em seu computador local.

  2. Implante o arquivo Bicep usando o Azure PowerShell ou a CLI do Azure.

New-AzResourceGroup -Name exampleRG -Location eastus

New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -adminUsername "<admin-username>"

Observação

Substitua <admin-username> por um nome de usuário com o qual você possa autenticar.

Analisar os recursos implementados

Use o portal do Azure, o Azure PowerShell ou a CLI do Azure para listar os recursos implantados no grupo de recursos.

Get-AzResource -ResourceGroupName exampleRG

Próximos passos

Explore os relatórios de descoberta de armazenamento

  • Last updated on