Az Azure-beli egyéni erőforrás-szolgáltatók áttekintése
Az Azure Custom Resource Providers egy bővíthetőségi platform az Azure-ban. Lehetővé teszi egyéni API-k meghatározását, amelyek az alapértelmezett Azure-élmény bővítésére használhatók. Ez a dokumentáció a következőket ismerteti:
- Egyéni Azure-erőforrás-szolgáltató létrehozása és üzembe helyezése.
- Az Azure Custom Resource Providers használata a meglévő munkafolyamatok kibővítéséhez.
- Útmutatók és kódminták keresése az első lépésekhez.
Fontos
Az egyéni erőforrás-szolgáltatók jelenleg nyilvános előzetes verzióban vannak. Erre az előzetes verzióra nem vonatkozik szolgáltatói szerződés, és a használata nem javasolt éles számítási feladatok esetén. Előfordulhat, hogy néhány funkció nem támogatott, vagy korlátozott képességekkel rendelkezik. További információ: Kiegészítő használati feltételek a Microsoft Azure előzetes verziójú termékeihez.
Mit tehetnek az egyéni erőforrás-szolgáltatók?
Íme néhány példa arra, hogy mit érhet el az Azure-beli egyéni erőforrás-szolgáltatókkal:
- Az Azure Resource Manager REST API kiterjesztése belső és külső szolgáltatásokra.
- Egyéni forgatókönyvek engedélyezése a meglévő Azure-munkafolyamatokon felül.
- Testre szabhatja az Azure Resource Manager Templates vezérlőt és effektust.
Mi az az egyéni erőforrás-szolgáltató?
Az Azure-beli egyéni erőforrás-szolgáltatók az Azure és egy végpont közötti szerződés létrehozásával jönnek létre. Ez a szerződés a Microsoft.CustomProviders/resourceProviders erőforráson keresztül definiálja az új erőforrások és műveletek listáját. Az egyéni erőforrás-szolgáltató ezután közzéteszi ezeket az új API-kat az Azure-ban. Az Azure-beli egyéni erőforrás-szolgáltatók három részből állnak: egyéni erőforrás-szolgáltatóból, végpontokból és egyéni erőforrásokból.
Egyéni erőforrás-szolgáltatók létrehozása
Az egyéni erőforrás-szolgáltatók az Azure és a végpontok közötti szerződések listáját képezik. Ezek a szerződések azt írják le, hogyan kell az Azure-nak használnia a végpontokat. Az erőforrás-szolgáltatók proxyként viselkednek, és továbbítják a kéréseket és válaszokat a megadott végpontjukra és onnan. Az erőforrás-szolgáltató kétféle szerződést adhat meg: resourceTypes és actions. Ezek végpontdefiníciókon keresztül engedélyezve vannak. A végpontdefiníció három mezőből áll: név, routingType és végpont.
Mintavégpont:
{
"name": "{endpointDefinitionName}",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
| Tulajdonság | Kötelező | Leírás |
|---|---|---|
| name | igen | A végpontdefiníció neve. Az Azure ezt a nevet az API-jában teszi elérhetővé a következő alatt: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}' |
| routingType | nem | Meghatározza a végponttal rendelkező szerződés típusát. Ha nincs megadva, az alapértelmezés szerint "Proxy" lesz. |
| endpoint | igen | A kérések átirányításához a végpont. Ez kezeli a választ, valamint a kérés esetleges mellékhatásait. |
Egyéni erőforrások létrehozása
A ResourceTypes az Azure-hoz hozzáadott új egyéni erőforrásokat írja le. Ezek az alapvető RESTful CRUD metódusokat teszik elérhetővé. További információ az egyéni erőforrások létrehozásáról
Minta egyéni erőforrás-szolgáltató resourceTypes használatával:
{
"properties": {
"resourceTypes": [
{
"name": "myCustomResources",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
A fenti mintához hozzáadott API-k az Azure-ban:
| HttpMethod | Minta URI | Leírás |
|---|---|---|
| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Az Azure REST API-hívás egy új erőforrás létrehozásához. |
| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Az Azure REST API-hívás egy meglévő erőforrás törlésére. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Az Azure REST API-hívás egy meglévő erőforrás lekéréséhez. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources?api-version=2018-09-01-preview |
Az Azure REST API-hívás a meglévő erőforrások listájának lekéréséhez. |
Egyéni műveletek létrehozása
A műveletek az Azure-hoz hozzáadott új műveleteket írják le. Ezek közzétehetők az erőforrás-szolgáltató tetején, vagy egy resourceType alá ágyazva. További információ az egyéni műveletek létrehozásáról
Egyéni erőforrás-szolgáltató mintaműveletekkel:
{
"properties": {
"actions": [
{
"name": "myCustomAction",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
A fenti mintához hozzáadott API-k az Azure-ban:
| HttpMethod | Minta URI | Leírás |
|---|---|---|
| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction?api-version=2018-09-01-preview |
Az Azure REST API-hívás aktiválja a műveletet. |
Segítségkérés
Ha kérdése van az Azure egyéni erőforrás-szolgáltató fejlesztésével kapcsolatban, próbálja meg megkérdezni a Stack Overflow-on. Lehet, hogy már feltettek és megválaszoltak egy hasonló kérdést, ezért először a közzététel előtt ellenőrizze. Adja hozzá a címkét azure-custom-providers a gyors válaszhoz!
Következő lépések
Ebben a cikkben megismerkedett az egyéni erőforrás-szolgáltatókkal. A következő cikkben egyéni erőforrás-szolgáltatót hozhat létre.