Components - Create Or Update

Odwołanie

Usługa:: Application Insights

Wersja interfejsu API:: 2015-05-01

Tworzy (lub aktualizuje) składnik usługi Application Insights. Uwaga: nie można określić innej wartości dla elementu InstrumentationKey ani AppId w operacji Put.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
resourceName	path	True	string	Nazwa zasobu składnika usługi Application Insights.
subscriptionId	path	True	string	Identyfikator subskrypcji docelowej.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
kind	True	string	Rodzaj aplikacji, do którego odwołuje się ten składnik, używany do dostosowywania interfejsu użytkownika. Ta wartość jest ciągiem dowolnym, wartości zwykle powinny być jednym z następujących: web, ios, other, store, java, phone.
location	True	string	Lokalizacja zasobu
properties.Application_Type	True	ApplicationType	Typ monitorowanej aplikacji.
properties.DisableIpMasking		boolean	Wyłącz maskowanie adresów IP.
properties.Flow_Type		FlowType	Używany przez system usługi Application Insights do określania rodzaju przepływu, przez który został utworzony ten składnik. Ma to być ustawione na wartość "Bluefield" podczas tworzenia/aktualizowania składnika za pośrednictwem interfejsu API REST.
properties.HockeyAppId		string	Unikatowy identyfikator aplikacji utworzony podczas dodawania nowej aplikacji do usługi HockeyApp używany do komunikacji z usługą HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Przeczyść dane bezpośrednio po 30 dniach.
properties.IngestionMode		IngestionMode	Wskazuje przepływ pozyskiwania.
properties.Request_Source		RequestSource	Opisuje narzędzie, które utworzyło ten składnik usługi Application Insights. Klienci korzystający z tego interfejsu API powinni ustawić wartość domyślną "rest".
properties.RetentionInDays		integer	Okres przechowywania w dniach.
properties.SamplingPercentage		number	Procent danych generowanych przez monitorowaną aplikację, która jest próbkowana na potrzeby telemetrii usługi Application Insights.
tags		object	Tagi zasobów

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ApplicationInsightsComponent	Pomyślne żądanie podczas tworzenia lub aktualizowania składnika usługi Application Insights. Zwracany jest zaktualizowany składnik.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ComponentCreate

ComponentUpdate

ComponentCreate

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Definicje

Nazwa	Opis
ApplicationInsightsComponent	Definicja składnika usługi Application Insights.
ApplicationType	Typ monitorowanej aplikacji.
FlowType	Używany przez system usługi Application Insights do określania rodzaju przepływu, przez który został utworzony ten składnik. Ma to być ustawione na wartość "Bluefield" podczas tworzenia/aktualizowania składnika za pośrednictwem interfejsu API REST.
IngestionMode	Wskazuje przepływ pozyskiwania.
PrivateLinkScopedResource	Dokumentacja zasobów zakresu łącza prywatnego.
RequestSource	Opisuje narzędzie, które utworzyło ten składnik usługi Application Insights. Klienci korzystający z tego interfejsu API powinni ustawić wartość domyślną "rest".

ApplicationInsightsComponent

Definicja składnika usługi Application Insights.

Nazwa	Typ	Domyślna wartość	Opis
id	string		Identyfikator zasobu platformy Azure
kind	string		Rodzaj aplikacji, do którego odwołuje się ten składnik, używany do dostosowywania interfejsu użytkownika. Ta wartość jest ciągiem dowolnym, wartości zwykle powinny być jednym z następujących: web, ios, other, store, java, phone.
location	string		Lokalizacja zasobu
name	string		Nazwa zasobu platformy Azure
properties.AppId	string		Unikatowy identyfikator usługi Application Insights dla aplikacji.
properties.ApplicationId	string		Unikatowy identyfikator aplikacji. To pole odzwierciedla pole "Name" i nie można go zmienić.
properties.Application_Type	ApplicationType	web	Typ monitorowanej aplikacji.
properties.ConnectionString	string		Parametry połączenia składnika usługi Application Insights.
properties.CreationDate	string		Data utworzenia składnika usługi Application Insights w formacie ISO 8601.
properties.DisableIpMasking	boolean		Wyłącz maskowanie adresów IP.
properties.Flow_Type	FlowType	Bluefield	Używany przez system usługi Application Insights do określania rodzaju przepływu, przez który został utworzony ten składnik. Ma to być ustawione na wartość "Bluefield" podczas tworzenia/aktualizowania składnika za pośrednictwem interfejsu API REST.
properties.HockeyAppId	string		Unikatowy identyfikator aplikacji utworzony podczas dodawania nowej aplikacji do usługi HockeyApp używany do komunikacji z usługą HockeyApp.
properties.HockeyAppToken	string		Token używany do uwierzytelniania komunikacji między usługą Application Insights i usługą HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Przeczyść dane bezpośrednio po 30 dniach.
properties.IngestionMode	IngestionMode	ApplicationInsights	Wskazuje przepływ pozyskiwania.
properties.InstrumentationKey	string		Klucz instrumentacji usługi Application Insights. Wartość tylko do odczytu, która może być używana przez aplikacje do identyfikowania miejsca docelowego dla wszystkich danych telemetrycznych wysyłanych do usługi aplikacja systemu Azure Insights. Ta wartość zostanie dostarczona podczas konstruowania każdego nowego składnika usługi Application Insights.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Lista połączonych zasobów zakresu łącza prywatnego.
properties.Request_Source	RequestSource	rest	Opisuje narzędzie, które utworzyło ten składnik usługi Application Insights. Klienci korzystający z tego interfejsu API powinni ustawić wartość domyślną "rest".
properties.RetentionInDays	integer	90	Okres przechowywania w dniach.
properties.SamplingPercentage	number		Procent danych generowanych przez monitorowaną aplikację, która jest próbkowana na potrzeby telemetrii usługi Application Insights.
properties.TenantId	string		Identyfikator dzierżawy platformy Azure.
properties.provisioningState	string		Bieżący stan tego składnika: czy aprowizacja została aprowizowana w grupie zasobów, która jest zdefiniowana. Użytkownicy nie mogą zmienić tej wartości, ale mogą z niej odczytać. Wartości będą obejmować powodzenie, wdrożenie, anulowanie i niepowodzenie.
tags	object		Tagi zasobów
type	string		Typ zasobu platformy Azure

ApplicationType

Typ monitorowanej aplikacji.

Nazwa	Typ	Opis
other	string
web	string

FlowType

Używany przez system usługi Application Insights do określania rodzaju przepływu, przez który został utworzony ten składnik. Ma to być ustawione na wartość "Bluefield" podczas tworzenia/aktualizowania składnika za pośrednictwem interfejsu API REST.

Nazwa	Typ	Opis
Bluefield	string

IngestionMode

Wskazuje przepływ pozyskiwania.

Nazwa	Typ	Opis
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

Dokumentacja zasobów zakresu łącza prywatnego.

Nazwa	Typ	Opis
ResourceId	string	Pełny identyfikator zasobu zakresu łącza prywatnego.
ScopeId	string	Unikatowy identyfikator zakresu łącza prywatnego.

RequestSource

Opisuje narzędzie, które utworzyło ten składnik usługi Application Insights. Klienci korzystający z tego interfejsu API powinni ustawić wartość domyślną "rest".

Nazwa	Typ	Opis
rest	string

Udostępnij za pośrednictwem

Components - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

ComponentCreate

Przykładowe żądanie

Przykładowa odpowiedź

ComponentUpdate

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Dodatkowe zasoby