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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resource group. De naam is hoofdletterongevoelig. |
|
server
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)* |
De naam van de server. |
|
subscription
|
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. |
|
maintenance
|
query |
Filter onderhoudsgebeurtenissen op status. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
Azure-operatie succesvol voltooid. |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Het identiteitstype dat de resource heeft gemaakt. |
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
Het foutdetail. |
|
Error |
Foutreactie |
|
Maintenance |
Onderhoudsgebeurtenisbron voor een flexibele PostgreSQL-server. |
|
Maintenance |
De reactie van een MaintenanceEventResource-lijstoperatie. |
|
Maintenance |
Eigenschappen van een onderhoudsevenementresource. |
|
Maintenance |
De status van een onderhoudsgebeurtenis. |
|
Maintenance |
Filter onderhoudsgebeurtenissen op status. |
|
Maintenance |
Soort onderhoudsevenementenbron. |
|
system |
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 |
Aanvullende informatie over de fout. |
|
| code |
string |
De foutcode. |
| details |
De foutgegevens. |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het foutdoelwit. |
ErrorResponse
Foutreactie
| Name | Type | Description |
|---|---|---|
| error |
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 |
De resourcespecifieke eigenschappen voor deze resource. |
|
| 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 |
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 |
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 |
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 |
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 |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |