Components - Create Or Update

Servizio:: Application Insights

Versione API:: 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 minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
resourceName	path	True	string	Nome della risorsa componente di Application Insights.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	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	Percorso risorsa
properties.Application_Type	True	ApplicationType	Tipo di applicazione monitorata.
properties.DisableIpMasking		boolean	Disabilitare la maschera IP.
properties.Flow_Type		FlowType	Usato dal sistema Application Insights per determinare il tipo di flusso creato da questo componente. Questa opzione deve essere impostata su "Bluefield" durante la creazione o l'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	Eliminare 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 (double)	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.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ComponentCreate

ComponentUpdate

ComponentCreate

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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 Application Insights per determinare il tipo di flusso creato da questo componente. Questa opzione deve essere impostata su "Bluefield" durante la creazione o l'aggiornamento di un componente tramite l'API REST.
IngestionMode	Indica il flusso dell'inserimento.
PrivateLinkScopedResource	Riferimento alla risorsa 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

Object

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		Percorso 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 'Nome' 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 (date-time)		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 Application Insights per determinare il tipo di flusso creato da questo componente. Questa opzione deve essere impostata su "Bluefield" durante la creazione o l'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		Eliminare 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 ad Azure Application Insights. Questo valore verrà fornito alla 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 (double)		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 o meno il provisioning 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

Enumerazione

Tipo di applicazione monitorata.

Valore	Descrizione
web
other

FlowType

Enumerazione

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

Valore	Descrizione
Bluefield

IngestionMode

Enumerazione

Indica il flusso dell'inserimento.

Valore	Descrizione
ApplicationInsights
ApplicationInsightsWithDiagnosticSettings
LogAnalytics

PrivateLinkScopedResource

Object

Riferimento alla risorsa dell'ambito del collegamento privato.

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

RequestSource

Enumerazione

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

Valore	Descrizione
rest

Condividi tramite

Components - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

ComponentCreate

Esempio di richiesta

Risposta di esempio

ComponentUpdate

Esempio di richiesta

Risposta di esempio

Definizioni

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource