Metadata - Create

Servizio:

Sentinel

Versione API:

2025-09-01

Creare un metadati.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
metadataName	path	True	string pattern: ^\S+$	Nome metadati.
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.
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.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.kind	True	string	Il tipo di contenuto a cui sono destinati i metadati.
properties.parentId	True	string	ID risorsa padre completo dell'elemento di contenuto a cui si riferiscono i metadati. Si tratta dell'ID completo della risorsa, incluso l'ambito (sottoscrizione e gruppo di risorse)
etag		string	Etag della risorsa di Azure
properties.author		metadataAuthor	L'autore dell'elemento di contenuto.
properties.categories		metadataCategories	Categorie per l'elemento di contenuto della soluzione
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.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.firstPublishDate		string (date)	Elemento di contenuto della soluzione della prima data di pubblicazione
properties.icon		string	l'identificatore dell'icona. Questo ID può essere recuperato in un secondo momento dal modello di soluzione
properties.lastPublishDate		string (date)	Data dell'ultima pubblicazione per l'elemento di contenuto della soluzione
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[]	Provider per l'elemento di contenuto della soluzione
properties.source		metadataSource	Fonte del contenuto. Questo è dove/come è stato creato.
properties.support		metadataSupport	Informazioni di supporto per i metadati: 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 procedure consigliate per i modelli di Resource Manager. Può anche essere qualsiasi stringa, ma in questo caso non possiamo garantire alcun controllo della versione

Risposte

Nome	Tipo	Descrizione
200 OK	MetadataModel	OK, operazione completata con successo
201 Created	MetadataModel	Created
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

Create/update full metadata.

Create/update minimal metadata.

Create/update full metadata.

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/metadata/metadataName?api-version=2025-09-01

{
  "properties": {
    "contentId": "c00ee137-7475-47c8-9cce-ec6f0f1bedd0",
    "version": "1.0.0.0",
    "kind": "AnalyticsRule",
    "parentId": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/ruleName",
    "source": {
      "kind": "Solution",
      "name": "Contoso Solution 1.0",
      "sourceId": "b688a130-76f4-4a07-bf57-762222a3cadf"
    },
    "author": {
      "name": "User Name",
      "email": "email@microsoft.com"
    },
    "support": {
      "name": "Microsoft",
      "email": "support@microsoft.com",
      "link": "https://support.microsoft.com/",
      "tier": "Partner"
    },
    "dependencies": {
      "operator": "AND",
      "criteria": [
        {
          "operator": "OR",
          "criteria": [
            {
              "contentId": "045d06d0-ee72-4794-aba4-cf5646e4c756",
              "kind": "DataConnector",
              "name": "Microsoft Defender for Endpoint"
            },
            {
              "contentId": "dbfcb2cc-d782-40ef-8d94-fe7af58a6f2d",
              "kind": "DataConnector"
            },
            {
              "contentId": "de4dca9b-eb37-47d6-a56f-b8b06b261593",
              "kind": "DataConnector",
              "version": "2.0"
            }
          ]
        },
        {
          "kind": "Playbook",
          "contentId": "31ee11cc-9989-4de8-b176-5e0ef5c4dbab",
          "version": "1.0"
        },
        {
          "kind": "Parser",
          "contentId": "21ba424a-9438-4444-953a-7059539a7a1b"
        }
      ]
    },
    "categories": {
      "domains": [
        "Application",
        "Security – Insider Threat"
      ],
      "verticals": [
        "Healthcare"
      ]
    },
    "providers": [
      "Amazon",
      "Microsoft"
    ],
    "firstPublishDate": "2021-05-18",
    "lastPublishDate": "2021-05-18",
    "previewImages": [
      "firstImage.png",
      "secondImage.jpeg"
    ],
    "previewImagesDark": [
      "firstImageDark.png",
      "secondImageDark.jpeg"
    ],
    "contentSchemaVersion": "2.0",
    "customVersion": "1.0",
    "threatAnalysisTactics": [
      "reconnaissance",
      "commandandcontrol"
    ],
    "threatAnalysisTechniques": [
      "T1548",
      "T1548.001"
    ]
  }
}

