Vue d’ensemble de l’intégration des ressources des fournisseurs de ressources personnalisés Azure

L’intégration des ressources des fournisseurs de ressources personnalisés Azure est un modèle d’extensibilité pour les types de ressources Azure. Il vous permet d’appliquer des opérations ou de la gestion sur les ressources Azure existantes à grande échelle. Pour plus d’informations, consultez Comment les fournisseurs de ressources personnalisés Azure peuvent étendre Azure. Cet article aborde les points suivants :

• Ce que l'intégration des ressources peut accomplir.
• Principes de base de l’intégration des ressources et comment l’utiliser.
• Où trouver des guides et des exemples de code pour commencer.

Que peut faire l’intégration des ressources ?

Comme pour les ressources personnalisés des fournisseurs de ressources personnalisés Azure, l’intégration des ressources établit un contrat qui proxyse les demandes d’intégration vers un point de terminaison. Contrairement aux ressources personnalisées, l’intégration de ressources ne crée pas de type de ressource. Au lieu de cela, il autorise l’extension des types de ressources existants. L’intégration des ressources fonctionne avec Azure Policy, de sorte que la gestion et la configuration des ressources peuvent être effectuées à grande échelle. Voici quelques exemples de flux de travail d’intégration de ressources :

• Installez et gérez des extensions sur des machines virtuelles.
• Chargez et configurez les valeurs par défaut sur les comptes de stockage Azure.
• Activez les paramètres de diagnostic de référence à grande échelle.

Principes de base de l’intégration des ressources

Vous pouvez configurer l’intégration des ressources via les fournisseurs de ressources personnalisés Azure à l’aide des types de ressources Microsoft.CustomProviders/resourceProviders et Microsoft.CustomProviders/associations. Afin d’activer l’intégration des ressources pour un fournisseur de ressources personnalisé, pendant le processus de configuration, créez un resourceType appelé « associations » avec un routingType incluant « extension ». Microsoft.CustomProviders/associations et Microsoft.CustomProviders/resourceProviders n’ont pas besoin d’appartenir au même groupe de ressources.

Voici un exemple de fournisseur de ressources personnalisé Azure :

{
  "properties": {
    "resourceTypes": [
      {
        "name": "associations",
        "routingType": "Proxy,Cache,Extension",
        "endpoint": "https://microsoft.com/"
      }
    ]
  },
  "location": "eastus"
}

Après avoir créé le fournisseur de ressources personnalisé avec le type de ressource associations, vous pouvez cibler à l’aide de Microsoft.CustomProviders/associations. Microsoft.CustomProviders/associations est une ressource d’extension qui peut étendre n’importe quelle autre ressource Azure. Lorsqu’une instance de Microsoft.CustomProviders/associations est créée, elle prend une propriété targetResourceId, qui doit être un ID de ressource Microsoft.CustomProviders/resourceProviders valide ou Microsoft.Solutions/applications. Dans ce cas, la requête est transférée au type de ressource associations sur l’instance Microsoft.CustomProviders/resourceProviders que vous avez créée.

Exemple d’association de fournisseurs de ressources personnalisés Azure :

{
  "properties": {
    "targetResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}",
    ...
  }
}

Utilisation de l’intégration des ressources

L’intégration des ressources fonctionne en étendant d’autres ressources avec la ressource d’extension Microsoft.CustomProviders/associations. Dans l’exemple suivant, la requête est effectuée pour une machine virtuelle, mais toute ressource peut être étendue.

Tout d’abord, vous devez créer une ressource de fournisseur de ressources personnalisé avec un type de ressource Associations. Cela déclare l’URL de rappel qui sera utilisée lorsqu’une ressource Microsoft.CustomProviders/associations correspondante est créée, qui cible le fournisseur de ressources personnalisé.

Exemple de requête de création pour Microsoft.CustomProviders/resourceProviders :

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

{
  "properties": {
    "resourceTypes": [
      {
        "name": "associations",
        "routingType": "Proxy,Cache,Extension",
        "endpoint": "https://{myCustomEndpoint}/"
      }
    ]
  },
  "location": "{location}"
}

Après avoir créé le fournisseur de ressources personnalisé, vous pouvez cibler d’autres ressources et appliquer les effets secondaires du fournisseur de ressources personnalisé.

Exemple de demande de création pour Microsoft.CustomProviders/associations :

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.CustomProviders/associations/{associationName}?api-version=2018-09-01-preview
Authorization: Bearer eyJ0e...
Content-Type: application/json

{
  "properties": {
    "targetResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}",
    "myProperty1": "myPropertyValue1",
    "myProperty2": {
        "myProperty3" : "myPropertyValue3"
    }
  }
}

Cette requête sera ensuite transférée au point de terminaison spécifié dans le fournisseur de ressources personnalisé que vous avez créé, qui est référencé par le targetResourceId dans ce formulaire :

PUT https://{endpointURL}/?api-version=2018-09-01-preview
Content-Type: application/json
X-MS-CustomProviders-RequestPath: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/associations/{associationName}
X-MS-CustomProviders-ExtensionPath: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}/providers/Microsoft.CustomProviders/associations/{associationName}
X-MS-CustomProviders-ExtendedResource: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{virtualMachineName}

{
  "properties": {
    "myProperty1": "myPropertyValue1",
    "myProperty2": {
        "myProperty3" : "myPropertyValue3"
    }
  }
}

Le point de terminaison doit répondre avec une application/json Content-Type et un corps de réponse JSON valide. Les champs retournés sous l’objet propriétés du JSON seront ajoutés à la réponse de retour d’association.

Obtenir de l’aide

Si vous avez des questions sur le développement de fournisseurs de ressources personnalisés Azure, essayez de les poser sur Stack Overflow. Une question similaire a peut-être déjà été répondue. Vérifiez d’abord avant de publier. Ajoutez la balise azure-custom-providers pour obtenir une réponse rapide !

Étapes suivantes

Dans cet article, vous avez découvert les fournisseurs de ressources personnalisés. Pour en savoir plus, consultez les articles suivants :

• Tutoriel : Intégration de ressources avec des fournisseurs de ressources personnalisés
• Tutoriel : Créer des actions et des ressources personnalisées dans Azure
• Démarrage rapide : Créer un fournisseur de ressources personnalisé Azure et déployer des ressources personnalisées
• Guide pratique pour ajouter des actions personnalisées à une API REST Azure
• Guide pratique pour ajouter des ressources personnalisées à une API REST Azure