Grafana - Update

Szolgáltatás:

Managed Grafana

API-verzió:

2025-08-01

Grafana-erőforrás munkaterületének frissítése.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Dashboard/grafana/{workspaceName}?api-version=2025-08-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
workspaceName	path	True	string pattern: ^[a-zA-Z][a-z0-9A-Z-]{0,28}[a-z0-9A-Z]$	Az Azure Managed Grafana munkaterületneve.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Típus	Description
identity	ManagedServiceIdentity	A grafana erőforrás felügyelt identitása.
properties	ManagedGrafanaPropertiesUpdateParameters	A felügyelt grafana-erőforrásra jellemző tulajdonságok.
sku	ResourceSku	Egy erőforrás termékváltozatát jelöli.
tags	object	A grafana erőforrás új címkéi.

Válaszok

Name	Típus	Description
200 OK	ManagedGrafana	Az Azure-művelet sikeresen befejeződött.
202 Accepted	ManagedGrafana	A kérelem feldolgozásra lett elfogadva, de a feldolgozás még nem fejeződött be. Fejlécek Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Grafana_Update

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Dashboard/grafana/myWorkspace?api-version=2025-08-01

{
  "properties": {
    "apiKey": "Enabled",
    "deterministicOutboundIP": "Enabled",
    "enterpriseConfigurations": {
      "marketplaceAutoRenew": "Enabled",
      "marketplacePlanId": "myPlanId"
    },
    "grafanaConfigurations": {
      "security": {
        "csrfAlwaysCheck": false
      },
      "smtp": {
        "enabled": true,
        "fromAddress": "test@sendemail.com",
        "fromName": "emailsender",
        "host": "smtp.sendemail.com:587",
        "password": "<password>",
        "skipVerify": true,
        "startTLSPolicy": "OpportunisticStartTLS",
        "user": "username"
      },
      "snapshots": {
        "externalEnabled": true
      },
      "unifiedAlertingScreenshots": {
        "captureEnabled": false
      },
      "users": {
        "editorsCanAdmin": true,
        "viewersCanEdit": true
      }
    },
    "grafanaIntegrations": {
      "azureMonitorWorkspaceIntegrations": [
        {
          "azureMonitorWorkspaceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"
        }
      ]
    },
    "grafanaMajorVersion": "9",
    "grafanaPlugins": {
      "sample-plugin-id": {}
    }
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "Environment": "Dev 2"
  }
}

Java

