Components - Create Or Update

Tjänst:: Application Insights

API-version:: 2015-05-01

Skapar (eller uppdaterar) en Application Insights-komponent. Obs! Du kan inte ange ett annat värde för InstrumentationKey eller AppId i put-åtgärden.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
resourceName	path	True	string	Namnet på Application Insights-komponentresursen.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
kind	True	string	Den typ av program som den här komponenten refererar till, som används för att anpassa användargränssnittet. Det här värdet är en frihandssträng, värden bör vanligtvis vara något av följande: web, ios, other, store, java, phone.
location	True	string	Resursplats
properties.Application_Type	True	ApplicationType	Typ av program som övervakas.
properties.DisableIpMasking		boolean	Inaktivera IP-maskering.
properties.Flow_Type		FlowType	Används av Application Insights-systemet för att avgöra vilken typ av flöde komponenten skapades av. Detta ska anges till "Bluefield" när du skapar/uppdaterar en komponent via REST-API:et.
properties.HockeyAppId		string	Det unika program-ID som skapas när ett nytt program läggs till i HockeyApp, som används för kommunikation med HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Rensa data omedelbart efter 30 dagar.
properties.IngestionMode		IngestionMode	Anger flödet för inmatningen.
properties.Request_Source		RequestSource	Beskriver vilket verktyg som skapade den här Application Insights-komponenten. Kunder som använder det här API:et bör ange standardvärdet "rest".
properties.RetentionInDays		integer	Kvarhållningsperiod i dagar.
properties.SamplingPercentage		number (double)	Procentandel av de data som produceras av programmet som övervakas och som samplas för Application Insights-telemetri.
tags		object	Resurstaggar

Svar

Name	Typ	Description
200 OK	ApplicationInsightsComponent	Lyckad begäran när du skapar eller uppdaterar en Application Insights-komponent. Den uppdaterade komponenten returneras.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

ComponentCreate

ComponentUpdate

ComponentCreate

Exempelbegäran

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

Exempelsvar

Statuskod:: 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

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name	Description
ApplicationInsightsComponent	En Application Insights-komponentdefinition.
ApplicationType	Typ av program som övervakas.
FlowType	Används av Application Insights-systemet för att avgöra vilken typ av flöde komponenten skapades av. Detta ska anges till "Bluefield" när du skapar/uppdaterar en komponent via REST-API:et.
IngestionMode	Anger flödet för inmatningen.
PrivateLinkScopedResource	Resursreferensen för private link-omfånget.
RequestSource	Beskriver vilket verktyg som skapade den här Application Insights-komponenten. Kunder som använder det här API:et bör ange standardvärdet "rest".

ApplicationInsightsComponent

Objekt

En Application Insights-komponentdefinition.

Name	Typ	Standardvärde	Description
id	string		Azure-resurs-ID
kind	string		Den typ av program som den här komponenten refererar till, som används för att anpassa användargränssnittet. Det här värdet är en frihandssträng, värden bör vanligtvis vara något av följande: web, ios, other, store, java, phone.
location	string		Resursplats
name	string		Azure-resursnamn
properties.AppId	string		Application Insights Unikt ID för ditt program.
properties.ApplicationId	string		Det unika ID:t för ditt program. Det här fältet speglar fältet Namn och kan inte ändras.
properties.Application_Type	ApplicationType	web	Typ av program som övervakas.
properties.ConnectionString	string		Application Insights-komponentanslutningssträng.
properties.CreationDate	string (date-time)		Skapandedatum för Application Insights-komponenten i ISO 8601-format.
properties.DisableIpMasking	boolean		Inaktivera IP-maskering.
properties.Flow_Type	FlowType	Bluefield	Används av Application Insights-systemet för att avgöra vilken typ av flöde komponenten skapades av. Detta ska anges till "Bluefield" när du skapar/uppdaterar en komponent via REST-API:et.
properties.HockeyAppId	string		Det unika program-ID som skapas när ett nytt program läggs till i HockeyApp, som används för kommunikation med HockeyApp.
properties.HockeyAppToken	string		Token som används för att autentisera kommunikation med mellan Application Insights och HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Rensa data omedelbart efter 30 dagar.
properties.IngestionMode	IngestionMode	ApplicationInsights	Anger flödet för inmatningen.
properties.InstrumentationKey	string		Application Insights Instrumentation-nyckel. Ett skrivskyddat värde som program kan använda för att identifiera målet för all telemetri som skickas till Azure Application Insights. Det här värdet kommer att anges vid konstruktion av varje ny Application Insights-komponent.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Lista över resurser för länkat privat länkomfång.
properties.Request_Source	RequestSource	rest	Beskriver vilket verktyg som skapade den här Application Insights-komponenten. Kunder som använder det här API:et bör ange standardvärdet "rest".
properties.RetentionInDays	integer	90	Kvarhållningsperiod i dagar.
properties.SamplingPercentage	number (double)		Procentandel av de data som produceras av programmet som övervakas och som samplas för Application Insights-telemetri.
properties.TenantId	string		Azure-klientorganisations-ID.
properties.provisioningState	string		Aktuellt tillstånd för den här komponenten: om den har etablerats i den resursgrupp som den har definierats eller inte. Användare kan inte ändra det här värdet men kan läsa från det. Värdena inkluderar Succeeded, Deploying, Canceled och Failed.
tags	object		Resurstaggar
type	string		Azure-resurstyp

ApplicationType

Uppräkning

Typ av program som övervakas.

Värde	Description
web
other

FlowType

Uppräkning

Används av Application Insights-systemet för att avgöra vilken typ av flöde komponenten skapades av. Detta ska anges till "Bluefield" när du skapar/uppdaterar en komponent via REST-API:et.

Värde	Description
Bluefield

IngestionMode

Uppräkning

Anger flödet för inmatningen.

Värde	Description
ApplicationInsights
ApplicationInsightsWithDiagnosticSettings
LogAnalytics

PrivateLinkScopedResource

Objekt

Resursreferensen för private link-omfånget.

Name	Typ	Description
ResourceId	string	Det fullständiga resurs-ID:t för den privata länkomfångsresursen.
ScopeId	string	Den unika identifieraren för det privata länkomfånget.

RequestSource

Uppräkning

Beskriver vilket verktyg som skapade den här Application Insights-komponenten. Kunder som använder det här API:et bör ange standardvärdet "rest".

Värde	Description
rest

Dela via

Components - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

ComponentCreate

Exempelbegäran

Exempelsvar

ComponentUpdate

Exempelbegäran

Exempelsvar

Definitioner

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource