Data Collection Endpoints - Update

Riferimento

Servizio:: Monitor

Versione API:: 2023-03-11

Aggiorna parte di un endpoint di raccolta dati.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionEndpoints/{dataCollectionEndpointName}?api-version=2023-03-11

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
dataCollectionEndpointName	path	True	string	Nome dell'endpoint di raccolta dati. Il nome non fa distinzione tra maiuscole e minuscole.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
identity	Identity	Identità del servizio gestita.
tags	object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	DataCollectionEndpointResource	L'endpoint di raccolta dati è stato aggiornato correttamente
Other Status Codes	ErrorResponseCommonV2	Errore

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Update data collection endpoint

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionEndpoints/myDataCollectionEndpoint?api-version=2023-03-11

{
  "tags": {
    "tag1": "A"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionEndpoints/myDataCollectionEndpoint",
  "name": "myDataCollectionEndpoint",
  "type": "Microsoft.Insights/dataCollectionEndpoints",
  "location": "eastus",
  "tags": {
    "tag1": "A"
  },
  "properties": {
    "immutableId": "dce-cd85a330eb664aa3bc7883cc394b0000",
    "configurationAccess": {
      "endpoint": "https://mydatacollectionendpoint-71ib.eastus-1.handler.control.monitor.azure.com"
    },
    "logsIngestion": {
      "endpoint": "https://mydatacollectionendpoint-71ib.eastus-1.ingest.monitor.azure.com"
    },
    "metricsIngestion": {
      "endpoint": "https://mydatacollectionendpoint-71ib.eastus-1.metrics.ingest.monitor.azure.com"
    },
    "networkAcls": {
      "publicNetworkAccess": "Enabled"
    },
    "provisioningState": "Succeeded"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2024-03-22T08:40:59.2431682Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-03-22T11:55:22.5074142Z"
  },
  "etag": "0000ae31-0000-0100-0000-65fd441c0000"
}

Definizioni

Nome	Descrizione
ConfigurationAccess	Endpoint usato dai client per accedere alla configurazione.
createdByType	Tipo di identità che ha creato la risorsa.
DataCollectionEndpointResource	Definizione della risorsa di primo livello rilevata da ARM.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponseCommonV2	Risposta di errore
FailoverConfiguration	Configurazione del failover in questo endpoint. Questa proprietà è DI SOLA LETTURA.
Identity	Identità del servizio gestita della risorsa.
KnownDataCollectionEndpointProvisioningState	Stato del provisioning delle risorse. Questa proprietà è DI SOLA LETTURA.
KnownDataCollectionEndpointResourceKind	Tipo di risorsa.
KnownLocationSpecProvisioningStatus	Stato del provisioning delle risorse in questa posizione.
KnownPublicNetworkAccessOptions	Configurazione da impostare se l'accesso alla rete da Internet pubblico agli endpoint è consentito.
LocationSpec
LogsIngestion	Endpoint usato dai client per inserire i log.
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
Metadata	Metadati per la risorsa. Questa proprietà è DI SOLA LETTURA.
MetricsIngestion	Endpoint usato dai client per inserire le metriche.
NetworkAcls	Regole di controllo di accesso di rete per gli endpoint.
PrivateLinkScopedResource
ResourceForUpdate	Definizione delle proprietà delle risorse di livello superiore rilevate per l'operazione di aggiornamento.
SystemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

ConfigurationAccess

Object

Endpoint usato dai client per accedere alla configurazione.

Nome	Tipo	Descrizione
endpoint	string	Endpoint. Questa proprietà è DI SOLA LETTURA.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

DataCollectionEndpointResource

Object

Definizione della risorsa di primo livello rilevata da ARM.

Nome	Tipo	Descrizione
etag	string	Tag di entità risorsa (ETag).
id	string	ID completo della risorsa.
identity	Identity	Identità del servizio gestita della risorsa.
kind	KnownDataCollectionEndpointResourceKind	Tipo di risorsa.
location	string	Posizione geografica in cui risiede la risorsa.
name	string	Nome della risorsa.
properties.configurationAccess	ConfigurationAccess	Endpoint usato dai client per accedere alla configurazione.
properties.description	string	Descrizione dell'endpoint di raccolta dati.
properties.failoverConfiguration	FailoverConfiguration	Configurazione del failover in questo endpoint. Questa proprietà è DI SOLA LETTURA.
properties.immutableId	string	ID non modificabile di questa risorsa endpoint di raccolta dati. Questa proprietà è DI SOLA LETTURA.
properties.logsIngestion	LogsIngestion	Endpoint usato dai client per inserire i log.
properties.metadata	Metadata	Metadati per la risorsa. Questa proprietà è DI SOLA LETTURA.
properties.metricsIngestion	MetricsIngestion	Endpoint usato dai client per inserire le metriche.
properties.networkAcls	NetworkAcls	Regole di controllo di accesso di rete per gli endpoint.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]	Elenco delle risorse dell'ambito del collegamento privato di Monitoraggio di Azure a cui è associata questa risorsa endpoint di raccolta dati. Questa proprietà è DI SOLA LETTURA.
properties.provisioningState	KnownDataCollectionEndpointProvisioningState	Stato del provisioning delle risorse. Questa proprietà è DI SOLA LETTURA.
systemData	SystemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
tags	object	Tag di risorsa.
type	string	Tipo della risorsa.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponseCommonV2

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