import com.azure.resourcemanager.dashboard.models.ApiKey;
import com.azure.resourcemanager.dashboard.models.AzureMonitorWorkspaceIntegration;
import com.azure.resourcemanager.dashboard.models.DeterministicOutboundIp;
import com.azure.resourcemanager.dashboard.models.EnterpriseConfigurations;
import com.azure.resourcemanager.dashboard.models.GrafanaConfigurations;
import com.azure.resourcemanager.dashboard.models.GrafanaIntegrations;
import com.azure.resourcemanager.dashboard.models.GrafanaPlugin;
import com.azure.resourcemanager.dashboard.models.ManagedGrafana;
import com.azure.resourcemanager.dashboard.models.ManagedGrafanaPropertiesUpdateParameters;
import com.azure.resourcemanager.dashboard.models.MarketplaceAutoRenew;
import com.azure.resourcemanager.dashboard.models.ResourceSku;
import com.azure.resourcemanager.dashboard.models.Security;
import com.azure.resourcemanager.dashboard.models.Smtp;
import com.azure.resourcemanager.dashboard.models.Snapshots;
import com.azure.resourcemanager.dashboard.models.StartTlsPolicy;
import com.azure.resourcemanager.dashboard.models.UnifiedAlertingScreenshots;
import com.azure.resourcemanager.dashboard.models.Users;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Grafana Update.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-08-01/Grafana_Update.json
     */
    /**
     * Sample code: Grafana_Update.
     * 
     * @param manager Entry point to DashboardManager.
     */
    public static void grafanaUpdate(com.azure.resourcemanager.dashboard.DashboardManager manager) {
        ManagedGrafana resource = manager.grafanas()
            .getByResourceGroupWithResponse("myResourceGroup", "myWorkspace", com.azure.core.util.Context.NONE)
            .getValue();
        resource.update().withTags(mapOf("Environment", "Dev 2")).withSku(new ResourceSku().withName("Standard"))
            .withProperties(new ManagedGrafanaPropertiesUpdateParameters().withApiKey(ApiKey.ENABLED)
                .withDeterministicOutboundIp(DeterministicOutboundIp.ENABLED)
                .withGrafanaIntegrations(new GrafanaIntegrations().withAzureMonitorWorkspaceIntegrations(
                    Arrays.asList(new AzureMonitorWorkspaceIntegration().withAzureMonitorWorkspaceResourceId(
                        "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"))))
                .withEnterpriseConfigurations(new EnterpriseConfigurations().withMarketplacePlanId("myPlanId")
                    .withMarketplaceAutoRenew(MarketplaceAutoRenew.ENABLED))
                .withGrafanaConfigurations(new GrafanaConfigurations()
                    .withSmtp(new Smtp().withEnabled(true).withHost("smtp.sendemail.com:587").withUser("username")
                        .withPassword("fakeTokenPlaceholder").withFromAddress("test@sendemail.com")
                        .withFromName("emailsender").withStartTlsPolicy(StartTlsPolicy.OPPORTUNISTIC_START_TLS)
                        .withSkipVerify(true))
                    .withSnapshots(new Snapshots().withExternalEnabled(true))
                    .withUsers(new Users().withViewersCanEdit(true).withEditorsCanAdmin(true))
                    .withSecurity(new Security().withCsrfAlwaysCheck(false))
                    .withUnifiedAlertingScreenshots(new UnifiedAlertingScreenshots().withCaptureEnabled(false)))
                .withGrafanaPlugins(mapOf("sample-plugin-id", new GrafanaPlugin())).withGrafanaMajorVersion("9"))
            .apply();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.dashboard import DashboardManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-dashboard
# USAGE
    python grafana_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DashboardManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.grafana.begin_update(
        resource_group_name="myResourceGroup",
        workspace_name="myWorkspace",
        request_body_parameters={
            "properties": {
                "apiKey": "Enabled",
                "deterministicOutboundIP": "Enabled",
                "enterpriseConfigurations": {"marketplaceAutoRenew": "Enabled", "marketplacePlanId": "myPlanId"},
                "grafanaConfigurations": {
                    "security": {"csrfAlwaysCheck": False},
                    "smtp": {
                        "enabled": True,
                        "fromAddress": "test@sendemail.com",
                        "fromName": "emailsender",
                        "host": "smtp.sendemail.com:587",
                        "password": "<password>",
                        "skipVerify": True,
                        "startTLSPolicy": "OpportunisticStartTLS",
                        "user": "username",
                    },
                    "snapshots": {"externalEnabled": True},
                    "unifiedAlertingScreenshots": {"captureEnabled": False},
                    "users": {"editorsCanAdmin": True, "viewersCanEdit": True},
                },
                "grafanaIntegrations": {
                    "azureMonitorWorkspaceIntegrations": [
                        {
                            "azureMonitorWorkspaceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"
                        }
                    ]
                },
                "grafanaMajorVersion": "9",
                "grafanaPlugins": {"sample-plugin-id": {}},
            },
            "sku": {"name": "Standard"},
            "tags": {"Environment": "Dev 2"},
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-08-01/Grafana_Update.json
if __name__ == "__main__":
    main()

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

Go

package armdashboard_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dashboard/armdashboard/v2"
)

// Generated from example definition: 2025-08-01/Grafana_Update.json
func ExampleGrafanaClient_BeginUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armdashboard.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewGrafanaClient().BeginUpdate(ctx, "myResourceGroup", "myWorkspace", armdashboard.ManagedGrafanaUpdateParameters{
		Properties: &armdashboard.ManagedGrafanaPropertiesUpdateParameters{
			APIKey:                  to.Ptr(armdashboard.APIKeyEnabled),
			DeterministicOutboundIP: to.Ptr(armdashboard.DeterministicOutboundIPEnabled),
			EnterpriseConfigurations: &armdashboard.EnterpriseConfigurations{
				MarketplaceAutoRenew: to.Ptr(armdashboard.MarketplaceAutoRenewEnabled),
				MarketplacePlanID:    to.Ptr("myPlanId"),
			},
			GrafanaConfigurations: &armdashboard.GrafanaConfigurations{
				Security: &armdashboard.Security{
					CsrfAlwaysCheck: to.Ptr(false),
				},
				SMTP: &armdashboard.SMTP{
					Enabled:        to.Ptr(true),
					FromAddress:    to.Ptr("test@sendemail.com"),
					FromName:       to.Ptr("emailsender"),
					Host:           to.Ptr("smtp.sendemail.com:587"),
					Password:       to.Ptr("<password>"),
					SkipVerify:     to.Ptr(true),
					StartTLSPolicy: to.Ptr(armdashboard.StartTLSPolicyOpportunisticStartTLS),
					User:           to.Ptr("username"),
				},
				Snapshots: &armdashboard.Snapshots{
					ExternalEnabled: to.Ptr(true),
				},
				UnifiedAlertingScreenshots: &armdashboard.UnifiedAlertingScreenshots{
					CaptureEnabled: to.Ptr(false),
				},
				Users: &armdashboard.Users{
					EditorsCanAdmin: to.Ptr(true),
					ViewersCanEdit:  to.Ptr(true),
				},
			},
			GrafanaIntegrations: &armdashboard.GrafanaIntegrations{
				AzureMonitorWorkspaceIntegrations: []*armdashboard.AzureMonitorWorkspaceIntegration{
					{
						AzureMonitorWorkspaceResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"),
					},
				},
			},
			GrafanaMajorVersion: to.Ptr("9"),
			GrafanaPlugins: map[string]*armdashboard.GrafanaPlugin{
				"sample-plugin-id": {},
			},
		},
		SKU: &armdashboard.ResourceSKU{
			Name: to.Ptr("Standard"),
		},
		Tags: map[string]*string{
			"Environment": to.Ptr("Dev 2"),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armdashboard.GrafanaClientUpdateResponse{
	// 	ManagedGrafana: &armdashboard.ManagedGrafana{
	// 		Name: to.Ptr("myWorkspace"),
	// 		Type: to.Ptr("Microsoft.Dashboard/grafana"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/grafana/myWorkspace"),
	// 		Location: to.Ptr("West US"),
	// 		Properties: &armdashboard.ManagedGrafanaProperties{
	// 			APIKey: to.Ptr(armdashboard.APIKeyEnabled),
	// 			AutoGeneratedDomainNameLabelScope: to.Ptr(armdashboard.AutoGeneratedDomainNameLabelScopeTenantReuse),
	// 			DeterministicOutboundIP: to.Ptr(armdashboard.DeterministicOutboundIPEnabled),
	// 			Endpoint: to.Ptr("https://myworkspace-abcdefghijklmnop.wus.grafana.azure.com"),
	// 			EnterpriseConfigurations: &armdashboard.EnterpriseConfigurations{
	// 				MarketplaceAutoRenew: to.Ptr(armdashboard.MarketplaceAutoRenewEnabled),
	// 				MarketplacePlanID: to.Ptr("myPlanId"),
	// 			},
	// 			GrafanaConfigurations: &armdashboard.GrafanaConfigurations{
	// 				Security: &armdashboard.Security{
	// 					CsrfAlwaysCheck: to.Ptr(false),
	// 				},
	// 				SMTP: &armdashboard.SMTP{
	// 					Enabled: to.Ptr(true),
	// 					FromAddress: to.Ptr("test@sendemail.com"),
	// 					FromName: to.Ptr("emailsender"),
	// 					Host: to.Ptr("smtp.sendemail.com:587"),
	// 					SkipVerify: to.Ptr(true),
	// 					StartTLSPolicy: to.Ptr(armdashboard.StartTLSPolicyOpportunisticStartTLS),
	// 					User: to.Ptr("username"),
	// 				},
	// 				Snapshots: &armdashboard.Snapshots{
	// 					ExternalEnabled: to.Ptr(true),
	// 				},
	// 				Users: &armdashboard.Users{
	// 					EditorsCanAdmin: to.Ptr(true),
	// 					ViewersCanEdit: to.Ptr(true),
	// 				},
	// 			},
	// 			GrafanaIntegrations: &armdashboard.GrafanaIntegrations{
	// 				AzureMonitorWorkspaceIntegrations: []*armdashboard.AzureMonitorWorkspaceIntegration{
	// 					{
	// 						AzureMonitorWorkspaceResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"),
	// 					},
	// 				},
	// 			},
	// 			GrafanaMajorVersion: to.Ptr("9"),
	// 			GrafanaPlugins: map[string]*armdashboard.GrafanaPlugin{
	// 				"sample-plugin-id": &armdashboard.GrafanaPlugin{
	// 					PluginID: to.Ptr("sample-plugin-id"),
	// 				},
	// 			},
	// 			GrafanaVersion: to.Ptr("9.4.5"),
	// 			OutboundIPs: []*string{
	// 				to.Ptr("192.168.0.1"),
	// 				to.Ptr("192.168.0.2"),
	// 			},
	// 			ProvisioningState: to.Ptr(armdashboard.ProvisioningStateSucceeded),
	// 			PublicNetworkAccess: to.Ptr(armdashboard.PublicNetworkAccessEnabled),
	// 			ZoneRedundancy: to.Ptr(armdashboard.ZoneRedundancyEnabled),
	// 		},
	// 		SKU: &armdashboard.ResourceSKU{
	// 			Name: to.Ptr("Standard"),
	// 		},
	// 		Tags: map[string]*string{
	// 			"Environment": to.Ptr("Dev 2"),
	// 		},
	// 	},
	// }
}

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

JavaScript

const { DashboardManagementClient } = require("@azure/arm-dashboard");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to update a workspace for Grafana resource.
 *
 * @summary update a workspace for Grafana resource.
 * x-ms-original-file: 2025-08-01/Grafana_Update.json
 */
async function grafanaUpdate() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new DashboardManagementClient(credential, subscriptionId);
  const result = await client.grafana.update("myResourceGroup", "myWorkspace", {
    properties: {
      apiKey: "Enabled",
      deterministicOutboundIP: "Enabled",
      enterpriseConfigurations: {
        marketplaceAutoRenew: "Enabled",
        marketplacePlanId: "myPlanId",
      },
      grafanaConfigurations: {
        security: { csrfAlwaysCheck: false },
        smtp: {
          enabled: true,
          fromAddress: "test@sendemail.com",
          fromName: "emailsender",
          host: "smtp.sendemail.com:587",
          password: "<password>",
          skipVerify: true,
          startTLSPolicy: "OpportunisticStartTLS",
          user: "username",
        },
        snapshots: { externalEnabled: true },
        unifiedAlertingScreenshots: { captureEnabled: false },
        users: { editorsCanAdmin: true, viewersCanEdit: true },
      },
      grafanaIntegrations: {
        azureMonitorWorkspaceIntegrations: [
          {
            azureMonitorWorkspaceResourceId:
              "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace",
          },
        ],
      },
      grafanaMajorVersion: "9",
      grafanaPlugins: { "sample-plugin-id": {} },
    },
    sku: { name: "Standard" },
    tags: { Environment: "Dev 2" },
  });
  console.log(result);
}

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Grafana.Models;
using Azure.ResourceManager.Grafana;

// Generated from example definition: 2025-08-01/Grafana_Update.json
// this example is just showing the usage of "ManagedGrafana_Update" 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 ManagedGrafanaResource created on azure
// for more information of creating ManagedGrafanaResource, please refer to the document of ManagedGrafanaResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "myResourceGroup";
string workspaceName = "myWorkspace";
ResourceIdentifier managedGrafanaResourceId = ManagedGrafanaResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, workspaceName);
ManagedGrafanaResource managedGrafana = client.GetManagedGrafanaResource(managedGrafanaResourceId);

// invoke the operation
ManagedGrafanaPatch patch = new ManagedGrafanaPatch
{
    Sku = new ManagedGrafanaSku("Standard"),
    Tags =
    {
    ["Environment"] = "Dev 2"
    },
    Properties = new ManagedGrafanaPatchProperties
    {
        ApiKey = GrafanaApiKey.Enabled,
        DeterministicOutboundIP = DeterministicOutboundIP.Enabled,
        MonitorWorkspaceIntegrations = {new MonitorWorkspaceIntegration
        {
        MonitorWorkspaceResourceId = new ResourceIdentifier("/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"),
        }},
        EnterpriseConfigurations = new EnterpriseConfigurations
        {
            MarketplacePlanId = "myPlanId",
            MarketplaceAutoRenew = MarketplaceAutoRenew.Enabled,
        },
        GrafanaConfigurations = new GrafanaConfigurations
        {
            Smtp = new GrafanaSmtpSettings
            {
                IsEnabled = true,
                Host = "smtp.sendemail.com:587",
                User = "username",
                Password = "<password>",
                FromAddress = "test@sendemail.com",
                FromName = "emailsender",
                StartTLSPolicy = GrafanaStartTlsPolicy.OpportunisticStartTls,
                SkipVerify = true,
            },
            IsExternalEnabled = true,
            Users = new GrafanaUserSettings
            {
                ViewersCanEdit = true,
                EditorsCanAdmin = true,
            },
            IsCsrfAlwaysCheckEnabled = false,
            IsCaptureEnabled = false,
        },
        GrafanaPlugins =
        {
        ["sample-plugin-id"] = new GrafanaPlugin()
        },
        GrafanaMajorVersion = "9",
    },
};
ArmOperation<ManagedGrafanaResource> lro = await managedGrafana.UpdateAsync(WaitUntil.Completed, patch);
ManagedGrafanaResource 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
ManagedGrafanaData 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

Mintaválasz

Állapotkód:

200

{
  "name": "myWorkspace",
  "type": "Microsoft.Dashboard/grafana",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/grafana/myWorkspace",
  "location": "West US",
  "properties": {
    "apiKey": "Enabled",
    "autoGeneratedDomainNameLabelScope": "TenantReuse",
    "deterministicOutboundIP": "Enabled",
    "endpoint": "https://myworkspace-abcdefghijklmnop.wus.grafana.azure.com",
    "enterpriseConfigurations": {
      "marketplaceAutoRenew": "Enabled",
      "marketplacePlanId": "myPlanId"
    },
    "grafanaConfigurations": {
      "security": {
        "csrfAlwaysCheck": false
      },
      "smtp": {
        "enabled": true,
        "fromAddress": "test@sendemail.com",
        "fromName": "emailsender",
        "host": "smtp.sendemail.com:587",
        "skipVerify": true,
        "startTLSPolicy": "OpportunisticStartTLS",
        "user": "username"
      },
      "snapshots": {
        "externalEnabled": true
      },
      "users": {
        "editorsCanAdmin": true,
        "viewersCanEdit": true
      }
    },
    "grafanaIntegrations": {
      "azureMonitorWorkspaceIntegrations": [
        {
          "azureMonitorWorkspaceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"
        }
      ]
    },
    "grafanaMajorVersion": "9",
    "grafanaPlugins": {
      "sample-plugin-id": {
        "pluginId": "sample-plugin-id"
      }
    },
    "grafanaVersion": "9.4.5",
    "outboundIPs": [
      "192.168.0.1",
      "192.168.0.2"
    ],
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled",
    "zoneRedundancy": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "tags": {
    "Environment": "Dev 2"
  }
}

Állapotkód:

202

Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Dashboard/locations/eastus2/operationStatuses/sample-op-status?api-version=2025-08-01

{
  "name": "myWorkspace",
  "type": "Microsoft.Dashboard/grafana",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/grafana/myWorkspace",
  "location": "West US",
  "properties": {
    "apiKey": "Enabled",
    "autoGeneratedDomainNameLabelScope": "TenantReuse",
    "deterministicOutboundIP": "Enabled",
    "endpoint": "https://myworkspace-abcdefghijklmnop.wus.grafana.azure.com",
    "enterpriseConfigurations": {
      "marketplaceAutoRenew": "Enabled",
      "marketplacePlanId": "myPlanId"
    },
    "grafanaConfigurations": {
      "security": {
        "csrfAlwaysCheck": false
      },
      "smtp": {
        "enabled": true,
        "fromAddress": "test@sendemail.com",
        "fromName": "emailsender",
        "host": "smtp.sendemail.com:587",
        "skipVerify": true,
        "startTLSPolicy": "OpportunisticStartTLS",
        "user": "username"
      },
      "snapshots": {
        "externalEnabled": true
      },
      "users": {
        "editorsCanAdmin": true,
        "viewersCanEdit": true
      }
    },
    "grafanaIntegrations": {
      "azureMonitorWorkspaceIntegrations": [
        {
          "azureMonitorWorkspaceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/microsoft.monitor/accounts/myAzureMonitorWorkspace"
        }
      ]
    },
    "grafanaMajorVersion": "9",
    "grafanaPlugins": {
      "sample-plugin-id": {
        "pluginId": "sample-plugin-id"
      }
    },
    "grafanaVersion": "9.4.5",
    "provisioningState": "Accepted",
    "publicNetworkAccess": "Enabled",
    "zoneRedundancy": "Enabled"
  },
  "sku": {
    "name": "Standard"
  },
  "systemData": {
    "createdAt": "2020-02-03T01:01:01.1075056Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-02-04T02:03:01.1974346Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  },
  "tags": {
    "Environment": "Dev 2"
  }
}

Definíciók

Name	Description
ApiKey	A Grafana-példány API-kulcsbeállítása.
AutoGeneratedDomainNameLabelScope	A DNS determinisztikus névkivonat-számításának hatóköre
AzureMonitorWorkspaceIntegration	Integrációk az Azure Monitor-munkaterülethez.
createdByType	Az erőforrást létrehozó identitás típusa.
CreatorCanAdmin	A létrehozó rendszergazdai hozzáféréssel rendelkezik a Grafana-példányhoz.
DeterministicOutboundIP	Hogy egy Grafana-példány determinisztikus kimenő IP-címeket használ-e.
EnterpriseConfigurations	Grafana-példány vállalati beállításai
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
GrafanaConfigurations	Grafana-példány kiszolgálókonfigurációi
GrafanaIntegrations	A GrafanaIntegrations egy csomagban elérhető megfigyelhetőségi felület (például előre konfigurált adatforrás, testreszabott Grafana-irányítópultok, riasztási alapértékek) a gyakori monitorozási forgatókönyvekhez.
GrafanaPlugin	A Grafana beépülő modulja
ManagedGrafana	A grafana erőforrástípus.
ManagedGrafanaProperties	A grafana erőforrásra jellemző tulajdonságok.
ManagedGrafanaPropertiesUpdateParameters	A grafana-erőforrásra irányuló PATCH-kérés tulajdonságok paraméterei.
ManagedGrafanaUpdateParameters	A grafana-erőforrásra vonatkozó PATCH-kérés paraméterei.
ManagedServiceIdentity	Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)
ManagedServiceIdentityType	A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).
MarketplaceAutoRenew	A Nagyvállalati előfizetés automatikus megújítási beállítása
PrivateEndpoint	A privát végpont erőforrása.
PrivateEndpointConnection	A privát végpont kapcsolati erőforrása.
PrivateEndpointConnectionProvisioningState	Az aktuális kiépítési állapot.
PrivateEndpointServiceConnectionStatus	A privát végpont kapcsolatának állapota.
PrivateLinkServiceConnectionState	A szolgáltatásfelhasználó és a szolgáltató közötti kapcsolat állapotával kapcsolatos információk gyűjteménye.
ProvisioningState
PublicNetworkAccess	Adja meg a nyilvános felületen keresztüli forgalom engedélyezésének vagy letiltásának állapotát.
ResourceSku	Egy erőforrás termékváltozatát jelöli.
Security	Grafana biztonsági beállításai
Size	Megadja a Grafana-példány kapacitásszintjét.
Smtp	E-mail-kiszolgáló beállításai. https://grafana.com/docs/grafana/v9.0/setup-grafana/configure-grafana/#smtp
Snapshots	Grafana-pillanatképek beállításai
StartTLSPolicy	Az SMTP-konfiguráció StartTLSPolicy beállítása https://pkg.go.dev/github.com/go-mail/mail#StartTLSPolicy
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UnifiedAlertingScreenshots	Grafana egyesített riasztási képernyőképek beállításai
UserAssignedIdentity	Felhasználó által hozzárendelt identitástulajdonságok
Users	Grafana felhasználói beállítások
ZoneRedundancy	A Grafana-példány zónaredundanciabeállítása.

ApiKey

Enumerálás

A Grafana-példány API-kulcsbeállítása.

Érték	Description
Disabled
Enabled

AutoGeneratedDomainNameLabelScope

Enumerálás

A DNS determinisztikus névkivonat-számításának hatóköre

Érték	Description
TenantReuse

AzureMonitorWorkspaceIntegration

Objektum

Integrációk az Azure Monitor-munkaterülethez.

Name	Típus	Description
azureMonitorWorkspaceResourceId	string	A csatlakoztatott Azure Monitor-munkaterület erőforrás-azonosítója.

createdByType

Enumerálás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

CreatorCanAdmin

Enumerálás

A létrehozó rendszergazdai hozzáféréssel rendelkezik a Grafana-példányhoz.

Érték	Description
Disabled	Az alkotói adminisztrátori hozzáférés le van tiltva
Enabled	A tartalomkészítői adminisztrátori hozzáférés engedélyezve van

DeterministicOutboundIP

Enumerálás

Hogy egy Grafana-példány determinisztikus kimenő IP-címeket használ-e.

Érték	Description
Disabled
Enabled

EnterpriseConfigurations

Objektum

Grafana-példány vállalati beállításai

Name	Típus	Description
marketplaceAutoRenew	MarketplaceAutoRenew	A Nagyvállalati előfizetés automatikus megújítási beállítása
marketplacePlanId	string	A nagyvállalati beépülő modulokhoz készült Azure Marketplace-előfizetés csomagazonosítója

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

GrafanaConfigurations

Objektum

Grafana-példány kiszolgálókonfigurációi

Name	Típus	Description
security	Security	Grafana biztonsági beállításai
smtp	Smtp	E-mail-kiszolgáló beállításai. https://grafana.com/docs/grafana/v9.0/setup-grafana/configure-grafana/#smtp
snapshots	Snapshots	Grafana-pillanatképek beállításai
unifiedAlertingScreenshots	UnifiedAlertingScreenshots	Grafana egyesített riasztási képernyőképek beállításai
users	Users	Grafana felhasználói beállítások

GrafanaIntegrations

Objektum

A GrafanaIntegrations egy csomagban elérhető megfigyelhetőségi felület (például előre konfigurált adatforrás, testreszabott Grafana-irányítópultok, riasztási alapértékek) a gyakori monitorozási forgatókönyvekhez.

Name	Típus	Description
azureMonitorWorkspaceIntegrations	AzureMonitorWorkspaceIntegration[]	Integrációk az Azure Monitor-munkaterülethez.

GrafanaPlugin

Objektum

A Grafana beépülő modulja

Name	Típus	Description
pluginId	string	Grafana beépülő modul azonosítója

ManagedGrafana

Objektum

A grafana erőforrástípus.

Name	Típus	Description
id	string	Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Az erőforráshoz rendelt felügyeltszolgáltatás-identitások.
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties	ManagedGrafanaProperties	A grafana erőforrásra jellemző tulajdonságok.
sku	ResourceSku	A grafana erőforrás termékváltozata.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

ManagedGrafanaProperties

Objektum

A grafana erőforrásra jellemző tulajdonságok.

Name	Típus	Alapértelmezett érték	Description
apiKey	ApiKey	Disabled	A Grafana-példány API-kulcsbeállítása.
autoGeneratedDomainNameLabelScope	AutoGeneratedDomainNameLabelScope		A dns determinisztikus névkivonat-számításának hatóköre.
creatorCanAdmin	CreatorCanAdmin		A létrehozó rendszergazdai hozzáféréssel rendelkezik a Grafana-példányhoz.
deterministicOutboundIP	DeterministicOutboundIP	Disabled	Hogy egy Grafana-példány determinisztikus kimenő IP-címeket használ-e.
endpoint	string		A Grafana-példány végpontja.
enterpriseConfigurations	EnterpriseConfigurations		Grafana-példány vállalati beállításai
grafanaConfigurations	GrafanaConfigurations		Grafana-példány kiszolgálókonfigurációi
grafanaIntegrations	GrafanaIntegrations		A GrafanaIntegrations egy csomagban elérhető megfigyelhetőségi felület (például előre konfigurált adatforrás, testreszabott Grafana-irányítópultok, riasztási alapértékek) a gyakori monitorozási forgatókönyvekhez.
grafanaMajorVersion	string		A fő Grafana szoftververzió, amit meg kell célozni.
grafanaPlugins	<string,  GrafanaPlugin>		A Grafana-példány telepített beépülő modullistája. A kulcs a beépülő modul azonosítója, az érték pedig a beépülő modul definíciója.
grafanaVersion	string		A Grafana szoftververzió.
outboundIPs	string[]		A kimenő IP-címek listája, ha a deterministicOutboundIP engedélyezve van.
privateEndpointConnections	PrivateEndpointConnection[]		A Grafana-példány privát végponti kapcsolatai.
provisioningState	ProvisioningState		Az erőforrás kiépítési állapota.
publicNetworkAccess	PublicNetworkAccess	Enabled	Adja meg a nyilvános felületen keresztüli forgalom engedélyezésének vagy letiltásának állapotát.
zoneRedundancy	ZoneRedundancy	Disabled	A Grafana-példány zónaredundanciabeállítása.

ManagedGrafanaPropertiesUpdateParameters

Objektum

A grafana-erőforrásra irányuló PATCH-kérés tulajdonságok paraméterei.

Name	Típus	Alapértelmezett érték	Description
apiKey	ApiKey	Disabled	A Grafana-példány API-kulcsbeállítása.
creatorCanAdmin	CreatorCanAdmin		A létrehozó rendszergazdai hozzáféréssel rendelkezik a Grafana-példányhoz.
deterministicOutboundIP	DeterministicOutboundIP	Disabled	Hogy egy Grafana-példány determinisztikus kimenő IP-címeket használ-e.
enterpriseConfigurations	EnterpriseConfigurations		Grafana-példány vállalati beállításai
grafanaConfigurations	GrafanaConfigurations		Grafana-példány kiszolgálókonfigurációi
grafanaIntegrations	GrafanaIntegrations		A GrafanaIntegrations egy csomagban elérhető megfigyelhetőségi felület (például előre konfigurált adatforrás, testreszabott Grafana-irányítópultok, riasztási alapértékek) a gyakori monitorozási forgatókönyvekhez.
grafanaMajorVersion	string		A fő Grafana szoftververzió, amit meg kell célozni.
grafanaPlugins	<string,  GrafanaPlugin>		A Grafana beépülő modul frissítése. A kulcs a beépülő modul azonosítója, az érték pedig a beépülő modul definíciója. Ha a bővítmény definíciója null, akkor a megadott plugin azonosítóval rendelkező bővítmény eltávolításra kerül. Ellenkező esetben a megadott bővítmény telepítésre kerül.
publicNetworkAccess	PublicNetworkAccess	Enabled	Adja meg a nyilvános felületen keresztüli forgalom engedélyezésének vagy letiltásának állapotát.
zoneRedundancy	ZoneRedundancy	Disabled	A Grafana-példány zónaredundanciabeállítása.

ManagedGrafanaUpdateParameters

Objektum

A grafana-erőforrásra vonatkozó PATCH-kérés paraméterei.

Name	Típus	Description
identity	ManagedServiceIdentity	A grafana erőforrás felügyelt identitása.
properties	ManagedGrafanaPropertiesUpdateParameters	A felügyelt grafana-erőforrásra jellemző tulajdonságok.
sku	ResourceSku	Egy erőforrás termékváltozatát jelöli.
tags	object	A grafana erőforrás új címkéi.

ManagedServiceIdentity

Objektum

Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)

Name	Típus	Description
principalId	string (uuid)	A rendszer által hozzárendelt identitás szolgáltatásnév-azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.
tenantId	string (uuid)	A rendszer által hozzárendelt identitás bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva.
type	ManagedServiceIdentityType	A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).
userAssignedIdentities	<string,  UserAssignedIdentity>	User-Assigned identitások Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsok arm-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben.

ManagedServiceIdentityType

Enumerálás

A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).

