Issue - Create

Служба:: Monitor

Версия API:: 2025-10-03

Создание новой задачи или обновление существующей

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Monitor/accounts/{azureMonitorWorkspaceName}/issues/{issueName}?api-version=2025-10-03

С использованием необязательных параметров:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Monitor/accounts/{azureMonitorWorkspaceName}/issues/{issueName}?api-version=2025-10-03&related={related}

Параметры URI

Имя	В	Обязательно	Тип	Описание
azureMonitorWorkspaceName	path	True	string pattern: ^(?!-)[a-zA-Z0-9-]+[^-]$	Название Azure Monitor Workspace. Имя является нечувствительным к регистру
issueName	path	True	string pattern: ^(?!-)[a-zA-Z0-9-]+[^-]$	Имя ресурса IssueResource
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
related	query		string	Связанный ресурс или оповещение, которое должно быть добавлено к проблеме (по умолчанию: пусто — проблема будет создана без каких-либо связанных ресурсов или оповещений)

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

Имя	Тип	Описание
properties	IssueProperties	Свойства, относящиеся к ресурсу, для этого ресурса.

Ответы

Имя	Тип	Описание
200 OK	IssueResource	Операция обновления ресурса 'IssueResource' выполнена успешно
201 Created	IssueResource	Операция по созданию ресурса 'IssueResource' выполнена успешно
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Поток OAuth2 Azure Active Directory.

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

Области

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

Примеры

Issue_Create_MaximumSet

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

PUT https://management.azure.com/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Monitor/accounts/myWorkspace/issues/3f29e1b2b05f8371595dc761fed8e8b3?api-version=2025-10-03

