Overzicht van aangepaste Azure-resource providers

Aangepaste Azure-resource providers is een uitbreidbaar platform voor Azure. Hiermee kunt u aangepaste Api's definiëren die kunnen worden gebruikt om de standaard Azure-ervaring te verrijken. Deze documentatie beschrijft:

  • Een aangepaste Azure-resource provider bouwen en implementeren.
  • Het gebruik van aangepaste Azure-resource providers om bestaande werk stromen uit te breiden.
  • Waar u gidsen en code voorbeelden kunt vinden om aan de slag te gaan.

Overzicht van aangepaste provider

Belangrijk

Aangepaste providers zijn momenteel beschikbaar als open bare preview. Deze preview-versie wordt aangeboden zonder service level agreement en wordt niet aanbevolen voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Supplemental Terms of Use for Microsoft Azure Previews (Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews) voor meer informatie.

Wat kunnen aangepaste resource providers doen

Hier volgen enkele voor beelden van wat u kunt doen met aangepaste Azure-resource providers:

  • Breid Azure Resource Manager REST API uit voor het toevoegen van interne en externe services.
  • Schakel aangepaste scenario's in op bestaande Azure-werk stromen.
  • Het besturings element en het effect van Azure Resource Manager sjablonen aanpassen.

Wat is een aangepaste resource provider?

Aangepaste Azure-resource providers worden gemaakt door een contract te maken tussen Azure en een eind punt. Dit contract definieert een lijst met nieuwe resources en acties via een nieuwe resource, micro soft. CustomProviders/resourceProviders. De aangepaste resource provider maakt deze nieuwe Api's vervolgens beschikbaar in Azure. Aangepaste Azure-resource providers bestaan uit drie delen: aangepaste resource provider, eind punten en aangepaste resources.

Aangepaste resource providers bouwen

Aangepaste resource providers zijn een lijst met contracten tussen Azure en eind punten. In dit contract wordt beschreven hoe Azure moet communiceren met een eind punt. De resource provider fungeert als een proxy, stuurt aanvragen en antwoorden van en naar het opgegeven eind punt. Een resource provider kan twee soorten contracten opgeven: resourceTypes en Actions. Deze zijn ingeschakeld via eindpunt definities. Een eindpunt definitie bestaat uit drie velden: naam, routingType en eind punt.

Voor beeld-eind punt:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}
Eigenschap Vereist Beschrijving
naam klikt De naam van de eindpuntdefinitie. Azure geeft deze naam beschikbaar via de API onder/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/
resourceProviders/{resourceProviderName}/{endpointDefinitionName}'
routingType geen Bepaalt het contract type met het eind punt. Als u niets opgeeft, wordt het standaard ingesteld op proxy.
endpoint klikt Het eindpunt waarnaar de aanvragen worden gerouteerd. Hiermee worden de reactie en eventuele neven effecten van de aanvraag verwerkt.

Aangepaste resources bouwen

ResourceTypes beschrijven nieuwe aangepaste resources die worden toegevoegd aan Azure. Deze beschikken over elementaire, geruste ruwe methoden. Meer informatie over het maken van aangepaste resources

Voor beeld van een aangepaste resource provider met resourceTypes:

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

Api's die zijn toegevoegd aan Azure voor het bovenstaande voor beeld:

HttpMethod Voor beeld-URI Beschrijving
PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}? API-Version = 2018-09 -01-preview
De Azure REST API-aanroep voor het maken van een nieuwe resource.
DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}? API-Version = 2018-09 -01-preview
De Azure REST API-aanroep voor het verwijderen van een bestaande resource.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}? API-Version = 2018-09 -01-preview
De Azure REST API-aanroep om een bestaande resource op te halen.
GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources? API-Version = 2018-9 -01-preview
De Azure REST API-aanroep voor het ophalen van de lijst met bestaande resources.

Aangepaste acties bouwen

Acties beschrijven nieuwe acties die aan Azure worden toegevoegd. Deze kunnen worden weer gegeven boven op de resource provider of genest zijn onder een resource type. Meer informatie over het maken van aangepaste acties

Voor beeld van een aangepaste resource provider met acties:

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

Api's die zijn toegevoegd aan Azure voor het bovenstaande voor beeld:

HttpMethod Voor beeld-URI Beschrijving
POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomAction? API-Version = 2018-9 -01-preview
De aanroep van Azure REST API om de actie te activeren.

Hulp nodig?

Als u vragen hebt over de ontwikkeling van de aangepaste Azure-resource provider, kunt u de vragen stellen op stack overflow. Misschien is er een soortgelijke vraag gesteld en beantwoord, dus controleer dit eerst vóór u een vraag stelt. Voeg de tag azure-custom-providers toe om snel antwoord te krijgen.

Volgende stappen

In dit artikel hebt u geleerd over aangepaste providers. Ga naar het volgende artikel om een aangepaste provider te maken.