Components - Create Or Update

Referência

Serviço:: Application Insights

Versão da API:: 2015-05-01

Cria (ou atualiza) um componente do Application Insights. Observação: você não pode especificar um valor diferente para InstrumentationKey nem AppId na operação Put.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.
resourceName	path	True	string	O nome do recurso de componente do Application Insights.
subscriptionId	path	True	string	A ID da assinatura de destino.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
kind	True	string	O tipo de aplicativo ao qual esse componente se refere, usado para personalizar a interface do usuário. Esse valor é uma cadeia de caracteres de forma livre, os valores normalmente devem ser um dos seguintes: Web, ios, outro, store, java, telefone.
location	True	string	Localização do recurso
properties.Application_Type	True	ApplicationType	Tipo de aplicativo que está sendo monitorado.
properties.DisableIpMasking		boolean	Desabilitar a máscara de IP.
properties.Flow_Type		FlowType	Usado pelo sistema application insights para determinar o tipo de fluxo pelo qual esse componente foi criado. Isso deve ser definido como 'Bluefield' ao criar/atualizar um componente por meio da API REST.
properties.HockeyAppId		string	A ID de aplicativo exclusiva criada quando um novo aplicativo é adicionado ao HockeyApp, usado para comunicações com o HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Limpe os dados imediatamente após 30 dias.
properties.IngestionMode		IngestionMode	Indica o fluxo da ingestão.
properties.Request_Source		RequestSource	Descreve qual ferramenta criou esse componente do Application Insights. Os clientes que usam essa API devem definir isso como o padrão 'rest'.
properties.RetentionInDays		integer	Período de retenção em dias.
properties.SamplingPercentage		number	Percentual dos dados produzidos pelo aplicativo que está sendo monitorado que está sendo amostrado para telemetria do Application Insights.
tags		object	Marcações de recursos

Respostas

Nome	Tipo	Description
200 OK	ApplicationInsightsComponent	Solicitação bem-sucedida ao criar ou atualizar um componente do Application Insights. O componente atualizado é retornado.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

ComponentCreate

ComponentUpdate

ComponentCreate

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
  }
}

Definições

Nome	Description
ApplicationInsightsComponent	Uma definição de componente do Application Insights.
ApplicationType	Tipo de aplicativo que está sendo monitorado.
FlowType	Usado pelo sistema application insights para determinar o tipo de fluxo pelo qual esse componente foi criado. Isso deve ser definido como 'Bluefield' ao criar/atualizar um componente por meio da API REST.
IngestionMode	Indica o fluxo da ingestão.
PrivateLinkScopedResource	A referência de recurso de escopo do link privado.
RequestSource	Descreve qual ferramenta criou esse componente do Application Insights. Os clientes que usam essa API devem definir isso como o padrão 'rest'.

ApplicationInsightsComponent

Uma definição de componente do Application Insights.

Nome	Tipo	Valor padrão	Description
id	string		ID do recurso do Azure
kind	string		O tipo de aplicativo ao qual esse componente se refere, usado para personalizar a interface do usuário. Esse valor é uma cadeia de caracteres de forma livre, os valores normalmente devem ser um dos seguintes: Web, ios, outro, store, java, telefone.
location	string		Localização do recurso
name	string		Nome do recurso do Azure
properties.AppId	string		ID exclusiva do Application Insights para seu aplicativo.
properties.ApplicationId	string		A ID exclusiva do aplicativo. Esse campo espelha o campo 'Nome' e não pode ser alterado.
properties.Application_Type	ApplicationType	web	Tipo de aplicativo que está sendo monitorado.
properties.ConnectionString	string		Cadeia de conexão de componentes do Application Insights.
properties.CreationDate	string		Data de criação do componente Application Insights, no formato ISO 8601.
properties.DisableIpMasking	boolean		Desabilitar a máscara de IP.
properties.Flow_Type	FlowType	Bluefield	Usado pelo sistema application insights para determinar o tipo de fluxo pelo qual esse componente foi criado. Isso deve ser definido como 'Bluefield' ao criar/atualizar um componente por meio da API REST.
properties.HockeyAppId	string		A ID de aplicativo exclusiva criada quando um novo aplicativo é adicionado ao HockeyApp, usado para comunicações com o HockeyApp.
properties.HockeyAppToken	string		Token usado para autenticar as comunicações entre o Application Insights e o HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Limpe os dados imediatamente após 30 dias.
properties.IngestionMode	IngestionMode	ApplicationInsights	Indica o fluxo da ingestão.
properties.InstrumentationKey	string		Chave de instrumentação do Application Insights. Um valor somente leitura que os aplicativos podem usar para identificar o destino de toda a telemetria enviada ao Aplicativo Azure Insights. Esse valor será fornecido após a construção de cada novo componente do Application Insights.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Lista de recursos de escopo de link privado vinculados.
properties.Request_Source	RequestSource	rest	Descreve qual ferramenta criou esse componente do Application Insights. Os clientes que usam essa API devem definir isso como o padrão 'rest'.
properties.RetentionInDays	integer	90	Período de retenção em dias.
properties.SamplingPercentage	number		Percentual dos dados produzidos pelo aplicativo que está sendo monitorado que está sendo amostrado para telemetria do Application Insights.
properties.TenantId	string		ID do Locatário do Azure.
properties.provisioningState	string		Estado atual deste componente: se foi provisionado ou não dentro do grupo de recursos definido. Os usuários não podem alterar esse valor, mas podem lê-lo. Os valores incluirão Êxito, Implantação, Cancelamento e Falha.
tags	object		Marcações de recursos
type	string		Tipo de recurso do Azure

ApplicationType

Tipo de aplicativo que está sendo monitorado.

Nome	Tipo	Description
other	string
web	string

FlowType

Usado pelo sistema application insights para determinar o tipo de fluxo pelo qual esse componente foi criado. Isso deve ser definido como 'Bluefield' ao criar/atualizar um componente por meio da API REST.

Nome	Tipo	Description
Bluefield	string

IngestionMode

Indica o fluxo da ingestão.

Nome	Tipo	Description
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

A referência de recurso de escopo do link privado.

Nome	Tipo	Description
ResourceId	string	A ID de recurso completa do recurso de escopo do link privado.
ScopeId	string	O identificador exclusivo do escopo do link privado.

RequestSource

Descreve qual ferramenta criou esse componente do Application Insights. Os clientes que usam essa API devem definir isso como o padrão 'rest'.

Nome	Tipo	Description
rest	string

Compartilhar via

Components - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

ComponentCreate

Solicitação de exemplo

Resposta de exemplo

ComponentUpdate

Solicitação de exemplo

Resposta de exemplo

Definições

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Recursos adicionais