Monitors - Update

Aggiornare un oggetto MonitorResource

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

Parametri dell'URI

Name In Required Type Description
monitorName
path True
  • string

Monitorare il nome della risorsa

resourceGroupName
path True
  • string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Type Description
dynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

marketplaceSubscriptionStatus

Stato della sottoscrizione del Marketplace.

monitoringStatus

Stato del monitoraggio.

planData

Informazioni sul piano di fatturazione.

tags
  • object

Tag delle risorse.

userInfo

Informazioni utente.

Risposte

Name Type Description
200 OK

Operazione arm completata correttamente.

Other Status Codes

Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

AccountInfo

Informazioni sull'account Dynatrace

createdByType

Tipo di identità che ha creato la risorsa.

DynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

DynatraceSingleSignOnProperties

Dettagli dell'accesso Single Sign-On di Dynatrace.

EnvironmentInfo

Informazioni sull'ambiente Dynatrace

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

IdentityProperties

Proprietà delle identità del servizio gestito assegnate a questa risorsa.

LiftrResourceCategories

Categoria di risorse liftr

ManagedIdentityType

Tipo di identità gestita assegnata a questa risorsa.

MarketplaceSubscriptionStatus

Flag che specifica lo stato della sottoscrizione del Marketplace della risorsa. Se il pagamento non viene effettuato nel tempo, la risorsa passerà in stato Sospeso.

MonitoringStatus

Flag che specifica se il monitoraggio delle risorse è abilitato o disabilitato.

MonitorResource

Risorsa Dynatrace Monitor

MonitorResourceUpdate

Proprietà aggiornabili di MonitorResource.

PlanData

Informazioni sul piano di fatturazione.

ProvisioningState

Stato di provisioning della risorsa di monitoraggio

SingleSignOnStates

Vari stati della risorsa SSO

systemData

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

UserAssignedIdentity

Identità gestita assegnata dall'utente.

UserInfo

Informazioni utente.

AccountInfo

Informazioni sull'account Dynatrace

Name Type Description
accountId
  • string

ID account dell'account a cui è collegato questo ambiente

regionId
  • string

Area in cui viene creato l'account

createdByType

Tipo di identità che ha creato la risorsa.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

Name Type Description
accountInfo

Informazioni sull'account Dynatrace

environmentInfo

Informazioni sull'ambiente Dynatrace

singleSignOnProperties

Dettagli dell'accesso Single Sign-On di Dynatrace.

userId
  • string

ID utente

DynatraceSingleSignOnProperties

Dettagli dell'accesso Single Sign-On di Dynatrace.

Name Type Description
aadDomains
  • string[]

matrice di domini Aad(azure active directory)

enterpriseAppId
  • string

Versione dell'agente Dynatrace installata nella macchina virtuale.

provisioningState

Stato di provisioning della risorsa.

singleSignOnState

Stato di Single Sign-On

singleSignOnUrl
  • string

URL di accesso specifico dell'ambiente Dynatrace

EnvironmentInfo

Informazioni sull'ambiente Dynatrace

Name Type Description
environmentId
  • string

ID dell'ambiente creato

ingestionKey
  • string

Chiave di inserimento dell'ambiente

landingURL
  • string

URL di destinazione per l'ambiente Dynatrace

logsIngestionEndpoint
  • string

Endpoint di inserimento usato per l'invio di log

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Name Type Description
info
  • object

Informazioni aggiuntive.

type
  • string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Name Type Description
additionalInfo

Informazioni aggiuntive sull'errore.

code
  • string

Codice di errore.

details

Dettagli dell'errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Name Type Description
error

Oggetto error.

IdentityProperties

Proprietà delle identità del servizio gestito assegnate a questa risorsa.

Name Type Description
principalId
  • string

Identificatore active directory dell'entità.

tenantId
  • string

ID tenant di Active Directory dell'entità.

type

Tipo di identità gestita assegnata a questa risorsa.

userAssignedIdentities

Identità assegnate a questa risorsa dall'utente.

LiftrResourceCategories

Categoria di risorse liftr

Name Type Description
MonitorLogs
  • string
Unknown
  • string

ManagedIdentityType

Tipo di identità gestita assegnata a questa risorsa.

Name Type Description
SystemAndUserAssigned
  • string
SystemAssigned
  • string
UserAssigned
  • string

MarketplaceSubscriptionStatus

Flag che specifica lo stato della sottoscrizione del Marketplace della risorsa. Se il pagamento non viene effettuato nel tempo, la risorsa passerà in stato Sospeso.

Name Type Description
Active
  • string
Suspended
  • string

MonitoringStatus

Flag che specifica se il monitoraggio delle risorse è abilitato o disabilitato.

Name Type Description
Disabled
  • string
Enabled
  • string

MonitorResource

Risorsa Dynatrace Monitor

Name Type Description
id
  • string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identità del servizio gestite assegnate a questa risorsa.

location
  • string

Posizione geografica in cui risiede la risorsa

name
  • string

nome della risorsa.

properties.dynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

properties.liftrResourceCategory

Categoria Risorsa liftr.

properties.liftrResourcePreference
  • integer

Priorità della risorsa.

properties.marketplaceSubscriptionStatus

Stato della sottoscrizione del Marketplace.

properties.monitoringStatus

Stato del monitoraggio.

properties.planData

Informazioni sul piano di fatturazione.

properties.provisioningState

Stato di provisioning della risorsa.

properties.userInfo

Informazioni utente.

systemData

Metadati di sistema per questa risorsa.

tags
  • object

Tag delle risorse.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

MonitorResourceUpdate

Proprietà aggiornabili di MonitorResource.

Name Type Description
dynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

marketplaceSubscriptionStatus

Stato della sottoscrizione del Marketplace.

monitoringStatus

Stato del monitoraggio.

planData

Informazioni sul piano di fatturazione.

tags
  • object

Tag delle risorse.

userInfo

Informazioni utente.

PlanData

Informazioni sul piano di fatturazione.

Name Type Description
billingCycle
  • string

cicli di fatturazione diversi, ad esempio MONTHLY/WEEKLY. potrebbe trattarsi di enumerazione

effectiveDate
  • string

data di applicazione del piano

planDetails
  • string

id piano pubblicato da Dynatrace

usageType
  • string

tipo di utilizzo diverso, ad esempio PAYG/COMMITTED. potrebbe trattarsi di enumerazione

ProvisioningState

Stato di provisioning della risorsa di monitoraggio

Name Type Description
Accepted
  • string
Canceled
  • string
Creating
  • string
Deleted
  • string
Deleting
  • string
Failed
  • string
NotSpecified
  • string
Succeeded
  • string
Updating
  • string

SingleSignOnStates

Vari stati della risorsa SSO

Name Type Description
Disable
  • string
Enable
  • string
Existing
  • string
Initial
  • string

systemData

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

Name Type Description
createdAt
  • string

Timestamp della creazione di risorse (UTC).

createdBy
  • string

Identità che ha creato la risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt
  • string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy
  • string

Identità che ha modificato l'ultima volta la risorsa.

lastModifiedByType

Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentity

Identità gestita assegnata dall'utente.

Name Type Description
clientId
  • string

Identificatore client di Active Directory per questa entità.

principalId
  • string

Identificatore di Active Directory per questa entità.

UserInfo

Informazioni utente.

Name Type Description
country
  • string

Paese dell'utente

emailAddress
  • string

Email dell'utente usato da Dynatrace per contattarli, se necessario

firstName
  • string

Nome dell'utente

lastName
  • string

Cognome dell'utente

phoneNumber
  • string

Numero di telefono dell'utente usato da Dynatrace per contattarli, se necessario