Metadata - Create

Servicio:

Sentinel

Versión de la API:

2025-09-01

Crear metadatos.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
metadataName	path	True	string pattern: ^\S+$	Nombre de metadatos.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
workspaceName	path	True	string minLength: 1 maxLength: 90 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nombre del área de trabajo.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.kind	True	string	El tipo de contenido para el que son los metadatos.
properties.parentId	True	string	Identificador completo del recurso primario del elemento de contenido para el que son los metadatos. Este es el identificador de recurso completo, incluido el ámbito (suscripción y grupo de recursos)
etag		string	Etag del recurso de Azure
properties.author		metadataAuthor	El creador del elemento de contenido.
properties.categories		metadataCategories	Categorías para el elemento de contenido de la solución
properties.contentId		string	ID estático para el contenido. Se usa para identificar dependencias y contenido de soluciones o comunidad. Codificado/estático para contenido y soluciones listos para usar. Dinámico para creado por el usuario. Este es el nombre del recurso
properties.contentSchemaVersion		string	Versión de esquema del contenido. Se puede utilizar para distinguir entre diferentes flujos en función de la versión del esquema
properties.customVersion		string	La versión personalizada del contenido. Un texto libre opcional
properties.dependencies		metadataDependencies	Dependencias del elemento de contenido, qué otros elementos de contenido requiere para funcionar. Puede describir dependencias más complejas mediante una estructura recursiva o anidada. Para una sola dependencia, se puede proporcionar un id / tipo / versión u operador / criterio para formatos complejos.
properties.firstPublishDate		string (date)	Elemento de contenido de la solución de la primera fecha de publicación
properties.icon		string	el identificador del icono. Este identificador se puede capturar posteriormente de la plantilla de solución
properties.lastPublishDate		string (date)	Fecha de última publicación para el elemento de contenido de la solución
properties.previewImages		string[]	Previsualiza los nombres de los archivos de imagen. Estos se tomarán de los artefactos de la solución
properties.previewImagesDark		string[]	Previsualiza los nombres de los archivos de imagen. Estos se tomarán de los artefactos de solución. Se utiliza para la compatibilidad con temas oscuros
properties.providers		string[]	Proveedores para el elemento de contenido de la solución
properties.source		metadataSource	Fuente del contenido. Aquí es dónde/cómo se creó.
properties.support		metadataSupport	Información de soporte para los metadatos: tipo, nombre, información de contacto
properties.threatAnalysisTactics		string[]	Las tácticas que cubre el recurso
properties.threatAnalysisTechniques		string[]	las técnicas que cubre el recurso, estas deben estar alineadas con las tácticas que se utilizan
properties.version		string	Versión del contenido. El formato predeterminado y recomendado es numérico (por ejemplo, 1, 1.0, 1.0.0, 1.0.0.0), siguiendo los procedimientos recomendados de plantilla de ARM. También puede ser cualquier cadena, pero entonces no podemos garantizar ninguna comprobación de versión

Respuestas

Nombre	Tipo	Description
200 OK	MetadataModel	OK, Operación completada con éxito
201 Created	MetadataModel	Creado
Other Status Codes	CloudError	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Create/update full metadata.

Create/update minimal metadata.

Create/update full metadata.

Solicitud de ejemplo

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"
    ]
  }
}

Respuesta de muestra

status code:

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"
    ]
  }
}

status code:

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.

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:

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"
  }
}

status code:

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"
  }
}

Definiciones

Nombre	Description
CloudError	Estructura de respuesta de error.
CloudErrorBody	Detalles del error.
createdByType	Tipo de identidad que creó el recurso.
metadataAuthor	Editor o creador del elemento de contenido.
metadataCategories	ies para el elemento de contenido de la solución
metadataDependencies	Dependencias del elemento de contenido, qué otros elementos de contenido requiere para funcionar. Puede describir dependencias más complejas mediante una estructura recursiva o anidada. Para una sola dependencia, se puede proporcionar un id/tipo/versión u operador/criterio para dependencias complejas.
MetadataModel	Definición de recursos de metadatos.
metadataSource	El origen original del elemento de contenido, de dónde proviene.
metadataSupport	Información de soporte técnico para el elemento de contenido.
operator	Operador utilizado para la lista de dependencias en la matriz de criterios.
sourceKind	Tipo de fuente del contenido
supportTier	Tipo de soporte para el elemento de contenido
systemData	Metadatos relativos a la creación y última modificación del recurso.

CloudError

Object

Estructura de respuesta de error.

Nombre	Tipo	Description
error	CloudErrorBody	Datos de error

CloudErrorBody

Object

Detalles del error.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

metadataAuthor

Object

Editor o creador del elemento de contenido.

Nombre	Tipo	Description
email	string	Correo electrónico de contacto del autor
link	string	Enlace para la página de autor/proveedor
name	string	Nombre del autor. Empresa o persona.

metadataCategories

Object

ies para el elemento de contenido de la solución

