Components - Create Or Update

Ссылка

Служба:: Application Insights

Версия API:: 2015-05-01

Создает (или обновляет) компонент Application Insights. Примечание. В операции Put нельзя указать другое значение для InstrumentationKey или AppId.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
resourceGroupName	path	True	string	Имя группы ресурсов. Регистр букв в имени не учитывается.
resourceName	path	True	string	Имя ресурса компонента Application Insights.
subscriptionId	path	True	string	Идентификатор целевой подписки.
api-version	query	True	string	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
kind	True	string	Тип приложения, к которому относится этот компонент, используемый для настройки пользовательского интерфейса. Это значение представляет собой строку произвольной формы, значения обычно должны иметь одно из следующих значений: web, ios, other, store, java, phone.
location	True	string	Расположение ресурса
properties.Application_Type	True	ApplicationType	Тип отслеживаемого приложения.
properties.DisableIpMasking		boolean	Отключите маскирование IP-адресов.
properties.Flow_Type		FlowType	Используется системой Application Insights для определения типа потока, созданного этим компонентом. При создании или обновлении компонента с помощью REST API необходимо задать значение Bluefield.
properties.HockeyAppId		string	Уникальный идентификатор приложения, созданный при добавлении нового приложения в HockeyApp, используемый для взаимодействия с HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Очистка данных сразу через 30 дней.
properties.IngestionMode		IngestionMode	Указывает поток приема.
properties.Request_Source		RequestSource	Описывает, какое средство создало этот компонент Application Insights. Клиенты, использующие этот API, должны задать значение по умолчанию rest.
properties.RetentionInDays		integer	Период хранения в днях.
properties.SamplingPercentage		number	Процент данных, создаваемых отслеживаемым приложением, который является выборкой для телеметрии Application Insights.
tags		object	Теги ресурсов

Ответы

Имя	Тип	Описание
200 OK	ApplicationInsightsComponent	Успешный запрос при создании или обновлении компонента Application Insights. Возвращается обновленный компонент.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

ComponentCreate

ComponentUpdate

ComponentCreate

Образец запроса

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

Пример ответа

Код состояния:: 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

Образец запроса

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

Пример ответа

Код состояния:: 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"
  }
}

Определения

Имя	Описание
ApplicationInsightsComponent	Определение компонента Application Insights.
ApplicationType	Тип отслеживаемого приложения.
FlowType	Используется системой Application Insights для определения типа потока, созданного этим компонентом. При создании или обновлении компонента с помощью REST API необходимо задать значение Bluefield.
IngestionMode	Указывает поток приема.
PrivateLinkScopedResource	Приватный канал область справочник по ресурсу.
RequestSource	Описывает, какое средство создало этот компонент Application Insights. Клиенты, использующие этот API, должны задать значение по умолчанию rest.

ApplicationInsightsComponent

Определение компонента Application Insights.

Имя	Тип	Default value	Описание
id	string		Идентификатор ресурса Azure
kind	string		Тип приложения, к которому относится этот компонент, используемый для настройки пользовательского интерфейса. Это значение представляет собой строку произвольной формы, значения обычно должны иметь одно из следующих значений: web, ios, other, store, java, phone.
location	string		Расположение ресурса
name	string		Имя ресурса Azure
properties.AppId	string		Уникальный идентификатор приложения Application Insights.
properties.ApplicationId	string		Уникальный идентификатор приложения. Это поле отражает поле "Имя" и не может быть изменено.
properties.Application_Type	ApplicationType	web	Тип отслеживаемого приложения.
properties.ConnectionString	string		строка подключения компонента Application Insights.
properties.CreationDate	string		Дата создания компонента Application Insights в формате ISO 8601.
properties.DisableIpMasking	boolean		Отключите маскирование IP-адресов.
properties.Flow_Type	FlowType	Bluefield	Используется системой Application Insights для определения типа потока, созданного этим компонентом. При создании или обновлении компонента с помощью REST API необходимо задать значение Bluefield.
properties.HockeyAppId	string		Уникальный идентификатор приложения, созданный при добавлении нового приложения в HockeyApp, используемый для взаимодействия с HockeyApp.
properties.HockeyAppToken	string		Маркер, используемый для проверки подлинности обмена данными между Application Insights и HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Очистка данных сразу через 30 дней.
properties.IngestionMode	IngestionMode	ApplicationInsights	Указывает поток приема.
properties.InstrumentationKey	string		Ключ инструментирования Application Insights. Значение только для чтения, которое приложения могут использовать для определения назначения для всех данных телеметрии, отправляемых в приложение Azure Insights. Это значение будет предоставлено при создании каждого нового компонента Application Insights.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Список связанных ресурсов область приватного канала.
properties.Request_Source	RequestSource	rest	Описывает, какое средство создало этот компонент Application Insights. Клиенты, использующие этот API, должны задать значение по умолчанию rest.
properties.RetentionInDays	integer	90	Период хранения в днях.
properties.SamplingPercentage	number		Процент данных, создаваемых отслеживаемым приложением, который является выборкой для телеметрии Application Insights.
properties.TenantId	string		Идентификатор клиента Azure.
properties.provisioningState	string		Текущее состояние этого компонента: было ли подготовлено в определенной группе ресурсов. Пользователи не могут изменить это значение, но могут считывать его. Значения будут включать Succeeded, Deploying, Canceled и Failed.
tags	object		Теги ресурсов
type	string		Тип ресурса Azure

ApplicationType

Тип отслеживаемого приложения.

Имя	Тип	Описание
other	string
web	string

FlowType

Используется системой Application Insights для определения типа потока, созданного этим компонентом. При создании или обновлении компонента с помощью REST API необходимо задать значение Bluefield.

Имя	Тип	Описание
Bluefield	string

IngestionMode

Указывает поток приема.

Имя	Тип	Описание
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

Приватный канал область справочник по ресурсу.

Имя	Тип	Описание
ResourceId	string	Полный идентификатор ресурса область приватного канала.
ScopeId	string	Приватный канал область уникальный идентификатор.

RequestSource

Описывает, какое средство создало этот компонент Application Insights. Клиенты, использующие этот API, должны задать значение по умолчанию rest.

Имя	Тип	Описание
rest	string

Поделиться через

Components - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

ComponentCreate

Образец запроса

Пример ответа

ComponentUpdate

Образец запроса

Пример ответа

Определения

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Дополнительные ресурсы