Monitors - Create

Référence

Service:: Datadog

Version d'API:: 2023-10-20

Créez une ressource de surveillance.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
monitorName	path	True	string	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
identity		IdentityProperties
properties		MonitorProperties	Propriétés spécifiques à la ressource de surveillance.
sku		ResourceSku
tags		object

Réponses

Nom	Type	Description
200 OK	DatadogMonitorResource	Succès
201 Created	DatadogMonitorResource	Succès
Other Status Codes	ErrorResponse	Réponse d’erreur par défaut.

Exemples

Monitors_Create

Exemple de requête

HTTP

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

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

Exemple de réponse

Code d’état:: 200

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

Code d’état:: 201

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

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
DatadogMonitorResource
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 de la Place de marché de la ressource. Si le paiement n’est pas effectué dans le temps, la ressource est en é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
Application
Key
ManagedIdentity
User

DatadogMonitorResource

Object

Nom	Type	Description
id	string	ID ARM de la ressource du moniteur.
identity	IdentityProperties
location	string
name	string	Nom de la ressource de surveillance.
properties	MonitorProperties	Propriétés spécifiques à la ressource de surveillance.
sku	ResourceSku
systemData	systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
tags	object
type	string	Type de la ressource de surveillance.

DatadogOrganizationProperties

Object

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	Clé API associée à l’organisation Datadog.
applicationKey	string	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	Code d’authentification utilisé pour établir une liaison à une organisation Datadog existante.
linkingClientId	string	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.

ErrorAdditionalInfo

Object

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

Object

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	Cible d’erreur.

ErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

IdentityProperties

Object

Nom	Type	Description
principalId	string	ID 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
MonitorLogs
Unknown

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 de la Place de marché de la ressource. Si le paiement n’est pas effectué dans le temps, la ressource est en état suspendu.

Valeur	Description
Active
Provisioning
Suspended
Unsubscribed

MonitoringStatus

Énumération

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

Valeur	Description
Disabled
Enabled

MonitorProperties

Object

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)		Priorité de la ressource.
marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus		Indicateur spécifiant l’état de l’abonnement de la Place de marché de la ressource. Si le paiement n’est pas effectué dans le temps, la ressource est en é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
Canceled
Creating
Deleted
Deleting
Failed
NotSpecified
Succeeded
Updating

ResourceSku

Object

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

Object

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

Object

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

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