Monitors - Update

Aktualisieren einer MonitorResource

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Dynatrace.Observability/monitors/{monitorName}?api-version=2021-09-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
monitorName
path True

string

Überwachen des Ressourcennamens

resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Typ Beschreibung
dynatraceEnvironmentProperties

DynatraceEnvironmentProperties

Eigenschaften der Dynatrace-Umgebung.

marketplaceSubscriptionStatus

MarketplaceSubscriptionStatus

Marketplace-Abonnement status.

monitoringStatus

MonitoringStatus

Status des Monitors.

planData

PlanData

Abrechnungsplaninformationen.

tags

object

Ressourcentags.

userInfo

UserInfo

Benutzerinformationen.

Antworten

Name Typ Beschreibung
200 OK

MonitorResource

DER ARM-Vorgang wurde erfolgreich abgeschlossen.

Other Status Codes

ErrorResponse

Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Monitors_Update_MaximumSet_Gen
Monitors_Update_MinimumSet_Gen

Monitors_Update_MaximumSet_Gen

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Dynatrace.Observability/monitors/myMonitor?api-version=2021-09-01

{
  "tags": {
    "Environment": "Dev"
  },
  "monitoringStatus": "Enabled",
  "marketplaceSubscriptionStatus": "Active",
  "dynatraceEnvironmentProperties": {
    "accountInfo": {},
    "environmentInfo": {},
    "singleSignOnProperties": {}
  },
  "userInfo": {
    "firstName": "Alice",
    "lastName": "Bobab",
    "emailAddress": "alice@microsoft.com",
    "phoneNumber": "123456",
    "country": "westus2"
  },
  "planData": {
    "usageType": "Committed",
    "billingCycle": "Monthly",
    "planDetails": "dynatraceapitestplan",
    "effectiveDate": "2019-08-30T15:14:33+02:00"
  }
}

Sample Response

{
  "identity": {
    "principalId": "4534676867978",
    "tenantId": "23456789001",
    "type": "SystemAssigned"
  },
  "properties": {
    "monitoringStatus": "Enabled",
    "marketplaceSubscriptionStatus": "Active",
    "dynatraceEnvironmentProperties": {
      "userId": "alice123",
      "accountInfo": {
        "accountId": "1234567890",
        "regionId": "wus2"
      },
      "environmentInfo": {
        "environmentId": "a23xcv456",
        "ingestionKey": "1234567890",
        "logsIngestionEndpoint": "https://dynatrace.com",
        "landingURL": "https://a23xcv456.dynatrace.com"
      },
      "singleSignOnProperties": {
        "singleSignOnState": "Enable",
        "enterpriseAppId": "00000000-0000-0000-0000-000000000000",
        "singleSignOnUrl": "https://www.dynatrace.io/IAmSomeHash",
        "aadDomains": [
          "mpliftrdt20210811outlook.onmicrosoft.com"
        ]
      }
    },
    "userInfo": {
      "firstName": "Alice",
      "lastName": "Bobab",
      "emailAddress": "alice@microsoft.com",
      "phoneNumber": "123456",
      "country": "westus2"
    },
    "planData": {
      "usageType": "Committed",
      "billingCycle": "Monthly",
      "planDetails": "dynatraceapitestplan",
      "effectiveDate": "2019-08-30T15:14:33+02:00"
    },
    "liftrResourceCategory": "Unknown",
    "liftrResourcePreference": 28,
    "provisioningState": "Accepted"
  },
  "systemData": {
    "createdBy": "alice@microsoft.com",
    "createdByType": "User",
    "createdAt": "2021-07-16T04:25:21.040Z",
    "lastModifiedBy": "alice@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-07-16T04:25:21.040Z"
  },
  "tags": {
    "Environment": "Dev"
  },
  "location": "West US 2",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/monitors/myMonitor",
  "name": "myMonitor",
  "type": "Dynatrace.Observability/monitors"
}

