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 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.
resourceName	path	True	string	Application Insights 구성 요소 리소스의 이름입니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
kind	True	string	이 구성 요소가 참조하는 애플리케이션의 종류로, UI를 사용자 지정하는 데 사용됩니다. 이 값은 자유형 문자열이며, 값은 일반적으로 웹, ios, 기타, 저장소, java, 휴대폰 중 하나여야 합니다.
___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에 새 애플리케이션을 추가할 때 생성되는 고유한 애플리케이션 ID입니다.
properties.ImmediatePurgeDataOn30Days		boolean	30일 후 즉시 데이터를 제거합니다.
properties.IngestionMode		IngestionMode	수집 흐름을 나타냅니다.
properties.Request_Source		RequestSource	이 Application Insights 구성 요소를 만든 도구에 대해 설명합니다. 이 API를 사용하는 고객은 이를 기본 'rest'로 설정해야 합니다.
properties.RetentionInDays		integer	보존 기간(일)입니다.
properties.SamplingPercentage		number (double)	Application Insights 원격 분석을 위해 샘플링되는 모니터링되는 애플리케이션에서 생성되는 데이터의 백분율입니다.
tags		object	리소스 태그

응답

Name	형식	Description
200 OK	ApplicationInsightsComponent	Application Insights 구성 요소를 만들거나 업데이트할 때 요청이 성공했습니다. 업데이트된 구성 요소가 반환됩니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

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

정의

Name	Description
ApplicationInsightsComponent	Application Insights 구성 요소 정의입니다.
ApplicationType	모니터링되는 애플리케이션의 유형입니다.
FlowType	Application Insights 시스템에서 이 구성 요소가 만든 흐름의 종류를 결정하는 데 사용됩니다. REST API를 통해 구성 요소를 만들거나 업데이트할 때 'Bluefield'로 설정해야 합니다.
IngestionMode	수집 흐름을 나타냅니다.
PrivateLinkScopedResource	프라이빗 링크 범위 리소스 참조입니다.
RequestSource	이 Application Insights 구성 요소를 만든 도구에 대해 설명합니다. 이 API를 사용하는 고객은 이를 기본 'rest'로 설정해야 합니다.

ApplicationInsightsComponent

Object

Application Insights 구성 요소 정의입니다.

Name	형식	Default value	Description
id	string		Azure 리소스 ID
kind	string		이 구성 요소가 참조하는 애플리케이션의 종류로, UI를 사용자 지정하는 데 사용됩니다. 이 값은 자유형 문자열이며, 값은 일반적으로 웹, ios, 기타, 저장소, java, 휴대폰 중 하나여야 합니다.
___location	string		리소스 위치
name	string		Azure 리소스 이름
properties.AppId	string		애플리케이션에 대한 Application Insights 고유 ID입니다.
properties.ApplicationId	string		애플리케이션의 고유 ID입니다. 이 필드는 '이름' 필드를 미러링하며 변경할 수 없습니다.
properties.Application_Type	ApplicationType	web	모니터링되는 애플리케이션의 유형입니다.
properties.ConnectionString	string		Application Insights 구성 요소 연결 문자열입니다.
properties.CreationDate	string (date-time)		Application Insights 구성 요소의 생성 날짜(ISO 8601 형식)입니다.
properties.DisableIpMasking	boolean		IP 마스킹을 사용하지 않도록 설정합니다.
properties.Flow_Type	FlowType	Bluefield	Application Insights 시스템에서 이 구성 요소가 만든 흐름의 종류를 결정하는 데 사용됩니다. REST API를 통해 구성 요소를 만들거나 업데이트할 때 'Bluefield'로 설정해야 합니다.
properties.HockeyAppId	string		HockeyApp과의 통신에 사용되는 HockeyApp에 새 애플리케이션을 추가할 때 생성되는 고유한 애플리케이션 ID입니다.
properties.HockeyAppToken	string		Application Insights와 HockeyApp 간의 통신을 인증하는 데 사용되는 토큰입니다.
properties.ImmediatePurgeDataOn30Days	boolean		30일 후 즉시 데이터를 제거합니다.
properties.IngestionMode	IngestionMode	ApplicationInsights	수집 흐름을 나타냅니다.
properties.InstrumentationKey	string		Application Insights 계측 키입니다. 애플리케이션이 Azure Application Insights로 전송된 모든 원격 분석의 대상을 식별하는 데 사용할 수 있는 읽기 전용 값입니다. 이 값은 각 새 Application Insights 구성 요소를 생성할 때 제공됩니다.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		연결된 프라이빗 링크 범위 리소스 목록입니다.
properties.Request_Source	RequestSource	rest	이 Application Insights 구성 요소를 만든 도구에 대해 설명합니다. 이 API를 사용하는 고객은 이를 기본 'rest'로 설정해야 합니다.
properties.RetentionInDays	integer	90	보존 기간(일)입니다.
properties.SamplingPercentage	number (double)		Application Insights 원격 분석을 위해 샘플링되는 모니터링되는 애플리케이션에서 생성되는 데이터의 백분율입니다.
properties.TenantId	string		Azure 테넌트 ID입니다.
properties.provisioningState	string		이 구성 요소의 현재 상태: 정의된 리소스 그룹 내에서 프로비전되었는지 여부입니다. 사용자는 이 값을 변경할 수 없지만 이 값을 읽을 수 있습니다. 값에는 성공, 배포, 취소 및 실패가 포함됩니다.
tags	object		리소스 태그
type	string		Azure 리소스 종류

ApplicationType

열거형

모니터링되는 애플리케이션의 유형입니다.

값	Description
other
web

FlowType

열거형

Application Insights 시스템에서 이 구성 요소가 만든 흐름의 종류를 결정하는 데 사용됩니다. REST API를 통해 구성 요소를 만들거나 업데이트할 때 'Bluefield'로 설정해야 합니다.

값	Description
Bluefield

IngestionMode

열거형

수집 흐름을 나타냅니다.

값	Description
ApplicationInsights
ApplicationInsightsWithDiagnosticSettings
LogAnalytics

PrivateLinkScopedResource

Object

프라이빗 링크 범위 리소스 참조입니다.

Name	형식	Description
ResourceId	string	프라이빗 링크 범위 리소스의 전체 리소스 ID입니다.
ScopeId	string	프라이빗 링크 범위 고유 식별자입니다.

RequestSource

열거형

이 Application Insights 구성 요소를 만든 도구에 대해 설명합니다. 이 API를 사용하는 고객은 이를 기본 'rest'로 설정해야 합니다.

값	Description
rest

다음을 통해 공유

Components - Create Or Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

ComponentCreate

샘플 요청

샘플 응답

ComponentUpdate

샘플 요청

샘플 응답

정의

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource