Updates - List Parent

Szolgáltatás:

Maintenance

API-verzió:

2023-09-01-preview

Erőforrások frissítésének lekérése.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
providerName	path	True	string	Erőforrás-szolgáltató neve
resourceGroupName	path	True	string	Erőforráscsoport neve
resourceName	path	True	string	Erőforrás-azonosító
resourceParentName	path	True	string	Erőforrás szülőazonosítója
resourceParentType	path	True	string	Erőforrás szülőtípusa
resourceType	path	True	string	Erőforrás típusa
subscriptionId	path	True	string	Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.
api-version	query	True	string	Az ügyfélkéréshez használandó API verziója.

Válaszok

Name	Típus	Description
200 OK	ListUpdatesResult	OKÉ
Other Status Codes	MaintenanceError	Hibás kérés

Példák

Updates_ListParent

Mintakérelem

HTTP

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.maintenance import MaintenanceManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-maintenance
# USAGE
    python updates_list_parent.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = MaintenanceManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="5b4b650e-28b9-4790-b3ab-ddbd88d727c4",
    )

    response = client.updates.list_parent(
        resource_group_name="examplerg",
        provider_name="Microsoft.Compute",
        resource_parent_type="virtualMachineScaleSets",
        resource_parent_name="smdtest1",
        resource_type="virtualMachines",
        resource_name="1",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/maintenance/resource-manager/Microsoft.Maintenance/preview/2023-09-01-preview/examples/Updates_ListParent.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Maintenance;
using Azure.ResourceManager.Maintenance.Models;
using Azure.ResourceManager.Resources;

// Generated from example definition: specification/maintenance/resource-manager/Microsoft.Maintenance/preview/2023-09-01-preview/examples/Updates_ListParent.json
// this example is just showing the usage of "Updates_ListParent" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "5b4b650e-28b9-4790-b3ab-ddbd88d727c4";
string resourceGroupName = "examplerg";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// invoke the operation and iterate over the result
string providerName = "Microsoft.Compute";
string resourceParentType = "virtualMachineScaleSets";
string resourceParentName = "smdtest1";
string resourceType = "virtualMachines";
string resourceName = "1";
await foreach (MaintenanceUpdate item in resourceGroupResource.GetUpdatesByParentAsync(providerName, resourceParentType, resourceParentName, resourceType, resourceName))
{
    Console.WriteLine($"Succeeded: {item}");
}

Console.WriteLine($"Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Mintaválasz

Állapotkód:

200

{
  "value": [
    {
      "maintenanceScope": "Resource",
      "status": "Pending",
      "impactType": "Reboot",
      "impactDurationInSec": 1440,
      "notBefore": "2018-10-09T06:17:44.235Z",
      "properties": {
        "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1"
      }
    }
  ]
}

Definíciók

Name	Description
ErrorDetails	Az Azure Maintenance szolgáltatástól kapott hibaválasz részletei.
ImpactType	Az ütközés típusa
ListUpdatesResult	Válasz a frissítések listájára
MaintenanceError	Az Azure Maintenance szolgáltatástól kapott hibaválasz.
MaintenanceScope	Lekéri vagy beállítja a karbantartást A konfiguráció hatóköre
Update	Karbantartási frissítés egy erőforráson
UpdateStatus	Az állapot

ErrorDetails

Objektum

Az Azure Maintenance szolgáltatástól kapott hibaválasz részletei.

Name	Típus	Description
code	string	Szolgáltatás által definiált hibakód. Ez a kód a válaszban megadott HTTP-hibakód alállapotaként szolgál.
message	string	A hiba emberi olvasásra alkalmas ábrázolása.

ImpactType

Enumerálás

Az ütközés típusa

Érték	Description
Freeze	A függőben lévő frissítések lefagyaszthatják a hálózati vagy lemez io-műveletet az erőforráson.
None	A függőben lévő frissítések nincsenek hatással az erőforrásra.
Redeploy	A függőben lévő frissítések újra üzembe helyezhetik az erőforrást.
Restart	A függőben lévő frissítések miatt az erőforrás újraindulhat.

ListUpdatesResult

Objektum

Válasz a frissítések listájára

Name	Típus	Description
value	Update[]	A függőben lévő frissítések

MaintenanceError

Objektum

Az Azure Maintenance szolgáltatástól kapott hibaválasz.

Name	Típus	Description
error	ErrorDetails	A hiba részletei

MaintenanceScope

Enumerálás

Lekéri vagy beállítja a karbantartást A konfiguráció hatóköre

Érték	Description
Extension	Ez a karbantartási hatókör szabályozza a bővítmény telepítését a virtuális gépen/VMSS-en
Host	Ez a karbantartási hatókör szabályozza az Azure Platform frissítéseinek telepítését, azaz az ügyfél virtuális gépeket üzemeltető fizikai csomópontokon lévő szolgáltatásokat.
InGuestPatch	Ez a karbantartási hatókör a Windows- és Linux-csomagok telepítését szabályozza virtuális gépen/VMSS-en
OSImage	Ez a karbantartási hatókör szabályozza az operációs rendszer lemezképének telepítését a virtuális gépen/VMSS-en
Resource	Ez a karbantartási hatókör szabályozza az Azure-erőforrás alapértelmezett frissítési karbantartását
SQLDB	Ez a karbantartási hatókör szabályozza az SQL Server platformfrissítéseinek telepítését.
SQLManagedInstance	Ez a karbantartási hatókör szabályozza a felügyelt SQL-példány platformfrissítésének telepítését.

Update

Objektum

Karbantartási frissítés egy erőforráson

Name	Típus	Description
impactDurationInSec	integer (int32)	Az ütközés időtartama másodpercben
impactType	ImpactType	Az ütközés típusa
maintenanceScope	MaintenanceScope	A hatásterület
notBefore	string (date-time)	Az az idő, amikor az Azure elkezdi kényszeríteni a frissítéseket, ha az ügyfél ezt megelőzően nem frissíti önként a frissítéseket
properties.resourceId	string	A resourceId
status	UpdateStatus	Az állapot

UpdateStatus

Enumerálás

Az állapot

Érték	Description
Cancel	Szakítsa meg az ütemezést, és ne hozzon létre PMR-t az erőforrások egy részének. Csak a karbantartási konfiguráció erőforrástípusára alkalmazható.
Cancelled	Küldje el a megszakított választ a felhasználónak, ha a kérés az ütemezés megszakítására érkezett. Csak a karbantartási konfiguráció erőforrástípusára alkalmazható.
Completed	Minden frissítés sikeresen alkalmazva van.
InProgress	A frissítések telepítése folyamatban van.
NoUpdatesPending	Nincsenek függőben lévő frissítések.
Pending	Vannak függőben lévő frissítések, amelyeket telepíteni kell.
RetryLater	A frissítések telepítése sikertelen volt, és később újra meg kell próbálkozni.
RetryNow	A frissítések telepítése sikertelen volt, de készen állnak az újrapróbálkozásra.