Monitors_Update_MinimumSet_Gen

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Dynatrace.Observability/monitors/myMonitor?api-version=2021-09-01

{}

Sample Response

{
  "properties": {},
  "location": "West US 2"
}

Definitionen

Name Beschreibung
AccountInfo

Dynatrace-Kontoinformationen

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DynatraceEnvironmentProperties

Eigenschaften der Dynatrace-Umgebung.

DynatraceSingleSignOnProperties

Die Details eines einmaligen Anmeldens von Dynatrace.

EnvironmentInfo

Dynatrace-Umgebungsinformationen

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

IdentityProperties

Die Eigenschaften der verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind.

LiftrResourceCategories

Liftr-Ressourcenkategorie

ManagedIdentityType

Die Art der verwalteten Identität, die dieser Ressource zugewiesen ist.

MarketplaceSubscriptionStatus

Flag, das den Marketplace-Abonnementstatus der Ressource angibt. Wenn die Zahlung nicht rechtzeitig erfolgt, wird die Ressource im Status Angehalten angezeigt.

MonitoringStatus

Flag, das angibt, ob die Ressourcenüberwachung aktiviert oder deaktiviert ist.

MonitorResource

Dynatrace Monitor-Ressource

MonitorResourceUpdate

Die aktualisierbaren Eigenschaften der MonitorResource.

PlanData

Abrechnungsplaninformationen.

ProvisioningState

Bereitstellungsstatus der Überwachungsressource

SingleSignOnStates

Verschiedene Zustände der SSO-Ressource

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

UserAssignedIdentity

Eine vom Benutzer zugewiesene verwaltete Identität.

UserInfo

Benutzerinformationen.

AccountInfo

Dynatrace-Kontoinformationen

Name Typ Beschreibung
accountId

string

Konto-ID des Kontos, mit dem diese Umgebung verknüpft ist

regionId

string

Region, in der das Konto erstellt wird

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

DynatraceEnvironmentProperties

Eigenschaften der Dynatrace-Umgebung.

Name Typ Beschreibung
accountInfo

AccountInfo

Dynatrace-Kontoinformationen

environmentInfo

EnvironmentInfo

Dynatrace-Umgebungsinformationen

singleSignOnProperties

DynatraceSingleSignOnProperties

Die Details eines einmaligen Anmeldens von Dynatrace.

userId

string

Benutzer-ID

DynatraceSingleSignOnProperties

Die Details eines einmaligen Anmeldens von Dynatrace.

Name Typ Beschreibung
aadDomains

string[]

Array von Aad(azure Active Directory)-Domänen

enterpriseAppId

string

Version des Dynatrace-Agents, der auf der VM installiert ist.

provisioningState

ProvisioningState

Bereitstellungsstatus der Ressource.

singleSignOnState

SingleSignOnStates

Status der Single Sign-On

singleSignOnUrl

string

Die für diese Dynatrace-Umgebung spezifische Anmelde-URL

EnvironmentInfo

Dynatrace-Umgebungsinformationen

Name Typ Beschreibung
environmentId

string

ID der erstellten Umgebung

ingestionKey

string

Erfassungsschlüssel der Umgebung

landingURL

string

Ziel-URL für dynatrace-Umgebung

logsIngestionEndpoint

string

Erfassungsendpunkt, der zum Senden von Protokollen verwendet wird

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

IdentityProperties

Die Eigenschaften der verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind.

Name Typ Beschreibung
principalId

string

Der Active Directory-Bezeichner dieses Prinzipals.

tenantId

string

Die Active Directory-Mandanten-ID des Prinzipals.

type

ManagedIdentityType

Der Typ der verwalteten Identität, die dieser Ressource zugewiesen ist.

userAssignedIdentities

<string,  UserAssignedIdentity>

Die Identitäten, die dieser Ressource vom Benutzer zugewiesen sind.

LiftrResourceCategories

Liftr-Ressourcenkategorie

