Delen via


Maintenance Configurations - List By Managed Cluster

Hiermee haalt u een lijst met onderhoudsconfiguraties op in het opgegeven beheerde cluster.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/maintenanceConfigurations?api-version=2025-04-01

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

resourceName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

De naam van de beheerde clusterresource.

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.

Antwoorden

Name Type Description
200 OK

MaintenanceConfigurationListResult

OK

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

List maintenance configurations by Managed Cluster
List maintenance configurations configured with maintenance window by Managed Cluster

List maintenance configurations by Managed Cluster

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations?api-version=2025-04-01

Voorbeeldrespons

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/default",
      "name": "default",
      "properties": {
        "timeInWeek": [
          {
            "day": "Monday",
            "hourSlots": [
              1,
              2
            ]
          }
        ],
        "notAllowedTime": [
          {
            "start": "2020-11-26T03:00:00Z",
            "end": "2020-11-30T12:00:00Z"
          }
        ]
      }
    }
  ]
}

List maintenance configurations configured with maintenance window by Managed Cluster

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations?api-version=2025-04-01

Voorbeeldrespons

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/aksManagedNodeOSUpgradeSchedule",
      "name": "aksManagedNodeOSUpgradeSchedule",
      "properties": {
        "maintenanceWindow": {
          "schedule": {
            "daily": {
              "intervalDays": 5
            }
          },
          "durationHours": 10,
          "utcOffset": "-07:00",
          "startDate": "2023-01-01",
          "startTime": "13:30"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
      "name": "aksManagedAutoUpgradeSchedule",
      "properties": {
        "maintenanceWindow": {
          "schedule": {
            "absoluteMonthly": {
              "intervalMonths": 3,
              "dayOfMonth": 15
            }
          },
          "durationHours": 5,
          "utcOffset": "+00:00",
          "startDate": "2023-01-01",
          "startTime": "08:30",
          "notAllowedDates": [
            {
              "start": "2023-02-18",
              "end": "2023-02-25"
            },
            {
              "start": "2023-12-23",
              "end": "2024-01-05"
            }
          ]
        }
      }
    }
  ]
}

Definities

Name Description
AbsoluteMonthlySchedule

Voor schema's zoals: 'elke maand terugkeren op de 15e' of 'elke 3 maanden op de 20e'.

CloudError

Een foutreactie van de Container-service.

CloudErrorBody

Een foutreactie van de Container-service.

createdByType

Het type identiteit waarmee de resource is gemaakt.

DailySchedule

Voor schema's zoals: 'elke dag terugkeren' of 'elke 3 dagen terugkeren'.

DateSpan

Een datumbereik.

MaintenanceConfiguration

Configuratie van gepland onderhoud, die wordt gebruikt om te configureren wanneer updates kunnen worden geïmplementeerd in een beheerd cluster.

MaintenanceConfigurationListResult

Het antwoord van de bewerking Onderhoudsconfiguraties vermelden.

MaintenanceWindow

Onderhoudsvenster dat wordt gebruikt voor het configureren van geplande automatische upgrade voor een beheerd cluster.

RelativeMonthlySchedule

Voor schema's zoals: 'elke maand terugkeren op de eerste maandag' of 'elke 3 maanden op afgelopen vrijdag'.

Schedule

Er moet slechts één van de schematypen worden opgegeven. Kies 'dagelijks', 'wekelijks', 'absoluteMonthly' of 'relativeMonthly' voor uw onderhoudsplanning.

systemData

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

TimeInWeek

Tijd in een week.

TimeSpan

Een tijdsbereik.

type

De weekindex.

WeekDay

De weekdag enum.

WeeklySchedule

Voor schema's zoals: 'elke maandag terugkeren' of 'elke 3 weken op woensdag'.

AbsoluteMonthlySchedule

Voor schema's zoals: 'elke maand terugkeren op de 15e' of 'elke 3 maanden op de 20e'.

Name Type Description
dayOfMonth

integer (int32)

minimum: 1
maximum: 31

De datum van de maand.

intervalMonths

integer (int32)

minimum: 1
maximum: 6

Hiermee geeft u het aantal maanden tussen elke set exemplaren.

CloudError

Een foutreactie van de Container-service.

Name Type Description
error

CloudErrorBody

Details over de fout.

CloudErrorBody

Een foutreactie van de Container-service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

details

CloudErrorBody[]

Een lijst met aanvullende informatie over de fout.

message

string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

target

string

Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
Application
Key
ManagedIdentity
User

DailySchedule

Voor schema's zoals: 'elke dag terugkeren' of 'elke 3 dagen terugkeren'.

Name Type Description
intervalDays

integer (int32)

minimum: 1
maximum: 7

Hiermee geeft u het aantal dagen tussen elke set exemplaren.

DateSpan

Een datumbereik.

Name Type Description
end

string (date)

De einddatum van de datumspanne.

start

string (date)

De begindatum van de datumspanne.

MaintenanceConfiguration

Configuratie van gepland onderhoud, die wordt gebruikt om te configureren wanneer updates kunnen worden geïmplementeerd in een beheerd cluster.

Name Type Description
id

string

Resource-id.

name

string

De naam van de resource die uniek is binnen een resourcegroep. Deze naam kan worden gebruikt voor toegang tot de resource.

properties.maintenanceWindow

MaintenanceWindow

Onderhoudsvenster voor de onderhoudsconfiguratie.

properties.notAllowedTime

TimeSpan[]

