Scheduled Actions - Create Or Update By Scope

Hizmet:

Cost Management

API Sürümü:

2025-03-01

Belirtilen kapsam içinde paylaşılan bir zamanlanmış eylem oluşturun veya güncelleştirin.

PUT https://management.azure.com/{scope}/providers/Microsoft.CostManagement/scheduledActions/{name}?api-version=2025-03-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
name	path	True	string	Zamanlanmış eylem adı.
scope	path	True	string	tanımlanmamış
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
If-Match		string	Varlığın ETag'i. Varlık oluştururken gerekli değildir. Bir varlığı güncelleştirirken isteğe bağlı ve iyimser eşzamanlılık elde etmek için belirtilebilir.

İstek Gövdesi

Name	Gerekli	Tür	Description
properties.displayName	True	string	Zamanlanmış eylem adı.
properties.notification	True	NotificationProperties	Zamanlanmış eylem türüne göre bildirim özellikleri.
properties.schedule	True	ScheduleProperties	Zamanlanan eylemin zamanlaması.
properties.status	True	ScheduledActionStatus	Zamanlanan eylemin durumu.
properties.viewId	True	string	Zamanlanmış eylem için kullanılan maliyet analizi viewId değeri. Örneğin, '/providers/Microsoft.CostManagement/views/swaggerExample'
eTag		string	Kaynak Etag'i. Güncelleştirme çağrıları için eTag isteğe bağlıdır ve iyimser eşzamanlılık elde etmek için belirtilebilir. Önce bir 'GET' çağrısı yaparak ve ardından güncelleştirmeyi gerçekleştirirken istek gövdesinin parçası olarak en son eTag'i veya 'If-Match' üst bilgisini ekleyerek kaynağın eTag'ini getirin. Çağrı oluşturmak için eTag gerekli değildir.
kind		ScheduledActionKind	Zamanlanmış eylemin türü.
properties.fileDestination		FileDestination	Görünüm verilerinin hedef biçimi. Bu isteğe bağlıdır.
properties.notificationEmail		string	Abonelikten çıkma isteklerini ve bildirim e-postalarını alması gereken kişi noktasının e-posta adresi.
properties.scope		string	Özel zamanlanmış eylem (Oluştur veya Güncelleştir) için kapsam boş olacaktır. Paylaşılan zamanlanmış eylem (Kapsama Göre Oluştur veya Güncelleştir) için Maliyet Yönetimi kapsamı, abonelik kapsamı için 'subscriptions/{subscriptionId}', resourceGroup kapsamı için 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', Ödeme Hesabı kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}', Departman kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}', 'providers/Microsoft' olabilir. EnrollmentAccount kapsamı için Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}', BillingProfile kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}', InvoiceSection kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}', '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' ExternalBillingAccount kapsamı ve ExternalSubscription kapsamı için '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}'.

Yanıtlar

Name	Tür	Description
200 OK	ScheduledAction	Kaynak 'ScheduledAction' güncelleme işlemi başarılı oldu
201 Created	ScheduledAction	Resource 'ScheduledAction' işlemi başarılı oldu
Other Status Codes	ErrorResponseWithNestedDetails	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

CreateOrUpdateInsightAlertScheduledActionByScope

CreateOrUpdateScheduledActionByScope

CreateOrUpdateInsightAlertScheduledActionByScope

Örnek isteği

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/scheduledActions/dailyAnomalyByResource?api-version=2025-03-01


{
  "kind": "InsightAlert",
  "properties": {
    "displayName": "Daily anomaly by resource",
    "notification": {
      "subject": "Cost anomaly detected in the resource",
      "to": [
        "user@gmail.com",
        "team@gmail.com"
      ]
    },
    "schedule": {
      "endDate": "2021-06-19T22:21:51.1287144Z",
      "frequency": "Daily",
      "startDate": "2020-06-19T22:21:51.1287144Z"
    },
    "status": "Enabled",
    "viewId": "/providers/Microsoft.CostManagement/views/swaggerExample"
  }
}

Örnek yanıt

Durum kodu:

200