FailoverConfiguration

Object

Configurazione del failover in questo endpoint. Questa proprietà è DI SOLA LETTURA.

Nome	Tipo	Descrizione
activeLocation	string	Posizione attiva in cui si verificherà il flusso di dati.
locations	LocationSpec[]	Percorsi configurati per il failover.

Identity

Object

Identità del servizio gestita della risorsa.

Nome	Tipo	Descrizione
principalId	string (uuid)	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string (uuid)	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

KnownDataCollectionEndpointProvisioningState

Enumerazione

Stato del provisioning delle risorse. Questa proprietà è DI SOLA LETTURA.

Valore	Descrizione
Canceled
Creating
Deleting
Failed
Succeeded
Updating

KnownDataCollectionEndpointResourceKind

Enumerazione

Tipo di risorsa.

Valore	Descrizione
Linux
Windows

KnownLocationSpecProvisioningStatus

Enumerazione

Stato del provisioning delle risorse in questa posizione.

Valore	Descrizione
Canceled
Creating
Deleting
Failed
Succeeded
Updating

KnownPublicNetworkAccessOptions

Enumerazione

Configurazione da impostare se l'accesso alla rete da Internet pubblico agli endpoint è consentito.

Valore	Descrizione
Disabled
Enabled
SecuredByPerimeter

LocationSpec

Object

Nome	Tipo	Descrizione
location	string	Nome della posizione.
provisioningStatus	KnownLocationSpecProvisioningStatus	Stato del provisioning delle risorse in questa posizione.

LogsIngestion

Object

Endpoint usato dai client per inserire i log.

Nome	Tipo	Descrizione
endpoint	string	Endpoint. Questa proprietà è DI SOLA LETTURA.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore	Descrizione
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

Metadata

Object

Metadati per la risorsa. Questa proprietà è DI SOLA LETTURA.

Nome	Tipo	Descrizione
provisionedBy	string	Offerta di Azure che gestisce questa risorsa per conto del cliente.
provisionedByImmutableId	string	ID non modificabile dell'offerta azure che gestisce questa risorsa per conto del cliente.
provisionedByResourceId	string	ID risorsa dell'offerta azure che gestisce questa risorsa per conto del cliente.

MetricsIngestion

Object

Endpoint usato dai client per inserire le metriche.

Nome	Tipo	Descrizione
endpoint	string	Endpoint. Questa proprietà è DI SOLA LETTURA.

NetworkAcls

Object

Regole di controllo di accesso di rete per gli endpoint.

Nome	Tipo	Descrizione
publicNetworkAccess	KnownPublicNetworkAccessOptions	Configurazione da impostare se l'accesso alla rete da Internet pubblico agli endpoint è consentito.

PrivateLinkScopedResource

Object

Nome	Tipo	Descrizione
resourceId	string	ResourceId della risorsa con ambito ambito collegamento privato di Monitoraggio di Azure tramite cui questo controller di dominio è associato a un ambito collegamento privato di Monitoraggio di Azure.
scopeId	string	ImmutableId della risorsa ambito collegamento privato di Monitoraggio di Azure a cui si trova l'associazione.

ResourceForUpdate

Object

Definizione delle proprietà delle risorse di livello superiore rilevate per l'operazione di aggiornamento.

Nome	Tipo	Descrizione
identity	Identity	Identità del servizio gestita.
tags	object	Tag di risorsa.

SystemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentity

Object

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client dell'identità assegnata.
principalId	string (uuid)	ID entità dell'identità assegnata.

Condividi tramite

Data Collection Endpoints - Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Update data collection endpoint

Esempio di richiesta

Risposta di esempio

Definizioni

ConfigurationAccess

createdByType

DataCollectionEndpointResource

ErrorAdditionalInfo

ErrorDetail

ErrorResponseCommonV2

FailoverConfiguration

Identity

KnownDataCollectionEndpointProvisioningState

KnownDataCollectionEndpointResourceKind

KnownLocationSpecProvisioningStatus

KnownPublicNetworkAccessOptions

LocationSpec

LogsIngestion

ManagedServiceIdentityType

Metadata

MetricsIngestion

NetworkAcls

PrivateLinkScopedResource

ResourceForUpdate

SystemData

UserAssignedIdentity

Risorse aggiuntive