Érték	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MarketplaceAutoRenew

Enumerálás

A Nagyvállalati előfizetés automatikus megújítási beállítása

Érték	Description
Disabled
Enabled

PrivateEndpoint

Objektum

A privát végpont erőforrása.

Name	Típus	Description
id	string	A privát végpont ARM-azonosítója

PrivateEndpointConnection

Objektum

A privát végpont kapcsolati erőforrása.

Name	Típus	Description
id	string	Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Az erőforrás neve
properties.groupIds	string[]	A privát végpont kapcsolatcsoport-azonosítói.
properties.privateEndpoint	PrivateEndpoint	A privát végpont erőforrása.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	A szolgáltatásfelhasználó és a szolgáltató közötti kapcsolat állapotával kapcsolatos információk gyűjteménye.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	A privát végpont kapcsolati erőforrásának kiépítési állapota.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Enumerálás

Az aktuális kiépítési állapot.

Érték	Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Enumerálás

A privát végpont kapcsolatának állapota.

Érték	Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Objektum

A szolgáltatásfelhasználó és a szolgáltató közötti kapcsolat állapotával kapcsolatos információk gyűjteménye.

Name	Típus	Description
actionsRequired	string	Üzenet, amely jelzi, hogy a szolgáltató módosításaihoz szükség van-e a fogyasztó frissítésére.
description	string	A kapcsolat jóváhagyásának/elutasításának oka.
status	PrivateEndpointServiceConnectionStatus	Azt jelzi, hogy a szolgáltatás tulajdonosa jóváhagyta/elutasította/eltávolította-e a kapcsolatot.

