Components - Create Or Update

Referencia

Servicio:: Application Insights

Versión de la API:: 2015-05-01

Crea (o actualiza) un componente de Application Insights. Nota: No se puede especificar un valor diferente para InstrumentationKey ni AppId en la operación Put.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}?api-version=2015-05-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
resourceName	path	True	string	Nombre del recurso de componente de Application Insights.
subscriptionId	path	True	string	Identificador de la suscripción de destino.
api-version	query	True	string	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
kind	True	string	Tipo de aplicación a la que hace referencia este componente, que se usa para personalizar la interfaz de usuario. Este valor es una cadena de forma libre, los valores normalmente deben ser uno de los siguientes: web, ios, other, store, java, phone.
location	True	string	Ubicación de los recursos
properties.Application_Type	True	ApplicationType	Tipo de aplicación que se está supervisando.
properties.DisableIpMasking		boolean	Deshabilite el enmascaramiento IP.
properties.Flow_Type		FlowType	Lo usa el sistema de Application Insights para determinar qué tipo de flujo creó este componente. Se debe establecer en "Bluefield" al crear o actualizar un componente a través de la API REST.
properties.HockeyAppId		string	El identificador de aplicación único creado cuando se agrega una nueva aplicación a HockeyApp, que se usa para las comunicaciones con HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Purga los datos inmediatamente después de 30 días.
properties.IngestionMode		IngestionMode	Indica el flujo de la ingesta.
properties.Request_Source		RequestSource	Describe qué herramienta creó este componente de Application Insights. Los clientes que usan esta API deben establecer esto en el "resto" predeterminado.
properties.RetentionInDays		integer	Período de retención en días.
properties.SamplingPercentage		number	Porcentaje de los datos generados por la aplicación que se está supervisando que se está muestreando para la telemetría de Application Insights.
tags		object	Etiquetas del recurso

Respuestas

Nombre	Tipo	Description
200 OK	ApplicationInsightsComponent	Solicitud correcta al crear o actualizar un componente de Application Insights. Se devuelve el componente actualizado.

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	suplantación de su cuenta de usuario

Ejemplos

ComponentCreate

ComponentUpdate

ComponentCreate

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component?api-version=2015-05-01