Risposta di esempio

Codice di stato:

201

{
  "id": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/metadata/metadataName",
  "name": "metadataName",
  "type": "Microsoft.SecurityInsights/metadata",
  "properties": {
    "contentId": "c00ee137-7475-47c8-9cce-ec6f0f1bedd0",
    "version": "1.0.0.0",
    "kind": "AnalyticsRule",
    "parentId": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/ruleName",
    "source": {
      "kind": "Solution",
      "name": "Contoso Solution 1.0",
      "sourceId": "b688a130-76f4-4a07-bf57-762222a3cadf"
    },
    "author": {
      "name": "User Name",
      "email": "email@microsoft.com"
    },
    "support": {
      "name": "Microsoft",
      "email": "support@microsoft.com",
      "link": "https://support.microsoft.com/",
      "tier": "Partner"
    },
    "dependencies": {
      "operator": "AND",
      "criteria": [
        {
          "operator": "OR",
          "criteria": [
            {
              "contentId": "045d06d0-ee72-4794-aba4-cf5646e4c756",
              "kind": "DataConnector"
            },
            {
              "contentId": "dbfcb2cc-d782-40ef-8d94-fe7af58a6f2d",
              "kind": "DataConnector"
            },
            {
              "contentId": "de4dca9b-eb37-47d6-a56f-b8b06b261593",
              "kind": "DataConnector",
              "version": "2.0"
            }
          ]
        },
        {
          "kind": "Playbook",
          "contentId": "31ee11cc-9989-4de8-b176-5e0ef5c4dbab",
          "version": "1.0"
        },
        {
          "kind": "Parser",
          "contentId": "21ba424a-9438-4444-953a-7059539a7a1b"
        }
      ]
    },
    "categories": {
      "domains": [
        "Application",
        "Security – Insider Threat"
      ],
      "verticals": [
        "Healthcare"
      ]
    },
    "providers": [
      "Amazon",
      "Microsoft"
    ],
    "firstPublishDate": "2021-05-18",
    "lastPublishDate": "2021-05-18",
    "previewImages": [
      "firstImage.png",
      "secondImage.jpeg"
    ],
    "previewImagesDark": [
      "firstImageDark.png",
      "secondImageDark.jpeg"
    ],
    "contentSchemaVersion": "2.0",
    "customVersion": "1.0",
    "threatAnalysisTactics": [
      "reconnaissance",
      "commandandcontrol"
    ],
    "threatAnalysisTechniques": [
      "T1548",
      "T1548.001"
    ]
  }
}

Codice di stato:

200

{
  "id": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/metadata/metadataName",
  "name": "metadataName",
  "type": "Microsoft.SecurityInsights/metadata",
  "properties": {
    "contentId": "c00ee137-7475-47c8-9cce-ec6f0f1bedd0",
    "version": "1.0.0.0",
    "kind": "AnalyticsRule",
    "parentId": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/ruleName",
    "source": {
      "kind": "Solution",
      "name": "Contoso Solution 1.0",
      "sourceId": "b688a130-76f4-4a07-bf57-762222a3cadf"
    },
    "author": {
      "name": "User Name",
      "email": "email@microsoft.com"
    },
    "support": {
      "name": "Microsoft",
      "email": "support@microsoft.com",
      "link": "https://support.microsoft.com/",
      "tier": "Partner"
    },
    "dependencies": {
      "operator": "AND",
      "criteria": [
        {
          "operator": "OR",
          "criteria": [
            {
              "contentId": "045d06d0-ee72-4794-aba4-cf5646e4c756",
              "kind": "DataConnector"
            },
            {
              "contentId": "dbfcb2cc-d782-40ef-8d94-fe7af58a6f2d",
              "kind": "DataConnector"
            },
            {
              "contentId": "de4dca9b-eb37-47d6-a56f-b8b06b261593",
              "kind": "DataConnector",
              "version": "2.0"
            }
          ]
        },
        {
          "kind": "Playbook",
          "contentId": "31ee11cc-9989-4de8-b176-5e0ef5c4dbab",
          "version": "1.0"
        },
        {
          "kind": "Parser",
          "contentId": "21ba424a-9438-4444-953a-7059539a7a1b"
        }
      ]
    },
    "categories": {
      "domains": [
        "Application",
        "Security – Insider Threat"
      ],
      "verticals": [
        "Healthcare"
      ]
    },
    "providers": [
      "Amazon",
      "Microsoft"
    ],
    "firstPublishDate": "2021-05-18",
    "lastPublishDate": "2021-05-18",
    "previewImages": [
      "firstImage.png",
      "secondImage.jpeg"
    ],
    "previewImagesDark": [
      "firstImageDark.png",
      "secondImageDark.jpeg"
    ],
    "contentSchemaVersion": "2.0",
    "customVersion": "1.0",
    "threatAnalysisTactics": [
      "reconnaissance",
      "commandandcontrol"
    ],
    "threatAnalysisTechniques": [
      "T1548",
      "T1548.001"
    ]
  }
}