{
  "properties": {
    "title": "Alert fired on VM CPU",
    "status": "New",
    "severity": "Sev2",
    "impactTime": "2024-12-13T02:45:33",
    "notifications": {
      "updateTypes": [
        {
          "updateType": "IssueCreation"
        },
        {
          "updateType": "OnChange"
        },
        {
          "updateType": "TimeBased",
          "updateInterval": "PT1H"
        }
      ],
      "actionGroupIds": [
        "/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Insights/actionGroups/myActionGroup"
      ],
      "excludeDefaultActionGroups": false
    }
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.monitorworkspaces import MonitorWorkspacesMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-monitorworkspaces
# USAGE
    python issue_create_maximum_set_gen.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 = MonitorWorkspacesMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.issue.create(
        resource_group_name="rg1",
        azure_monitor_workspace_name="myWorkspace",
        issue_name="3f29e1b2b05f8371595dc761fed8e8b3",
        resource={
            "properties": {
                "impactTime": "2024-12-13T02:45:33",
                "notifications": {
                    "actionGroupIds": [
                        "/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Insights/actionGroups/myActionGroup"
                    ],
                    "excludeDefaultActionGroups": False,
                    "updateTypes": [
                        {"updateType": "IssueCreation"},
                        {"updateType": "OnChange"},
                        {"updateInterval": "PT1H", "updateType": "TimeBased"},
                    ],
                },
                "severity": "Sev2",
                "status": "New",
                "title": "Alert fired on VM CPU",
            }
        },
    )
    print(response)


# x-ms-original-file: 2025-10-03/Issue_Create_MaximumSet_Gen.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

package armmonitorworkspaces_test

import (
	"context"
	"log"
	"time"

	"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/monitor/armmonitorworkspaces"
)

// Generated from example definition: 2025-10-03/Issue_Create_MaximumSet_Gen.json
func ExampleIssueClient_Create() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmonitorworkspaces.NewClientFactory("aceaa046-91f0-492a-96dc-45e10a9183dc", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewIssueClient().Create(ctx, "rg1", "myWorkspace", "3f29e1b2b05f8371595dc761fed8e8b3", armmonitorworkspaces.IssueResource{
		Properties: &armmonitorworkspaces.IssueProperties{
			Title:      to.Ptr("Alert fired on VM CPU"),
			Status:     to.Ptr(armmonitorworkspaces.StatusNew),
			Severity:   to.Ptr("Sev2"),
			ImpactTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-12-13T02:45:33"); return t }()),
			Notifications: &armmonitorworkspaces.Notifications{
				UpdateTypes: []armmonitorworkspaces.IssueNotificationTypeClassification{
					&armmonitorworkspaces.IssueCreationNotificationType{
						UpdateType: to.Ptr(armmonitorworkspaces.UpdateTypeIssueCreation),
					},
					&armmonitorworkspaces.OnChangeNotificationType{
						UpdateType: to.Ptr(armmonitorworkspaces.UpdateTypeOnChange),
					},
					&armmonitorworkspaces.TimeBasedUpdatesNotificationType{
						UpdateType:     to.Ptr(armmonitorworkspaces.UpdateTypeTimeBased),
						UpdateInterval: to.Ptr("PT1H"),
					},
				},
				ActionGroupIDs: []*string{
					to.Ptr("/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Insights/actionGroups/myActionGroup"),
				},
				ExcludeDefaultActionGroups: to.Ptr(false),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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 = armmonitorworkspaces.IssueClientCreateResponse{
	// 	IssueResource: armmonitorworkspaces.IssueResource{
	// 		Properties: &armmonitorworkspaces.IssueProperties{
	// 			Title: to.Ptr("Alert fired on VM CPU"),
	// 			Status: to.Ptr(armmonitorworkspaces.StatusNew),
	// 			Severity: to.Ptr("Sev2"),
	// 			Investigations: []*armmonitorworkspaces.InvestigationMetadata{
	// 			},
	// 			ImpactTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-12-13T02:45:33"); return t}()),
	// 			InvestigationsCount: to.Ptr[int32](0),
	// 			Notifications: &armmonitorworkspaces.Notifications{
	// 				UpdateTypes: []armmonitorworkspaces.IssueNotificationTypeClassification{
	// 					&armmonitorworkspaces.IssueCreationNotificationType{
	// 						UpdateType: to.Ptr(armmonitorworkspaces.UpdateTypeIssueCreation),
	// 					},
	// 					&armmonitorworkspaces.OnChangeNotificationType{
	// 						UpdateType: to.Ptr(armmonitorworkspaces.UpdateTypeOnChange),
	// 					},
	// 					&armmonitorworkspaces.TimeBasedUpdatesNotificationType{
	// 						UpdateType: to.Ptr(armmonitorworkspaces.UpdateTypeTimeBased),
	// 						UpdateInterval: to.Ptr("PT1H"),
	// 					},
	// 				},
	// 				ActionGroupIDs: []*string{
	// 					to.Ptr("/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Insights/actionGroups/myActionGroup"),
	// 				},
	// 				ExcludeDefaultActionGroups: to.Ptr(false),
	// 			},
	// 			ProvisioningState: to.Ptr(armmonitorworkspaces.ResourceProvisioningStateSucceeded),
	// 		},
	// 		ID: to.Ptr("/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.AlertsManagement/issues/3f29e1b2b05f8371595dc761fed8e8b3"),
	// 		Name: to.Ptr("3f29e1b2b05f8371595dc761fed8e8b3"),
	// 		SystemData: &armmonitorworkspaces.SystemData{
	// 			CreatedBy: to.Ptr("171a811c-2a3a-4e6c-b742-f78f5f6ca51c"),
	// 			CreatedByType: to.Ptr(armmonitorworkspaces.CreatedByType("Manual")),
	// 			CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-12-13T03:11:07"); return t}()),
	// 			LastModifiedBy: to.Ptr("171a811c-2a3a-4e6c-b742-f78f5f6ca51c"),
	// 			LastModifiedByType: to.Ptr(armmonitorworkspaces.CreatedByType("Manual")),
	// 			LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2024-12-13T03:51:45"); return t}()),
	// 		},
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to create a new issue or updates an existing one
 *
 * @summary create a new issue or updates an existing one
 * x-ms-original-file: 2025-10-03/Issue_Create_MaximumSet_Gen.json
 */
async function issueCreateMaximumSet() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "aceaa046-91f0-492a-96dc-45e10a9183dc";
  const client = new MonitorClient(credential, subscriptionId);
  const result = await client.issue.create(
    "rg1",
    "myWorkspace",
    "3f29e1b2b05f8371595dc761fed8e8b3",
    {
      properties: {
        title: "Alert fired on VM CPU",
        status: "New",
        severity: "Sev2",
        impactTime: new Date("2024-12-13T02:45:33"),
      },
    },
  );
  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

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

Код состояния:: 200

{
  "properties": {
    "title": "Alert fired on VM CPU",
    "status": "New",
    "severity": "Sev2",
    "investigations": [],
    "impactTime": "2024-12-13T02:45:33",
    "investigationsCount": 0,
    "notifications": {
      "updateTypes": [
        {
          "updateType": "IssueCreation"
        },
        {
          "updateType": "OnChange"
        },
        {
          "updateType": "TimeBased",
          "updateInterval": "PT1H"
        }
      ],
      "actionGroupIds": [
        "/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Insights/actionGroups/myActionGroup"
      ],
      "excludeDefaultActionGroups": false
    },
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.AlertsManagement/issues/3f29e1b2b05f8371595dc761fed8e8b3",
  "name": "3f29e1b2b05f8371595dc761fed8e8b3",
  "systemData": {
    "createdBy": "171a811c-2a3a-4e6c-b742-f78f5f6ca51c",
    "createdByType": "Manual",
    "createdAt": "2024-12-13T03:11:07",
    "lastModifiedBy": "171a811c-2a3a-4e6c-b742-f78f5f6ca51c",
    "lastModifiedByType": "Manual",
    "lastModifiedAt": "2024-12-13T03:51:45"
  }
}

Код состояния:: 201

{
  "properties": {
    "title": "Alert fired on VM CPU",
    "status": "New",
    "severity": "Sev2",
    "investigations": [],
    "impactTime": "2024-12-13T02:45:33",
    "investigationsCount": 0,
    "notifications": {
      "updateTypes": [
        {
          "updateType": "IssueCreation"
        },
        {
          "updateType": "OnChange"
        },
        {
          "updateType": "TimeBased",
          "updateInterval": "PT1H"
        }
      ],
      "actionGroupIds": [
        "/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Insights/actionGroups/myActionGroup"
      ],
      "excludeDefaultActionGroups": false
    },
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/aceaa046-91f0-492a-96dc-45e10a9183dc/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/vm1/providers/Microsoft.AlertsManagement/issues/3f29e1b2b05f8371595dc761fed8e8b3",
  "name": "3f29e1b2b05f8371595dc761fed8e8b3",
  "systemData": {
    "createdBy": "171a811c-2a3a-4e6c-b742-f78f5f6ca51c",
    "createdByType": "Manual",
    "createdAt": "2024-12-13T03:11:07",
    "lastModifiedBy": "171a811c-2a3a-4e6c-b742-f78f5f6ca51c",
    "lastModifiedByType": "Manual",
    "lastModifiedAt": "2024-12-13T03:51:45"
  }
}

Определения

Имя	Описание
Background	Справочная информация о проблеме
BackgroundDetails	Элемент фоновых деталей
createdByType	Тип удостоверения, создавшего ресурс.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
InvestigationMetadata	Свойства текущего расследования
IssueCreationNotificationType	Тип уведомления о событиях создания выпусков
IssueProperties	Свойства проблемы
IssueResource	Ресурс «Проблема»
Notifications	Настройки уведомлений о выдаче
OnChangeNotificationType	Тип уведомления о событиях при переходе
ResourceProvisioningState	Состояние provisioning of the Azure Monitor Workspace. Если всё здорово, настройте на Успешно.
Status	Статус проблемы
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
TimeBasedUpdatesNotificationType	Тип уведомления для обновлений по времени
UpdateType	Тип обновления, который запускает уведомление

Background

Объект

Справочная информация о проблеме

Имя	Тип	Описание
details	BackgroundDetails[]	Предыстория
text	string	Фоновый текст
type	string	Тип фона

BackgroundDetails

Объект

Элемент фоновых деталей

Имя	Тип	Описание
name	string	Предыстории названия
value	string	Значение фоновых деталей

createdByType

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

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

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

ErrorAdditionalInfo

Объект

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

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

ErrorDetail

Объект

Сведения об ошибке.

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

ErrorResponse

Объект

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

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

InvestigationMetadata

Объект

Свойства текущего расследования

Имя	Тип	Описание
createdAt	string (date-time)	Время создания расследования (в UTC)
id	string (uuid)	Уникальный идентификатор расследования

IssueCreationNotificationType

Объект

Тип уведомления о событиях создания выпусков

Имя	Тип	Описание
updateType	string: IssueCreation	Тип обновления, который запускает уведомление

IssueProperties

Объект

Свойства проблемы

Имя	Тип	Описание
background	Background	Справочная информация о проблеме
impactTime	string (date-time)	Время воздействия проблемы (в UTC)
investigations	InvestigationMetadata[]	Список расследований в номере
investigationsCount	integer (int32)	Количество расследований в вопросе
notifications	Notifications	Настройки уведомления о проблеме
provisioningState	ResourceProvisioningState	Состояние подготовки ресурса.
severity	string	Серьезность проблемы
status	Status	Статус проблемы
title	string	Название номера

IssueResource

Объект

Ресурс «Проблема»

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties	IssueProperties	Свойства, относящиеся к ресурсу, для этого ресурса.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

Notifications

Объект

Настройки уведомлений о выдаче

Имя	Тип	Описание
actionGroupIds	string[]	Идентификаторы групп действий для уведомления
excludeDefaultActionGroups	boolean	Исключать ли группы действий по умолчанию из уведомлений
updateTypes	IssueNotificationType[]: IssueCreationNotificationType[] OnChangeNotificationType[] TimeBasedUpdatesNotificationType[]	Типы обновлений, которые запускают уведомления

OnChangeNotificationType

Объект

Тип уведомления о событиях при переходе

Имя	Тип	Описание
updateType	string: OnChange	Тип обновления, который запускает уведомление

ResourceProvisioningState

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

Состояние provisioning of the Azure Monitor Workspace. Если всё здорово, настройте на Успешно.

Значение	Описание
Succeeded	Ресурс создан.
Failed	Не удалось создать ресурс.
Canceled	Создание ресурсов было отменено.

Status

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

Статус проблемы

Значение	Описание
New	Вопрос новый
InProgress	Проблема находится в процессе разработки
Mitigated	Проблема устранена
Closed	Вопрос закрыт
Canceled	Вопрос отменен

systemData

Объект

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

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

TimeBasedUpdatesNotificationType

Объект

Тип уведомления для обновлений по времени

Имя	Тип	Описание
updateInterval	string	Интервал между обновлениями по времени
updateType	string: TimeBased	Тип обновления, который запускает уведомление

UpdateType

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

Тип обновления, который запускает уведомление

Значение	Описание
IssueCreation	Уведомление отправляется при возникновении проблемы
TimeBased	Уведомление отправляется на основе временных интервалов
OnChange	Уведомление отправляется при изменении проблемы