Components - Create Or Update

Referentie

Service:: Application Insights

API-versie:: 2015-05-01

Hiermee wordt een Application Insights-onderdeel gemaakt (of bijgewerkt). Opmerking: u kunt geen andere waarde opgeven voor InstrumentationKey of AppId in de bewerking Put.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
resourceName	path	True	string	De naam van de Application Insights-onderdeelresource.
subscriptionId	path	True	string	De id van het doelabonnement.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
kind	True	string	Het type toepassing waarnaar dit onderdeel verwijst, dat wordt gebruikt om de gebruikersinterface aan te passen. Deze waarde is een vrije-vormtekenreeks. Waarden moeten doorgaans een van de volgende zijn: web, ios, other, store, java, phone.
location	True	string	Resourcelocatie
properties.Application_Type	True	ApplicationType	Type toepassing dat wordt bewaakt.
properties.DisableIpMasking		boolean	IP-maskering uitschakelen.
properties.Flow_Type		FlowType	Wordt gebruikt door het Application Insights-systeem om te bepalen door welk type stroom dit onderdeel is gemaakt. Dit moet worden ingesteld op 'Bluefield' bij het maken/bijwerken van een onderdeel via de REST API.
properties.HockeyAppId		string	De unieke toepassings-id die wordt gemaakt wanneer een nieuwe toepassing wordt toegevoegd aan HockeyApp, die wordt gebruikt voor communicatie met HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Gegevens onmiddellijk na 30 dagen opschonen.
properties.IngestionMode		IngestionMode	Geeft de stroom van de opname aan.
properties.Request_Source		RequestSource	Beschrijft welk hulpprogramma dit Application Insights-onderdeel heeft gemaakt. Klanten die deze API gebruiken, moeten dit instellen op de standaard 'rest'.
properties.RetentionInDays		integer	Bewaarperiode in dagen.
properties.SamplingPercentage		number	Percentage van de gegevens die worden geproduceerd door de toepassing die wordt bewaakt en die worden bemonsterd voor Application Insights-telemetrie.
tags		object	Resourcetags

Antwoorden

Name	Type	Description
200 OK	ApplicationInsightsComponent	Geslaagde aanvraag bij het maken of bijwerken van een Application Insights-onderdeel. Het bijgewerkte onderdeel wordt geretourneerd.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	uw gebruikersaccount imiteren

Voorbeelden

ComponentCreate

ComponentUpdate

ComponentCreate

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
ApplicationInsightsComponent	Een Application Insights-onderdeeldefinitie.
ApplicationType	Type toepassing dat wordt bewaakt.
FlowType	Wordt gebruikt door het Application Insights-systeem om te bepalen door welk type stroom dit onderdeel is gemaakt. Dit moet worden ingesteld op 'Bluefield' bij het maken/bijwerken van een onderdeel via de REST API.
IngestionMode	Geeft de stroom van de opname aan.
PrivateLinkScopedResource	De resourcereferentie voor het bereik van de privékoppeling.
RequestSource	Beschrijft welk hulpprogramma dit Application Insights-onderdeel heeft gemaakt. Klanten die deze API gebruiken, moeten dit instellen op de standaard 'rest'.

ApplicationInsightsComponent

Een Application Insights-onderdeeldefinitie.

Name	Type	Default value	Description
id	string		Azure-resource-id
kind	string		Het type toepassing waarnaar dit onderdeel verwijst, dat wordt gebruikt om de gebruikersinterface aan te passen. Deze waarde is een vrije-vormtekenreeks. Waarden moeten doorgaans een van de volgende zijn: web, ios, other, store, java, phone.
location	string		Resourcelocatie
name	string		Azure-resourcenaam
properties.AppId	string		De unieke id van Application Insights voor uw toepassing.
properties.ApplicationId	string		De unieke id van uw toepassing. Dit veld weerspiegelt het veld Naam en kan niet worden gewijzigd.
properties.Application_Type	ApplicationType	web	Type toepassing dat wordt bewaakt.
properties.ConnectionString	string		Application Insights-onderdeel verbindingsreeks.
properties.CreationDate	string		Aanmaakdatum voor het Application Insights-onderdeel, in ISO 8601-indeling.
properties.DisableIpMasking	boolean		IP-maskering uitschakelen.
properties.Flow_Type	FlowType	Bluefield	Wordt gebruikt door het Application Insights-systeem om te bepalen door welk type stroom dit onderdeel is gemaakt. Dit moet worden ingesteld op 'Bluefield' bij het maken/bijwerken van een onderdeel via de REST API.
properties.HockeyAppId	string		De unieke toepassings-id die wordt gemaakt wanneer een nieuwe toepassing wordt toegevoegd aan HockeyApp, die wordt gebruikt voor communicatie met HockeyApp.
properties.HockeyAppToken	string		Token dat wordt gebruikt voor het verifiëren van communicatie met application insights en HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Gegevens onmiddellijk na 30 dagen opschonen.
properties.IngestionMode	IngestionMode	ApplicationInsights	Geeft de stroom van de opname aan.
properties.InstrumentationKey	string		Instrumentatiesleutel van Application Insights. Een alleen-lezenwaarde die toepassingen kunnen gebruiken om de bestemming te identificeren voor alle telemetrie die naar Azure-toepassing Insights wordt verzonden. Deze waarde wordt opgegeven bij de constructie van elk nieuw Application Insights-onderdeel.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Lijst met resources voor gekoppelde privékoppelingsbereiken.
properties.Request_Source	RequestSource	rest	Beschrijft welk hulpprogramma dit Application Insights-onderdeel heeft gemaakt. Klanten die deze API gebruiken, moeten dit instellen op de standaard 'rest'.
properties.RetentionInDays	integer	90	Bewaarperiode in dagen.
properties.SamplingPercentage	number		Percentage van de gegevens die worden geproduceerd door de toepassing die wordt bewaakt en die worden bemonsterd voor Application Insights-telemetrie.
properties.TenantId	string		Azure-tenant-id.
properties.provisioningState	string		Huidige status van dit onderdeel: of is ingericht binnen de resourcegroep die is gedefinieerd. Gebruikers kunnen deze waarde niet wijzigen, maar kunnen er wel uit lezen. Waarden zijn onder andere Geslaagd, Implementeren, Geannuleerd en Mislukt.
tags	object		Resourcetags
type	string		Azure-resourcetype

ApplicationType

Type toepassing dat wordt bewaakt.

Name	Type	Description
other	string
web	string

FlowType

Wordt gebruikt door het Application Insights-systeem om te bepalen door welk type stroom dit onderdeel is gemaakt. Dit moet worden ingesteld op 'Bluefield' bij het maken/bijwerken van een onderdeel via de REST API.

Name	Type	Description
Bluefield	string

IngestionMode

Geeft de stroom van de opname aan.

Name	Type	Description
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

De resourcereferentie voor het bereik van de privékoppeling.

Name	Type	Description
ResourceId	string	De volledige resource-id van de bereikresource van de private link.
ScopeId	string	De unieke id van het bereik van de private link.

RequestSource

Beschrijft welk hulpprogramma dit Application Insights-onderdeel heeft gemaakt. Klanten die deze API gebruiken, moeten dit instellen op de standaard 'rest'.

Name	Type	Description
rest	string

Delen via

Components - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

ComponentCreate

Voorbeeldaanvraag

Voorbeeldrespons

ComponentUpdate

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Aanvullende resources