Create/update minimal metadata.

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/metadata/metadataName?api-version=2025-09-01

{
  "properties": {
    "contentId": "c00ee137-7475-47c8-9cce-ec6f0f1bedd0",
    "kind": "AnalyticsRule",
    "parentId": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/ruleName"
  }
}

Risposta di esempio

Codice di stato:

201

{
  "id": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/metadata/metadataName",
  "name": "metadataName",
  "type": "Microsoft.SecurityInsights/metadata",
  "properties": {
    "kind": "AnalyticsRule",
    "parentId": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/ruleName"
  }
}

Codice di stato:

200

{
  "id": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/metadata/metadataName",
  "name": "metadataName",
  "type": "Microsoft.SecurityInsights/metadata",
  "properties": {
    "kind": "AnalyticsRule",
    "parentId": "/subscriptions/2e1dc338-d04d-4443-b721-037eff4fdcac/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/alertRules/ruleName"
  }
}

Definizioni

Nome	Descrizione
CloudError	Struttura della risposta all'errore.
CloudErrorBody	Dettagli errore.
createdByType	Tipo di identità che ha creato la risorsa.
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.
MetadataModel	Definizione della risorsa metadati.
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.
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

Object

Struttura della risposta all'errore.

Nome	Tipo	Descrizione
error	CloudErrorBody	Dati di errore

CloudErrorBody

Object

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

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

metadataAuthor

Object

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

Object

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

Object

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	string	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.

MetadataModel

Object

Definizione della risorsa metadati.

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'elemento di contenuto della soluzione
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.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.firstPublishDate	string (date)	Elemento di contenuto della soluzione della prima data di pubblicazione
properties.icon	string	l'identificatore dell'icona. Questo ID può essere recuperato in un secondo momento dal modello di soluzione
properties.kind	string	Il tipo di contenuto a cui sono destinati i metadati.
properties.lastPublishDate	string (date)	Data dell'ultima pubblicazione per l'elemento di contenuto della soluzione
properties.parentId	string	ID risorsa padre completo dell'elemento di contenuto a cui si riferiscono i metadati. Si tratta dell'ID completo della risorsa, incluso l'ambito (sottoscrizione e gruppo di risorse)
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[]	Provider per l'elemento di contenuto della soluzione
properties.source	metadataSource	Fonte del contenuto. Questo è dove/come è stato creato.
properties.support	metadataSupport	Informazioni di supporto per i metadati: 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 procedure consigliate per i modelli di Resource Manager. 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"

metadataSource

Object

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

Object

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

Enumerazione

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

Valore	Descrizione
AND
OR

sourceKind

Enumerazione

Tipo di origine del contenuto

Valore	Descrizione
LocalWorkspace
Community
Solution
SourceRepository

supportTier

Enumerazione

Tipo di supporto per l'elemento di contenuto

Valore	Descrizione
Microsoft
Partner
Community

systemData

Object

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.