{
  "name": "dailyAnomalyByResource",
  "type": "Microsoft.CostManagement/ScheduledActions",
  "eTag": "\"1d4ff9fe66f1d10\"",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/scheduledActions/dailyAnomalyByResource",
  "kind": "InsightAlert",
  "properties": {
    "displayName": "Daily anomaly by resource",
    "fileDestination": {
      "fileFormats": []
    },
    "notification": {
      "subject": "Cost anomaly detected in the resource",
      "to": [
        "user@gmail.com",
        "team@gmail.com"
      ]
    },
    "schedule": {
      "endDate": "2021-06-19T22:21:51.1287144Z",
      "frequency": "Daily",
      "startDate": "2020-06-19T22:21:51.1287144Z"
    },
    "scope": "subscriptions/00000000-0000-0000-0000-000000000000",
    "status": "Enabled",
    "viewId": "/providers/Microsoft.CostManagement/views/swaggerExample"
  },
  "systemData": {
    "createdAt": "2020-06-18T22:21:51.1287144Z",
    "createdBy": "testuser",
    "createdByType": "User",
    "lastModifiedAt": "2020-06-19T22:21:51.1287144Z",
    "lastModifiedBy": "testuser",
    "lastModifiedByType": "User"
  }
}

Durum kodu:

201

{
  "name": "dailyAnomalyByResource",
  "type": "Microsoft.CostManagement/ScheduledActions",
  "eTag": "\"1d4ff9fe66f1d10\"",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/scheduledActions/dailyAnomalyByResource",
  "kind": "InsightAlert",
  "properties": {
    "displayName": "Daily anomaly by resource",
    "fileDestination": {
      "fileFormats": []
    },
    "notification": {
      "subject": "Cost anomaly detected in the resource",
      "to": [
        "user@gmail.com",
        "team@gmail.com"
      ]
    },
    "schedule": {
      "endDate": "2021-06-19T22:21:51.1287144Z",
      "frequency": "Daily",
      "startDate": "2020-06-19T22:21:51.1287144Z"
    },
    "scope": "subscriptions/00000000-0000-0000-0000-000000000000",
    "status": "Enabled",
    "viewId": "/providers/Microsoft.CostManagement/views/swaggerExample"
  },
  "systemData": {
    "createdAt": "2020-06-18T22:21:51.1287144Z",
    "createdBy": "testuser",
    "createdByType": "User",
    "lastModifiedAt": "2020-06-18T22:21:51.1287144Z",
    "lastModifiedBy": "testuser",
    "lastModifiedByType": "User"
  }
}

CreateOrUpdateScheduledActionByScope

Örnek isteği

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/scheduledActions/monthlyCostByResource?api-version=2025-03-01


{
  "kind": "Email",
  "properties": {
    "displayName": "Monthly Cost By Resource",
    "fileDestination": {
      "fileFormats": [
        "Csv"
      ]
    },
    "notification": {
      "subject": "Cost by resource this month",
      "to": [
        "user@gmail.com",
        "team@gmail.com"
      ]
    },
    "schedule": {
      "daysOfWeek": [
        "Monday"
      ],
      "endDate": "2021-06-19T22:21:51.1287144Z",
      "frequency": "Monthly",
      "hourOfDay": 10,
      "startDate": "2020-06-19T22:21:51.1287144Z",
      "weeksOfMonth": [
        "First",
        "Third"
      ]
    },
    "status": "Enabled",
    "viewId": "/providers/Microsoft.CostManagement/views/swaggerExample"
  }
}

Örnek yanıt

Durum kodu:

200

{
  "name": "monthlyCostByResource",
  "type": "Microsoft.CostManagement/ScheduledActions",
  "eTag": "\"1d4ff9fe66f1d10\"",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/scheduledActions/monthlyCostByResource",
  "kind": "Email",
  "properties": {
    "displayName": "Monthly Cost By Resource",
    "notification": {
      "subject": "Cost by resource this month",
      "to": [
        "user@gmail.com",
        "team@gmail.com"
      ]
    },
    "schedule": {
      "daysOfWeek": [
        "Monday"
      ],
      "endDate": "2021-06-19T22:21:51.1287144Z",
      "frequency": "Monthly",
      "hourOfDay": 10,
      "startDate": "2020-06-19T22:21:51.1287144Z",
      "weeksOfMonth": [
        "First",
        "Third"
      ]
    },
    "scope": "subscriptions/00000000-0000-0000-0000-000000000000",
    "status": "Enabled",
    "viewId": "/providers/Microsoft.CostManagement/views/swaggerExample"
  },
  "systemData": {
    "createdAt": "2020-06-18T22:21:51.1287144Z",
    "createdBy": "testuser",
    "createdByType": "User",
    "lastModifiedAt": "2020-06-19T22:21:51.1287144Z",
    "lastModifiedBy": "testuser",
    "lastModifiedByType": "User"
  }
}

Durum kodu:

201

