Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Viktigt!
Anpassade resursprovidrar är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan serviceavtal och rekommenderas inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.
År 2026 kommer Azure Resource Manager att ta bort cuRP-tjänsten (Custom Resource Provider).
Vi drar tillbaka funktionen senast den 31 oktober 2026. Vi kommer att utföra ett skriktest den 24 februari 2026, som en del av denna utfasning. Från och med 31 juli 2026 kommer skapande, uppdateringar, korrigeringar och åtgärder för anpassade resurser och resursleverantörer att blockeras. Du kan bara läsa och ta bort dina anpassade resurser och resursleverantörer.
Vi förstår att denna utfasning kan vara en olägenhet för dig och ditt team. Här följer några möjliga CuRP-alternativ som du kan använda för att stödja dina befintliga arbetsflöden.
Om ditt CuRP-scenario:
- Det handlar bara om att utlösa en slutpunkt utan att behöva beständig resurshantering. Överväg distributionsskript.
- Det innebär bara att utlösa en slutpunkt utan behov av beständig resurshantering, och du använder Bicep, överväg Bicep-tillägg.
- Omfattar utlösande av flera olika slutpunkter eller tjänster för din lösning, överväg Azure Functions.
Om du har några frågor ber du din Microsoft-kontoansvarig att skicka e-post curpdeprecation@microsoft.com med ditt namn, företagsnamn, e-postkontakt och prenumerations-ID.
Azure Custom Resource Providers är en utökningsplattform till Azure. Det gör att du kan definiera anpassade API:er som kan användas för att utöka standardupplevelsen i Azure. I den här dokumentationen beskrivs:
- Så här skapar och distribuerar du en anpassad Azure-resursprovider.
- Så här använder du anpassade Azure-resursprovidrar för att utöka befintliga arbetsflöden.
- Var du hittar guider och kodexempel för att komma igång.
Vad kan anpassade resursprovidrar göra
Här är några exempel på vad du kan uppnå med Azure Custom Resource Providers:
- Utöka REST-API:et för Azure Resource Manager till att omfatta interna och externa tjänster.
- Aktivera anpassade scenarier ovanpå befintliga Azure-arbetsflöden.
- Anpassa kontroll och effekt för Azure Resource Manager-mallar.
Vad är en anpassad resursprovider?
Azure Custom Resource Providers skapas genom att skapa ett kontrakt mellan Azure och en slutpunkt. Det här kontraktet definierar en lista över nya resurser och åtgärder via en ny resurs, Microsoft.CustomProviders/resourceProviders. Den anpassade resursprovidern exponerar sedan dessa nya API:er i Azure. Azure Custom Resource Providers består av tre delar: anpassad resursprovider, slutpunkter och anpassade resurser.
Så här skapar du anpassade resursprovidrar
Anpassade resursprovidrar är en lista över kontrakt mellan Azure och slutpunkter. De här kontrakten beskriver hur Azure ska interagera med deras slutpunkter. Resursprovidrar fungerar som en proxy och vidarebefordrar begäranden och svar till och från sin angivna slutpunkt. En resursprovider kan ange två typer av kontrakt: resourceTypes och åtgärder. Dessa aktiveras via slutpunktsdefinitioner. En slutpunktsdefinition består av tre fält: namn, routingType och slutpunkt.
Exempelslutpunkt:
{
"name": "{endpointDefinitionName}",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
| Fastighet | Krävs | Description |
|---|---|---|
| name | Ja | Namnet på slutpunktsdefinitionen. Azure exponerar det här namnet via api:et under '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}' |
| routingType | inga | Avgör kontraktstypen med slutpunkten. Om den inte anges kommer den som standard att vara "Proxy". |
| endpoint | Ja | Slutpunkten som begäranden ska dirigeras till. Detta kommer att hantera svaret samt eventuella biverkningar av begäran. |
Skapa anpassade resurser
ResourceTypes beskriver nya anpassade resurser som läggs till i Azure. Dessa exponerar grundläggande RESTful CRUD-metoder. Läs mer om att skapa anpassade resurser
Exempel på anpassad resursprovider med resourceTypes:
{
"properties": {
"resourceTypes": [
{
"name": "myCustomResources",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
API:er som lagts till i Azure för exemplet ovan:
| HTTP-metod | Exempel-URI | Description |
|---|---|---|
| LÄGG | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Azure REST API-anropet för att skapa en ny resurs. |
| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Azure REST API-anropet för att ta bort en befintlig resurs. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Azure REST API-anropet för att hämta en befintlig resurs. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources?api-version=2018-09-01-preview |
Azure REST API-anropet för att hämta listan över befintliga resurser. |
Skapa anpassade åtgärder
Åtgärder beskriver nya åtgärder som läggs till i Azure. Dessa kan exponeras ovanpå resursprovidern eller kapslas under en resourceType. Läs mer om att skapa anpassade åtgärder
Exempel på anpassad resursprovider med åtgärder:
{
"properties": {
"actions": [
{
"name": "myCustomAction",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
API:er som lagts till i Azure för exemplet ovan:
| HTTP-metod | Exempel-URI | Description |
|---|---|---|
| Posten | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction?api-version=2018-09-01-preview |
Azure REST API-anropet för att aktivera åtgärden. |
Söker hjälp
Om du har frågor om utveckling av anpassad Azure-resursprovider kan du prova att fråga på Stack Overflow. En liknande fråga kan redan ha ställts och besvarats, så kontrollera först innan du publicerar. Lägg till taggen azure-custom-providers för att få ett snabbt svar!
Nästa steg
I den här artikeln har du lärt dig om anpassade resursprovidrar. Gå till nästa artikel för att skapa en anpassad resursprovider.