Components - Create Or Update

Referens

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	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
resourceName	path	True	string	Namnet på Application Insights-komponentresursen.
subscriptionId	path	True	string	ID för målprenumerationen.
api-version	query	True	string	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 den här 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 inmatningsflödet.
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 detta till standard "vila".
properties.RetentionInDays		integer	Kvarhållningsperiod i dagar.
properties.SamplingPercentage		number	Procentandel av de data som genereras 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 Flow.

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 den här komponenten skapades av. Detta ska anges till "Bluefield" när du skapar/uppdaterar en komponent via REST-API:et.
IngestionMode	Anger inmatningsflödet.
PrivateLinkScopedResource	Resursreferensen för privat länkomfång.
RequestSource	Beskriver vilket verktyg som skapade den här Application Insights-komponenten. Kunder som använder det här API:et bör ange detta till standard "vila".

ApplicationInsightsComponent

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-komponenten anslutningssträng.
properties.CreationDate	string		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 den här 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 inmatningsflödet.
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 tillhandahållas 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 detta till standard "vila".
properties.RetentionInDays	integer	90	Kvarhållningsperiod i dagar.
properties.SamplingPercentage	number		Procentandel av de data som genereras 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

Typ av program som övervakas.

Name	Typ	Description
other	string
web	string

FlowType

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

Name	Typ	Description
Bluefield	string

IngestionMode

Anger inmatningsflödet.

Name	Typ	Description
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

Resursreferensen för privat länkomfång.

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

Beskriver vilket verktyg som skapade den här Application Insights-komponenten. Kunder som använder det här API:et bör ange detta till standard "vila".

Name	Typ	Description
rest	string

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

Ytterligare resurser