Monitors - Create Or Update

Referenz

Dienst:: Dynatrace

API-Version:: 2021-09-01

Erstellen einer MonitorResource

PUT 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 minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
identity		IdentityProperties	Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind.
properties.dynatraceEnvironmentProperties		DynatraceEnvironmentProperties	Eigenschaften der Dynatrace-Umgebung.
properties.marketplaceSubscriptionStatus		MarketplaceSubscriptionStatus	Marketplace-Abonnementstatus.
properties.monitoringStatus		MonitoringStatus	Status des Monitors.
properties.planData		PlanData	Abrechnungsplaninformationen.
properties.userInfo		UserInfo	Benutzerinformationen.
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	MonitorResource	Der ARM-Vorgang wurde erfolgreich abgeschlossen.
201 Created	MonitorResource	Der ARM-Erstellungsvorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Häufige Fehlerantwort für alle Azure Resource Manager-APIs, um Fehlerdetails für fehlgeschlagene Vorgänge zurückzugeben.

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

Monitors_CreateOrUpdate_MaximumSet_Gen

Monitors_CreateOrUpdate_MinimumSet_Gen

Monitors_CreateOrUpdate_MaximumSet_Gen

Beispielanforderung

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

{
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "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"
    },
    "liftrResourceCategory": "Unknown",
    "provisioningState": "Accepted"
  },
  "tags": {
    "Environment": "Dev"
  },
  "location": "West US 2"
}

import com.azure.resourcemanager.dynatrace.fluent.models.DynatraceSingleSignOnProperties;
import com.azure.resourcemanager.dynatrace.models.AccountInfo;
import com.azure.resourcemanager.dynatrace.models.DynatraceEnvironmentProperties;
import com.azure.resourcemanager.dynatrace.models.EnvironmentInfo;
import com.azure.resourcemanager.dynatrace.models.IdentityProperties;
import com.azure.resourcemanager.dynatrace.models.ManagedIdentityType;
import com.azure.resourcemanager.dynatrace.models.MarketplaceSubscriptionStatus;
import com.azure.resourcemanager.dynatrace.models.MonitoringStatus;
import com.azure.resourcemanager.dynatrace.models.PlanData;
import com.azure.resourcemanager.dynatrace.models.UserInfo;
import java.time.OffsetDateTime;
import java.util.HashMap;
import java.util.Map;

/** Samples for Monitors CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MaximumSet_Gen.json
     */
    /**
     * Sample code: Monitors_CreateOrUpdate_MaximumSet_Gen.
     *
     * @param manager Entry point to DynatraceManager.
     */
    public static void monitorsCreateOrUpdateMaximumSetGen(
        com.azure.resourcemanager.dynatrace.DynatraceManager manager) {
        manager
            .monitors()
            .define("myMonitor")
            .withRegion("West US 2")
            .withExistingResourceGroup("myResourceGroup")
            .withTags(mapOf("Environment", "Dev"))
            .withIdentity(new IdentityProperties().withType(ManagedIdentityType.SYSTEM_ASSIGNED))
            .withMonitoringStatus(MonitoringStatus.ENABLED)
            .withMarketplaceSubscriptionStatus(MarketplaceSubscriptionStatus.ACTIVE)
            .withDynatraceEnvironmentProperties(
                new DynatraceEnvironmentProperties()
                    .withAccountInfo(new AccountInfo())
                    .withEnvironmentInfo(new EnvironmentInfo())
                    .withSingleSignOnProperties(new DynatraceSingleSignOnProperties()))
            .withUserInfo(
                new UserInfo()
                    .withFirstName("Alice")
                    .withLastName("Bobab")
                    .withEmailAddress("alice@microsoft.com")
                    .withPhoneNumber("123456")
                    .withCountry("westus2"))
            .withPlanData(
                new PlanData()
                    .withUsageType("Committed")
                    .withBillingCycle("Monthly")
                    .withPlanDetails("dynatraceapitestplan")
                    .withEffectiveDate(OffsetDateTime.parse("2019-08-30T15:14:33+02:00")))
            .create();
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential
from azure.mgmt.dynatrace import DynatraceObservabilityMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-dynatrace
# USAGE
    python monitors_create_or_update_maximum_set_gen.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DynatraceObservabilityMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.monitors.begin_create_or_update(
        resource_group_name="myResourceGroup",
        monitor_name="myMonitor",
        resource={
            "identity": {"type": "SystemAssigned"},
            "location": "West US 2",
            "properties": {
                "dynatraceEnvironmentProperties": {
                    "accountInfo": {},
                    "environmentInfo": {},
                    "singleSignOnProperties": {},
                },
                "liftrResourceCategory": "Unknown",
                "marketplaceSubscriptionStatus": "Active",
                "monitoringStatus": "Enabled",
                "planData": {
                    "billingCycle": "Monthly",
                    "effectiveDate": "2019-08-30T15:14:33+02:00",
                    "planDetails": "dynatraceapitestplan",
                    "usageType": "Committed",
                },
                "provisioningState": "Accepted",
                "userInfo": {
                    "country": "westus2",
                    "emailAddress": "alice@microsoft.com",
                    "firstName": "Alice",
                    "lastName": "Bobab",
                    "phoneNumber": "123456",
                },
            },
            "tags": {"Environment": "Dev"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MaximumSet_Gen.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armdynatrace_test

import (
	"context"
	"log"

	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dynatrace/armdynatrace"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/3751f321654db00858e70649291af5c81e94611e/specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MaximumSet_Gen.json
func ExampleMonitorsClient_BeginCreateOrUpdate_monitorsCreateOrUpdateMaximumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdynatrace.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewMonitorsClient().BeginCreateOrUpdate(ctx, "myResourceGroup", "myMonitor", armdynatrace.MonitorResource{
		Location: to.Ptr("West US 2"),
		Tags: map[string]*string{
			"Environment": to.Ptr("Dev"),
		},
		Identity: &armdynatrace.IdentityProperties{
			Type: to.Ptr(armdynatrace.ManagedIdentityTypeSystemAssigned),
		},
		Properties: &armdynatrace.MonitorProperties{
			DynatraceEnvironmentProperties: &armdynatrace.EnvironmentProperties{
				AccountInfo:            &armdynatrace.AccountInfo{},
				EnvironmentInfo:        &armdynatrace.EnvironmentInfo{},
				SingleSignOnProperties: &armdynatrace.SingleSignOnProperties{},
			},
			LiftrResourceCategory:         to.Ptr(armdynatrace.LiftrResourceCategoriesUnknown),
			MarketplaceSubscriptionStatus: to.Ptr(armdynatrace.MarketplaceSubscriptionStatusActive),
			MonitoringStatus:              to.Ptr(armdynatrace.MonitoringStatusEnabled),
			PlanData: &armdynatrace.PlanData{
				BillingCycle:  to.Ptr("Monthly"),
				EffectiveDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-08-30T15:14:33+02:00"); return t }()),
				PlanDetails:   to.Ptr("dynatraceapitestplan"),
				UsageType:     to.Ptr("Committed"),
			},
			ProvisioningState: to.Ptr(armdynatrace.ProvisioningStateAccepted),
			UserInfo: &armdynatrace.UserInfo{
				Country:      to.Ptr("westus2"),
				EmailAddress: to.Ptr("alice@microsoft.com"),
				FirstName:    to.Ptr("Alice"),
				LastName:     to.Ptr("Bobab"),
				PhoneNumber:  to.Ptr("123456"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.MonitorResource = armdynatrace.MonitorResource{
	// 	Name: to.Ptr("myMonitor"),
	// 	Type: to.Ptr("Dynatrace.Observability/monitors"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/monitors/myMonitor"),
	// 	Location: to.Ptr("West US 2"),
	// 	Tags: map[string]*string{
	// 		"Environment": to.Ptr("Dev"),
	// 	},
	// 	Identity: &armdynatrace.IdentityProperties{
	// 		Type: to.Ptr(armdynatrace.ManagedIdentityTypeSystemAssigned),
	// 		PrincipalID: to.Ptr("4534676867978"),
	// 		TenantID: to.Ptr("23456789001"),
	// 	},
	// 	Properties: &armdynatrace.MonitorProperties{
	// 		DynatraceEnvironmentProperties: &armdynatrace.EnvironmentProperties{
	// 			AccountInfo: &armdynatrace.AccountInfo{
	// 				AccountID: to.Ptr("1234567890"),
	// 				RegionID: to.Ptr("wus2"),
	// 			},
	// 			EnvironmentInfo: &armdynatrace.EnvironmentInfo{
	// 				EnvironmentID: to.Ptr("a23xcv456"),
	// 				IngestionKey: to.Ptr("1234567890"),
	// 				LogsIngestionEndpoint: to.Ptr("https://dynatrace.com"),
	// 			},
	// 			SingleSignOnProperties: &armdynatrace.SingleSignOnProperties{
	// 				AADDomains: []*string{
	// 					to.Ptr("mpliftrdt20210811outlook.onmicrosoft.com")},
	// 					EnterpriseAppID: to.Ptr("00000000-0000-0000-0000-000000000000"),
	// 					SingleSignOnState: to.Ptr(armdynatrace.SingleSignOnStatesEnable),
	// 					SingleSignOnURL: to.Ptr("https://www.dynatrace.io/IAmSomeHash"),
	// 				},
	// 				UserID: to.Ptr("alice123"),
	// 			},
	// 			LiftrResourceCategory: to.Ptr(armdynatrace.LiftrResourceCategoriesUnknown),
	// 			LiftrResourcePreference: to.Ptr[int32](28),
	// 			MarketplaceSubscriptionStatus: to.Ptr(armdynatrace.MarketplaceSubscriptionStatusActive),
	// 			MonitoringStatus: to.Ptr(armdynatrace.MonitoringStatusEnabled),
	// 			PlanData: &armdynatrace.PlanData{
	// 				BillingCycle: to.Ptr("Monthly"),
	// 				EffectiveDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-08-30T15:14:33+02:00"); return t}()),
	// 				PlanDetails: to.Ptr("dynatraceapitestplan"),
	// 				UsageType: to.Ptr("Committed"),
	// 			},
	// 			ProvisioningState: to.Ptr(armdynatrace.ProvisioningStateSucceeded),
	// 			UserInfo: &armdynatrace.UserInfo{
	// 				Country: to.Ptr("westus2"),
	// 				EmailAddress: to.Ptr("alice@microsoft.com"),
	// 				FirstName: to.Ptr("Alice"),
	// 				LastName: to.Ptr("Bobab"),
	// 				PhoneNumber: to.Ptr("123456"),
	// 			},
	// 		},
	// 		SystemData: &armdynatrace.SystemData{
	// 			CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-07-16T04:25:21.040Z"); return t}()),
	// 			CreatedBy: to.Ptr("alice@microsoft.com"),
	// 			CreatedByType: to.Ptr(armdynatrace.CreatedByTypeUser),
	// 			LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-07-16T04:25:21.040Z"); return t}()),
	// 			LastModifiedBy: to.Ptr("alice@microsoft.com"),
	// 			LastModifiedByType: to.Ptr(armdynatrace.CreatedByTypeUser),
	// 		},
	// 	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { DynatraceObservability } = require("@azure/arm-dynatrace");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Create a MonitorResource
 *
 * @summary Create a MonitorResource
 * x-ms-original-file: specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MaximumSet_Gen.json
 */
async function monitorsCreateOrUpdateMaximumSetGen() {
  const subscriptionId =
    process.env["DYNATRACE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["DYNATRACE_RESOURCE_GROUP"] || "myResourceGroup";
  const monitorName = "myMonitor";
  const resource = {
    dynatraceEnvironmentProperties: {
      accountInfo: {},
      environmentInfo: {},
      singleSignOnProperties: {},
    },
    identity: { type: "SystemAssigned" },
    liftrResourceCategory: "Unknown",
    location: "West US 2",
    marketplaceSubscriptionStatus: "Active",
    monitoringStatus: "Enabled",
    planData: {
      billingCycle: "Monthly",
      effectiveDate: new Date("2019-08-30T15:14:33+02:00"),
      planDetails: "dynatraceapitestplan",
      usageType: "Committed",
    },
    provisioningState: "Accepted",
    tags: { environment: "Dev" },
    userInfo: {
      country: "westus2",
      emailAddress: "alice@microsoft.com",
      firstName: "Alice",
      lastName: "Bobab",
      phoneNumber: "123456",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new DynatraceObservability(credential, subscriptionId);
  const result = await client.monitors.beginCreateOrUpdateAndWait(
    resourceGroupName,
    monitorName,
    resource
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 201

Azure-AsyncOperation: https://foo.com/operationstatus

{
  "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"
      },
      "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_CreateOrUpdate_MinimumSet_Gen

Beispielanforderung

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

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

import java.util.HashMap;
import java.util.Map;

/** Samples for Monitors CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MinimumSet_Gen.json
     */
    /**
     * Sample code: Monitors_CreateOrUpdate_MinimumSet_Gen.
     *
     * @param manager Entry point to DynatraceManager.
     */
    public static void monitorsCreateOrUpdateMinimumSetGen(
        com.azure.resourcemanager.dynatrace.DynatraceManager manager) {
        manager
            .monitors()
            .define("myMonitor")
            .withRegion("West US 2")
            .withExistingResourceGroup("myResourceGroup")
            .create();
    }

    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential
from azure.mgmt.dynatrace import DynatraceObservabilityMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-dynatrace
# USAGE
    python monitors_create_or_update_minimum_set_gen.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DynatraceObservabilityMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.monitors.begin_create_or_update(
        resource_group_name="myResourceGroup",
        monitor_name="myMonitor",
        resource={"location": "West US 2", "properties": {}},
    ).result()
    print(response)


# x-ms-original-file: specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MinimumSet_Gen.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armdynatrace_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dynatrace/armdynatrace"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/3751f321654db00858e70649291af5c81e94611e/specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MinimumSet_Gen.json
func ExampleMonitorsClient_BeginCreateOrUpdate_monitorsCreateOrUpdateMinimumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdynatrace.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewMonitorsClient().BeginCreateOrUpdate(ctx, "myResourceGroup", "myMonitor", armdynatrace.MonitorResource{
		Location:   to.Ptr("West US 2"),
		Properties: &armdynatrace.MonitorProperties{},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.MonitorResource = armdynatrace.MonitorResource{
	// 	Location: to.Ptr("West US 2"),
	// 	Properties: &armdynatrace.MonitorProperties{
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { DynatraceObservability } = require("@azure/arm-dynatrace");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Create a MonitorResource
 *
 * @summary Create a MonitorResource
 * x-ms-original-file: specification/dynatrace/resource-manager/Dynatrace.Observability/stable/2021-09-01/examples/Monitors_CreateOrUpdate_MinimumSet_Gen.json
 */
async function monitorsCreateOrUpdateMinimumSetGen() {
  const subscriptionId =
    process.env["DYNATRACE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["DYNATRACE_RESOURCE_GROUP"] || "myResourceGroup";
  const monitorName = "myMonitor";
  const resource = { location: "West US 2" };
  const credential = new DefaultAzureCredential();
  const client = new DynatraceObservability(credential, subscriptionId);
  const result = await client.monitors.beginCreateOrUpdateAndWait(
    resourceGroupName,
    monitorName,
    resource
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 201

Azure-AsyncOperation: https://foo.com/operationstatus

{
  "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 Dynatrace Single Sign-Ons.
EnvironmentInfo	Dynatrace-Umgebungsinformationen
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das 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 in den Zustand "Angehalten" verschoben.
MonitoringStatus	Flag, das angibt, ob die Ressourcenüberwachung aktiviert oder deaktiviert ist.
MonitorResource	Dynatrace Monitor-Ressource
PlanData	Abrechnungsplaninformationen.
ProvisioningState	Bereitstellungsstatus der Überwachungsressource
SingleSignOnStates	Verschiedene Zustände der SSO-Ressource
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
UserAssignedIdentity	Eine vom Benutzer zugewiesene verwaltete Identität.
UserInfo	Benutzerinformationen.

AccountInfo

Objekt

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

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

DynatraceEnvironmentProperties

Objekt

Eigenschaften der Dynatrace-Umgebung.

Name	Typ	Beschreibung
accountInfo	AccountInfo	Dynatrace-Kontoinformationen
environmentInfo	EnvironmentInfo	Dynatrace-Umgebungsinformationen
singleSignOnProperties	DynatraceSingleSignOnProperties	Die Details eines Dynatrace Single Sign-Ons.
userId	string	Benutzer-ID

DynatraceSingleSignOnProperties

Objekt

Die Details eines Dynatrace Single Sign-Ons.

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 des einmaligen Anmeldens
singleSignOnUrl	string	Die für diese Dynatrace-Umgebung spezifische Anmelde-URL

EnvironmentInfo

Objekt

Dynatrace-Umgebungsinformationen

Name	Typ	Beschreibung
environmentId	string	ID der erstellten Umgebung
ingestionKey	string	Aufnahmeschlüssel der Umgebung
landingURL	string	Ziel-URL für Dynatrace-Umgebung
logsIngestionEndpoint	string	Aufnahmeendpunkt, der zum Senden von Protokollen verwendet wird

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.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

IdentityProperties

Objekt

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

Enumeration

Liftr-Ressourcenkategorie

Wert	Beschreibung
MonitorLogs
Unknown

ManagedIdentityType

Enumeration

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

Wert	Beschreibung
SystemAndUserAssigned
SystemAssigned
UserAssigned

MarketplaceSubscriptionStatus

Enumeration

Flag, das den Marketplace-Abonnementstatus der Ressource angibt. Wenn die Zahlung nicht rechtzeitig erfolgt, wird die Ressource in den Zustand "Angehalten" verschoben.

Wert	Beschreibung
Active
Suspended

MonitoringStatus

Enumeration

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

Wert	Beschreibung
Disabled
Enabled

MonitorResource

Objekt

Dynatrace Monitor-Ressource

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /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 Resource category.
properties.liftrResourcePreference	integer (int32)	Die Priorität der Ressource.
properties.marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus	Marketplace-Abonnementstatus.
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"

PlanData

Objekt

Abrechnungsplaninformationen.

Name	Typ	Beschreibung
billingCycle	string	unterschiedliche Abrechnungszyklen wie MONATLICH/WÖCHENTLICH. dies könnte aufgezählt werden.
effectiveDate	string (date-time)	Datum der Anwendung des Plans
planDetails	string	Plan-ID wie von Dynatrace veröffentlicht
usageType	string	anderer Verwendungstyp wie PAYG/COMMIT. dies könnte aufgezählt werden.

ProvisioningState

Enumeration

Bereitstellungsstatus der Überwachungsressource

Wert	Beschreibung
Accepted
Canceled
Creating
Deleted
Deleting
Failed
NotSpecified
Succeeded
Updating

SingleSignOnStates

Enumeration

Verschiedene Zustände der SSO-Ressource

Wert	Beschreibung
Disable
Enable
Existing
Initial

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.

UserAssignedIdentity

Objekt

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

Objekt

Benutzerinformationen.

Name	Typ	Beschreibung
country	string	Land des Benutzers
emailAddress	string pattern: ^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$	E-Mail 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 maxLength: 40	Telefonnummer des Benutzers, der von Dynatrace für die Kontaktaufnahme bei Bedarf verwendet wird

Freigeben über

Monitors - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Monitors_CreateOrUpdate_MaximumSet_Gen

Beispielanforderung

Beispiel für eine Antwort

Monitors_CreateOrUpdate_MinimumSet_Gen

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AccountInfo

createdByType

DynatraceEnvironmentProperties

DynatraceSingleSignOnProperties

EnvironmentInfo

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdentityProperties

LiftrResourceCategories

ManagedIdentityType

MarketplaceSubscriptionStatus

MonitoringStatus

MonitorResource

PlanData

ProvisioningState

SingleSignOnStates

systemData

UserAssignedIdentity

UserInfo