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.

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.