Maintenance Events - List

Geeft alle onderhoudsgebeurtenissen voor een flexibele server weer op.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/maintenanceEvents?api-version=2026-04-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{serverName}/maintenanceEvents?api-version=2026-04-01-preview&maintenanceStatus={maintenanceStatus}

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resource group. De naam is hoofdletterongevoelig.

serverName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*

De naam van de server.

subscriptionId
path True

string (uuid)

De ID van het doelabonnement. De waarde moet een UUID zijn.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

maintenanceStatus
query

MaintenanceEventStatusFilter

Filter onderhoudsgebeurtenissen op status.

Antwoorden

Name Type Description
200 OK

MaintenanceEventResourceListResult

Azure-operatie succesvol voltooid.

Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

List maintenance events filtered by status for a server.
List ongoing and scheduled maintenance events for a server.

List maintenance events filtered by status for a server.

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/maintenanceEvents?api-version=2026-04-01-preview&maintenanceStatus=Upcoming

Voorbeeldrespons

{
  "value": [
    {
      "properties": {
        "maintenanceEventId": "XXXX-111",
        "maintenanceType": "PlannedMaintenance",
        "originalStartTime": "2026-04-02T07:23:00Z",
        "status": "Planned",
        "startTime": "2026-04-02T07:23:00Z",
        "endTime": "2026-04-02T08:23:00Z",
        "estimatedDowntime": "PT3600S",
        "deferrable": true,
        "deferralDeadline": "2026-04-16T07:23:00Z",
        "lastUpdatedTime": "2026-04-01T07:23:15.9626227Z"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/maintenanceEvents/XXXX-111",
      "name": "XXXX-111",
      "type": "Microsoft.DBforPostgreSQL/flexibleServers/maintenanceEvents"
    },
    {
      "properties": {
        "maintenanceEventId": "XXXX-222",
        "maintenanceType": "PlannedMaintenance",
        "originalStartTime": "2026-04-03T07:23:00Z",
        "status": "Planned",
        "startTime": "2026-04-03T08:23:00Z",
        "endTime": "2026-04-03T09:23:00Z",
        "estimatedDowntime": "PT3540S",
        "deferrable": true,
        "deferralDeadline": "2026-04-18T18:31:00Z",
        "lastUpdatedTime": "2026-04-02T07:23:15.9626227Z"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/maintenanceEvents/XXXX-222",
      "name": "XXXX-222",
      "type": "Microsoft.DBforPostgreSQL/flexibleServers/maintenanceEvents"
    }
  ]
}

List ongoing and scheduled maintenance events for a server.

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/maintenanceEvents?api-version=2026-04-01-preview

Voorbeeldrespons

{
  "value": [
    {
      "properties": {
        "maintenanceEventId": "XXXX-111",
        "maintenanceType": "PlannedMaintenance",
        "originalStartTime": "2026-04-02T07:23:00Z",
        "status": "Planned",
        "startTime": "2026-04-02T07:23:00Z",
        "endTime": "2026-04-02T08:23:00Z",
        "estimatedDowntime": "PT3600S",
        "deferrable": true,
        "deferralDeadline": "2026-04-16T07:23:00Z",
        "lastUpdatedTime": "2026-04-01T07:23:15.9626227Z"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/maintenanceEvents/XXXX-111",
      "name": "XXXX-111",
      "type": "Microsoft.DBforPostgreSQL/flexibleServers/maintenanceEvents"
    },
    {
      "properties": {
        "maintenanceEventId": "XXXX-222",
        "maintenanceType": "PlannedMaintenance",
        "originalStartTime": "2026-04-03T07:23:00Z",
        "status": "Planned",
        "startTime": "2026-04-03T08:23:00Z",
        "endTime": "2026-04-03T09:23:00Z",
        "estimatedDowntime": "PT3540S",
        "deferrable": true,
        "deferralDeadline": "2026-04-18T18:31:00Z",
        "lastUpdatedTime": "2026-04-02T07:23:15.9626227Z"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/exampleresourcegroup/providers/Microsoft.DBforPostgreSQL/flexibleServers/exampleserver/maintenanceEvents/XXXX-222",
      "name": "XXXX-222",
      "type": "Microsoft.DBforPostgreSQL/flexibleServers/maintenanceEvents"
    }
  ]
}

Definities

Name Description
createdByType

Het identiteitstype dat de resource heeft gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

Het foutdetail.

ErrorResponse

Foutreactie

MaintenanceEventResource

Onderhoudsgebeurtenisbron voor een flexibele PostgreSQL-server.

MaintenanceEventResourceListResult

De reactie van een MaintenanceEventResource-lijstoperatie.

MaintenanceEventResourceProperties

Eigenschappen van een onderhoudsevenementresource.

MaintenanceEventStatus

De status van een onderhoudsgebeurtenis.

MaintenanceEventStatusFilter

Filter onderhoudsgebeurtenissen op status.

MaintenanceType

Soort onderhoudsevenementenbron.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Het identiteitstype dat de resource heeft gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

Het foutdetail.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.

code

string

De foutcode.

details

ErrorDetail[]

De foutgegevens.

message

string

Het foutbericht.

target

string

Het foutdoelwit.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

MaintenanceEventResource

Onderhoudsgebeurtenisbron voor een flexibele PostgreSQL-server.

Name Type Description
id

string (arm-id)

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"

name

string

De naam van de resource

properties

MaintenanceEventResourceProperties

De resourcespecifieke eigenschappen voor deze resource.

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

MaintenanceEventResourceListResult

De reactie van een MaintenanceEventResource-lijstoperatie.

Name Type Description
nextLink

string (uri)

De koppeling naar de volgende pagina met items

value

MaintenanceEventResource[]

De MaintenanceEventResource-items op deze pagina

MaintenanceEventResourceProperties

Eigenschappen van een onderhoudsevenementresource.

Name Type Description
deferrable

boolean

Een waarde die aangeeft of dit onderhoudsevenement door de klant opnieuw kan worden ingepland.

deferralDeadline

string (date-time)

De laatste datum/tijd van dit onderhoudsmoment kan worden uitgesteld naar (UTC). Alleen aanwezig wanneer uitstel waar is.

description

string

De door mensen leesbare beschrijving van het onderhoudsevenement.

endTime

string (date-time)

De geplande eindtijd van het onderhoudsevenement (UTC).

estimatedDowntime

string

De geschatte downtime als een ISO 8601 duurstring (bijv. 'PT60S' = 60 seconden).

lastUpdatedTime

string (date-time)

Wanneer dit onderhoudsgebeurtenisrecord voor het laatst is bijgewerkt (UTC).

maintenanceEventId

string

Een door de service gegenereerde identificatie voor dit onderhoudsevenement, toegewezen door het platform (bijv. 'YL1T-HFG'). Het format is niet contractueel en klanten zouden niet moeten proberen deze waarde te interpreteren of te construeren.

maintenanceType

MaintenanceType

Het onderhoudstype (bijv. 'GeplandOnderhoud').

originalStartTime

string (date-time)

De initiële geplande starttijd vóór een eventuele herplanning (UTC). Gelijk aan startTime wanneer het evenement nooit is verplaatst.

rescheduledFrom

string (date-time)

De eerder geplande starttijd vóór de meest recente herplanning (UTC). Nietig als het evenement nooit is verplaatst.

startTime

string (date-time)

De geplande starttijd van het onderhoudsevenement (UTC).

status

MaintenanceEventStatus

De klantgerichte status van het onderhoudsevenement.

MaintenanceEventStatus

De status van een onderhoudsgebeurtenis.

Waarde Description
Planned

Het onderhoudsproject staat gepland en is nog niet begonnen.

InProgress

Het onderhoudsproject is momenteel aan de gang.

Complete

Het onderhoudsproject is succesvol afgerond.

Rescheduled

Het onderhoudsevenement is door de klant verplaatst (uitgesteld).

Canceled

Het onderhoudsevenement werd geannuleerd, mislukt of had een tijdslimiet.

MaintenanceEventStatusFilter

Filter onderhoudsgebeurtenissen op status.

Waarde Description
Upcoming

Stuur gebeurtenissen terug die een geplande of lopende status hebben.

Past

Stuur gebeurtenissen terug met een voltooide status.

MaintenanceType

Soort onderhoudsevenementenbron.

Waarde Description
PlannedMaintenance

Gepland onderhoudsevenement.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het aanmaken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het identiteitstype dat de resource heeft gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.