{
  "location": "South Central US",
  "kind": "web",
  "properties": {
    "Application_Type": "web",
    "Flow_Type": "Bluefield",
    "Request_Source": "rest"
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
  "name": "my-component",
  "type": "Microsoft.Insights/components",
  "location": "South Central US",
  "tags": "",
  "kind": "web",
  "properties": {
    "ApplicationId": "my-component",
    "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
    "Application_Type": "web",
    "Flow_Type": "Bluefield",
    "Request_Source": "rest",
    "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
    "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
    "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
    "HockeyAppId": "",
    "HockeyAppToken": "",
    "provisioningState": "Succeeded",
    "SamplingPercentage": 100,
    "RetentionInDays": 90,
    "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
    "DisableIpMasking": false,
    "ImmediatePurgeDataOn30Days": false,
    "IngestionMode": "ApplicationInsights"
  }
}

ComponentUpdate

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component?api-version=2015-05-01

{
  "location": "South Central US",
  "kind": "web",
  "tags": {
    "ApplicationGatewayType": "Internal-Only",
    "BillingEntity": "Self"
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component",
  "name": "my-component",
  "type": "Microsoft.Insights/components",
  "location": "South Central US",
  "tags": {
    "ApplicationGatewayType": "Internal-Only",
    "BillingEntity": "Self"
  },
  "kind": "web",
  "properties": {
    "ApplicationId": "my-component",
    "AppId": "887f4bfd-b5fd-40d7-9fc3-123456789abc",
    "Application_Type": "web",
    "Flow_Type": "Bluefield",
    "Request_Source": "rest",
    "InstrumentationKey": "bc095013-3cf2-45ac-ab47-123456789abc",
    "CreationDate": "2017-01-24T01:05:38.5934061+00:00",
    "TenantId": "f438d567-7177-4fe1-a5e3-123456789abc",
    "HockeyAppId": "",
    "HockeyAppToken": "",
    "provisioningState": "Succeeded",
    "SamplingPercentage": 100,
    "RetentionInDays": 90,
    "ConnectionString": "InstrumentationKey=bc095013-3cf2-45ac-ab47-123456789abc",
    "DisableIpMasking": false,
    "ImmediatePurgeDataOn30Days": false,
    "IngestionMode": "ApplicationInsights"
  }
}

Definiciones

Nombre	Description
ApplicationInsightsComponent	Una definición de componente de Application Insights.
ApplicationType	Tipo de aplicación que se está supervisando.
FlowType	Lo usa el sistema de Application Insights para determinar qué tipo de flujo creó este componente. Se debe establecer en "Bluefield" al crear o actualizar un componente a través de la API REST.
IngestionMode	Indica el flujo de la ingesta.
PrivateLinkScopedResource	Referencia de recursos de ámbito de vínculo privado.
RequestSource	Describe qué herramienta creó este componente de Application Insights. Los clientes que usan esta API deben establecer esto en el "resto" predeterminado.

ApplicationInsightsComponent

Una definición de componente de Application Insights.

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador de recurso de Azure
kind	string		Tipo de aplicación a la que hace referencia este componente, que se usa para personalizar la interfaz de usuario. Este valor es una cadena de forma libre, los valores normalmente deben ser uno de los siguientes: web, ios, other, store, java, phone.
location	string		Ubicación de los recursos
name	string		Nombre de recurso de Azure
properties.AppId	string		Id. único de Application Insights para la aplicación.
properties.ApplicationId	string		Identificador único de la aplicación. Este campo refleja el campo 'Name' y no se puede cambiar.
properties.Application_Type	ApplicationType	web	Tipo de aplicación que se está supervisando.
properties.ConnectionString	string		Cadena de conexión de componentes de Application Insights.
properties.CreationDate	string		Fecha de creación del componente de Application Insights, en formato ISO 8601.
properties.DisableIpMasking	boolean		Deshabilite el enmascaramiento IP.
properties.Flow_Type	FlowType	Bluefield	Lo usa el sistema de Application Insights para determinar qué tipo de flujo creó este componente. Se debe establecer en "Bluefield" al crear o actualizar un componente a través de la API REST.
properties.HockeyAppId	string		El identificador de aplicación único creado cuando se agrega una nueva aplicación a HockeyApp, que se usa para las comunicaciones con HockeyApp.
properties.HockeyAppToken	string		Token que se usa para autenticar las comunicaciones entre Application Insights y HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Purga los datos inmediatamente después de 30 días.
properties.IngestionMode	IngestionMode	ApplicationInsights	Indica el flujo de la ingesta.
properties.InstrumentationKey	string		Clave de instrumentación de Application Insights. Valor de solo lectura que las aplicaciones pueden usar para identificar el destino de todos los datos de telemetría enviados a Aplicación de Azure Insights. Este valor se proporcionará tras la construcción de cada nuevo componente de Application Insights.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Lista de recursos de ámbito de vínculo privado vinculados.
properties.Request_Source	RequestSource	rest	Describe qué herramienta creó este componente de Application Insights. Los clientes que usan esta API deben establecer esto en el "resto" predeterminado.
properties.RetentionInDays	integer	90	Período de retención en días.
properties.SamplingPercentage	number		Porcentaje de los datos generados por la aplicación que se está supervisando que se está muestreando para la telemetría de Application Insights.
properties.TenantId	string		Identificador de inquilino de Azure.
properties.provisioningState	string		Estado actual de este componente: si se ha aprovisionado o no dentro del grupo de recursos que está definido. Los usuarios no pueden cambiar este valor, pero pueden leerlo. Los valores incluirán Succeeded, Deploying, Canceled y Failed.
tags	object		Etiquetas del recurso
type	string		Tipo de recurso de Azure

ApplicationType

Tipo de aplicación que se está supervisando.

Nombre	Tipo	Description
other	string
web	string

FlowType

Lo usa el sistema de Application Insights para determinar qué tipo de flujo creó este componente. Se debe establecer en "Bluefield" al crear o actualizar un componente a través de la API REST.

Nombre	Tipo	Description
Bluefield	string

IngestionMode

Indica el flujo de la ingesta.

Nombre	Tipo	Description
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

Referencia de recursos de ámbito de vínculo privado.

Nombre	Tipo	Description
ResourceId	string	Identificador de recurso completo del recurso de ámbito de vínculo privado.
ScopeId	string	Identificador único del ámbito de vínculo privado.

RequestSource

Describe qué herramienta creó este componente de Application Insights. Los clientes que usan esta API deben establecer esto en el "resto" predeterminado.

Nombre	Tipo	Description
rest	string

Compartir a través de

Components - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

ComponentCreate

Solicitud de ejemplo

Respuesta de muestra

ComponentUpdate

Solicitud de ejemplo

Respuesta de muestra

Definiciones

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Recursos adicionales