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. Nota: 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 do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
resourceName	path	True	string	O nome do recurso do componente do Application Insights.
subscriptionId	path	True	string	O ID da subscrição de destino.
api-version	query	True	string	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
kind	True	string	O tipo de aplicação a que este componente se refere, utilizado para personalizar a IU. Este valor é uma cadeia de forma livre. Normalmente, os valores devem ser um dos seguintes: Web, ios, outros, store, java, phone.
location	True	string	Localização do recurso
properties.Application_Type	True	ApplicationType	Tipo de aplicação a ser monitorizada.
properties.DisableIpMasking		boolean	Desative a máscara de IP.
properties.Flow_Type		FlowType	Utilizado pelo sistema do Application Insights para determinar o tipo de fluxo pelo qual este componente foi criado. Isto deve ser definido como "Bluefield" ao criar/atualizar um componente através da API REST.
properties.HockeyAppId		string	O ID de aplicação exclusivo criado quando uma nova aplicação é adicionada ao HockeyApp, utilizada para comunicações com o HockeyApp.
properties.ImmediatePurgeDataOn30Days		boolean	Remova os dados imediatamente após 30 dias.
properties.IngestionMode		IngestionMode	Indica o fluxo da ingestão.
properties.Request_Source		RequestSource	Descreve a ferramenta que criou este componente do Application Insights. Os clientes que utilizam esta API devem definir esta opção como "rest" predefinida.
properties.RetentionInDays		integer	Período de retenção em dias.
properties.SamplingPercentage		number	Percentagem dos dados produzidos pela aplicação a ser monitorizada que está a ser amostrada para telemetria do Application Insights.
tags		object	Etiquetas de recursos

Respostas

Name	Tipo	Description
200 OK	ApplicationInsightsComponent	Pedido com êxito ao criar ou atualizar um componente do Application Insights. O componente atualizado é devolvido.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

ComponentCreate

ComponentUpdate

ComponentCreate

Pedido de amostra

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 da amostra

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

Pedido de amostra

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 da amostra

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

Name	Description
ApplicationInsightsComponent	Uma definição de componente do Application Insights.
ApplicationType	Tipo de aplicação a ser monitorizada.
FlowType	Utilizado pelo sistema do Application Insights para determinar o tipo de fluxo pelo qual este componente foi criado. Isto deve ser definido como "Bluefield" ao criar/atualizar um componente através da API REST.
IngestionMode	Indica o fluxo da ingestão.
PrivateLinkScopedResource	A referência de recursos do âmbito da ligação privada.
RequestSource	Descreve a ferramenta que criou este componente do Application Insights. Os clientes que utilizam esta API devem definir esta opção como "rest" predefinida.

ApplicationInsightsComponent

Uma definição de componente do Application Insights.

Name	Tipo	Default value	Description
id	string		ID do recurso do Azure
kind	string		O tipo de aplicação a que este componente se refere, utilizado para personalizar a IU. Este valor é uma cadeia de forma livre. Normalmente, os valores devem ser um dos seguintes: Web, ios, outros, store, java, phone.
location	string		Localização do recurso
name	string		Nome do recurso do Azure
properties.AppId	string		ID Exclusivo do Application Insights para a sua Aplicação.
properties.ApplicationId	string		O ID exclusivo da sua aplicação. Este campo espelha o campo "Nome" e não pode ser alterado.
properties.Application_Type	ApplicationType	web	Tipo de aplicação a ser monitorizada.
properties.ConnectionString	string		Cadeia de ligação de componentes do Application Insights.
properties.CreationDate	string		Data de Criação para o componente do Application Insights, no formato ISO 8601.
properties.DisableIpMasking	boolean		Desative a máscara de IP.
properties.Flow_Type	FlowType	Bluefield	Utilizado pelo sistema do Application Insights para determinar o tipo de fluxo pelo qual este componente foi criado. Isto deve ser definido como "Bluefield" ao criar/atualizar um componente através da API REST.
properties.HockeyAppId	string		O ID de aplicação exclusivo criado quando uma nova aplicação é adicionada ao HockeyApp, utilizada para comunicações com o HockeyApp.
properties.HockeyAppToken	string		Token utilizado para autenticar comunicações com o Application Insights e o HockeyApp.
properties.ImmediatePurgeDataOn30Days	boolean		Remova 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 só de leitura que as aplicações podem utilizar para identificar o destino de toda a telemetria enviada para o Aplicação Azure Insights. Este valor será fornecido após a construção de cada novo componente do Application Insights.
properties.PrivateLinkScopedResources	PrivateLinkScopedResource[]		Lista de recursos de âmbito de ligações privadas ligadas.
properties.Request_Source	RequestSource	rest	Descreve a ferramenta que criou este componente do Application Insights. Os clientes que utilizam esta API devem definir esta opção como "rest" predefinida.
properties.RetentionInDays	integer	90	Período de retenção em dias.
properties.SamplingPercentage	number		Percentagem dos dados produzidos pela aplicação a ser monitorizada que está a ser amostrada para telemetria do Application Insights.
properties.TenantId	string		ID do Inquilino do Azure.
properties.provisioningState	string		Estado atual deste componente: se foi ou não aprovisionado no grupo de recursos que está definido. Os utilizadores não podem alterar este valor, mas podem ler a partir do mesmo. Os valores incluirão Êxito, Implementação, Cancelado e Falhado.
tags	object		Etiquetas de recursos
type	string		Tipo de recurso do Azure

ApplicationType

Tipo de aplicação a ser monitorizada.

Name	Tipo	Description
other	string
web	string

FlowType

Utilizado pelo sistema do Application Insights para determinar o tipo de fluxo pelo qual este componente foi criado. Isto deve ser definido como "Bluefield" ao criar/atualizar um componente através da API REST.

Name	Tipo	Description
Bluefield	string

IngestionMode

Indica o fluxo da ingestão.

Name	Tipo	Description
ApplicationInsights	string
ApplicationInsightsWithDiagnosticSettings	string
LogAnalytics	string

PrivateLinkScopedResource

A referência de recursos do âmbito da ligação privada.

Name	Tipo	Description
ResourceId	string	O ID de recurso completo do recurso de âmbito da ligação privada.
ScopeId	string	O Identificador exclusivo do âmbito da ligação privada.

RequestSource

Descreve a ferramenta que criou este componente do Application Insights. Os clientes que utilizam esta API devem definir esta opção como "rest" predefinida.

Name	Tipo	Description
rest	string

Partilhar via

Components - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

ComponentCreate

Pedido de amostra

Resposta da amostra

ComponentUpdate

Pedido de amostra

Resposta da amostra

Definições

ApplicationInsightsComponent

ApplicationType

FlowType

IngestionMode

PrivateLinkScopedResource

RequestSource

Recursos adicionais