Monitors - Create

Служба:: Datadog

Версия API:: 2025-06-11

Создание ресурса монитора.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
monitorName	path	True	string minLength: 2 maxLength: 32 pattern: ^[a-zA-Z0-9_][a-zA-Z0-9_-]+$	Мониторинг имени ресурса
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId	path	True	string minLength: 1	Идентификатор целевой подписки.
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
identity		IdentityProperties
properties		MonitorProperties	Свойства, относящиеся к ресурсу монитора.
sku		ResourceSku
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	DatadogMonitorResource	Операция обновления ресурса 'DatadogMonitorResource' выполнена успешно
201 Created	DatadogMonitorResource	Операция по созданию ресурса 'DatadogMonitorResource' выполнена успешно Заголовки Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

DatadogMonitorResource

Операция обновления ресурса 'DatadogMonitorResource' выполнена успешно

201 Created

DatadogMonitorResource

Операция по созданию ресурса 'DatadogMonitorResource' выполнена успешно

Заголовки

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

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

Пример ответа

Код состояния:: 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"
  }
}

Код состояния:: 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"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
DatadogMonitorResource	Конкретные отслеживаемые типы ресурсов можно создать путем псевдонима этого типа с помощью определенного типа свойства.
DatadogOrganizationProperties	Укажите имя организации Datadog. В случае связывания с существующими организациями, id, ApiKey и Applicationkey также требуется.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Детали ошибки.
ErrorResponse	Ответ на ошибку
IdentityProperties
LiftrResourceCategories
ManagedIdentityTypes	Указывает тип удостоверения монитора Datadog. В настоящее время единственным допустимым значением является SystemAssigned.
MarketplaceSubscriptionStatus	Флаг, указывающий статус подписки на Marketplace ресурса. Если оплата не будет произведена вовремя, ресурс перейдет в состояние Suspended.
MonitoringStatus	Пометка, указывающая, включена ли мониторинг ресурсов или отключена.
MonitorProperties	Свойства, относящиеся к ресурсу монитора.
ProvisioningState
ResourceSku
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
UserInfo	Включает имя, электронную почту и при необходимости номер телефона. Сведения о пользователе не могут иметь значение NULL.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

DatadogMonitorResource

Объект

Конкретные отслеживаемые типы ресурсов можно создать путем псевдонима этого типа с помощью определенного типа свойства.

Имя	Тип	Описание
id	string	Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	IdentityProperties
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties	MonitorProperties	Свойства, относящиеся к ресурсу монитора.
sku	ResourceSku
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

DatadogOrganizationProperties

Объект

Укажите имя организации Datadog. В случае связывания с существующими организациями, id, ApiKey и Applicationkey также требуется.

Имя	Тип	Описание
apiKey	string (password)	Ключ API, связанный с организацией Datadog.
applicationKey	string (password)	Ключ приложения, связанный с организацией Datadog.
cspm	boolean	Конфигурация, описывающая состояние управления безопасностью облака. Это собирает сведения о конфигурации для всех ресурсов в подписке и отслеживает соответствие отраслевым тестам.
enterpriseAppId	string	Идентификатор корпоративного приложения, используемого для единого входа.
id	string	Идентификатор организации Datadog.
linkingAuthCode	string (password)	Код проверки подлинности, используемый для связывания с существующей организацией Datadog.
linkingClientId	string (password)	Client_id из существующего маркера проверки подлинности, чтобы связать организацию.
name	string	Имя организации Datadog.
redirectUri	string	URI перенаправления для связывания.
resourceCollection	boolean	Конфигурация, описывающая состояние сбора ресурсов. При этом собираются сведения о конфигурации для всех ресурсов в подписке.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительная информация.
type	string	Тип дополнительной информации.

ErrorDetail

Объект

Детали ошибки.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Ошибка дополнительная информация.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Цель ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

IdentityProperties

Объект

Имя	Тип	Описание
principalId	string	Идентификатор личности.
tenantId	string	Идентификатор клиента ресурса.
type	ManagedIdentityTypes	Указывает тип удостоверения монитора Datadog. В настоящее время единственным допустимым значением является SystemAssigned.

LiftrResourceCategories

Перечисление

Значение	Описание
Unknown
MonitorLogs

ManagedIdentityTypes

Перечисление

Указывает тип удостоверения монитора Datadog. В настоящее время единственным допустимым значением является SystemAssigned.

Значение	Описание
SystemAssigned
UserAssigned

MarketplaceSubscriptionStatus

Перечисление

Флаг, указывающий статус подписки на Marketplace ресурса. Если оплата не будет произведена вовремя, ресурс перейдет в состояние Suspended.

Значение	Описание
Provisioning
Active
Suspended
Unsubscribed

MonitoringStatus

Перечисление

Пометка, указывающая, включена ли мониторинг ресурсов или отключена.

Значение	Описание
Enabled
Disabled

MonitorProperties

Объект

Свойства, относящиеся к ресурсу монитора.

Имя	Тип	Default value	Описание
datadogOrganizationProperties	DatadogOrganizationProperties		Укажите имя организации Datadog. В случае связывания с существующими организациями, id, ApiKey и Applicationkey также требуется.
liftrResourceCategory	LiftrResourceCategories
liftrResourcePreference	integer (int32)		Приоритет ресурса.
marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus		Флаг, указывающий статус подписки на Marketplace ресурса. Если оплата не будет произведена вовремя, ресурс перейдет в состояние Suspended.
monitoringStatus	MonitoringStatus	Enabled	Пометка, указывающая, включена ли мониторинг ресурсов или отключена.
provisioningState	ProvisioningState
userInfo	UserInfo		Включает имя, электронную почту и при необходимости номер телефона. Сведения о пользователе не могут иметь значение NULL.

ProvisioningState

Перечисление

Значение	Описание
Accepted
Creating
Updating
Deleting
Succeeded
Failed
Canceled
Deleted
NotSpecified

ResourceSku

Объект

Имя	Тип	Описание
name	string	Имя номера SKU в формате {PlanId}. Для Terraform единственным допустимым значением является "Linked".

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

UserInfo

Объект

Включает имя, электронную почту и при необходимости номер телефона. Сведения о пользователе не могут иметь значение NULL.

Имя	Тип	Описание
emailAddress	string pattern: ^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$	Электронная почта пользователя, используемого Datadog для связи с ними при необходимости
name	string maxLength: 50	Имя пользователя
phoneNumber	string maxLength: 40	Номер телефона пользователя, используемого Datadog для связи с ними при необходимости

Поделиться через

Monitors - Create

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Monitors_Create

Образец запроса

Пример ответа

Определения

createdByType

DatadogMonitorResource

DatadogOrganizationProperties

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdentityProperties

LiftrResourceCategories

ManagedIdentityTypes

MarketplaceSubscriptionStatus

MonitoringStatus

MonitorProperties

ProvisioningState

ResourceSku

systemData

UserInfo