Compartir a través de


Product Template - Get

Obtiene una plantilla por su identificador.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
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.

templateId
path True

string

ID de plantilla

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.

Respuestas

Nombre Tipo Description
200 OK

productTemplateModel

OK

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

Get a template.

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
CloudError

Estructura de respuesta de error.

CloudErrorBody

Detalles del error.

createdByType

Tipo de identidad que creó el recurso.

flag

La marca indica si esta plantilla está en desuso

kind

El tipo de contenido para el que es la plantilla.

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.

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.

packageKind

el packageKind del paquete contiene esta plantilla

productTemplateModel

Definición de recursos de plantilla.

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

Estructura de respuesta de error.

Nombre Tipo Description
error

CloudErrorBody

Datos de error

CloudErrorBody

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

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

flag

La marca indica si esta plantilla está en desuso

Valor Description
true
false

kind

El tipo de contenido para el que es la plantilla.

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

Los conectores de la plataforma de conectores sin código (CCP)

Notebook

Cuadernos Jupyter

Standalone

Contenido único / independiente aportado por colaboradores de la comunidad

SummaryRule

Las reglas de resumen realizan el procesamiento por lotes directamente en el área de trabajo de Log Analytics.

metadataAuthor

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

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

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

kind

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.

metadataSource

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

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

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

Valor Description
AND
OR

packageKind

el packageKind del paquete contiene esta plantilla

Valor Description
Solution
Standalone

productTemplateModel

Definición de recursos de plantilla.

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 artículo

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

kind

El tipo de contenido para el que es la plantilla.

properties.contentProductId

string

ID único para el contenido. Debe generarse en función del contentId del paquete, contentId de la plantilla, contentKind de la plantilla y contentVersion de la plantilla

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

string

El nombre para mostrar de la plantilla

properties.firstPublishDate

string (date)

Elemento de contenido de la primera fecha de publicación

properties.icon

string

el identificador del icono. Este ID se puede obtener posteriormente de los metadatos de contenido

properties.isDeprecated

flag

La marca indica si esta plantilla está en desuso

properties.lastPublishDate

string (date)

Fecha de última publicación para el elemento de contenido

properties.packageId

string

el identificador del paquete contiene esta plantilla

properties.packageKind

packageKind

el packageKind del paquete contiene esta plantilla

properties.packageName

string

El nombre del paquete contiene esta plantilla

properties.packageVersion

string

Versión del paquete. 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 metadatos de ARM. También puede ser cualquier cadena, pero entonces no podemos garantizar ninguna comprobación de versión

properties.packagedContent

object

El json de la plantilla de ARM que se va a implementar

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

properties.source

metadataSource

Fuente del contenido. Aquí es dónde/cómo se creó.

properties.support

metadataSupport

Información de soporte para la plantilla: 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 metadatos 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"

sourceKind

Tipo de fuente del contenido

Valor Description
LocalWorkspace
Community
Solution
SourceRepository

supportTier

Tipo de soporte para el elemento de contenido

Valor Description
Microsoft
Partner
Community

systemData

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.