Monitored Subscriptions - List

Servizio:

Datadog

Versione API:

2025-06-11

Elencare le sottoscrizioni attualmente monitorate dalla risorsa di monitoraggio Datadog.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
monitorName	path	True	string minLength: 2 maxLength: 32 pattern: ^[a-zA-Z0-9_][a-zA-Z0-9_-]+$	Monitorare il nome della risorsa
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	MonitoredSubscriptionPropertiesList	L'operazione di Azure è stata completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Monitors_GetMonitoredSubscriptions

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Datadog/monitors/myMonitor/monitoredSubscriptions?api-version=2025-06-11

dotnet

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.Datadog;

// Generated from example definition: specification/datadog/resource-manager/Microsoft.Datadog/stable/2025-06-11/examples/MonitoredSubscriptions_List.json
// this example is just showing the usage of "MonitoredSubscriptions_List" 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 DatadogMonitorResource created on azure
// for more information of creating DatadogMonitorResource, please refer to the document of DatadogMonitorResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "myResourceGroup";
string monitorName = "myMonitor";
ResourceIdentifier datadogMonitorResourceId = DatadogMonitorResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, monitorName);
DatadogMonitorResource datadogMonitor = client.GetDatadogMonitorResource(datadogMonitorResourceId);

// get the collection of this DatadogMonitoredSubscriptionResource
DatadogMonitoredSubscriptionCollection collection = datadogMonitor.GetDatadogMonitoredSubscriptions();

