Public Maintenance Configurations - Get

Layanan:: Maintenance

Versi API:: 2023-09-01-preview

Mendapatkan catatan Konfigurasi Pemeliharaan Publik

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/{resourceName}?api-version=2023-09-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceName	path	True	string	Nama Konfigurasi Pemeliharaan
subscriptionId	path	True	string	Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien.

Respons

Nama	Jenis	Deskripsi
200 OK	MaintenanceConfiguration	OKE
Other Status Codes	MaintenanceError	BadRequest

Contoh

PublicMaintenanceConfigurations_GetForResource

Permintaan sampel

HTTP

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/configuration1?api-version=2023-09-01-preview

Respon sampel

Kode status:: 200

{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/configuration1",
  "name": "configuration1",
  "location": "westus2",
  "properties": {
    "namespace": "Microsoft.Maintenance",
    "maintenanceScope": "SQLDB",
    "visibility": "Public",
    "maintenanceWindow": {
      "startDateTime": "2020-04-30 08:00",
      "expirationDateTime": "9999-12-31 00:00",
      "duration": "05:00",
      "timeZone": "Pacific Standard Time",
      "recurEvery": "2Weeks"
    }
  }
}

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorDetails	Detail respons kesalahan yang diterima dari layanan Pemeliharaan Azure.
InputLinuxParameters	Input properti untuk menambal komputer Linux.
InputPatchConfiguration	Konfigurasi input untuk eksekusi patch
InputWindowsParameters	Properti input untuk menambal komputer Windows.
MaintenanceConfiguration	Jenis catatan konfigurasi pemeliharaan
MaintenanceError	Respons kesalahan diterima dari layanan Pemeliharaan Azure.
MaintenanceScope	Mendapatkan atau mengatur maintenanceScope konfigurasi
RebootOptions	Kemungkinan preferensi boot ulang seperti yang didefinisikan oleh pengguna berdasarkan yang akan diputuskan untuk me-reboot komputer atau tidak setelah operasi patch selesai.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
Visibility	Mendapatkan atau mengatur visibilitas konfigurasi. Nilai defaultnya adalah 'Kustom'

createdByType

Enumeration

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorDetails

Objek

Detail respons kesalahan yang diterima dari layanan Pemeliharaan Azure.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan yang ditentukan layanan. Kode ini berfungsi sebagai sub-status untuk kode kesalahan HTTP yang ditentukan dalam respons.
message	string	Representasi kesalahan yang dapat dibaca manusia.

InputLinuxParameters

Objek

Input properti untuk menambal komputer Linux.

Nama	Jenis	Deskripsi
classificationsToInclude	string[]	Kategori klasifikasi patch yang akan di-patch. Nilai yang diizinkan adalah 'Kritis', 'Keamanan', dan 'Lainnya'.
packageNameMasksToExclude	string[]	Nama paket yang akan dikecualikan untuk patching.
packageNameMasksToInclude	string[]	Nama paket yang akan disertakan untuk patching.

InputPatchConfiguration

Objek

Konfigurasi input untuk eksekusi patch

Nama	Jenis	Nilai default	Deskripsi
linuxParameters	InputLinuxParameters		Parameter input khusus untuk menambal komputer Linux. Untuk komputer Windows, jangan lewati properti ini.
rebootSetting	RebootOptions	IfRequired	Kemungkinan preferensi boot ulang seperti yang didefinisikan oleh pengguna berdasarkan yang akan diputuskan untuk me-reboot komputer atau tidak setelah operasi patch selesai.
windowsParameters	InputWindowsParameters		Parameter input khusus untuk menambal komputer Windows. Untuk komputer Linux, jangan lewati properti ini.

InputWindowsParameters

Objek

Properti input untuk menambal komputer Windows.

Nama	Jenis	Deskripsi
classificationsToInclude	string[]	Kategori klasifikasi patch yang akan di-patch. Nilai yang diizinkan adalah 'Kritis', 'Keamanan', 'UpdateRollup', 'FeaturePack', 'ServicePack', 'Definisi', 'Alat', dan 'Pembaruan'.
excludeKbsRequiringReboot	boolean	Mengecualikan patch yang perlu di-boot ulang
kbNumbersToExclude	string[]	Windows KBID yang akan dikecualikan untuk patching.
kbNumbersToInclude	string[]	Windows KBID yang akan disertakan untuk patching.

MaintenanceConfiguration

Objek

Jenis catatan konfigurasi pemeliharaan

