Monitors - Create

Service:: Datadog

API-versie:: 2025-06-11

Maak een monitorresource.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Datadog/monitors/{monitorName}?api-version=2025-06-11

URI-parameters

Name	In	Vereist	Type	Description
monitorName	path	True	string minLength: 2 maxLength: 32 pattern: ^[a-zA-Z0-9_][a-zA-Z0-9_-]+$	Resourcenaam bewaken
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
identity		IdentityProperties
properties		MonitorProperties	Eigenschappen die specifiek zijn voor de monitorresource.
sku		ResourceSku
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	DatadogMonitorResource	De updatebewerking van de bron 'DatadogMonitorResource' is geslaagd
201 Created	DatadogMonitorResource	Resource 'DatadogMonitorResource' create bewerking geslaagd Kopteksten Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Name

Type

Description

200 OK

DatadogMonitorResource

De updatebewerking van de bron 'DatadogMonitorResource' is geslaagd

201 Created

DatadogMonitorResource

Resource 'DatadogMonitorResource' create bewerking geslaagd

Kopteksten

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Monitors_Create

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Datadog/monitors/myMonitor?api-version=2025-06-11

{
  "location": "West US",
  "properties": {
    "datadogOrganizationProperties": {
      "name": "myOrg",
      "cspm": false,
      "enterpriseAppId": "00000000-0000-0000-0000-000000000000",
      "id": "myOrg123",
      "linkingAuthCode": "someAuthCode",
      "linkingClientId": "00000000-0000-0000-0000-000000000000",
      "resourceCollection": false
    },
    "monitoringStatus": "Enabled",
    "userInfo": {
      "name": "Alice",
      "emailAddress": "alice@microsoft.com",
      "phoneNumber": "123-456-7890"
    }
  },
  "sku": {
    "name": "free_Monthly"
  },
  "tags": {
    "Environment": "Dev"
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Datadog.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Datadog;

// Generated from example definition: specification/datadog/resource-manager/Microsoft.Datadog/stable/2025-06-11/examples/Monitors_Create.json
// this example is just showing the usage of "Monitors_Create" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this DatadogMonitorResource
DatadogMonitorCollection collection = resourceGroupResource.GetDatadogMonitors();

// invoke the operation
string monitorName = "myMonitor";
DatadogMonitorData data = new DatadogMonitorData(new AzureLocation("West US"))
{
    Properties = new DatadogMonitorProperties
    {
        MonitoringStatus = DatadogMonitoringStatus.Enabled,
        DatadogOrganizationProperties = new DatadogOrganizationProperties
        {
            Name = "myOrg",
            Id = "myOrg123",
            LinkingAuthCode = "someAuthCode",
            LinkingClientId = "00000000-0000-0000-0000-000000000000",
            EnterpriseAppId = "00000000-0000-0000-0000-000000000000",
            IsCspm = false,
            IsResourceCollection = false,
        },
        UserInfo = new DatadogUserInfo
        {
            Name = "Alice",
            EmailAddress = "alice@microsoft.com",
            PhoneNumber = "123-456-7890",
        },
    },
    SkuName = "free_Monthly",
    Tags =
    {
    ["Environment"] = "Dev"
    },
};
ArmOperation<DatadogMonitorResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, monitorName, data);
DatadogMonitorResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
DatadogMonitorData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Voorbeeldrespons

Statuscode:: 200

{
  "name": "myMonitor",
  "type": "Microsoft.Datadog/monitors",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/monitors/myMonitor",
  "location": "West US",
  "properties": {
    "datadogOrganizationProperties": {
      "name": "myOrg",
      "enterpriseAppId": null,
      "id": "myOrg123",
      "linkingAuthCode": null,
      "linkingClientId": null
    },
    "liftrResourceCategory": "MonitorLogs",
    "liftrResourcePreference": 1,
    "monitoringStatus": "Enabled",
    "provisioningState": "Succeeded"
  },
  "sku": {
    "name": "free_Monthly"
  },
  "tags": {
    "Environment": "Dev"
  }
}

Statuscode:: 201

{
  "name": "myMonitor",
  "type": "Microsoft.Datadog/monitors",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/monitors/myMonitor",
  "location": "West US",
  "properties": {
    "datadogOrganizationProperties": {
      "name": "myOrg",
      "id": "myOrg123"
    },
    "liftrResourceCategory": "MonitorLogs",
    "liftrResourcePreference": 1,
    "monitoringStatus": "Enabled",
    "provisioningState": "Accepted"
  },
  "sku": {
    "name": "free_Monthly"
  },
  "tags": {
    "Environment": "Dev"
  }
}

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
DatadogMonitorResource	Concrete bijgehouden resourcetypen kunnen worden gemaakt door dit type te aliasen met behulp van een specifiek eigenschapstype.
DatadogOrganizationProperties	Geef de naam van de Datadog-organisatie op. In het geval van een koppeling naar bestaande organisaties, id, ApiKey en Applicationkey is ook vereist.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
IdentityProperties
LiftrResourceCategories
ManagedIdentityTypes	Hiermee geeft u het identiteitstype van de Datadog Monitor. Op dit moment is de enige toegestane waarde 'SystemAssigned'.
MarketplaceSubscriptionStatus	Vlag die de Marketplace-abonnementsstatus van de resource opgeeft. Als de betaling niet op tijd wordt uitgevoerd, wordt de resource opgeschort.
MonitoringStatus	Vlag die aangeeft of de resourcebewaking is ingeschakeld of uitgeschakeld.
MonitorProperties	Eigenschappen die specifiek zijn voor de monitorresource.
ProvisioningState
ResourceSku
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UserInfo	Bevat de naam, het e-mailadres en eventueel het telefoonnummer. Gebruikersgegevens kunnen niet null zijn.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DatadogMonitorResource

Object

Concrete bijgehouden resourcetypen kunnen worden gemaakt door dit type te aliasen met behulp van een specifiek eigenschapstype.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	IdentityProperties
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties	MonitorProperties	Eigenschappen die specifiek zijn voor de monitorresource.
sku	ResourceSku
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

DatadogOrganizationProperties

Object

Geef de naam van de Datadog-organisatie op. In het geval van een koppeling naar bestaande organisaties, id, ApiKey en Applicationkey is ook vereist.

Name	Type	Description
apiKey	string (password)	Api-sleutel die is gekoppeld aan de Datadog-organisatie.
applicationKey	string (password)	Toepassingssleutel die is gekoppeld aan de Datadog-organisatie.
cspm	boolean	De configuratie die de status van cloudbeveiligingspostuurbeheer beschrijft. Hiermee worden configuratiegegevens verzameld voor alle resources in een abonnement en wordt de naleving van de benchmarks in de branche bijgehouden.
enterpriseAppId	string	De id van de enterprise-app die wordt gebruikt voor eenmalige aanmelding.
id	string	Id van de Datadog-organisatie.
linkingAuthCode	string (password)	De verificatiecode die wordt gebruikt voor het koppelen aan een bestaande Datadog-organisatie.
linkingClientId	string (password)	De client_id van een bestaande in ruil voor een verificatietoken om een organisatie te koppelen.
name	string	Naam van de Datadog-organisatie.
redirectUri	string	De omleidings-URI voor het koppelen.
resourceCollection	boolean	De configuratie die de status van het verzamelen van bronnen beschrijft. Hiermee worden configuratiegegevens verzameld voor alle resources in een abonnement.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IdentityProperties

Object

Name	Type	Description
principalId	string	De identiteits-ID.
tenantId	string	De tenant-id van de resource.
type	ManagedIdentityTypes	Hiermee geeft u het identiteitstype van de Datadog Monitor. Op dit moment is de enige toegestane waarde 'SystemAssigned'.

LiftrResourceCategories

Opsomming

Waarde	Description
Unknown
MonitorLogs

ManagedIdentityTypes

Opsomming

Hiermee geeft u het identiteitstype van de Datadog Monitor. Op dit moment is de enige toegestane waarde 'SystemAssigned'.

Waarde	Description
SystemAssigned
UserAssigned

MarketplaceSubscriptionStatus

Opsomming

Vlag die de Marketplace-abonnementsstatus van de resource opgeeft. Als de betaling niet op tijd wordt uitgevoerd, wordt de resource opgeschort.

Waarde	Description
Provisioning
Active
Suspended
Unsubscribed

MonitoringStatus

Opsomming

Vlag die aangeeft of de resourcebewaking is ingeschakeld of uitgeschakeld.

Waarde	Description
Enabled
Disabled

MonitorProperties

Object

Eigenschappen die specifiek zijn voor de monitorresource.

Name	Type	Default value	Description
datadogOrganizationProperties	DatadogOrganizationProperties		Geef de naam van de Datadog-organisatie op. In het geval van een koppeling naar bestaande organisaties, id, ApiKey en Applicationkey is ook vereist.
liftrResourceCategory	LiftrResourceCategories
liftrResourcePreference	integer (int32)		De prioriteit van de hulpbron.
marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus		Vlag die de Marketplace-abonnementsstatus van de resource opgeeft. Als de betaling niet op tijd wordt uitgevoerd, wordt de resource opgeschort.
monitoringStatus	MonitoringStatus	Enabled	Vlag die aangeeft of de resourcebewaking is ingeschakeld of uitgeschakeld.
provisioningState	ProvisioningState
userInfo	UserInfo		Bevat de naam, het e-mailadres en eventueel het telefoonnummer. Gebruikersgegevens kunnen niet null zijn.

ProvisioningState

Opsomming

Waarde	Description
Accepted
Creating
Updating
Deleting
Succeeded
Failed
Canceled
Deleted
NotSpecified

ResourceSku

Object

Name	Type	Description
name	string	Naam van de SKU in {PlanId}-indeling. Voor Terraform is de enige toegestane waarde Gekoppeld.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserInfo

Object

Bevat de naam, het e-mailadres en eventueel het telefoonnummer. Gebruikersgegevens kunnen niet null zijn.

Name	Type	Description
emailAddress	string pattern: ^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$	E-mail van de gebruiker die door Datadog wordt gebruikt voor het contact met de gebruiker indien nodig
name	string maxLength: 50	Naam van de gebruiker
phoneNumber	string maxLength: 40	Telefoonnummer van de gebruiker die door Datadog wordt gebruikt voor het contact met de gebruiker indien nodig

Delen via

Monitors - Create

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Monitors_Create

Voorbeeldaanvraag

Voorbeeldrespons

Definities

createdByType

DatadogMonitorResource

DatadogOrganizationProperties

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdentityProperties

LiftrResourceCategories

ManagedIdentityTypes

MarketplaceSubscriptionStatus

MonitoringStatus

MonitorProperties

ProvisioningState

ResourceSku

systemData

UserInfo