Components - Create Or Update

Reference

Služba:: Application Insights

Verze rozhraní API:: 2015-05-01

Vytvoří (nebo aktualizuje) komponentu Application Insights. Poznámka: V operaci Put nemůžete zadat jinou hodnotu pro InstrumentationKey ani AppId.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.
resourceName	path	True	string	Název prostředku komponenty Application Insights.
subscriptionId	path	True	string	ID cílového předplatného.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
kind	True	string	Druh aplikace, na kterou tato komponenta odkazuje, slouží k přizpůsobení uživatelského rozhraní. Tato hodnota je volný tvar řetězce, hodnoty by obvykle měly být jedna z následujících: web, ios, další, store, java, phone.
location	True	string	Umístění prostředku
properties.Application_Type	True	ApplicationType	Typ monitorované aplikace
properties.DisableIpMasking		boolean	Zakažte maskování IP adres.
properties.Flow_Type		FlowType	Používá se systémem Application Insights k určení typu toku, který tuto komponentu vytvořil. Při vytváření nebo aktualizaci komponenty prostřednictvím rozhraní REST API se nastaví na Bluefield.
properties.HockeyAppId		string	Jedinečné ID aplikace vytvořené při přidání nové aplikace do HockeyApp, které se používá ke komunikaci s HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Vyprázdnění dat okamžitě po 30 dnech
properties.IngestionMode		IngestionMode	Označuje tok příjmu dat.
properties.Request_Source		RequestSource	Popisuje, jaký nástroj vytvořil tuto komponentu Application Insights. Zákazníci, kteří používají toto rozhraní API, by měli nastavit výchozí rest.
properties.RetentionInDays		integer	Doba uchovávání ve dnech.
properties.SamplingPercentage		number	Procento dat generovaných monitorovanou aplikací, která se vzorkují pro telemetrii Application Insights
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	ApplicationInsightsComponent	Úspěšný požadavek při vytváření nebo aktualizaci komponenty Application Insights Vrátí se aktualizovaná komponenta.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ComponentCreate

ComponentUpdate

ComponentCreate

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Definice

Name	Description
ApplicationInsightsComponent	Definice komponenty Application Insights.
ApplicationType	Typ monitorované aplikace
FlowType	Používá se systémem Application Insights k určení typu toku, který tuto komponentu vytvořil. Při vytváření nebo aktualizaci komponenty prostřednictvím rozhraní REST API se nastaví na Bluefield.
IngestionMode	Označuje tok příjmu dat.
PrivateLinkScopedResource	Referenční informace k prostředku oboru privátního propojení
RequestSource	Popisuje, jaký nástroj vytvořil tuto komponentu Application Insights. Zákazníci, kteří používají toto rozhraní API, by měli nastavit výchozí rest.

ApplicationInsightsComponent

Definice komponenty Application Insights.

Name	Typ	Default value	Description
id	string		ID prostředku Azure
kind	string		Druh aplikace, na kterou tato komponenta odkazuje, slouží k přizpůsobení uživatelského rozhraní. Tato hodnota je volný tvar řetězce, hodnoty by obvykle měly být jedna z následujících: web, ios, další, store, java, phone.
location	string		Umístění prostředku
name	string		Název prostředku Azure
properties.AppId	string		Application Insights Jedinečné ID vaší aplikace.
properties.ApplicationId	string		Jedinečné ID vaší aplikace. Toto pole odpovídá poli Název a nelze ho změnit.
properties.Application_Type	ApplicationType	web	Typ monitorované aplikace
properties.ConnectionString	string		připojovací řetězec komponent Application Insights.
properties.CreationDate	string		Datum vytvoření komponenty Application Insights ve formátu ISO 8601.
properties.DisableIpMasking	boolean		Zakažte maskování IP adres.
properties.Flow_Type	FlowType	Bluefield	Používá se systémem Application Insights k určení typu toku, který tuto komponentu vytvořil. Při vytváření nebo aktualizaci komponenty prostřednictvím rozhraní REST API se nastaví na Bluefield.
properties.HockeyAppId	string		Jedinečné ID aplikace vytvořené při přidání nové aplikace do HockeyApp, které se používá ke komunikaci s HockeyApp.
properties.HockeyAppToken	string		Token používaný k ověřování komunikace mezi Application Insights a HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Vyprázdnění dat okamžitě po 30 dnech
properties.IngestionMode	IngestionMode	ApplicationInsights	Označuje tok příjmu dat.
properties.InstrumentationKey	string		Instrumentační klíč Application Insights. Hodnota jen pro čtení, kterou můžou aplikace použít k identifikaci cíle pro veškerou telemetrii odesílanou do Aplikace Azure Insights. Tato hodnota bude zadána při vytváření každé nové komponenty Application Insights.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Seznam prostředků propojeného oboru privátního propojení
properties.Request_Source	RequestSource	rest	Popisuje, jaký nástroj vytvořil tuto komponentu Application Insights. Zákazníci, kteří používají toto rozhraní API, by měli nastavit výchozí rest.
properties.RetentionInDays	integer	90	Doba uchovávání ve dnech.
properties.SamplingPercentage	number		Procento dat generovaných monitorovanou aplikací, která se vzorkují pro telemetrii Application Insights
properties.TenantId	string		ID tenanta Azure.
properties.provisioningState	string		Aktuální stav této komponenty: v rámci definované skupiny prostředků byla zřízena, zda je nebo není. Uživatelé nemůžou tuto hodnotu změnit, ale můžou z ní číst. Mezi hodnoty patří Succeeded (Úspěch), Deploying (Nasazení), Canceled (Zrušeno) a Failed (Selhání).
tags	object		Značky prostředků
type	string		Typ prostředku Azure

ApplicationType

Typ monitorované aplikace

Name	Typ	Description
other	string
web	string

FlowType

Používá se systémem Application Insights k určení typu toku, který tuto komponentu vytvořil. Při vytváření nebo aktualizaci komponenty prostřednictvím rozhraní REST API se nastaví na Bluefield.

Name	Typ	Description
Bluefield	string

IngestionMode

Označuje tok příjmu dat.

Name	Typ	Description
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

Referenční informace k prostředku oboru privátního propojení

Name	Typ	Description
ResourceId	string	Úplné ID prostředku oboru privátního propojení.
ScopeId	string	Jedinečný identifikátor oboru privátního propojení.

RequestSource

Popisuje, jaký nástroj vytvořil tuto komponentu Application Insights. Zákazníci, kteří používají toto rozhraní API, by měli nastavit výchozí rest.

Name	Typ	Description
rest	string

Sdílet prostřednictvím

Components - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

ComponentCreate

Ukázkový požadavek

Ukázková odpověď

ComponentUpdate

Ukázkový požadavek

Ukázková odpověď

Definice

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Další materiály