{
  "name": "monthlyCostByResource",
  "type": "Microsoft.CostManagement/ScheduledActions",
  "eTag": "\"1d4ff9fe66f1d10\"",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/scheduledActions/monthlyCostByResource",
  "kind": "Email",
  "properties": {
    "displayName": "Monthly Cost By Resource",
    "fileDestination": {
      "fileFormats": [
        "Csv"
      ]
    },
    "notification": {
      "subject": "Cost by resource this month",
      "to": [
        "user@gmail.com",
        "team@gmail.com"
      ]
    },
    "schedule": {
      "daysOfWeek": [
        "Monday"
      ],
      "endDate": "2021-06-19T22:21:51.1287144Z",
      "frequency": "Monthly",
      "hourOfDay": 10,
      "startDate": "2020-06-19T22:21:51.1287144Z",
      "weeksOfMonth": [
        "First",
        "Third"
      ]
    },
    "scope": "subscriptions/00000000-0000-0000-0000-000000000000",
    "status": "Enabled",
    "viewId": "/providers/Microsoft.CostManagement/views/swaggerExample"
  },
  "systemData": {
    "createdAt": "2020-06-18T22:21:51.1287144Z",
    "createdBy": "testuser",
    "createdByType": "User",
    "lastModifiedAt": "2020-06-18T22:21:51.1287144Z",
    "lastModifiedBy": "testuser",
    "lastModifiedByType": "User"
  }
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
DaysOfWeek	Haftanın günleri.
ErrorDetailsWithNestedDetails	Hatanın ayrıntıları.
ErrorResponseWithNestedDetails	Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde sağlanır. Bazı Hata yanıtları: 429 TooManyRequests - İstek kısıtlandı. "x-ms-ratelimit-microsoft.consumption-retry-after" üst bilgisinde belirtilen süreyi bekledikten sonra yeniden deneyin. 503 ServiceUnavailable - Hizmet geçici olarak kullanılamıyor. "Yeniden Dene-Sonra" üst bilgisinde belirtilen süreyi bekledikten sonra yeniden deneyin.
FileDestination	Görünüm verilerinin hedefi. Bu isteğe bağlıdır. Şu anda yalnızca CSV biçimi desteklenmektedir.
FileFormat	Görünüm verilerinin hedefi. Şu anda yalnızca CSV biçimi desteklenmektedir.
NotificationProperties	Zamanlanan eylem bildiriminin özellikleri.
ScheduledAction	Zamanlanmış eylem tanımı.
ScheduledActionKind	Zamanlanmış eylemin türü.
ScheduledActionStatus	Zamanlanan eylemin durumu.
ScheduleFrequency	Zamanlamanın sıklığı.
ScheduleProperties	Zamanlamanın özellikleri.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
WeeksOfMonth	Ayın haftası.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DaysOfWeek

Numaralandırma

Haftanın günleri.

Değer	Description
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

ErrorDetailsWithNestedDetails

Nesne

Hatanın ayrıntıları.

Name	Tür	Description
code	string	Hata kodu.
details	ErrorDetailsWithNestedDetails[]	Hatanın ek ayrıntıları.
message	string	İşlemin neden başarısız olduğunu gösteren hata iletisi.

ErrorResponseWithNestedDetails

Nesne

Hata yanıtı, hizmetin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde sağlanır.

Bazı Hata yanıtları:

• 429 TooManyRequests - İstek kısıtlandı. "x-ms-ratelimit-microsoft.consumption-retry-after" üst bilgisinde belirtilen süreyi bekledikten sonra yeniden deneyin.

• 503 ServiceUnavailable - Hizmet geçici olarak kullanılamıyor. "Yeniden Dene-Sonra" üst bilgisinde belirtilen süreyi bekledikten sonra yeniden deneyin.

Name	Tür	Description
error	ErrorDetailsWithNestedDetails	Hatanın ayrıntıları.

FileDestination

Nesne

Görünüm verilerinin hedefi. Bu isteğe bağlıdır. Şu anda yalnızca CSV biçimi desteklenmektedir.

Name	Tür	Description
fileFormats	FileFormat[]	Görünüm verilerinin hedefi. Şu anda yalnızca CSV biçimi desteklenmektedir.

FileFormat

Numaralandırma

Görünüm verilerinin hedefi. Şu anda yalnızca CSV biçimi desteklenmektedir.

Değer	Description
Csv

NotificationProperties

Nesne

Zamanlanan eylem bildiriminin özellikleri.

Name	Tür	Description
language	string	E-postanın yerel ayarı.
message	string	E-postaya eklenecek isteğe bağlı ileti. Uzunluk 250 karakterle sınırlıdır.
regionalFormat	string	E-postadaki tarih/saat ve para birimi değerlerini biçimlendirmek için kullanılan bölgesel biçim.
subject	string	E-postanın konusu. Uzunluk 70 karakterle sınırlıdır.
to	string[]	E-posta adresleri dizisi.

ScheduledAction

Nesne

Zamanlanmış eylem tanımı.

Name	Tür	Description
eTag	string	Kaynak Etag'i. Güncelleştirme çağrıları için eTag isteğe bağlıdır ve iyimser eşzamanlılık elde etmek için belirtilebilir. Önce bir 'GET' çağrısı yaparak ve ardından güncelleştirmeyi gerçekleştirirken istek gövdesinin parçası olarak en son eTag'i veya 'If-Match' üst bilgisini ekleyerek kaynağın eTag'ini getirin. Çağrı oluşturmak için eTag gerekli değildir.
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	ScheduledActionKind	Zamanlanmış eylemin türü.
name	string	Kaynağın adı
properties.displayName	string	Zamanlanmış eylem adı.
properties.fileDestination	FileDestination	Görünüm verilerinin hedef biçimi. Bu isteğe bağlıdır.
properties.notification	NotificationProperties	Zamanlanmış eylem türüne göre bildirim özellikleri.
properties.notificationEmail	string	Abonelikten çıkma isteklerini ve bildirim e-postalarını alması gereken kişi noktasının e-posta adresi.
properties.schedule	ScheduleProperties	Zamanlanan eylemin zamanlaması.
properties.scope	string	Özel zamanlanmış eylem (Oluştur veya Güncelleştir) için kapsam boş olacaktır. Paylaşılan zamanlanmış eylem (Kapsama Göre Oluştur veya Güncelleştir) için Maliyet Yönetimi kapsamı, abonelik kapsamı için 'subscriptions/{subscriptionId}', resourceGroup kapsamı için 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', Ödeme Hesabı kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}', Departman kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}', 'providers/Microsoft' olabilir. EnrollmentAccount kapsamı için Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{enrollmentAccountId}', BillingProfile kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}', InvoiceSection kapsamı için 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}', '/providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' ExternalBillingAccount kapsamı ve ExternalSubscription kapsamı için '/providers/Microsoft.CostManagement/externalSubscriptions/{externalSubscriptionName}'.
properties.status	ScheduledActionStatus	Zamanlanan eylemin durumu.
properties.viewId	string	Zamanlanmış eylem için kullanılan maliyet analizi viewId değeri. Örneğin, '/providers/Microsoft.CostManagement/views/swaggerExample'
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ScheduledActionKind

