Perbarui Jadwal Laporan

curl --request PUT \
  --url https://api.altostrat.io/sla/schedules/{scheduleId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Ringkasan SLA Eksekutif Bulanan",
  "disabled": false,
  "daily": true,
  "weekly": true,
  "monthly": true,
  "day_of_week": "monday",
  "day_of_month": 1,
  "sla_target": 99.95,
  "show_only_breached_sites_in_pdf": false,
  "calculate_sla_within_schedule_hours": true,
  "business_hours_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "site_selection_mode": "tags",
  "site_selection_logic": "or",
  "site_selection_rules": [
    {
      "key": "Region",
      "value": "APAC"
    }
  ],
  "grouping_rules": [
    {
      "key": "Region",
      "aggregation": "avg"
    }
  ],
  "sites": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "recipients": [
    "e47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "timezone": "Australia/Sydney",
  "ignore_power_outages": false,
  "notification_group": "network_admins_group"
}'

{
  "id": "sla_2ayc4Yy6w3g7Y2j4g4g4Yy6w3g7",
  "name": "Ringkasan SLA Eksekutif Bulanan",
  "disabled": false,
  "daily": true,
  "weekly": true,
  "monthly": true,
  "day_of_week": "monday",
  "day_of_month": 1,
  "sla_target": 99.95,
  "show_only_breached_sites_in_pdf": false,
  "calculate_sla_within_schedule_hours": true,
  "business_hours_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "site_selection_mode": "tags",
  "site_selection_logic": "or",
  "site_selection_rules": [
    {
      "key": "Region",
      "value": "APAC"
    }
  ],
  "grouping_rules": [
    {
      "key": "Region",
      "aggregation": "avg"
    }
  ],
  "sites": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "recipients": [
    "e47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "timezone": "Australia/Sydney",
  "ignore_power_outages": false,
  "notification_group": "network_admins_group",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

PUT

sla

schedules

{scheduleId}

Perbarui Jadwal Laporan

curl --request PUT \
  --url https://api.altostrat.io/sla/schedules/{scheduleId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Ringkasan SLA Eksekutif Bulanan",
  "disabled": false,
  "daily": true,
  "weekly": true,
  "monthly": true,
  "day_of_week": "monday",
  "day_of_month": 1,
  "sla_target": 99.95,
  "show_only_breached_sites_in_pdf": false,
  "calculate_sla_within_schedule_hours": true,
  "business_hours_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "site_selection_mode": "tags",
  "site_selection_logic": "or",
  "site_selection_rules": [
    {
      "key": "Region",
      "value": "APAC"
    }
  ],
  "grouping_rules": [
    {
      "key": "Region",
      "aggregation": "avg"
    }
  ],
  "sites": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "recipients": [
    "e47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "timezone": "Australia/Sydney",
  "ignore_power_outages": false,
  "notification_group": "network_admins_group"
}'

{
  "id": "sla_2ayc4Yy6w3g7Y2j4g4g4Yy6w3g7",
  "name": "Ringkasan SLA Eksekutif Bulanan",
  "disabled": false,
  "daily": true,
  "weekly": true,
  "monthly": true,
  "day_of_week": "monday",
  "day_of_month": 1,
  "sla_target": 99.95,
  "show_only_breached_sites_in_pdf": false,
  "calculate_sla_within_schedule_hours": true,
  "business_hours_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "site_selection_mode": "tags",
  "site_selection_logic": "or",
  "site_selection_rules": [
    {
      "key": "Region",
      "value": "APAC"
    }
  ],
  "grouping_rules": [
    {
      "key": "Region",
      "aggregation": "avg"
    }
  ],
  "sites": [
    "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "recipients": [
    "e47ac10b-58cc-4372-a567-0e02b2c3d479"
  ],
  "timezone": "Australia/Sydney",
  "ignore_power_outages": false,
  "notification_group": "network_admins_group",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Masukkan token autentikasi Anda.

Path Parameters

scheduleId

string

required

Pengidentifikasi unik untuk jadwal laporan SLA yang akan diperbarui, diawali dengan sla_.

Example:

"sla_2ayc4Yy6w3g7Y2j4g4g4Yy6w3g7"

Body

application/json

Konfigurasi jadwal laporan SLA yang diperbarui.

Properti yang diperlukan untuk membuat atau memperbarui jadwal laporan SLA.

name

string

required

Nama yang mudah dibaca untuk jadwal laporan.

Example:

"Ringkasan SLA Eksekutif Bulanan"

sla_target

number

required

Persentase target SLA. Situs dengan uptime di bawah nilai ini akan ditandai sebagai pelanggaran.

Example:

99.95

business_hours_id

string<uuid>

required

UUID dari jadwal Jam Kerja yang akan digunakan untuk perhitungan SLA.

Example:

"a1b2c3d4-e5f6-7890-1234-567890abcdef"

site_selection_mode

enum<string>

required

Menentukan bagaimana situs dipilih untuk laporan. manual menggunakan array sites. tags menggunakan pemilihan dinamis berdasarkan site_selection_rules.

Opsi yang tersedia:

manual,

tags

Example:

"tags"

timezone

string

required

Pengidentifikasi zona waktu IANA untuk menjadwalkan laporan (misalnya, 'America/New_York'). Laporan berjalan pada pukul 8 pagi di zona waktu ini.

Example:

"Australia/Sydney"

notification_group

string

required

ID grup notifikasi untuk mengirim laporan.

Example:

"network_admins_group"

disabled

boolean

default:false

Jika benar, jadwal dijeda dan tidak akan menghasilkan laporan secara otomatis.

daily

boolean

Jika benar, laporan berjalan setiap hari. Hanya satu dari daily, weekly, atau monthly yang boleh bernilai benar.

weekly

boolean

Jika benar, laporan berjalan seminggu sekali pada day_of_week yang ditentukan.

monthly

boolean

Jika benar, laporan berjalan sebulan sekali pada day_of_month yang ditentukan.

day_of_week

enum<string>

Diperlukan jika weekly bernilai benar. Hari dalam seminggu untuk menjalankan laporan.

Opsi yang tersedia:

monday,

tuesday,

wednesday,

thursday,

friday,

saturday,

sunday

Example:

"monday"

day_of_month

integer

Diperlukan jika monthly bernilai benar. Tanggal dalam bulan untuk menjalankan laporan.

Required range: 1 <= x <= 28

Example:

1

show_only_breached_sites_in_pdf

boolean

default:false

Jika benar, PDF yang dihasilkan hanya akan mencantumkan situs yang melanggar target SLA.

calculate_sla_within_schedule_hours

boolean

default:true

Jika benar, SLA hanya dihitung dalam jam kerja yang ditentukan. Jika salah, dihitung selama 24/7.

site_selection_logic

enum<string>

Ketika site_selection_mode adalah tags, ini menentukan bagaimana beberapa aturan digabungkan. or menyertakan situs yang cocok dengan aturan apa pun. and menyertakan situs yang cocok dengan semua aturan.

Opsi yang tersedia:

or,

and

Example:

"or"

site_selection_rules

object[]

Daftar aturan untuk memilih situs secara dinamis berdasarkan tag. Diperlukan jika site_selection_mode adalah tags.

Tampilkan atribut turunan

grouping_rules

object[]

Daftar aturan opsional untuk mengelompokkan situs dalam laporan berdasarkan nilai tag tertentu (misalnya, kelompokkan berdasarkan 'Region').

Tampilkan atribut turunan

sites

string<uuid>[]

Daftar UUID situs untuk disertakan dalam laporan. Diperlukan jika site_selection_mode adalah manual.

recipients

string<uuid>[]

Daftar UUID penerima untuk diberi tahu saat laporan sudah siap.

ignore_power_outages

boolean

default:false

Jika benar, waktu henti yang disebabkan oleh pemadaman listrik akan dikecualikan dari perhitungan SLA.

Response

Jadwal berhasil diperbarui.

Konfigurasi untuk laporan SLA terjadwal.

string

Pengidentifikasi unik yang dibuat server untuk jadwal, diawali dengan sla_.

Example:

"sla_2ayc4Yy6w3g7Y2j4g4g4Yy6w3g7"

name

string

Nama yang mudah dibaca untuk jadwal laporan.

Example:

"Ringkasan SLA Eksekutif Bulanan"

disabled

boolean

default:false

Jika benar, jadwal dijeda dan tidak akan menghasilkan laporan secara otomatis.

daily

boolean

Jika benar, laporan berjalan setiap hari. Hanya satu dari daily, weekly, atau monthly yang boleh bernilai benar.

weekly

boolean

Jika benar, laporan berjalan seminggu sekali pada day_of_week yang ditentukan.

monthly

boolean

Jika benar, laporan berjalan sebulan sekali pada day_of_month yang ditentukan.

day_of_week

enum<string>

Hari dalam seminggu untuk menjalankan laporan jika weekly bernilai benar.

Opsi yang tersedia:

monday,

tuesday,

wednesday,

thursday,

friday,

saturday,

sunday

Example:

"monday"

day_of_month

integer

Tanggal dalam bulan untuk menjalankan laporan jika monthly bernilai benar.

Required range: 1 <= x <= 28

Example:

1

sla_target

number

Persentase target SLA. Situs dengan uptime di bawah nilai ini akan ditandai sebagai pelanggaran.

Example:

99.95

show_only_breached_sites_in_pdf

boolean

default:false

Jika benar, PDF yang dihasilkan hanya akan mencantumkan situs yang melanggar target SLA.

calculate_sla_within_schedule_hours

boolean

default:true

Jika benar, SLA hanya dihitung dalam jam kerja yang ditentukan. Jika salah, dihitung selama 24/7.

business_hours_id

string<uuid>

UUID dari jadwal Jam Kerja yang akan digunakan untuk perhitungan SLA.

Example:

"a1b2c3d4-e5f6-7890-1234-567890abcdef"

site_selection_mode

enum<string>

Menentukan bagaimana situs dipilih untuk laporan. manual menggunakan array sites. tags menggunakan pemilihan dinamis berdasarkan site_selection_rules.

Opsi yang tersedia:

manual,

tags

Example:

"tags"

site_selection_logic

enum<string>

Opsi yang tersedia:

or,

and

Example:

"or"

site_selection_rules

object[]

Daftar aturan untuk memilih situs secara dinamis berdasarkan tag. Diperlukan jika site_selection_mode adalah tags.

Tampilkan atribut turunan

grouping_rules

object[]

Daftar aturan opsional untuk mengelompokkan situs dalam laporan berdasarkan nilai tag tertentu (misalnya, kelompokkan berdasarkan 'Region').

Tampilkan atribut turunan

sites

string<uuid>[]

Daftar UUID situs untuk disertakan dalam laporan. Diperlukan jika site_selection_mode adalah manual.

recipients

string<uuid>[]

Daftar UUID penerima untuk diberi tahu saat laporan sudah siap.

timezone

string

Pengidentifikasi zona waktu IANA untuk menjadwalkan laporan (misalnya, 'America/New_York'). Laporan berjalan pada pukul 8 pagi di zona waktu ini.

Example:

"Australia/Sydney"

ignore_power_outages

boolean

default:false

Jika benar, waktu henti yang disebabkan oleh pemadaman listrik akan dikecualikan dari perhitungan SLA.

notification_group

string | null

ID grup notifikasi untuk mengirim laporan.

Example:

"network_admins_group"

created_at

string<date-time>

Stempel waktu saat jadwal dibuat.

updated_at

string<date-time>

Stempel waktu saat jadwal terakhir diperbarui.

⌘I

Mulai

Platform & Identitas

Manajemen & Orkestrasi Perangkat

Otomatisasi & AI

Layanan Jaringan & Konektivitas

Keamanan & Manajemen Ancaman

Pemantauan & Analitik

Layanan & Utilitas Inti

Perbarui Jadwal Laporan

Authorizations

Path Parameters

Body

Response