Components - Create Or Update

Riferimento

Service:: Application Insights

API Version:: 2015-05-01

Crea (o aggiorna) un componente di Application Insights. Nota: non è possibile specificare un valore diverso per InstrumentationKey o AppId nell'operazione Put.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
resourceName	path	True	string	Nome della risorsa componente di Application Insights.
subscriptionId	path	True	string	ID della sottoscrizione di destinazione.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
kind	True	string	Tipo di applicazione a cui fa riferimento questo componente, usato per personalizzare l'interfaccia utente. Questo valore è una stringa a mano libera, i valori devono in genere essere uno dei seguenti: web, ios, altro, store, java, phone.
location	True	string	Posizione risorsa
properties.Application_Type	True	ApplicationType	Tipo di applicazione monitorata.
properties.DisableIpMasking		boolean	Disabilitare la maschera IP.
properties.Flow_Type		FlowType	Usato dal sistema di Application Insights per determinare il tipo di flusso creato da questo componente. Questa impostazione deve essere impostata su "Bluefield" durante la creazione/aggiornamento di un componente tramite l'API REST.
properties.HockeyAppId		string	ID applicazione univoco creato quando viene aggiunta una nuova applicazione a HockeyApp, usata per le comunicazioni con HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Ripulire i dati immediatamente dopo 30 giorni.
properties.IngestionMode		IngestionMode	Indica il flusso dell'inserimento.
properties.Request_Source		RequestSource	Descrive lo strumento creato dal componente Application Insights. I clienti che usano questa API devono impostare questa impostazione sul valore predefinito "rest".
properties.RetentionInDays		integer	Periodo di conservazione in giorni.
properties.SamplingPercentage		number	Percentuale dei dati prodotti dall'applicazione monitorata che viene campionata per i dati di telemetria di Application Insights.
tags		object	Tag delle risorse

Risposte

Nome	Tipo	Descrizione
200 OK	ApplicationInsightsComponent	Richiesta riuscita durante la creazione o l'aggiornamento di un componente di Application Insights. Viene restituito il componente aggiornato.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ComponentCreate

ComponentUpdate

ComponentCreate

Sample Request

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

Sample Response

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

Sample Request

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

Sample Response

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

Definizioni

Nome	Descrizione
ApplicationInsightsComponent	Definizione di componente di Application Insights.
ApplicationType	Tipo di applicazione monitorata.
FlowType	Usato dal sistema di Application Insights per determinare il tipo di flusso creato da questo componente. Questa impostazione deve essere impostata su "Bluefield" durante la creazione/aggiornamento di un componente tramite l'API REST.
IngestionMode	Indica il flusso dell'inserimento.
PrivateLinkScopedResource	Informazioni di riferimento sulle risorse dell'ambito del collegamento privato.
RequestSource	Descrive lo strumento creato dal componente Application Insights. I clienti che usano questa API devono impostare questa impostazione sul valore predefinito "rest".

ApplicationInsightsComponent

Definizione di componente di Application Insights.

Nome	Tipo	Valore predefinito	Descrizione
id	string		ID risorsa di Azure
kind	string		Tipo di applicazione a cui fa riferimento questo componente, usato per personalizzare l'interfaccia utente. Questo valore è una stringa a mano libera, i valori devono in genere essere uno dei seguenti: web, ios, altro, store, java, phone.
location	string		Posizione risorsa
name	string		Nome risorsa di Azure
properties.AppId	string		ID univoco di Application Insights per l'applicazione.
properties.ApplicationId	string		ID univoco dell'applicazione. Questo campo rispecchia il campo 'Name' e non può essere modificato.
properties.Application_Type	ApplicationType	web	Tipo di applicazione monitorata.
properties.ConnectionString	string		Stringa di connessione del componente Application Insights.
properties.CreationDate	string		Data di creazione per il componente Application Insights, in formato ISO 8601.
properties.DisableIpMasking	boolean		Disabilitare la maschera IP.
properties.Flow_Type	FlowType	Bluefield	Usato dal sistema di Application Insights per determinare il tipo di flusso creato da questo componente. Questa impostazione deve essere impostata su "Bluefield" durante la creazione/aggiornamento di un componente tramite l'API REST.
properties.HockeyAppId	string		ID applicazione univoco creato quando viene aggiunta una nuova applicazione a HockeyApp, usata per le comunicazioni con HockeyApp.
properties.HockeyAppToken	string		Token usato per autenticare le comunicazioni tra Application Insights e HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Ripulire i dati immediatamente dopo 30 giorni.
properties.IngestionMode	IngestionMode	ApplicationInsights	Indica il flusso dell'inserimento.
properties.InstrumentationKey	string		Chiave di strumentazione di Application Insights. Valore di sola lettura che le applicazioni possono usare per identificare la destinazione per tutti i dati di telemetria inviati a applicazione Azure Insights. Questo valore verrà fornito durante la costruzione di ogni nuovo componente di Application Insights.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Elenco delle risorse dell'ambito del collegamento privato collegato.
properties.Request_Source	RequestSource	rest	Descrive lo strumento creato dal componente Application Insights. I clienti che usano questa API devono impostare questa impostazione sul valore predefinito "rest".
properties.RetentionInDays	integer	90	Periodo di conservazione in giorni.
properties.SamplingPercentage	number		Percentuale dei dati prodotti dall'applicazione monitorata che viene campionata per i dati di telemetria di Application Insights.
properties.TenantId	string		ID tenant di Azure.
properties.provisioningState	string		Stato corrente di questo componente: se è stato effettuato il provisioning o meno all'interno del gruppo di risorse definito. Gli utenti non possono modificare questo valore, ma possono leggerlo. I valori includono Succeeded, Deploying, Canceled e Failed.
tags	object		Tag delle risorse
type	string		Tipo di risorsa di Azure

ApplicationType

Tipo di applicazione monitorata.

Nome	Tipo	Descrizione
other	string
web	string

FlowType

Usato dal sistema di Application Insights per determinare il tipo di flusso creato da questo componente. Questa impostazione deve essere impostata su "Bluefield" durante la creazione/aggiornamento di un componente tramite l'API REST.

Nome	Tipo	Descrizione
Bluefield	string

IngestionMode

Indica il flusso dell'inserimento.

Nome	Tipo	Descrizione
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

Informazioni di riferimento sulle risorse dell'ambito del collegamento privato.

Nome	Tipo	Descrizione
ResourceId	string	ID completo della risorsa dell'ambito del collegamento privato.
ScopeId	string	Identificatore univoco dell'ambito del collegamento privato.

RequestSource

Descrive lo strumento creato dal componente Application Insights. I clienti che usano questa API devono impostare questa impostazione sul valore predefinito "rest".

Nome	Tipo	Descrizione
rest	string

Components - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Scopes

Esempio

ComponentCreate

Sample Request

Sample Response

ComponentUpdate

Sample Request

Sample Response

Definizioni

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Risorse aggiuntive