Condividi tramite


Product Template - Get

Ottiene un modello in base al relativo identificatore.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/contentproducttemplates/{templateId}?api-version=2025-09-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

subscriptionId
path True

string (uuid)

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

templateId
path True

string

ID modello

workspaceName
path True

string

minLength: 1
maxLength: 90
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Nome dell'area di lavoro.

api-version
query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

productTemplateModel

Va bene

Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Get a template.

Esempio di richiesta

GET https://management.azure.com/subscriptions/d0cfeab2-9ae0-4464-9919-dccaee2e48f0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/contentproducttemplates/8365ebfe-a381-45b7-ad08-7d818070e11f?api-version=2025-09-01

Risposta di esempio

{
  "id": "/subscriptions/d0cfeab2-9ae0-4464-9919-dccaee2e48f0/resourceGroups/myRg/providers/Microsoft.OperationalIinsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/contentProductTemplates/8365ebfe-a381-45b7-ad08-7d818070e11f",
  "name": "8365ebfe-a381-45b7-ad08-7d818070e11f",
  "type": "Microsoft.SecurityInsights/contentproducttemplates",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "contentId": "contentId",
    "version": "1.0.0",
    "packageVersion": "1.0.0",
    "displayName": "My installed template",
    "contentKind": "Workbooks",
    "contentProductId": "packageId-wb-rimnsoeh4nt32",
    "packageId": "packageId",
    "packageKind": "Standalone",
    "packageName": "package name",
    "source": {
      "kind": "Standalone",
      "name": "Source name"
    },
    "mainTemplate": {}
  },
  "systemData": {
    "createdBy": "string",
    "createdByType": "User",
    "createdAt": "2020-04-27T21:53:29.0928001Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-04-27T21:53:29.0928001Z"
  }
}

Definizioni

Nome Descrizione
CloudError

Struttura della risposta all'errore.

CloudErrorBody

Dettagli errore.

createdByType

Tipo di identità che ha creato la risorsa.

flag

Il flag indica se questo modello è deprecato

kind

Il tipo di contenuto a cui è destinato il modello.

metadataAuthor

Editore o creatore dell'elemento di contenuto.

metadataCategories

ies per l'elemento di contenuto della soluzione

metadataDependencies

Dipendenze per l'elemento di contenuto, quali altri elementi di contenuto richiede per funzionare. È possibile descrivere dipendenze più complesse utilizzando una struttura ricorsiva/annidata. Per una singola dipendenza è possibile fornire un id/kind/version o un operatore/criterio per dipendenze complesse.

metadataSource

L'origine originale dell'elemento di contenuto, da cui proviene.

metadataSupport

Informazioni di supporto per l'elemento di contenuto.

operator

Operatore utilizzato per l'elenco delle dipendenze nell'array di criteri.

packageKind

il packageKind del pacchetto contiene questo modello

productTemplateModel

Definizione della risorsa modello.

sourceKind

Tipo di origine del contenuto

supportTier

Tipo di supporto per l'elemento di contenuto

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

CloudError

Struttura della risposta all'errore.

Nome Tipo Descrizione
error

CloudErrorBody

Dati di errore

CloudErrorBody

Dettagli errore.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

createdByType

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

flag

Il flag indica se questo modello è deprecato

Valore Descrizione
true
false

kind

Il tipo di contenuto a cui è destinato il modello.

Valore Descrizione
DataConnector
DataType
Workbook
WorkbookTemplate
Playbook
PlaybookTemplate
AnalyticsRuleTemplate
AnalyticsRule
HuntingQuery
InvestigationQuery
Parser
Watchlist
WatchlistTemplate
Solution
AzureFunction
LogicAppsCustomConnector
AutomationRule
ResourcesDataConnector

I connettori della piattaforma di connettori senza codice (CCP)

Notebook

Notebook di Jupyter

Standalone

Contenuti una tantum/autonomi forniti dai collaboratori della community

SummaryRule

Le regole di riepilogo eseguono l'elaborazione batch direttamente nell'area di lavoro Log Analytics.

metadataAuthor

Editore o creatore dell'elemento di contenuto.

Nome Tipo Descrizione
email

string

E-mail di contatto dell'autore

link

string

Link per la pagina dell'autore/fornitore

name

string

Nome dell'autore. Azienda o persona.

metadataCategories

ies per l'elemento di contenuto della soluzione

Nome Tipo Descrizione
domains

string[]

Dominio per l'elemento di contenuto della soluzione

verticals

string[]

Verticali di settore per l'elemento di contenuto della soluzione

metadataDependencies

Dipendenze per l'elemento di contenuto, quali altri elementi di contenuto richiede per funzionare. È possibile descrivere dipendenze più complesse utilizzando una struttura ricorsiva/annidata. Per una singola dipendenza è possibile fornire un id/kind/version o un operatore/criterio per dipendenze complesse.

Nome Tipo Descrizione
contentId

string

ID dell'elemento di contenuto da cui dipendiamo

criteria

metadataDependencies[]

Questo è l'elenco delle dipendenze che dobbiamo soddisfare, secondo l'operatore AND/OR

kind

kind

Tipo di contenuto da cui dipendiamo

name

string

Nome dell'elemento di contenuto

operator

operator

Operatore utilizzato per l'elenco delle dipendenze nell'array di criteri.