ProvisioningState

Enumerálás

Érték	Description
Accepted
Creating
Updating
Deleting
Succeeded
Failed
Canceled
Deleted
NotSpecified

PublicNetworkAccess

Enumerálás

Adja meg a nyilvános felületen keresztüli forgalom engedélyezésének vagy letiltásának állapotát.

Érték	Description
Enabled
Disabled

ResourceSku

Objektum

Egy erőforrás termékváltozatát jelöli.

Name	Típus	Description
name	string	Az termékváltozat neve.
size	Size	Megadja a Grafana-példány kapacitásszintjét.

Security

Objektum

Grafana biztonsági beállításai

Name	Típus	Description
csrfAlwaysCheck	boolean	Állítsa igaz értékre a CSRF-ellenőrzés végrehajtásához, még akkor is, ha a bejelentkezési cookie nincs egy kérésben (alapértelmezés szerint hamis).

Size

Enumerálás

Megadja a Grafana-példány kapacitásszintjét.

Érték	Description
X1	X1 kapacitási szint
X2	X2 kapacitási szint

Smtp

Objektum

E-mail-kiszolgáló beállításai. https://grafana.com/docs/grafana/v9.0/setup-grafana/configure-grafana/#smtp

Name	Típus	Alapértelmezett érték	Description
enabled	boolean	False	Engedélyezze ezt annak engedélyezéséhez, hogy Grafana e-maileket küldjön. Az alapértelmezett érték hamis
fromAddress	string		Az e-mailek küldéséhez használt cím https://pkg.go.dev/net/mail#Address
fromName	string		E-mailek küldésekor használandó név. Az alapértelmezett érték az "Azure Managed Grafana-értesítés" https://pkg.go.dev/net/mail#Address
host	string		SMTP-kiszolgáló állomásneve porttal, például test.email.net:587
password	string (password)		Az SMTP-hitelesítés jelszava. Ha a jelszó # vagy ;, akkor három idézőjelet kell becsomagolnia
skipVerify	boolean		Ellenőrizze az SSL-t az SMTP-kiszolgálóhoz. Az alapértelmezett érték hamis https://pkg.go.dev/crypto/tls#Config
startTLSPolicy	StartTLSPolicy		Az SMTP-konfiguráció StartTLSPolicy beállítása https://pkg.go.dev/github.com/go-mail/mail#StartTLSPolicy
user	string		SMTP-hitelesítés felhasználója

