Vlastní poskytovatelé prostředků Azure – přehled
Vlastní poskytovatelé prostředků Azure je rozšiřitelná platforma pro Azure. Umožňuje definovat vlastní rozhraní API, která se dají použít k rozšíření výchozích možností Azure. Tato dokumentace popisuje:
- Jak vytvořit a nasadit poskytovatele vlastního prostředku Azure
- Jak využívat vlastní poskytovatele prostředků Azure pro rozšiřování stávajících pracovních postupů.
- Kde najít příručky a ukázky kódu, které vám pomohou začít.

Důležité
Vlastní zprostředkovatelé jsou momentá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 vlastní poskytovatelé prostředků dělat
Tady je několik příkladů toho, co můžete dosáhnout pomocí vlastních poskytovatelů prostředků Azure:
- Rozšíří Azure Resource Manager REST API tak, aby zahrnovalo 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 kontraktu mezi Azure a koncovým bodem. Tato Smlouva definuje seznam nových prostředků a akcí pomocí nového prostředku, Microsoft. CustomProviders/resourceProviders. Vlastní poskytovatel prostředků pak tato nová rozhraní API zveřejní v Azure. Vlastní poskytovatelé prostředků Azure se skládají ze tří částí: vlastní poskytovatel prostředků, koncové body a vlastní prostředky.
Sestavování vlastních poskytovatelů prostředků
Vlastní poskytovatelé prostředků jsou seznam smluv mezi Azure a koncovými body. Tato smlouva popisuje, jak by měl Azure spolupracovat s koncovým bodem. Poskytovatel prostředků funguje jako proxy a předává žádosti a odpovědi na zadaný koncový bod a. Poskytovatel prostředků může určit dva typy smluv: prostředky a Akce. Tyto jsou povolené prostřednictvím definic koncových bodů. Definice koncového bodu se skládá ze tří polí: název, routingType a 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 rozhraní API v části/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}' |
| routingType | 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ého mají být směrovány požadavky. Tím se zpracuje odpověď i všechny vedlejší účinky žádosti. |
Sestavování vlastních prostředků
Resources popisují nové vlastní prostředky, které se přidají do Azure. Ty zveřejňují základní metody RESTful CRUD. Další informace o vytváření vlastních prostředků
Ukázkový vlastní poskytovatel prostředků s prostředky k dissourcetype:
{
"properties": {
"resourceTypes": [
{
"name": "myCustomResources",
"routingType": "Proxy",
"endpoint": "https://{endpointURL}/"
}
]
},
"location": "eastus"
}
Rozhraní API přidané do Azure pro výše uvedenou ukázku:
| HttpMethod | Ukázkový identifikátor URI | Popis |
|---|---|---|
| PUT | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ Zprostředkovatelé/Microsoft. CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}? API-Version = 2018-09 -01-Preview |
Azure REST API volání pro vytvoření nového prostředku. |
| DELETE | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ Zprostředkovatelé/Microsoft. CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}? API-Version = 2018-09 -01-Preview |
Volání Azure REST API k odstranění existujícího prostředku. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ Zprostředkovatelé/Microsoft. CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}? API-Version = 2018-09 -01-Preview |
Rozhraní Azure REST API volá načtení existujícího prostředku. |
| GET | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ Zprostředkovatelé/Microsoft. CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources? API-Version = 2018-09 -01-Preview |
Rozhraní Azure REST API volá načtení seznamu existujících prostředků. |
Sestavování vlastních akcí
Akce popisují nové akce, které se přidají do Azure. Můžou být vystavené na poskytovateli prostředků nebo můžou být vnořené pod možností 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:
| HttpMethod | Ukázkový identifikátor URI | Popis |
|---|---|---|
| POST | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ Zprostředkovatelé/Microsoft. CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction? API-Version = 2018-09 -01-Preview |
Volání služby Azure REST API k aktivaci akce. |
Hledáte nápovědu
Pokud máte dotazy pro vývoj vlastních poskytovatelů prostředků Azure, zkuste požádat o Stack Overflow. Podobná otázka již mohla být požádána o zodpovězení a byla zodpovězena, proto nejprve před odesláním zaregistrujte. Přidejte značku azure-custom-providers , abyste získali rychlou odpověď.
Další kroky
V tomto článku jste se dozvěděli o vlastních poskytovatelích. Pokud chcete vytvořit vlastního poskytovatele, přečtěte si další článek.