Numaralandırma

Zamanlanmış eylemin türü.

Değer	Description
Email	Maliyet analizi verileri e-postayla gönderilir.
InsightAlert	Maliyet anomalisi bilgileri e-postayla gönderilir. Yalnızca günlük sıklıkta abonelik kapsamında kullanılabilir. Kaynakta herhangi bir anomali algılanırsa e-posta gönderilmez.

ScheduledActionStatus

Numaralandırma

Zamanlanan eylemin durumu.

Değer	Description
Enabled	Zamanlanmış eylem kaydedilir ve çalıştırılır.
Expired	Zamanlanan eylemin süresi doldu.
Disabled	Zamanlanmış eylem kaydedilir ancak çalıştırılmaz.

ScheduleFrequency

Numaralandırma

Zamanlamanın sıklığı.

Değer	Description
Daily	Maliyet analizi verileri her gün e-postayla gönderilir.
Weekly	Maliyet analizi verileri her hafta e-postayla gönderilir.
Monthly	Maliyet analizi verileri her ay e-postayla gönderilir.

ScheduleProperties

Nesne

Zamanlamanın özellikleri.

Name	Tür	Description
dayOfMonth	integer (int32)	Maliyet analizi verilerinin e-postayla gönderileceği UTC günü. 1 ile 31 arasında olmalıdır. Bu özellik, sıklık Aylık olduğunda ve weeksOfMonth veya daysOfWeek'i geçersiz kıldığında geçerlidir.
daysOfWeek	DaysOfWeek[]	Maliyet analizi verilerinin e-postayla gönderileceği İngilizce gün adları. Bu özellik, sıklık Haftalık veya Aylık olduğunda geçerlidir.
endDate	string (date-time)	Zamanlanan eylemin bitiş tarihi ve saati (UTC).
frequency	ScheduleFrequency	Zamanlamanın sıklığı.
hourOfDay	integer (int32)	Maliyet analizi verilerinin e-postayla gönderileceği UTC saati.
startDate	string (date-time)	Zamanlanan eylemin başlangıç tarihi ve saati (UTC).
weeksOfMonth	WeeksOfMonth[]	Maliyet analizi verilerinin e-postayla gönderileceği haftalar. Sıklık Aylık olduğunda ve daysOfWeek ile birlikte kullanıldığında bu özellik geçerlidir.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

WeeksOfMonth

Numaralandırma

Ayın haftası.

Değer	Description
First
Second
Third
Fourth
Last