Monitors - Create

Servicio:: Datadog

Versión de la API:: 2025-06-11

Cree un recurso de monitor.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
monitorName	path	True	string minLength: 2 maxLength: 32 pattern: ^[a-zA-Z0-9_][a-zA-Z0-9_-]+$	Supervisión del nombre del recurso
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación geográfica donde reside el recurso
identity		IdentityProperties
properties		MonitorProperties	Propiedades específicas del recurso de supervisión.
sku		ResourceSku
tags		object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	DatadogMonitorResource	La operación de actualización del recurso "DatadogMonitorResource" se realizó correctamente
201 Created	DatadogMonitorResource	Operación de creación del recurso 'DatadogMonitorResource' realizada correctamente Encabezados Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

DatadogMonitorResource

La operación de actualización del recurso "DatadogMonitorResource" se realizó correctamente

201 Created

DatadogMonitorResource

Operación de creación del recurso 'DatadogMonitorResource' realizada correctamente

Encabezados

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

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

Respuesta de muestra

status code:: 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"
  }
}

status code:: 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"
  }
}

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
DatadogMonitorResource	Los tipos de recursos de seguimiento concreto se pueden crear mediante el alias de este tipo mediante un tipo de propiedad específico.
DatadogOrganizationProperties	Especifique el nombre de la organización de Datadog. En el caso de vincular a organizaciones existentes, también se requiere Id., ApiKey y Applicationkey.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
IdentityProperties
LiftrResourceCategories
ManagedIdentityTypes	Especifica el tipo de identidad del Monitor de Datadog. En este momento, el único valor permitido es "SystemAssigned".
MarketplaceSubscriptionStatus	Marca que especifica el estado de suscripción de Marketplace del recurso. Si el pago no se realiza a tiempo, el recurso pasará al estado Suspendido.
MonitoringStatus	Marca que especifica si la supervisión de recursos está habilitada o deshabilitada.
MonitorProperties	Propiedades específicas del recurso de supervisión.
ProvisioningState
ResourceSku
systemData	Metadatos relativos a la creación y última modificación del recurso.
UserInfo	Incluye el nombre, el correo electrónico y, opcionalmente, el número de teléfono. La información del usuario no puede ser nula.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DatadogMonitorResource

Objeto

Los tipos de recursos de seguimiento concreto se pueden crear mediante el alias de este tipo mediante un tipo de propiedad específico.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	IdentityProperties
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties	MonitorProperties	Propiedades específicas del recurso de supervisión.
sku	ResourceSku
systemData	systemData	Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DatadogOrganizationProperties

Objeto

Especifique el nombre de la organización de Datadog. En el caso de vincular a organizaciones existentes, también se requiere Id., ApiKey y Applicationkey.

Nombre	Tipo	Description
apiKey	string (password)	Clave de API asociada a la organización de Datadog.
applicationKey	string (password)	Clave de aplicación asociada a la organización de Datadog.
cspm	boolean	Configuración que describe el estado de administración de la posición de seguridad en la nube. Esto recopila información de configuración de todos los recursos de una suscripción y realiza un seguimiento de la conformidad con las pruebas comparativas del sector.
enterpriseAppId	string	El identificador de la aplicación empresarial que se usa para el inicio de sesión único.
id	string	Identificador de la organización de Datadog.
linkingAuthCode	string (password)	Código de autenticación usado para vincular a una organización de Datadog existente.
linkingClientId	string (password)	El client_id de un existente a cambio de un token de autenticación para vincular la organización.
name	string	Nombre de la organización de Datadog.
redirectUri	string	URI de redirección para vincular.
resourceCollection	boolean	Configuración que describe el estado de la recopilación de recursos. Esto recopila información de configuración para todos los recursos de una suscripción.

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

IdentityProperties

Objeto

Nombre	Tipo	Description
principalId	string	El ID de identidad.
tenantId	string	Identificador de inquilino del recurso.
type	ManagedIdentityTypes	Especifica el tipo de identidad del Monitor de Datadog. En este momento, el único valor permitido es "SystemAssigned".

LiftrResourceCategories

Enumeración

Valor	Description
Unknown
MonitorLogs

ManagedIdentityTypes

Enumeración

Especifica el tipo de identidad del Monitor de Datadog. En este momento, el único valor permitido es "SystemAssigned".

Valor	Description
SystemAssigned
UserAssigned

MarketplaceSubscriptionStatus

Enumeración

Marca que especifica el estado de suscripción de Marketplace del recurso. Si el pago no se realiza a tiempo, el recurso pasará al estado Suspendido.

Valor	Description
Provisioning
Active
Suspended
Unsubscribed

MonitoringStatus

Enumeración

Marca que especifica si la supervisión de recursos está habilitada o deshabilitada.

Valor	Description
Enabled
Disabled

MonitorProperties

Objeto

Propiedades específicas del recurso de supervisión.

Nombre	Tipo	Valor predeterminado	Description
datadogOrganizationProperties	DatadogOrganizationProperties		Especifique el nombre de la organización de Datadog. En el caso de vincular a organizaciones existentes, también se requiere Id., ApiKey y Applicationkey.
liftrResourceCategory	LiftrResourceCategories
liftrResourcePreference	integer (int32)		La prioridad del recurso.
marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus		Marca que especifica el estado de suscripción de Marketplace del recurso. Si el pago no se realiza a tiempo, el recurso pasará al estado Suspendido.
monitoringStatus	MonitoringStatus	Enabled	Marca que especifica si la supervisión de recursos está habilitada o deshabilitada.
provisioningState	ProvisioningState
userInfo	UserInfo		Incluye el nombre, el correo electrónico y, opcionalmente, el número de teléfono. La información del usuario no puede ser nula.

ProvisioningState

Enumeración

Valor	Description
Accepted
Creating
Updating
Deleting
Succeeded
Failed
Canceled
Deleted
NotSpecified

ResourceSku

Objeto

Nombre	Tipo	Description
name	string	Nombre de la SKU en formato {PlanId}. Para Terraform, el único valor permitido es "Vinculado".

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

UserInfo

Objeto

Incluye el nombre, el correo electrónico y, opcionalmente, el número de teléfono. La información del usuario no puede ser nula.

Nombre	Tipo	Description
emailAddress	string pattern: ^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$	Correo electrónico del usuario usado por Datadog para ponerse en contacto con ellos si es necesario
name	string maxLength: 50	Nombre del usuario
phoneNumber	string maxLength: 40	Número de teléfono del usuario usado por Datadog para ponerse en contacto con ellos si es necesario

Compartir a través de

Monitors - Create

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Monitors_Create

Solicitud de ejemplo

Respuesta de muestra

Definiciones

createdByType

DatadogMonitorResource

DatadogOrganizationProperties

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdentityProperties

LiftrResourceCategories

ManagedIdentityTypes

MarketplaceSubscriptionStatus

MonitoringStatus

MonitorProperties

ProvisioningState

ResourceSku

systemData

UserInfo