Condividi tramite


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

Nome In Necessario Tipo Descrizione
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

Nome Tipo Descrizione
dynatraceEnvironmentProperties

DynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

marketplaceSubscriptionStatus

MarketplaceSubscriptionStatus

Stato della sottoscrizione del Marketplace.

monitoringStatus

MonitoringStatus

Stato del monitoraggio.

planData

PlanData

Informazioni sul piano di fatturazione.

tags

object

Tag delle risorse.

userInfo

UserInfo

Informazioni utente.

Risposte

Nome Tipo Descrizione
200 OK

MonitorResource

Operazione arm completata correttamente.

Other Status Codes

ErrorResponse

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.

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

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Monitors_Update_MaximumSet_Gen
Monitors_Update_MinimumSet_Gen

Monitors_Update_MaximumSet_Gen

Esempio di richiesta

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

Risposta di esempio

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

Esempio di richiesta

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

{}

Risposta di esempio

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

Definizioni

Nome Descrizione
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

Nome Tipo Descrizione
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.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

DynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

Nome Tipo Descrizione
accountInfo

AccountInfo

Informazioni sull'account Dynatrace

environmentInfo

EnvironmentInfo

Informazioni sull'ambiente Dynatrace

singleSignOnProperties

DynatraceSingleSignOnProperties

Dettagli dell'accesso Single Sign-On di Dynatrace.

userId

string

ID utente

DynatraceSingleSignOnProperties

Dettagli dell'accesso Single Sign-On di Dynatrace.

Nome Tipo Descrizione
aadDomains

string[]

matrice di domini Aad(azure active directory)

enterpriseAppId

string

Versione dell'agente Dynatrace installata nella macchina virtuale.

provisioningState

ProvisioningState

Stato di provisioning della risorsa.

singleSignOnState

SingleSignOnStates

Stato di Single Sign On

singleSignOnUrl

string

URL di accesso specifico dell'ambiente Dynatrace

EnvironmentInfo

Informazioni sull'ambiente Dynatrace

Nome Tipo Descrizione
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.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

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.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

IdentityProperties

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

Nome Tipo Descrizione
principalId

string

Identificatore active directory dell'entità.

tenantId

string

ID tenant di Active Directory dell'entità.

type

ManagedIdentityType

Tipo di identità gestita assegnata a questa risorsa.

userAssignedIdentities

<string,  UserAssignedIdentity>

Identità assegnate a questa risorsa dall'utente.

LiftrResourceCategories

Categoria di risorse liftr

Nome Tipo Descrizione
MonitorLogs

string

Unknown

string

ManagedIdentityType

Tipo di identità gestita assegnata a questa risorsa.

Nome Tipo Descrizione
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.

Nome Tipo Descrizione
Active

string

Suspended

string

MonitoringStatus

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

Nome Tipo Descrizione
Disabled

string

Enabled

string

MonitorResource

Risorsa Dynatrace Monitor

Nome Tipo Descrizione
id

string

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

identity

IdentityProperties

Identità del servizio gestite assegnate a questa risorsa.

location

string

Posizione geografica in cui risiede la risorsa

name

string

nome della risorsa.

properties.dynatraceEnvironmentProperties

DynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

properties.liftrResourceCategory

LiftrResourceCategories

Categoria Risorsa liftr.

properties.liftrResourcePreference

integer

Priorità della risorsa.

properties.marketplaceSubscriptionStatus

MarketplaceSubscriptionStatus

Stato della sottoscrizione del Marketplace.

properties.monitoringStatus

MonitoringStatus

Stato del monitoraggio.

properties.planData

PlanData

Informazioni sul piano di fatturazione.

properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa.

properties.userInfo

UserInfo

Informazioni utente.

systemData

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.

Nome Tipo Descrizione
dynatraceEnvironmentProperties

DynatraceEnvironmentProperties

Proprietà dell'ambiente Dynatrace.

marketplaceSubscriptionStatus

MarketplaceSubscriptionStatus

Stato della sottoscrizione del Marketplace.

monitoringStatus

MonitoringStatus

Stato del monitoraggio.

planData

PlanData

Informazioni sul piano di fatturazione.

tags

object

Tag delle risorse.

userInfo

UserInfo

Informazioni utente.

PlanData

Informazioni sul piano di fatturazione.

Nome Tipo Descrizione
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

Nome Tipo Descrizione
Accepted

string

Canceled

string

Creating

string

Deleted

string

Deleting

string

Failed

string

NotSpecified

string

Succeeded

string

Updating

string

SingleSignOnStates

Vari stati della risorsa SSO

Nome Tipo Descrizione
Disable

string

Enable

string

Existing

string

Initial

string

systemData

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

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

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

createdByType

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

UserAssignedIdentity

Identità gestita assegnata dall'utente.

Nome Tipo Descrizione
clientId

string

Identificatore client di Active Directory per questa entità.

principalId

string

Identificatore di Active Directory per questa entità.

UserInfo

Informazioni utente.

Nome Tipo Descrizione
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