Přehled vlastních poskytovatelů prostředků Azure

Článek
07/20/2023

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.

Diagram vlastních poskytovatelů prostředků Azure zobrazující vztah mezi Azure Resource Manager, vlastními poskytovateli prostředků a prostředky

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.

Sdílet prostřednictvím