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

Les fournisseurs de ressources personnalisés Azure sont une plateforme d’extensibilité vers Azure. Il vous permet de définir des API personnalisées qui peuvent être utilisées pour enrichir l’expérience Azure par défaut. Cette documentation décrit les éléments suivants :

• Comment créer et déployer un fournisseur de ressources personnalisé Azure.
• Comment utiliser des fournisseurs de ressources personnalisés Azure pour étendre les flux de travail existants.
• Où trouver des guides et des exemples de code pour commencer.

Que peuvent faire les fournisseurs de ressources personnalisés

Voici quelques exemples de ce que vous pouvez réaliser avec les fournisseurs de ressources personnalisés Azure :

• Étendez l’API REST Azure Resource Manager pour inclure des services internes et externes.
• Activez des scénarios personnalisés en plus des flux de travail Azure existants.
• Personnaliser le contrôle et l’effet des modèles Azure Resource Manager.

Qu’est-ce qu’un fournisseur de ressources personnalisé ?

Les fournisseurs de ressources personnalisés Azure sont créés en créant un contrat entre Azure et un point de terminaison. Ce contrat définit une liste de nouvelles ressources et actions via une nouvelle ressource, Microsoft.CustomProviders/resourceProviders. Le fournisseur de ressources personnalisé expose ensuite ces nouvelles API dans Azure. Les fournisseurs de ressources personnalisés Azure sont composés de trois parties : fournisseur de ressources personnalisé, points de terminaison et ressources personnalisées.

Comment créer des fournisseurs de ressources personnalisés

Les fournisseurs de ressources personnalisés sont une liste de contrats entre Azure et les points de terminaison. Ces contrats décrivent comment Azure doit interagir avec leurs points de terminaison. Les fournisseurs de ressources agissent comme un proxy et transfèrent les demandes et les réponses vers et depuis leur point de terminaison spécifié. Un fournisseur de ressources peut spécifier deux types de contrats : resourceTypes et actions. Celles-ci sont activées par le biais de définitions de point de terminaison. Une définition de point de terminaison est composée de trois champs : nom, routingType et point de terminaison.

Exemple de point de terminaison :

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}

Création de ressources personnalisées

Les ResourceTypes décrivent de nouvelles ressources personnalisées ajoutées à Azure. Celles-ci exposent des méthodes CRUD RESTful de base. Voir plus d'informations sur la création de ressources personnalisées

Exemple de fournisseur de ressources personnalisé avec resourceTypes :

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

API ajoutées à Azure pour l’exemple ci-dessus :

Création d’actions personnalisées

Les actions décrivent les nouvelles actions ajoutées à Azure. Celles-ci peuvent être exposées au-dessus du fournisseur de ressources ou imbriquées sous un resourceType. Voir plus sur la création d’actions personnalisées

Exemple de fournisseur de ressources personnalisé avec actions :

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

API ajoutées à Azure pour l’exemple ci-dessus :

Recherche d’aide

Si vous avez des questions sur le développement du fournisseur de ressources personnalisé Azure, essayez de poser des questions sur Stack Overflow. Une question similaire a peut-être déjà été posée et répondue, donc 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. Accédez à l’article suivant pour créer un fournisseur de ressources personnalisé.

• Démarrage rapide : Créer un fournisseur de ressources personnalisé Azure et déployer des ressources personnalisées
• Tutoriel : Créer des actions et des ressources personnalisées dans Azure
• Guide pratique pour ajouter des actions personnalisées à l’API REST Azure
• Guide pratique pour ajouter des ressources personnalisées à l’API REST Azure