Tijdvakken waarop de upgrade niet is toegestaan.

properties.timeInWeek

TimeInWeek[]

Tijdsleuven tijdens de week waarop gepland onderhoud mag worden voortgezet.
Als twee matrixvermeldingen dezelfde dag van de week opgeven, is de toegepaste configuratie de samenvoeging van tijden in beide vermeldingen.

systemData

systemData

De systeemmetagegevens met betrekking tot deze resource.

type

string

Hulpmiddeltype

MaintenanceConfigurationListResult

Het antwoord van de bewerking Onderhoudsconfiguraties vermelden.

Name Type Description
nextLink

string

De URL voor het ophalen van de volgende set onderhoudsconfiguratieresultaten.

value

MaintenanceConfiguration[]

De lijst met onderhoudsconfiguraties.

MaintenanceWindow

Onderhoudsvenster dat wordt gebruikt voor het configureren van geplande automatische upgrade voor een beheerd cluster.

Name Type Default value Description
durationHours

integer (int32)

minimum: 4
maximum: 24
24

De duur van het onderhoudsvenster varieert van 4 tot 24 uur.

notAllowedDates

DateSpan[]

Datumbereiken waarop de upgrade niet is toegestaan. UtcOffset is van toepassing op dit veld. Bijvoorbeeld: met 'utcOffset: +02:00' en 'dateSpan' wordt '2022-12-23' tot '2023-01-03', wordt het onderhoud geblokkeerd van '2022-12-22 22:00' tot '2023-01-03 22:00' in UTC-tijd.

schedule

Schedule

Terugkeerschema voor het onderhoudsvenster.

startDate

string (date)

De datum waarop het onderhoudsvenster wordt geactiveerd. Als de huidige datum vóór deze datum valt, is het onderhoudsvenster inactief en wordt het niet gebruikt voor upgrades. Als dit niet is opgegeven, is het onderhoudsvenster direct actief.

startTime

string

pattern: ^\d{2}:\d{2}$

De begintijd van het onderhoudsvenster. Geaccepteerde waarden zijn van '00:00' tot '23:59'. UtcOffset is van toepassing op dit veld. Bijvoorbeeld: '02:00' met 'utcOffset: +02:00' betekent UTC-tijd '00:00'.

utcOffset

string

pattern: ^(-|\+)[0-9]{2}:[0-9]{2}$

De UTC-offset in notatie +/-UU:mm. Bijvoorbeeld '+05:30' voor IST en '-07:00' voor PST. Als dit niet is opgegeven, is de standaardwaarde '+00:00'.

RelativeMonthlySchedule

Voor schema's zoals: 'elke maand terugkeren op de eerste maandag' of 'elke 3 maanden op afgelopen vrijdag'.

Name Type Description
dayOfWeek

WeekDay

Hiermee geeft u op welke dag van de week het onderhoud plaatsvindt.

intervalMonths

integer (int32)

minimum: 1
maximum: 6

Hiermee geeft u het aantal maanden tussen elke set exemplaren.

weekIndex

type

De weekindex.
Hiermee geeft u op op welke week van de maand de dagOfWeek van toepassing is.

Schedule

Er moet slechts één van de schematypen worden opgegeven. Kies 'dagelijks', 'wekelijks', 'absoluteMonthly' of 'relativeMonthly' voor uw onderhoudsplanning.

Name Type Description
absoluteMonthly

AbsoluteMonthlySchedule

Voor schema's zoals: 'elke maand terugkeren op de 15e' of 'elke 3 maanden op de 20e'.

daily

DailySchedule

Voor schema's zoals: 'elke dag terugkeren' of 'elke 3 dagen terugkeren'.

relativeMonthly

RelativeMonthlySchedule

Voor schema's zoals: 'elke maand terugkeren op de eerste maandag' of 'elke 3 maanden op afgelopen vrijdag'.

weekly

WeeklySchedule

Voor schema's zoals: 'elke maandag terugkeren' of 'elke 3 weken op woensdag'.

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 maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is 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.

TimeInWeek

Tijd in een week.

Name Type Description
day

WeekDay

De dag van de week.

hourSlots

integer[] (int32)

minimum: 0
maximum: 23

Een lijst met uren in de dag die wordt gebruikt om een tijdsbereik te identificeren.
Elk geheel getal vertegenwoordigt een tijdsbereik dat begint bij 0m na het uur dat eindigt op het volgende uur (niet-inclusief). 0 komt overeen met 00:00 UTC, 23 komt overeen met 23:00 UTC. Als u [0, 1] opgeeft, betekent dit het tijdsbereik 00:00 - 02:00 UTC.

TimeSpan

Een tijdsbereik.

Name Type Description
end

string (date-time)

Het einde van een periode

start

string (date-time)

Het begin van een periode

type

De weekindex.

Waarde Description
First

Eerste week van de maand.

Fourth

Vierde week van de maand.

Last

Vorige week van de maand.

Second

Tweede week van de maand.

Third

Derde week van de maand.

WeekDay

De weekdag enum.

Waarde Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

WeeklySchedule

Voor schema's zoals: 'elke maandag terugkeren' of 'elke 3 weken op woensdag'.

Name Type Description
dayOfWeek

WeekDay

Hiermee geeft u op welke dag van de week het onderhoud plaatsvindt.

intervalWeeks

integer (int32)

minimum: 1
maximum: 4

Hiermee geeft u het aantal weken tussen elke set exemplaren.