Linee guida per la denominazione delle risorse per Microsoft Discovery

Microsoft Scoperta include diversi tipi di risorse, alcune delle quali dipendono da risorse in altri provider. Comprendendo i vincoli di denominazione delle risorse, è possibile migliorare la chiarezza, prevenire i conflitti, abilitare l'automazione e supportare la governance e la sicurezza.

In questo articolo sono presentate le regole di denominazione per tutti i tipi di risorse all'interno di Microsoft Discovery. Queste indicazioni consentono di prendere decisioni informate ed evitare errori di distribuzione.

Linee guida generali per la denominazione

Le regole seguenti si applicano a tutte le risorse di individuazione Microsoft, a meno che una sezione specifica della risorsa non stabilisca diversamente.

  • Unicità: I nomi delle risorse devono essere univoci all'interno dell'ambito (sottoscrizione o gruppo di risorse).
  • Prevedibilità: Usare modelli di denominazione coerenti per facilitare l'automazione e l'integrazione.
  • Caratteri consentiti: Segui le regole specifiche di caratteri e pattern per risorsa qui sotto; molti tipi permettono anche trattini.
  • Distinzione tra maiuscole e minuscole: I nomi delle risorse non fanno distinzione tra maiuscole e minuscole, ma devono essere immessi e archiviati in lettere minuscole per coerenza.
  • Lunghezza: Ogni tipo di risorsa definisce la propria lunghezza minima e massima. Il superamento di tali limiti comporta un errore di distribuzione.
  • Nessuna spazi o caratteri speciali: I nomi delle risorse non possono includere spazi vuoti o caratteri speciali, ad eccezione dei trattini (-) se non diversamente specificato.
  • Nessun separatore consecutivo: Più trattini, caratteri di sottolineatura o altri separatori non devono essere visualizzati consecutivamente.

Convenzioni di denominazione del gruppo di risorse gestite

Quando vengono create determinate risorse di individuazione, viene eseguito automaticamente il provisioning dei gruppi di risorse gestiti corrispondenti per ospitare i componenti del servizio necessari per supportare tali risorse. Le convenzioni di denominazione seguenti si applicano a questi mrg:

Tipo di risorsa Convenzione di denominazione Example
Microsoft Workspace di Ricerca mrg-dwsp-<customer-provided-name>-<6-char-random-sequence> mrg-dwsp-testworkspace-abcdef
Microsoft libreria di individuazione mrg-dbksf-<customer-provided-name>-<6-char-random-sequence> mrg-dbksf-testbookshelf-lmnopq
Microsoft Discovery Supercomputer mrg-dscmp-<customer-provided-name>-<6-char-random-sequence> mrg-dscmp-testsc-abcxyz

Regole di denominazione specifiche delle risorse

Le sezioni seguenti descrivono le regole di denominazione per ogni tipo di risorsa di individuazione Microsoft.

Aree di lavoro

Il nome dell'area di lavoro viene usato anche come nome del sottodominio dell'endpoint dell'area di lavoro.

Proprietà Value
Caratteri consentiti Lettere minuscole (a–z), cifre (0–9), trattini (-)
Length 3-24 caratteri
Modello Deve iniziare con una lettera; Può includere cifre e trattini; deve terminare con una lettera o una cifra
Examples workspace01, workspace-main

Progetti

Proprietà Value
Caratteri consentiti Lettere minuscole, cifre, trattini (-)
Length 3-12 caratteri
Modello Deve iniziare con una lettera; i trattini possono essere usati come separatori di parole
Examples ai-project, adhesives01

Supercomputer

Proprietà Value
Caratteri consentiti Lettere minuscole, cifre, trattini (-)
Length 3-24 caratteri
Modello Deve iniziare con una lettera; i trattini sono consentiti come separatori; deve terminare con una lettera o una cifra
Examples quantum-supercomputer, supercomputer01

NodePools

Proprietà Value
Caratteri consentiti Lettere minuscole (a–z), cifre (0–9), trattini (-)
Length 3-12 caratteri
Modello Deve iniziare con una lettera; Può includere cifre e trattini; deve terminare con una lettera o una cifra
Examples nodepool01, gpu-nodepool

Tools

Proprietà Value
Caratteri consentiti Lettere maiuscole o minuscole, cifre, trattini (-)
Length 3-24 caratteri
Modello Deve iniziare con una lettera; trattini vengono usati come separatori; deve terminare con una lettera o una cifra
Examples adft-tool, mol-toolkit

Agents

Proprietà Value
Caratteri consentiti Lettere maiuscole o minuscole, cifre, trattini (-)
Length 3-63 caratteri
Modello Deve iniziare e terminare con un carattere alfanumerico (lettera o cifra); i trattini possono essere usati al centro
Examples search-agent, crawler-agent

Contenitori

Proprietà Value
Caratteri consentiti Lettere minuscole, cifre, trattini (-)
Length 3-24 caratteri
Modello Deve iniziare e terminare con una lettera; trattini sono separatori di parole facoltativi
Examples contoso-datacontainer, archivecontainer

Risorse di Stoccaggio

Proprietà Value
Caratteri consentiti Lettere minuscole (a–z), cifre (0–9), trattini (-)
Length 3-24 caratteri
Modello Deve iniziare con una lettera; Può includere cifre e trattini; deve terminare con una lettera o una cifra
Examples input-molecules-01, outputdata

Indagini

Proprietà Value
Caratteri consentiti Lettere minuscole, cifre, trattini (-)
Length 1-20 caratteri
Modello Deve iniziare e terminare con una lettera; i trattini fungono da separatori di parole
Examples chem-investigation, anomaly-study

Internazionalizzazione e localizzazione

Usare i termini e i caratteri ASCII in inglese per tutti i nomi delle risorse per garantire la massima compatibilità tra sistemi e aree globali. Se la localizzazione è necessaria, usare una tabella di mapping o un campo di metadati anziché codificare i nomi localizzati direttamente nel nome della risorsa.

Convalida e gestione degli errori

Il compito di configurazione di onboarding controlla i nomi prima del provisioning. Rivedi sia i controlli di sintassi sia eventuali controlli di disponibilità di nomi attivi non disponibili; il successo locale non dimostra l'unicità in Azure. I nomi generati dagli strumenti possono avere regole di derivazione aggiuntive, come il nome predefinito del contenitore di archiviazione del progetto.

Tutti i nomi delle risorse vengono convalidati prima della creazione o della modifica. La convalida include:

  • Controllo della sintassi: Lunghezza, caratteri consentiti e divieto per separatori consecutivi.
  • Controllo dell'univocità: Verificato nell'ambito appropriato (sottoscrizione o gruppo di risorse).

Quando si usa il portale di Azure o Microsoft Discovery Studio, i messaggi di errore espliciti vengono visualizzati in tempo reale quando viene violato un vincolo di denominazione. Correggere l'input in base alle regole per il tipo di risorsa specifico prima di riprovare.