Name Typ Beschreibung
MonitorLogs

string

Unknown

string

ManagedIdentityType

Die Art der verwalteten Identität, die dieser Ressource zugewiesen ist.

Name Typ Beschreibung
SystemAndUserAssigned

string

SystemAssigned

string

UserAssigned

string

MarketplaceSubscriptionStatus

Flag, das den Marketplace-Abonnementstatus der Ressource angibt. Wenn die Zahlung nicht rechtzeitig erfolgt, wird die Ressource im Status Angehalten angezeigt.

Name Typ Beschreibung
Active

string

Suspended

string

MonitoringStatus

Flag, das angibt, ob die Ressourcenüberwachung aktiviert oder deaktiviert ist.

Name Typ Beschreibung
Disabled

string

Enabled

string

MonitorResource

Dynatrace Monitor-Ressource

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

IdentityProperties

Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind.

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.dynatraceEnvironmentProperties

DynatraceEnvironmentProperties

Eigenschaften der Dynatrace-Umgebung.

properties.liftrResourceCategory

LiftrResourceCategories

Liftr-Ressourcenkategorie.

properties.liftrResourcePreference

integer

Die Priorität der Ressource.

properties.marketplaceSubscriptionStatus

MarketplaceSubscriptionStatus

Marketplace-Abonnement status.

properties.monitoringStatus

MonitoringStatus

Status des Monitors.

properties.planData

PlanData

Abrechnungsplaninformationen.

properties.provisioningState

ProvisioningState

Bereitstellungsstatus der Ressource.

properties.userInfo

UserInfo

Benutzerinformationen.

systemData

systemData

Systemmetadaten für diese Ressource.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

MonitorResourceUpdate

Die aktualisierbaren Eigenschaften der MonitorResource.

Name Typ Beschreibung
dynatraceEnvironmentProperties

DynatraceEnvironmentProperties

Eigenschaften der Dynatrace-Umgebung.

marketplaceSubscriptionStatus

MarketplaceSubscriptionStatus

Marketplace-Abonnement status.

monitoringStatus

MonitoringStatus

Status des Monitors.

planData

PlanData

Abrechnungsplaninformationen.

tags

object

Ressourcentags.

userInfo

UserInfo

Benutzerinformationen.

PlanData

Abrechnungsplaninformationen.

Name Typ Beschreibung
billingCycle

string

verschiedene Abrechnungszyklen wie MONATLICH/WÖCHENTLICH. Dies könnte eine Enumeration sein.

effectiveDate

string

Datum der Anwendung des Plans

planDetails

string

Plan-ID, wie von Dynatrace veröffentlicht

usageType

string

unterschiedlicher Nutzungstyp wie PAYG/COMMITTED. Dies könnte eine Enumeration sein.

ProvisioningState

Bereitstellungsstatus der Überwachungsressource

Name Typ Beschreibung
Accepted

string

Canceled

string

Creating

string

Deleted

string

Deleting

string

Failed

string

NotSpecified

string

Succeeded

string

Updating

string

SingleSignOnStates

Verschiedene Zustände der SSO-Ressource

Name Typ Beschreibung
Disable

string

Enable

string

Existing

string

Initial

string

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

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

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.

UserAssignedIdentity

Eine vom Benutzer zugewiesene verwaltete Identität.

Name Typ Beschreibung
clientId

string

Der Active Directory-Clientbezeichner für diesen Prinzipal.

principalId

string

Der Active Directory-Bezeichner für diesen Prinzipal.

UserInfo

Benutzerinformationen.

Name Typ Beschreibung
country

string

Land des Benutzers

emailAddress

string

Email des Benutzers, der von Dynatrace verwendet wird, um sie bei Bedarf zu kontaktieren

firstName

string

Vorname des Benutzers

lastName

string

Nachname des Benutzers

phoneNumber

string

Telefonnummer des Benutzers, der von Dynatrace für die Kontaktaufnahme bei Bedarf verwendet wird