Nombre	Tipo	Description
domains	string[]	dominio para el elemento de contenido de la solución
verticals	string[]	Verticales del sector para el elemento de contenido de la solución

metadataDependencies

Object

Dependencias del elemento de contenido, qué otros elementos de contenido requiere para funcionar. Puede describir dependencias más complejas mediante una estructura recursiva o anidada. Para una sola dependencia, se puede proporcionar un id/tipo/versión u operador/criterio para dependencias complejas.

Nombre	Tipo	Description
contentId	string	Id del elemento de contenido del que dependemos
criteria	metadataDependencies[]	Esta es la lista de dependencias que debemos cumplir, según el operador AND/OR
kind	string	Tipo de contenido del que dependemos
name	string	Nombre del elemento de contenido
operator	operator	Operador utilizado para la lista de dependencias en la matriz de criterios.
version	string	Versión del elemento de contenido del que dependemos. Puede estar en blanco, * o faltar para indicar que cualquier versión cumple con la dependencia. Si la versión no coincide con nuestro formato numérico definido, se requiere una coincidencia exacta.

MetadataModel

Object

Definición de recursos de metadatos.

Nombre	Tipo	Description
etag	string	Etag del recurso de Azure
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties.author	metadataAuthor	El creador del elemento de contenido.
properties.categories	metadataCategories	Categorías para el elemento de contenido de la solución
properties.contentId	string	ID estático para el contenido. Se usa para identificar dependencias y contenido de soluciones o comunidad. Codificado/estático para contenido y soluciones listos para usar. Dinámico para creado por el usuario. Este es el nombre del recurso
properties.contentSchemaVersion	string	Versión de esquema del contenido. Se puede utilizar para distinguir entre diferentes flujos en función de la versión del esquema
properties.customVersion	string	La versión personalizada del contenido. Un texto libre opcional
properties.dependencies	metadataDependencies	Dependencias del elemento de contenido, qué otros elementos de contenido requiere para funcionar. Puede describir dependencias más complejas mediante una estructura recursiva o anidada. Para una sola dependencia, se puede proporcionar un id / tipo / versión u operador / criterio para formatos complejos.
properties.firstPublishDate	string (date)	Elemento de contenido de la solución de la primera fecha de publicación
properties.icon	string	el identificador del icono. Este identificador se puede capturar posteriormente de la plantilla de solución
properties.kind	string	El tipo de contenido para el que son los metadatos.
properties.lastPublishDate	string (date)	Fecha de última publicación para el elemento de contenido de la solución
properties.parentId	string	Identificador completo del recurso primario del elemento de contenido para el que son los metadatos. Este es el identificador de recurso completo, incluido el ámbito (suscripción y grupo de recursos)
properties.previewImages	string[]	Previsualiza los nombres de los archivos de imagen. Estos se tomarán de los artefactos de la solución
properties.previewImagesDark	string[]	Previsualiza los nombres de los archivos de imagen. Estos se tomarán de los artefactos de solución. Se utiliza para la compatibilidad con temas oscuros
properties.providers	string[]	Proveedores para el elemento de contenido de la solución
properties.source	metadataSource	Fuente del contenido. Aquí es dónde/cómo se creó.
properties.support	metadataSupport	Información de soporte para los metadatos: tipo, nombre, información de contacto
properties.threatAnalysisTactics	string[]	Las tácticas que cubre el recurso
properties.threatAnalysisTechniques	string[]	las técnicas que cubre el recurso, estas deben estar alineadas con las tácticas que se utilizan
properties.version	string	Versión del contenido. El formato predeterminado y recomendado es numérico (por ejemplo, 1, 1.0, 1.0.0, 1.0.0.0), siguiendo los procedimientos recomendados de plantilla de ARM. También puede ser cualquier cadena, pero entonces no podemos garantizar ninguna comprobación de versión
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

metadataSource

Object

El origen original del elemento de contenido, de dónde proviene.

Nombre	Tipo	Description
kind	sourceKind	Tipo de fuente del contenido
name	string	Nombre del origen de contenido. El nombre del repositorio, el nombre de la solución, el nombre del espacio de trabajo de LA, etc.
sourceId	string	Identificador del origen de contenido. El ID de la solución, el ID del área de trabajo, etc.

metadataSupport

Object

Información de soporte técnico para el elemento de contenido.

Nombre	Tipo	Description
email	string	Correo electrónico de contacto de soporte
link	string	Enlace para ayuda de soporte, como la página de soporte para abrir un ticket, etc.
name	string	Nombre del contacto de soporte. Empresa o persona.
tier	supportTier	Tipo de soporte para el elemento de contenido

operator

Enumeración

Operador utilizado para la lista de dependencias en la matriz de criterios.

Valor	Description
AND
OR

sourceKind

Enumeración

Tipo de fuente del contenido

Valor	Description
LocalWorkspace
Community
Solution
SourceRepository

supportTier

Enumeración

Tipo de soporte para el elemento de contenido

Valor	Description
Microsoft
Partner
Community

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.