Configuration Assignments For Resource Group - Get

Referencia

Szolgáltatás:: Maintenance

API-verzió:: 2023-09-01-preview

Konfiguráció-hozzárendelés lekérése az erőforráshoz.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Maintenance/configurationAssignments/{configurationAssignmentName}?api-version=2023-09-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
configurationAssignmentName	path	True	string pattern: ^.+$	Konfiguráció-hozzárendelés neve
resourceGroupName	path	True	string	Erőforráscsoport neve
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	ConfigurationAssignment	OKÉ
Other Status Codes	MaintenanceError	Hibás kérés

Példák

ConfigurationAssignmentsForResourceGroup_Get

Mintakérelem

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Maintenance/configurationAssignments/workervmConfiguration?api-version=2023-09-01-preview

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

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-maintenance
# USAGE
    python configuration_assignments_for_resource_group_get.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.configuration_assignments_for_resource_group.get(
        resource_group_name="examplerg",
        configuration_assignment_name="workervmConfiguration",
    )
    print(response)


# x-ms-original-file: specification/maintenance/resource-manager/Microsoft.Maintenance/preview/2023-09-01-preview/examples/ConfigurationAssignmentsForResourceGroup_Get.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

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/ConfigurationAssignmentsForResourceGroup_Get.json
// this example is just showing the usage of "ConfigurationAssignmentsForResourceGroup_Get" 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
string configurationAssignmentName = "workervmConfiguration";
MaintenanceConfigurationAssignmentData result = await resourceGroupResource.GetConfigurationAssignmentByResourceGroupAsync(configurationAssignmentName);

Console.WriteLine($"Succeeded: {result}");

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

{
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Maintenance/configurationAssignments/workervmConfiguration",
  "name": "workervmConfiguration",
  "type": "Microsoft.Maintenance/configurationAssignments",
  "properties": {
    "filter": {
      "resourceTypes": [
        "Microsoft.HybridCompute/machines",
        "Microsoft.Compute/virtualMachines"
      ],
      "tagSettings": {
        "tags": {
          "tag1": [
            "tag1Value1",
            "tag1Value2",
            "tag1Value3"
          ],
          "tag2": [
            "tag2Value1",
            "tag2Value2",
            "tag2Value3"
          ]
        },
        "filterOperator": "All"
      },
      "locations": [
        "Japan East",
        "UK South"
      ]
    },
    "maintenanceConfigurationId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Maintenance/maintenanceConfigurations/configuration1",
    "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg"
  }
}

Definíciók

Name	Description
ConfigurationAssignment	Konfigurációs hozzárendelés
ConfigurationAssignmentFilterProperties	Azure-lekérdezés a frissítési konfigurációhoz.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorDetails	Az Azure Maintenance szolgáltatástól kapott hibaválasz részletei.
MaintenanceError	Az Azure Maintenance szolgáltatástól kapott hibaválasz.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
TagOperators	Virtuális gépek szűrése bármely vagy minden megadott címke alapján.
TagSettingsProperties	A virtuális gép címkeszűrő adatai.

ConfigurationAssignment

Objektum

Konfigurációs hozzárendelés

Name	Típus	Description
id	string	Az erőforrás teljes azonosítója
location	string	Az erőforrás helye
name	string	Az erőforrás neve
properties.filter	ConfigurationAssignmentFilterProperties	A konfigurációs hozzárendelés tulajdonságai
properties.maintenanceConfigurationId	string	A karbantartási konfiguráció azonosítója
properties.resourceId	string	Az egyedi resourceId
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string	Az erőforrás típusa

ConfigurationAssignmentFilterProperties

Objektum

Azure-lekérdezés a frissítési konfigurációhoz.

Name	Típus	Description
locations	string[]	Azon helyek listája, ahol a lekérdezés hatóköre szerepel.
osTypes	string[]	Az engedélyezett operációs rendszerek listája.
resourceGroups	string[]	Az engedélyezett erőforráscsoportok listája.
resourceTypes	string[]	Az engedélyezett erőforrások listája.
tagSettings	TagSettingsProperties	A virtuális gép címkebeállításai.

createdByType

Enumerálás

Az erőforrást létrehozó identitás típusa.

Érték	Description
Application
Key
ManagedIdentity
User

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.

MaintenanceError

Objektum

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

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

systemData

Objektum

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

TagOperators

Enumerálás

Virtuális gépek szűrése bármely vagy minden megadott címke alapján.

Érték	Description
All
Any

TagSettingsProperties

Objektum

A virtuális gép címkeszűrő adatai.

Name	Típus	Description
filterOperator	TagOperators	Virtuális gépek szűrése bármely vagy minden megadott címke alapján.
tags	object	Címkék szótára az értékek listájával.

Megosztás a következőn keresztül:

Configuration Assignments For Resource Group - Get

URI-paraméterek

Válaszok

Példák

ConfigurationAssignmentsForResourceGroup_Get

Mintakérelem

Mintaválasz

Definíciók

ConfigurationAssignment

ConfigurationAssignmentFilterProperties

createdByType

ErrorDetails

MaintenanceError

systemData

TagOperators

TagSettingsProperties