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 |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is hoofdletterongevoelig. |
resource
|
path | True |
string minLength: 1maxLength: 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. |
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. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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 |
---|---|
Absolute |
Voor schema's zoals: 'elke maand terugkeren op de 15e' of 'elke 3 maanden op de 20e'. |
Cloud |
Een foutreactie van de Container-service. |
Cloud |
Een foutreactie van de Container-service. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Daily |
Voor schema's zoals: 'elke dag terugkeren' of 'elke 3 dagen terugkeren'. |
Date |
Een datumbereik. |
Maintenance |
Configuratie van gepland onderhoud, die wordt gebruikt om te configureren wanneer updates kunnen worden geïmplementeerd in een beheerd cluster. |
Maintenance |
Het antwoord van de bewerking Onderhoudsconfiguraties vermelden. |
Maintenance |
Onderhoudsvenster dat wordt gebruikt voor het configureren van geplande automatische upgrade voor een beheerd cluster. |
Relative |
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. |
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
Time |
Tijd in een week. |
Time |
Een tijdsbereik. |
type |
De weekindex. |
Week |
De weekdag enum. |
Weekly |
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: 1maximum: 31 |
De datum van de maand. |
intervalMonths |
integer (int32) minimum: 1maximum: 6 |
Hiermee geeft u het aantal maanden tussen elke set exemplaren. |
CloudError
Een foutreactie van de Container-service.
Name | Type | Description |
---|---|---|
error |
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 |
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: 1maximum: 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 |
Onderhoudsvenster voor de onderhoudsconfiguratie. |
|
properties.notAllowedTime |
Time |
Tijdvakken waarop de upgrade niet is toegestaan. |
properties.timeInWeek |
Tijdsleuven tijdens de week waarop gepland onderhoud mag worden voortgezet. |
|
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 |
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: 4maximum: 24 |
24 |
De duur van het onderhoudsvenster varieert van 4 tot 24 uur. |
notAllowedDates |
Date |
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 |
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 |
Hiermee geeft u op welke dag van de week het onderhoud plaatsvindt. |
|
intervalMonths |
integer (int32) minimum: 1maximum: 6 |
Hiermee geeft u het aantal maanden tussen elke set exemplaren. |
weekIndex |
De weekindex. |
Schedule
Er moet slechts één van de schematypen worden opgegeven. Kies 'dagelijks', 'wekelijks', 'absoluteMonthly' of 'relativeMonthly' voor uw onderhoudsplanning.
Name | Type | Description |
---|---|---|
absoluteMonthly |
Voor schema's zoals: 'elke maand terugkeren op de 15e' of 'elke 3 maanden op de 20e'. |
|
daily |
Voor schema's zoals: 'elke dag terugkeren' of 'elke 3 dagen terugkeren'. |
|
relativeMonthly |
Voor schema's zoals: 'elke maand terugkeren op de eerste maandag' of 'elke 3 maanden op afgelopen vrijdag'. |
|
weekly |
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 |
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 |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |
TimeInWeek
Tijd in een week.
Name | Type | Description |
---|---|---|
day |
De dag van de week. |
|
hourSlots |
integer[] (int32) minimum: 0maximum: 23 |
Een lijst met uren in de dag die wordt gebruikt om een tijdsbereik te identificeren. |
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 |
Hiermee geeft u op welke dag van de week het onderhoud plaatsvindt. |
|
intervalWeeks |
integer (int32) minimum: 1maximum: 4 |
Hiermee geeft u het aantal weken tussen elke set exemplaren. |