Nama	Jenis	Deskripsi
id	string	Pengidentifikasi sumber daya yang sepenuhnya memenuhi syarat
location	string	Mendapatkan atau mengatur lokasi sumber daya
name	string	Nama sumber daya
properties.extensionProperties	object	Mendapatkan atau mengatur extensionProperties dari maintenanceConfiguration
properties.installPatches	InputPatchConfiguration	Parameter input yang akan diteruskan ke operasi eksekusi patch.
properties.maintenanceScope	MaintenanceScope	Mendapatkan atau mengatur maintenanceScope konfigurasi
properties.maintenanceWindow.duration	string	Durasi jendela pemeliharaan dalam format HH:mm. Jika tidak disediakan, nilai default akan digunakan berdasarkan cakupan pemeliharaan yang disediakan. Contoh: 05:00.
properties.maintenanceWindow.expirationDateTime	string	Tanggal kedaluwarsa efektif jendela pemeliharaan dalam format YYYY-MM-DD hh:mm. Jendela akan dibuat di zona waktu yang disediakan dan disesuaikan dengan penghematan siang hari sesuai dengan zona waktu tersebut. Tanggal kedaluwarsa harus diatur ke tanggal mendatang. Jika tidak disediakan, itu akan diatur ke tanggalwaktu maksimum 9999-12-31 23:59:59.
properties.maintenanceWindow.recurEvery	string	Laju di mana jendela Pemeliharaan diharapkan berulang. Tarif dapat dinyatakan sebagai jadwal harian, mingguan, atau bulanan. Jadwal harian diformat sebagai recurEvery: [Frekuensi sebagai bilangan bulat]['Hari']. Jika tidak ada frekuensi yang disediakan, frekuensi defaultnya adalah 1. Contoh jadwal harian adalah recurEvery: Day, recurEvery: 3Days. Jadwal mingguan diformat sebagai recurEvery: [Frekuensi sebagai bilangan bulat]['Minggu'] [Daftar terpisah koma opsional hari kerja Senin-Minggu]. Contoh jadwal mingguan adalah recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Jadwal bulanan diformat sebagai [Frekuensi sebagai bilangan bulat]['Bulan'] [Daftar hari bulanan yang dipisahkan koma] atau [Frekuensi sebagai bilangan bulat]['Bulan'] [Minggu Dalam Bulan (Pertama, Kedua, Ketiga, Keempat, Terakhir)] [Mingguan Senin-Minggu] [Offset Opsional(Tidak. hari)]. Nilai offset harus antara -6 hingga 6 inklusif. Contoh jadwal bulanan adalah recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6.
properties.maintenanceWindow.startDateTime	string	Tanggal mulai efektif jendela pemeliharaan dalam format YYYY-MM-DD hh:mm. Tanggal mulai dapat diatur ke tanggal saat ini atau tanggal mendatang. Jendela akan dibuat di zona waktu yang disediakan dan disesuaikan dengan penghematan siang hari sesuai dengan zona waktu tersebut.
properties.maintenanceWindow.timeZone	string	Nama zona waktu. Daftar zona waktu dapat diperoleh dengan mengeksekusi [System.TimeZoneInfo]::GetSystemTimeZones() di PowerShell. Contoh: Waktu Standar Pasifik, UTC, W. Waktu Standar Eropa, Waktu Standar Korea, Cen. Waktu Standar Australia.
properties.namespace	string	Mendapatkan atau mengatur namespace sumber daya
properties.visibility	Visibility	Mendapatkan atau mengatur visibilitas konfigurasi. Nilai defaultnya adalah 'Kustom'
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Mendapatkan atau mengatur tag sumber daya
type	string	Jenis sumber daya

MaintenanceError

Objek

Respons kesalahan diterima dari layanan Pemeliharaan Azure.

Nama	Jenis	Deskripsi
error	ErrorDetails	Detail kesalahan

MaintenanceScope

Enumeration

Mendapatkan atau mengatur maintenanceScope konfigurasi

Nilai	Deskripsi
Host	Cakupan pemeliharaan ini mengontrol penginstalan pembaruan platform azure yaitu layanan pada simpul fisik yang menghosting VM pelanggan.
Resource	Cakupan pemeliharaan ini mengontrol pemeliharaan pembaruan default Sumber Daya Azure
OSImage	Cakupan pemeliharaan ini mengontrol penginstalan gambar os pada VM/VMSS
Extension	Cakupan pemeliharaan ini mengontrol penginstalan ekstensi pada VM/VMSS
InGuestPatch	Cakupan pemeliharaan ini mengontrol penginstalan paket windows dan linux pada VM/VMSS
SQLDB	Cakupan pemeliharaan ini mengontrol penginstalan pembaruan platform server SQL.
SQLManagedInstance	Cakupan pemeliharaan ini mengontrol penginstalan pembaruan platform instans terkelola SQL.

RebootOptions

Enumeration

Kemungkinan preferensi boot ulang seperti yang didefinisikan oleh pengguna berdasarkan yang akan diputuskan untuk me-reboot komputer atau tidak setelah operasi patch selesai.

Nilai	Deskripsi
IfRequired
Never
Always

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Visibility

Enumeration

Mendapatkan atau mengatur visibilitas konfigurasi. Nilai defaultnya adalah 'Kustom'

Nilai	Deskripsi
Custom	Hanya terlihat oleh pengguna dengan izin.
Public	Terlihat oleh semua pengguna.

Bagikan melalui

Public Maintenance Configurations - Get

Parameter URI

Respons

Contoh

PublicMaintenanceConfigurations_GetForResource

Permintaan sampel

Respon sampel

Definisi

createdByType

ErrorDetails

InputLinuxParameters

InputPatchConfiguration

InputWindowsParameters

MaintenanceConfiguration

MaintenanceError

MaintenanceScope

RebootOptions

systemData

Visibility