Snapshots

Objektum

Grafana-pillanatképek beállításai

Name	Típus	Description
externalEnabled	boolean	A külső pillanatkép-közzétételi végpont letiltásához állítsa hamis értékre

StartTLSPolicy

Enumerálás

Az SMTP-konfiguráció StartTLSPolicy beállítása https://pkg.go.dev/github.com/go-mail/mail#StartTLSPolicy

Érték	Description
OpportunisticStartTLS
MandatoryStartTLS
NoStartTLS

systemData

Objektum

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UnifiedAlertingScreenshots

Objektum

Grafana egyesített riasztási képernyőképek beállításai

Name	Típus	Description
captureEnabled	boolean	Állítsa false (hamis) értékre a képernyőkép rögzítésének letiltásához az egyesített riasztásban teljesítményprobléma miatt.

UserAssignedIdentity

Objektum

Felhasználó által hozzárendelt identitástulajdonságok

Name	Típus	Description
clientId	string (uuid)	A hozzárendelt identitás ügyfélazonosítója.
principalId	string (uuid)	A hozzárendelt identitás egyszerű azonosítója.

Users

Objektum

Grafana felhasználói beállítások

Name	Típus	Description
editorsCanAdmin	boolean	Állítsa igaz értékre, hogy a szerkesztők adminisztrálhassák az irányítópultokat, mappákat és csapatokat.
viewersCanEdit	boolean	Állítsa igaz értékre, hogy a megtekintők hozzáférhessenek és használhassák a feltárásokat, és ideiglenes módosításokat hajtsanak végre az olyan irányítópultokon, amelyekhez hozzáféréssel rendelkeznek. Nem menthetik a módosításokat.

ZoneRedundancy

Enumerálás

A Grafana-példány zónaredundanciabeállítása.

Érték	Description
Disabled
Enabled