Översikt över Azures anpassade resurs leverantörer
Azures anpassade resurs leverantörer är en utöknings bara plattform till Azure. Det gör att du kan definiera anpassade API: er som kan användas för att utöka Azures standard upplevelse. I den här dokumentationen beskrivs:
- Så här skapar och distribuerar du en Azure-anpassad resurs leverantör.
- Så här använder du Azure-anpassade resurs leverantörer för att utöka befintliga arbets flöden.
- Var du hittar guider och kod exempel för att komma igång.

Viktigt
Anpassade providers är för närvarande en offentlig för hands version. 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.
Vad kan anpassade resurs leverantörer göra
Här följer några exempel på vad du kan uppnå med Azures anpassade resurs leverantörer:
- Utöka Azure Resource Manager REST API för att inkludera interna och externa tjänster.
- Aktivera anpassade scenarier ovanpå befintliga Azure-arbetsflöden.
- Anpassa Azure Resource Manager templates-kontroller och-effekter.
Vad är en anpassad resurs leverantör
Azures anpassade resurs leverantörer görs genom att skapa ett kontrakt mellan Azure och en slut punkt. Detta kontrakt definierar en lista över nya resurser och åtgärder via en ny resurs, Microsoft. CustomProviders/resourceProviders. Den anpassade resurs leverantören kommer sedan att exponera dessa nya API: er i Azure. Azures anpassade resurs leverantörer består av tre delar: anpassad Resource Provider, slut punkter och anpassade resurser.
Så här skapar du anpassade resurs leverantörer
Anpassade resurs leverantörer är en lista över kontrakt mellan Azure och slut punkter. Detta avtal beskriver hur Azure ska interagera med en slut punkt. Resurs leverantören fungerar som en proxy och vidarebefordrar begär Anden och svar till och från den angivna slut punkten. En resurs leverantör kan ange två typer av kontrakt: resourceTypes och åtgärder. Dessa är aktiverade genom slut punkts definitioner. En slut punkts definition består av tre fält: Name, routingType och Endpoint.
Exempel slut punkt:
{
"name": "{endpointDefinitionName}",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
| Egenskap | Krävs | Beskrivning |
|---|---|---|
| name | Ja | Namnet på slut punkts definitionen. Azure kommer att exponera detta namn via dess API under "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}' |
| routingType | Nej | Bestämmer kontrakts typen med slut punkten. Om inget värde anges används proxy för standardvärdet. |
| slutpunkt | Ja | Slut punkten för att dirigera begär anden till. Detta hanterar svaret och eventuella sido effekter i begäran. |
Skapa anpassade resurser
ResourceTypes beskriver nya anpassade resurser som läggs till i Azure. Dessa visar Basic RESTful CRUD-metoder. Läs mer om att skapa anpassade resurser
Exempel på anpassad resurs leverantör med resourceTypes:
{
"properties": {
"resourceTypes": [
{
"name": "myCustomResources",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
API: er som lagts till i Azure för exemplet ovan:
| HttpMethod | Exempel-URI | Beskrivning |
|---|---|---|
| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft. CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}? API-version = 2018-09 01 – för hands version |
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 – för hands version |
Azure REST API-anrop 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 – för hands version |
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 – för hands version |
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å resurs leverantören eller kapslas under en resourceType. Läs mer om att skapa anpassade åtgärder
Exempel på anpassad resurs leverantör 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:
| HttpMethod | Exempel-URI | Beskrivning |
|---|---|---|
| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft. CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction? API-version = 2018-09 01 – för hands version |
Azure REST API-anropet för att aktivera åtgärden. |
Söker efter hjälp
Om du har frågor om utveckling av Azure anpassad resurs leverantör kan du prova med att ange Stack Overflow. En liknande fråga kanske redan har blivit ombeddd och besvarad, så kontrol lera 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 leverantörer. Gå till nästa artikel om du vill skapa en anpassad Provider.