Configuration Assignments For Resource Group - Create Or Update

Service:

Maintenance

Version d'API:

2023-09-01-preview

Créer une attribution de configuration
Inscrivez la configuration pour la ressource.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
configurationAssignmentName	path	True	string	Nom de l’affectation de configuration
resourceGroupName	path	True	string	Nom du groupe de ressources
subscriptionId	path	True	string	Informations d’identification d’abonnement qui identifient de manière unique un abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente.

Corps de la demande

Nom	Type	Description
location	string	Emplacement de la ressource
properties.filter	ConfigurationAssignmentFilterProperties	Propriétés de l’affectation de configuration
properties.maintenanceConfigurationId	string	ID de configuration de maintenance
properties.resourceId	string	ResourceId unique

Réponses

Nom	Type	Description
200 OK	ConfigurationAssignment	Demande de mise à jour de l’affectation de configuration acceptée
201 Created	ConfigurationAssignment	Demande de création d’affectation de configuration acceptée
Other Status Codes	MaintenanceError	Requête incorrecte

Exemples

ConfigurationAssignmentsForResourceGroup_CreateOrUpdate

Exemple de requête

HTTP

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

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

Exemple de réponse

Code d’état:

200

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

Code d’état:

201

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

Définitions

Nom	Description
ConfigurationAssignment	Affectation de configuration
ConfigurationAssignmentFilterProperties	Requête Azure pour la configuration de la mise à jour.
createdByType	Type d’identité qui a créé la ressource.
ErrorDetails	Détails de la réponse d’erreur reçus du service maintenance Azure.
MaintenanceError	Réponse d’erreur reçue du service Maintenance Azure.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TagOperators	Filtrez les machines virtuelles par balises Any ou All spécifiées.
TagSettingsProperties	Baliser les informations de filtre pour la machine virtuelle.

ConfigurationAssignment

Object

Affectation de configuration

Nom	Type	Description
id	string	Identificateur complet de la ressource
location	string	Emplacement de la ressource
name	string	Nom de la ressource
properties.filter	ConfigurationAssignmentFilterProperties	Propriétés de l’affectation de configuration
properties.maintenanceConfigurationId	string	ID de configuration de maintenance
properties.resourceId	string	ResourceId unique
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource

ConfigurationAssignmentFilterProperties

Object

Requête Azure pour la configuration de la mise à jour.

Nom	Type	Description
locations	string[]	Liste des emplacements dans utilisant l’étendue de la requête.
osTypes	string[]	Liste des systèmes d’exploitation autorisés.
resourceGroups	string[]	Liste des groupes de ressources autorisés.
resourceTypes	string[]	Liste des ressources autorisées.
tagSettings	TagSettingsProperties	Paramètres de balise de la machine virtuelle.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorDetails

Object

Détails de la réponse d’erreur reçus du service maintenance Azure.

Nom	Type	Description
code	string	Code d’erreur défini par le service. Ce code sert de sous-état pour le code d’erreur HTTP spécifié dans la réponse.
message	string	Représentation lisible par l’homme de l’erreur.

MaintenanceError

Object

Réponse d’erreur reçue du service Maintenance Azure.

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

TagOperators

Énumération

Filtrez les machines virtuelles par balises Any ou All spécifiées.

Valeur	Description
All
Any

TagSettingsProperties

Object

Baliser les informations de filtre pour la machine virtuelle.

Nom	Type	Description
filterOperator	TagOperators	Filtrez les machines virtuelles par balises Any ou All spécifiées.
tags	object	Dictionnaire de balises avec sa liste de valeurs.