Monitors - Create

Tjänst:: Datadog

API-version:: 2025-06-11

Skapa en övervakningsresurs.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
monitorName	path	True	string minLength: 2 maxLength: 32 pattern: ^[a-zA-Z0-9_][a-zA-Z0-9_-]+$	Övervaka resursnamn
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Den geo-plats där resursen finns
identity		IdentityProperties
properties		MonitorProperties	Egenskaper som är specifika för övervakningsresursen.
sku		ResourceSku
tags		object	Resursetiketter.

Svar

Name	Typ	Description
200 OK	DatadogMonitorResource	Uppdateringsåtgärden för resursen "DatadogMonitorResource" lyckades
201 Created	DatadogMonitorResource	Resursen "DatadogMonitorResource" för att skapa åtgärden lyckades Sidhuvuden Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

DatadogMonitorResource

Uppdateringsåtgärden för resursen "DatadogMonitorResource" lyckades

201 Created

DatadogMonitorResource

Resursen "DatadogMonitorResource" för att skapa åtgärden lyckades

Sidhuvuden

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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

Exempelsvar

Statuskod:: 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"
  }
}

Statuskod:: 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"
  }
}

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
DatadogMonitorResource	Konkreta spårade resurstyper kan skapas genom att aliasisera den här typen med hjälp av en specifik egenskapstyp.
DatadogOrganizationProperties	Ange namnet på Datadog-organisationen. När det gäller länkning till befintliga organisationer krävs även ID, ApiKey och Applicationkey.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
IdentityProperties
LiftrResourceCategories
ManagedIdentityTypes	Anger identitetstypen för Datadog Monitor. För närvarande är det enda tillåtna värdet "SystemAssigned".
MarketplaceSubscriptionStatus	Flagga som anger Marketplace-prenumerationsstatus för resursen. Om betalningen inte görs i tid kommer resursen att försättas i pausat tillstånd.
MonitoringStatus	Flagga som anger om resursövervakningen är aktiverad eller inaktiverad.
MonitorProperties	Egenskaper som är specifika för övervakningsresursen.
ProvisioningState
ResourceSku
systemData	Metadata som rör skapande och senaste ändring av resursen.
UserInfo	Innehåller namn, e-post och valfritt telefonnummer. Användarinformation får inte vara null.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DatadogMonitorResource

Objekt

Konkreta spårade resurstyper kan skapas genom att aliasisera den här typen med hjälp av en specifik egenskapstyp.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	IdentityProperties
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties	MonitorProperties	Egenskaper som är specifika för övervakningsresursen.
sku	ResourceSku
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. T.ex. "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

DatadogOrganizationProperties

Objekt

Ange namnet på Datadog-organisationen. När det gäller länkning till befintliga organisationer krävs även ID, ApiKey och Applicationkey.

Name	Typ	Description
apiKey	string (password)	API-nyckel som är associerad med Datadog-organisationen.
applicationKey	string (password)	Programnyckel som är associerad med Datadog-organisationen.
cspm	boolean	Konfigurationen som beskriver tillståndet för hantering av molnsäkerhetsstatus. Detta samlar in konfigurationsinformation för alla resurser i en prenumeration och spårar efterlevnaden av branschriktmärken.
enterpriseAppId	string	ID:t för den Enterprise-app som används för enkel inloggning.
id	string	ID för Datadog-organisationen.
linkingAuthCode	string (password)	Den autentiseringskod som används för att länka till en befintlig Datadog-organisation.
linkingClientId	string (password)	Client_id från en befintlig i utbyte mot en autentiseringstoken för att länka organisationen.
name	string	Namnet på Datadog-organisationen.
redirectUri	string	Omdirigerings-URI:n för länkning.
resourceCollection	boolean	Konfigurationen som beskriver tillståndet för resursinsamlingen. Detta samlar in konfigurationsinformation för alla resurser i en prenumeration.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

IdentityProperties

Objekt

Name	Typ	Description
principalId	string	Identitets-ID.
tenantId	string	Resursens klientorganisations-ID.
type	ManagedIdentityTypes	Anger identitetstypen för Datadog Monitor. För närvarande är det enda tillåtna värdet "SystemAssigned".

LiftrResourceCategories

Uppräkning

Värde	Description
Unknown
MonitorLogs

ManagedIdentityTypes

Uppräkning

Anger identitetstypen för Datadog Monitor. För närvarande är det enda tillåtna värdet "SystemAssigned".

Värde	Description
SystemAssigned
UserAssigned

MarketplaceSubscriptionStatus

Uppräkning

Flagga som anger Marketplace-prenumerationsstatus för resursen. Om betalningen inte görs i tid kommer resursen att försättas i pausat tillstånd.

Värde	Description
Provisioning
Active
Suspended
Unsubscribed

MonitoringStatus

Uppräkning

Flagga som anger om resursövervakningen är aktiverad eller inaktiverad.

Värde	Description
Enabled
Disabled

MonitorProperties

Objekt

Egenskaper som är specifika för övervakningsresursen.

Name	Typ	Standardvärde	Description
datadogOrganizationProperties	DatadogOrganizationProperties		Ange namnet på Datadog-organisationen. När det gäller länkning till befintliga organisationer krävs även ID, ApiKey och Applicationkey.
liftrResourceCategory	LiftrResourceCategories
liftrResourcePreference	integer (int32)		Resursens prioritet.
marketplaceSubscriptionStatus	MarketplaceSubscriptionStatus		Flagga som anger Marketplace-prenumerationsstatus för resursen. Om betalningen inte görs i tid kommer resursen att försättas i pausat tillstånd.
monitoringStatus	MonitoringStatus	Enabled	Flagga som anger om resursövervakningen är aktiverad eller inaktiverad.
provisioningState	ProvisioningState
userInfo	UserInfo		Innehåller namn, e-post och valfritt telefonnummer. Användarinformation får inte vara null.

ProvisioningState

Uppräkning

Värde	Description
Accepted
Creating
Updating
Deleting
Succeeded
Failed
Canceled
Deleted
NotSpecified

ResourceSku

Objekt

Name	Typ	Description
name	string	Namnet på SKU:n i {PlanId}-format. För Terraform är det enda tillåtna värdet Länkat.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

UserInfo

Objekt

Innehåller namn, e-post och valfritt telefonnummer. Användarinformation får inte vara null.

Name	Typ	Description
emailAddress	string pattern: ^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$	E-post för den användare som används av Datadog för att kontakta dem om det behövs
name	string maxLength: 50	Användarens namn
phoneNumber	string maxLength: 40	Telefonnummer för den användare som används av Datadog för att kontakta dem om det behövs

Dela via

Monitors - Create

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Monitors_Create

Exempelbegäran

Exempelsvar

Definitioner

createdByType

DatadogMonitorResource

DatadogOrganizationProperties

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdentityProperties

LiftrResourceCategories

ManagedIdentityTypes

MarketplaceSubscriptionStatus

MonitoringStatus

MonitorProperties

ProvisioningState

ResourceSku

systemData

UserInfo