Monitors - Create

Service:: Datadog

Version d'API:: 2025-06-11

Créez une ressource de moniteur.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
monitorName	path	True	string minLength: 2 maxLength: 32 pattern: ^[a-zA-Z0-9_][a-zA-Z0-9_-]+$	Surveiller le nom de la ressource
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
identity		IdentityProperties
properties		MonitorProperties	Propriétés spécifiques à la ressource de surveillance.
sku		ResourceSku
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	DatadogMonitorResource	Réussite de l’opération de mise à jour de la ressource « DatadogMonitorResource »
201 Created	DatadogMonitorResource	Réussite de l’opération de création de la ressource 'DatadogMonitorResource' En-têtes Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

DatadogMonitorResource

Réussite de l’opération de mise à jour de la ressource « DatadogMonitorResource »

201 Created

DatadogMonitorResource

Réussite de l’opération de création de la ressource 'DatadogMonitorResource'

En-têtes

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

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

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: 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"
  }
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
DatadogMonitorResource	Les types de ressources suivis concrets peuvent être créés en alias ce type à l’aide d’un type de propriété spécifique.
DatadogOrganizationProperties	Spécifiez le nom de l’organisation Datadog. Dans le cas d’une liaison à des organisations existantes, Id, ApiKey et Applicationkey sont également nécessaires.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
IdentityProperties
LiftrResourceCategories
ManagedIdentityTypes	Spécifie le type d’identité du Moniteur Datadog. À ce stade, la seule valeur autorisée est « SystemAssigned ».
MarketplaceSubscriptionStatus	Indicateur spécifiant l’état de l’abonnement à la Place de marché de la ressource. Si le paiement n’est pas effectué à temps, la ressource passe à l’état Suspendu.
MonitoringStatus	Indicateur spécifiant si la surveillance des ressources est activée ou désactivée.
MonitorProperties	Propriétés spécifiques à la ressource de surveillance.
ProvisioningState
ResourceSku
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UserInfo	Inclut le nom, l’e-mail et éventuellement le numéro de téléphone. Les informations utilisateur ne peuvent pas être null.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DatadogMonitorResource

Objet

Les types de ressources suivis concrets peuvent être créés en alias ce type à l’aide d’un type de propriété spécifique.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	IdentityProperties
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties	MonitorProperties	Propriétés spécifiques à la ressource de surveillance.
sku	ResourceSku
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

DatadogOrganizationProperties

Objet

Spécifiez le nom de l’organisation Datadog. Dans le cas d’une liaison à des organisations existantes, Id, ApiKey et Applicationkey sont également nécessaires.

Nom	Type	Description
apiKey	string (password)	Clé API associée à l’organisation Datadog.
applicationKey	string (password)	Clé d’application associée à l’organisation Datadog.
cspm	boolean	Configuration qui décrit l’état de la gestion de la posture de sécurité cloud. Cela collecte des informations de configuration pour toutes les ressources d’un abonnement et effectue le suivi de la conformité aux benchmarks du secteur.
enterpriseAppId	string	ID de l’application Entreprise utilisée pour l’authentification unique.
id	string	ID de l’organisation Datadog.
linkingAuthCode	string (password)	Code d’authentification utilisé pour établir une liaison à une organisation Datadog existante.
linkingClientId	string (password)	Le client_id d’un jeton d’authentification existant en échange d’un jeton d’authentification pour lier l’organisation.
name	string	Nom de l’organisation Datadog.
redirectUri	string	URI de redirection pour la liaison.
resourceCollection	boolean	Configuration qui décrit l’état de la collecte des ressources. Cela collecte les informations de configuration de toutes les ressources d’un abonnement.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	La cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

IdentityProperties

Objet

Nom	Type	Description
principalId	string	L’identifiant d’identité.
tenantId	string	ID de locataire de la ressource.
type	ManagedIdentityTypes	Spécifie le type d’identité du Moniteur Datadog. À ce stade, la seule valeur autorisée est « SystemAssigned ».

LiftrResourceCategories

Énumération

Valeur	Description
Unknown
MonitorLogs

ManagedIdentityTypes

Énumération

Spécifie le type d’identité du Moniteur Datadog. À ce stade, la seule valeur autorisée est « SystemAssigned ».

Valeur	Description
SystemAssigned
UserAssigned

MarketplaceSubscriptionStatus

Énumération

Indicateur spécifiant l’état de l’abonnement à la Place de marché de la ressource. Si le paiement n’est pas effectué à temps, la ressource passe à l’état Suspendu.

Valeur	Description
Provisioning
Active
Suspended
Unsubscribed

MonitoringStatus

Énumération

Indicateur spécifiant si la surveillance des ressources est activée ou désactivée.

Valeur	Description
Enabled
Disabled

MonitorProperties

Objet

Propriétés spécifiques à la ressource de surveillance.

Nom	Type	Valeur par défaut	Description
datadogOrganizationProperties	DatadogOrganizationProperties		Spécifiez le nom de l’organisation Datadog. Dans le cas d’une liaison à des organisations existantes, Id, ApiKey et Applicationkey sont également nécessaires.
liftrResourceCategory	LiftrResourceCategories
liftrResourcePreference	integer (int32)		La priorité de la ressource.
marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus		Indicateur spécifiant l’état de l’abonnement à la Place de marché de la ressource. Si le paiement n’est pas effectué à temps, la ressource passe à l’état Suspendu.
monitoringStatus	MonitoringStatus	Enabled	Indicateur spécifiant si la surveillance des ressources est activée ou désactivée.
provisioningState	ProvisioningState
userInfo	UserInfo		Inclut le nom, l’e-mail et éventuellement le numéro de téléphone. Les informations utilisateur ne peuvent pas être null.

ProvisioningState

Énumération

Valeur	Description
Accepted
Creating
Updating
Deleting
Succeeded
Failed
Canceled
Deleted
NotSpecified

ResourceSku

Objet

Nom	Type	Description
name	string	Nom de la référence SKU au format {PlanId}. Pour Terraform, la seule valeur autorisée est « Lié ».

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

UserInfo

Objet

Inclut le nom, l’e-mail et éventuellement le numéro de téléphone. Les informations utilisateur ne peuvent pas être null.

Nom	Type	Description
emailAddress	string pattern: ^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$	E-mail de l’utilisateur utilisé par Datadog pour les contacter si nécessaire
name	string maxLength: 50	Nom de l’utilisateur
phoneNumber	string maxLength: 40	Numéro de téléphone de l’utilisateur utilisé par Datadog pour les contacter si nécessaire

Partager via

Monitors - Create

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Monitors_Create

Exemple de requête

Exemple de réponse

Définitions

createdByType

DatadogMonitorResource

DatadogOrganizationProperties

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdentityProperties

LiftrResourceCategories

ManagedIdentityTypes

MarketplaceSubscriptionStatus

MonitoringStatus

MonitorProperties

ProvisioningState

ResourceSku

systemData

UserInfo