Přehled vlastních poskytovatelů prostředků Azure
Vlastní poskytovatelé prostředků Azure jsou platformou rozšiřitelnosti azure. Umožňuje definovat vlastní rozhraní API, která se dají použít k obohacení výchozího prostředí Azure. Tato dokumentace popisuje:
- Postup sestavení a nasazení vlastního poskytovatele prostředků Azure
- Jak využít vlastní poskytovatele prostředků Azure k rozšíření stávajících pracovních postupů.
- Kde najdete příručky a ukázky kódu, abyste mohli začít.
Důležité
Vlastní poskytovatelé prostředků jsou aktuálně ve verzi Public Preview. Tato verze Preview se poskytuje bez smlouvy o úrovni služeb a nedoporučuje se pro úlohy v produkčním prostředí. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.
Co můžou dělat vlastní poskytovatelé prostředků
Tady je několik příkladů toho, čeho můžete dosáhnout s vlastními poskytovateli prostředků Azure:
- Rozšíření rozhraní Azure Resource Manager REST API o interní a externí služby
- Povolte vlastní scénáře nad stávajícími pracovními postupy Azure.
- Přizpůsobení ovládacího prvku a efektu šablon Azure Resource Manager
Co je vlastní poskytovatel prostředků
Vlastní poskytovatelé prostředků Azure se vytvářejí vytvořením smlouvy mezi Azure a koncovým bodem. Tento kontrakt definuje seznam nových prostředků a akcí prostřednictvím nového prostředku Microsoft.CustomProviders/resourceProviders. Poskytovatel vlastních prostředků pak tato nová rozhraní API zveřejní v Azure. Vlastní poskytovatelé prostředků Azure se skládají ze tří částí: vlastního poskytovatele prostředků, koncových bodů a vlastních prostředků.
Jak vytvořit vlastní poskytovatele prostředků
Vlastní poskytovatelé prostředků jsou seznam kontraktů mezi Azure a koncovými body. Tyto kontrakty popisují, jak má Azure pracovat se svými koncovými body. Poskytovatelé prostředků fungují jako proxy a předávají požadavky a odpovědi do a ze svého zadaného koncového bodu. Poskytovatel prostředků může zadat dva typy kontraktů: resourceTypes a actions. Ty jsou povolené prostřednictvím definic koncových bodů. Definice koncového bodu se skládá ze tří polí: name (název), routingType (Typ směrování) a endpoint (koncový bod).
Ukázkový koncový bod:
{
"name": "{endpointDefinitionName}",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
| Vlastnost | Povinné | Popis |
|---|---|---|
| name | Ano | Název definice koncového bodu. Azure zveřejní tento název prostřednictvím svého rozhraní API v části /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}' |
| typ směrování | Ne | Určuje typ kontraktu s koncovým bodem. Pokud není zadaný, použije se výchozí hodnota Proxy. |
| endpoint | Ano | Koncový bod, do který se mají požadavky směrovat. Tím se zpracuje odpověď i všechny vedlejší účinky požadavku. |
Vytváření vlastních prostředků
ResourceTypes popisují nové vlastní prostředky, které se přidají do Azure. Ty zpřístupňují základní metody RESTful CRUD. Další informace o vytváření vlastních prostředků
Ukázkový vlastní poskytovatel prostředků s typy prostředků:
{
"properties": {
"resourceTypes": [
{
"name": "myCustomResources",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
Rozhraní API přidaná do Azure pro výše uvedenou ukázku:
| Metoda HTTP | Ukázkový identifikátor URI | Description |
|---|---|---|
| PUT | /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Volání rozhraní Azure REST API pro vytvoření nového prostředku |
| DELETE | /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Volání rozhraní Azure REST API k odstranění existujícího prostředku |
| GET | /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview |
Volání rozhraní Azure REST API pro načtení existujícího prostředku |
| GET | /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources?api-version=2018-09-01-preview |
Volání rozhraní Azure REST API pro načtení seznamu existujících prostředků |
Vytváření vlastních akcí
Akce popisují nové akce přidané do Azure. Ty můžou být zveřejněné nad poskytovatelem prostředků nebo vnořené pod resourceType. Další informace o vytváření vlastních akcí
Ukázkový vlastní poskytovatel prostředků s akcemi:
{
"properties": {
"actions": [
{
"name": "myCustomAction",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
Rozhraní API přidaná do Azure pro výše uvedenou ukázku:
| Metoda HTTP | Ukázkový identifikátor URI | Description |
|---|---|---|
| POST | /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction?api-version=2018-09-01-preview |
Volání rozhraní Azure REST API k aktivaci akce |
Hledám pomoc
Pokud máte dotazy k vývoji vlastního poskytovatele prostředků Azure, zkuste se zeptat na Stack Overflow. Podobná otázka už možná byla položena a zodpovězena, proto se před publikováním nejprve podívejte. Přidejte značku azure-custom-providers a získejte rychlou odpověď.
Další kroky
V tomto článku jste se dozvěděli o vlastních poskytovatelích prostředků. Pokud chcete vytvořit vlastního poskytovatele prostředků, přejděte k dalšímu článku.