version

string

Versione dell'elemento di contenuto da cui dipendiamo. Può essere vuoto, * o mancante per indicare che qualsiasi versione soddisfa la dipendenza. Se la versione non corrisponde al formato numerico definito, è necessaria una corrispondenza esatta.

metadataSource

L'origine originale dell'elemento di contenuto, da cui proviene.

Nome Tipo Descrizione
kind

sourceKind

Tipo di origine del contenuto

name

string

Nome dell'origine di contenuto. Il nome del repository, il nome della soluzione, il nome dell'area di lavoro LA e così via.

sourceId

string

ID dell'origine di contenuto. L'ID della soluzione, l'ID dell'area di lavoro, ecc

metadataSupport

Informazioni di supporto per l'elemento di contenuto.

Nome Tipo Descrizione
email

string

E-mail di contatto di supporto

link

string

Link per assistenza di supporto, mi piace alla pagina di supporto per aprire un ticket, ecc.

name

string

Nome del contatto di supporto. Azienda o persona.

tier

supportTier

Tipo di supporto per l'elemento di contenuto

operator

Operatore utilizzato per l'elenco delle dipendenze nell'array di criteri.

Valore Descrizione
AND
OR

packageKind

il packageKind del pacchetto contiene questo modello

Valore Descrizione
Solution
Standalone

productTemplateModel

Definizione della risorsa modello.

Nome Tipo Descrizione
etag

string

Etag della risorsa di Azure

id

string (arm-id)

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties.author

metadataAuthor

L'autore dell'elemento di contenuto.

properties.categories

metadataCategories

Categorie per l'articolo

properties.contentId

string

ID statico per il contenuto. Utilizzato per identificare le dipendenze e il contenuto delle soluzioni o della community. Hardcoded/statico per contenuti e soluzioni pronti all'uso. Dinamico per le creazioni create dall'utente. Questo è il nome della risorsa

properties.contentKind

kind

Il tipo di contenuto a cui è destinato il modello.

properties.contentProductId

string

ID univoco per il contenuto. Deve essere generato in base al contentId del pacchetto, contentId del modello, contentKind del modello e contentVersion del modello

properties.contentSchemaVersion

string

Versione dello schema del contenuto. Può essere utilizzato per distinguere tra flussi diversi in base alla versione dello schema

properties.customVersion

string

La versione personalizzata del contenuto. Un testo libero facoltativo

properties.dependencies

metadataDependencies

Dipendenze per l'elemento di contenuto, quali altri elementi di contenuto richiede per funzionare. È possibile descrivere dipendenze più complesse utilizzando una struttura ricorsiva/annidata. Per una singola dipendenza è possibile fornire un id/kind/version o un operatore/criterio per formati complessi.

properties.displayName

string

Il nome visualizzato del modello

properties.firstPublishDate

string (date)

Elemento del contenuto della prima data di pubblicazione

properties.icon

string

l'identificatore dell'icona. Questo ID può essere recuperato in seguito dai metadati del contenuto

properties.isDeprecated

flag

Il flag indica se questo modello è deprecato

properties.lastPublishDate

string (date)

Data di ultima pubblicazione dell'elemento di contenuto

properties.packageId

string

l'ID del pacchetto contiene questo modello

properties.packageKind

packageKind

il packageKind del pacchetto contiene questo modello

properties.packageName

string

Il nome del pacchetto contiene questo modello

properties.packageVersion

string

Versione del pacchetto. Il formato predefinito e consigliato è numerico (ad esempio 1, 1.0, 1.0.0, 1.0.0.0), seguendo le best practice per i metadati ARM. Può anche essere qualsiasi stringa, ma in questo caso non possiamo garantire alcun controllo della versione

properties.packagedContent

object

Il codice JSON del modello di Resource Manager da distribuire

properties.previewImages

string[]

Visualizza l'anteprima dei nomi dei file immagine. Questi verranno presi dagli artefatti della soluzione

properties.previewImagesDark

string[]

Visualizza l'anteprima dei nomi dei file immagine. Questi saranno presi dagli artefatti della soluzione. Utilizzato per il supporto del tema scuro

properties.providers

string[]

Fornitori per l'elemento di contenuto

properties.source

metadataSource

Fonte del contenuto. Questo è dove/come è stato creato.

properties.support

metadataSupport

Informazioni di supporto per il modello: tipo, nome, informazioni di contatto

properties.threatAnalysisTactics

string[]

Le tattiche coperte dalla risorsa

properties.threatAnalysisTechniques

string[]

Le tecniche coperte dalla risorsa, queste devono essere allineate con le tattiche utilizzate

properties.version

string

Versione del contenuto. Il formato predefinito e consigliato è numerico (ad esempio 1, 1.0, 1.0.0, 1.0.0.0), seguendo le best practice per i metadati ARM. Può anche essere qualsiasi stringa, ma in questo caso non possiamo garantire alcun controllo della versione

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

sourceKind

Tipo di origine del contenuto

Valore Descrizione
LocalWorkspace
Community
Solution
SourceRepository

supportTier

Tipo di supporto per l'elemento di contenuto

Valore Descrizione
Microsoft
Partner
Community

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string (date-time)

Timestamp della creazione della risorsa (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string (date-time)

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.