// invoke the operation and iterate over the result
await foreach (DatadogMonitoredSubscriptionResource item in collection.GetAllAsync())
{
    // the variable item 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
    DatadogMonitoredSubscriptionData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:

200

{
  "value": [
    {
      "name": "default",
      "type": "Microsoft.Datadog/monitors/monitoredSubscriptions",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Datadog/monitors/myMonitor/monitoredSubscriptions/default",
      "properties": {
        "monitoredSubscriptionList": [
          {
            "status": "Active",
            "subscriptionId": "/subscriptions/00000000-0000-0000-0000-000000000000",
            "tagRules": {
              "automuting": true,
              "logRules": {
                "filteringTags": [
                  {
                    "name": "Environment",
                    "action": "Include",
                    "value": "Prod"
                  },
                  {
                    "name": "Environment",
                    "action": "Exclude",
                    "value": "Dev"
                  }
                ],
                "sendAadLogs": false,
                "sendResourceLogs": true,
                "sendSubscriptionLogs": true
              },
              "metricRules": {
                "filteringTags": []
              }
            }
          },
          {
            "status": "Failed",
            "subscriptionId": "/subscriptions/00000000-0000-0000-0000-000000000001",
            "tagRules": {
              "automuting": true,
              "logRules": {
                "filteringTags": [
                  {
                    "name": "Environment",
                    "action": "Include",
                    "value": "Prod"
                  },
                  {
                    "name": "Environment",
                    "action": "Exclude",
                    "value": "Dev"
                  }
                ],
                "sendAadLogs": false,
                "sendResourceLogs": true,
                "sendSubscriptionLogs": true
              },
              "metricRules": {
                "filteringTags": []
              }
            }
          }
        ]
      }
    }
  ]
}

Definizioni

Nome	Descrizione
AgentRules	Set di regole per la gestione degli agenti per la risorsa Monitor.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
FilteringTag	La definizione di un tag di filtraggio. I tag di filtro vengono utilizzati per acquisire le risorse e includerle/escluderle dal monitoraggio.
LogRules	Set di regole per l'invio di log per la risorsa Monitoraggio.
MetricRules	Set di regole per l'invio di metriche per la risorsa Monitoraggio.
MonitoredSubscription	L'elenco delle sottoscrizioni e il relativo stato di monitoraggio da parte del monitor Datadog corrente.
MonitoredSubscriptionProperties	Richiesta di aggiornamento delle sottoscrizioni che devono essere monitorate dalla risorsa di monitoraggio di Datadog.
MonitoredSubscriptionPropertiesList	Insieme di paging di elementi MonitoredSubscriptionProperties
MonitoringTagRulesProperties	Definizione delle proprietà per una risorsa TagRules.
Operation	Operazione per la patch sulla risorsa.
ProvisioningState
Status	Stato del monitoraggio.
SubscriptionList	Richiesta di aggiornamento delle sottoscrizioni che devono essere monitorate dalla risorsa di monitoraggio di Datadog.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TagAction	Azioni valide per un tag di filtro. L'esclusione ha la priorità sull'inclusione.

AgentRules

Oggetto

Set di regole per la gestione degli agenti per la risorsa Monitor.

Nome	Tipo	Descrizione
enableAgentMonitoring	boolean	Flag che specifica se il monitoraggio dell'agente deve essere abilitato per la risorsa Monitor.
filteringTags	FilteringTag[]	Elenco dei tag di filtro da usare per l'acquisizione delle metriche. Se vuoto, verranno acquisite tutte le risorse. Se viene specificata solo l'azione Escludi, le regole verranno applicate all'elenco di tutte le risorse disponibili. Se vengono specificate azioni Di inclusione, le regole includeranno solo le risorse con i tag associati.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

FilteringTag

Oggetto

La definizione di un tag di filtraggio. I tag di filtro vengono utilizzati per acquisire le risorse e includerle/escluderle dal monitoraggio.

Nome	Tipo	Descrizione
action	TagAction	Azioni valide per un tag di filtro. L'esclusione ha la priorità sull'inclusione.
name	string	Nome (noto anche come chiave) del tag.
value	string	Il valore del tag.

LogRules

Oggetto

Set di regole per l'invio di log per la risorsa Monitoraggio.

Nome	Tipo	Descrizione
filteringTags	FilteringTag[]	Elenco dei tag di filtro da usare per l'acquisizione dei log. Questa operazione ha effetto solo se il flag SendResourceLogs è abilitato. Se vuoto, verranno acquisite tutte le risorse. Se viene specificata solo l'azione Escludi, le regole verranno applicate all'elenco di tutte le risorse disponibili. Se vengono specificate azioni Di inclusione, le regole includeranno solo le risorse con i tag associati.
sendAadLogs	boolean	Flag che specifica se i log di AAD devono essere inviati per la risorsa Monitoraggio.
sendResourceLogs	boolean	Flag che specifica se i log delle risorse di Azure devono essere inviati per la risorsa Monitoraggio.
sendSubscriptionLogs	boolean	Flag che specifica se i log delle sottoscrizioni di Azure devono essere inviati per la risorsa Monitoraggio.

MetricRules

Oggetto

Set di regole per l'invio di metriche per la risorsa Monitoraggio.

Nome	Tipo	Descrizione
filteringTags	FilteringTag[]	Elenco dei tag di filtro da usare per l'acquisizione delle metriche. Se vuoto, verranno acquisite tutte le risorse. Se viene specificata solo l'azione Escludi, le regole verranno applicate all'elenco di tutte le risorse disponibili. Se vengono specificate azioni Di inclusione, le regole includeranno solo le risorse con i tag associati.

MonitoredSubscription

Oggetto

L'elenco delle sottoscrizioni e il relativo stato di monitoraggio da parte del monitor Datadog corrente.

Nome	Tipo	Descrizione
error	string	Motivo del mancato monitoraggio della sottoscrizione.
status	Status	Stato del monitoraggio.
subscriptionId	string	SubscriptionId da monitorare.
tagRules	MonitoringTagRulesProperties	Definizione delle proprietà per una risorsa TagRules.

MonitoredSubscriptionProperties

Oggetto

Richiesta di aggiornamento delle sottoscrizioni che devono essere monitorate dalla risorsa di monitoraggio di Datadog.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties	SubscriptionList	Richiesta di aggiornamento delle sottoscrizioni che devono essere monitorate dalla risorsa di monitoraggio di Datadog.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

MonitoredSubscriptionPropertiesList

Oggetto

Insieme di paging di elementi MonitoredSubscriptionProperties

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	MonitoredSubscriptionProperties[]	Gli elementi MonitoredSubscriptionProperties in questa pagina

MonitoringTagRulesProperties

Oggetto

Definizione delle proprietà per una risorsa TagRules.

Nome	Tipo	Descrizione
agentRules	AgentRules	Set di regole per la gestione degli agenti per la risorsa Monitor.
automuting	boolean	Configurazione per abilitare/disabilitare il flag di disattivazione automatica
customMetrics	boolean	Configurazione per abilitare/disabilitare le metriche personalizzate. Se abilitata, le metriche personalizzate delle informazioni dettagliate sulle app verranno inviate.
logRules	LogRules	Set di regole per l'invio di log per la risorsa Monitoraggio.
metricRules	MetricRules	Set di regole per l'invio di metriche per la risorsa Monitoraggio.
provisioningState	ProvisioningState

Operation

Enumerazione

Operazione per la patch sulla risorsa.

Valore	Descrizione
AddBegin
AddComplete
DeleteBegin
DeleteComplete
Active

ProvisioningState

Enumerazione

Valore	Descrizione
Accepted
Creating
Updating
Deleting
Succeeded
Failed
Canceled
Deleted
NotSpecified

Status

Enumerazione

Stato del monitoraggio.

Valore	Descrizione
InProgress
Active
Failed
Deleting

SubscriptionList

Oggetto

Richiesta di aggiornamento delle sottoscrizioni che devono essere monitorate dalla risorsa di monitoraggio di Datadog.

Nome	Tipo	Descrizione
monitoredSubscriptionList	MonitoredSubscription[]	Elenco di sottoscrizioni e stato del monitoraggio.
operation	Operation	Operazione per la patch sulla risorsa.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TagAction

Enumerazione

Azioni valide per un tag di filtro. L'esclusione ha la priorità sull'inclusione.

Valore	Descrizione
Include
Exclude