Data Collection Rule Associations - Create

Referenz

Dienst:: Monitor

API-Version:: 2023-03-11

Erstellt oder aktualisiert eine Zuordnung.

PUT https://management.azure.com/{resourceUri}/providers/Microsoft.Insights/dataCollectionRuleAssociations/{associationName}?api-version=2023-03-11

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
associationName	path	True	string	Der Name der Zuordnung. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
resourceUri	path	True	string minLength: 1	Der Bezeichner der Ressource.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.dataCollectionEndpointId	string	Die Ressourcen-ID des Datensammlungsendpunkts, der zugeordnet werden soll.
properties.dataCollectionRuleId	string	Die Ressourcen-ID der Datensammlungsregel, die zugeordnet werden soll.
properties.description	string	Beschreibung der Zuordnung.

Antworten

Name	Typ	Beschreibung
200 OK	DataCollectionRuleAssociationProxyOnlyResource	Die Zuordnung wurde erfolgreich aktualisiert.
201 Created	DataCollectionRuleAssociationProxyOnlyResource	Die Zuordnung wurde erfolgreich erstellt.
Other Status Codes	ErrorResponseCommonV2	Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Create or update association

Create or update association with a data collection endpoint

Create or update association

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm/providers/Microsoft.Insights/dataCollectionRuleAssociations/myAssociation?api-version=2023-03-11

{
  "properties": {
    "dataCollectionRuleId": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myCollectionRule"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm/providers/Microsoft.Insights/dataCollectionRuleAssociations/myAssociation",
  "name": "myAssociation",
  "type": "Microsoft.Insights/dataCollectionRuleAssociations",
  "properties": {
    "dataCollectionRuleId": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myCollectionRule"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2024-03-22T19:15:08.2155156Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-03-22T19:15:08.2155156Z"
  },
  "etag": "00000836-0000-0100-0000-65fdd8bc0000"
}

Statuscode:: 201

{
  "id": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm/providers/Microsoft.Insights/dataCollectionRuleAssociations/myAssociation",
  "name": "myAssociation",
  "type": "Microsoft.Insights/dataCollectionRuleAssociations",
  "properties": {
    "dataCollectionRuleId": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionRules/myCollectionRule"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2024-03-22T19:15:08.2155156Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-03-22T19:15:08.2155156Z"
  },
  "etag": "00000836-0000-0100-0000-65fdd8bc0000"
}

Create or update association with a data collection endpoint

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm/providers/Microsoft.Insights/dataCollectionRuleAssociations/configurationAccessEndpoint?api-version=2023-03-11

{
  "properties": {
    "dataCollectionEndpointId": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionEndpoints/myCollectionEndpoint"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm/providers/Microsoft.Insights/dataCollectionRuleAssociations/configurationAccessEndpoint",
  "name": "configurationAccessEndpoint",
  "type": "Microsoft.Insights/dataCollectionRuleAssociations",
  "properties": {
    "dataCollectionEndpointId": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionEndpoints/myCollectionEndpoint"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2024-03-22T19:15:08.2155156Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-03-22T19:15:08.2155156Z"
  },
  "etag": "00000836-0000-0100-0000-65fdd8bc0000"
}

Statuscode:: 201

{
  "id": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm/providers/Microsoft.Insights/dataCollectionRuleAssociations/configurationAccessEndpoint",
  "name": "configurationAccessEndpoint",
  "type": "Microsoft.Insights/dataCollectionRuleAssociations",
  "properties": {
    "dataCollectionEndpointId": "/subscriptions/703362b3-f278-4e4b-9179-c76eaf41ffc2/resourceGroups/myResourceGroup/providers/Microsoft.Insights/dataCollectionEndpoints/myCollectionEndpoint"
  },
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2024-03-22T19:15:08.2155156Z",
    "lastModifiedBy": "user1",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-03-22T19:15:08.2155156Z"
  },
  "etag": "00000836-0000-0100-0000-65fdd8bc0000"
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DataCollectionRuleAssociationProxyOnlyResource	Definition der generischen ARM-Proxyressource.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponseCommonV2	Fehlerantwort
KnownDataCollectionRuleAssociationProvisioningState	Der Ressourcenbereitstellungsstatus.
Metadata	Metadaten zur Ressource
SystemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

DataCollectionRuleAssociationProxyOnlyResource

Objekt

Definition der generischen ARM-Proxyressource.

Name	Typ	Beschreibung
etag	string	Ressourcenentitätstag (ETag).
id	string	Vollqualifizierte ID der Ressource.
name	string	Der Name der Ressource.
properties.dataCollectionEndpointId	string	Die Ressourcen-ID des Datensammlungsendpunkts, der zugeordnet werden soll.
properties.dataCollectionRuleId	string	Die Ressourcen-ID der Datensammlungsregel, die zugeordnet werden soll.
properties.description	string	Beschreibung der Zuordnung.
properties.metadata	Metadata	Metadaten zur Ressource
properties.provisioningState	KnownDataCollectionRuleAssociationProvisioningState	Der Ressourcenbereitstellungsstatus.
systemData	SystemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
type	string	Der Typ der Ressource.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponseCommonV2

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

KnownDataCollectionRuleAssociationProvisioningState

Enumeration

Der Ressourcenbereitstellungsstatus.

Wert	Beschreibung
Canceled
Creating
Deleting
Failed
Succeeded
Updating

Metadata

Objekt

Metadaten zur Ressource

Name	Typ	Beschreibung
provisionedBy	string	Azure bietet die Verwaltung dieser Ressource im Auftrag des Kunden an.
provisionedByImmutableId	string	Unveränderliche ID des Azure-Angebots, das diese Ressource im Auftrag des Kunden verwaltet.
provisionedByResourceId	string	Ressourcen-ID von Azure, die diese Ressource im Auftrag des Kunden verwaltet.

SystemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

Data Collection Rule Associations - Create

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Create or update association

Beispielanforderung

Beispiel für eine Antwort

Create or update association with a data collection endpoint

Beispielanforderung

Beispiel für eine Antwort

Definitionen

createdByType

DataCollectionRuleAssociationProxyOnlyResource

ErrorAdditionalInfo

ErrorDetail

ErrorResponseCommonV2

KnownDataCollectionRuleAssociationProvisioningState

Metadata

SystemData

Zusätzliche Ressourcen