Omówienie niestandardowych dostawców zasobów platformy Azure

Artykuł
07/20/2023

Dostawcy zasobów niestandardowych platformy Azure to platforma rozszerzalności na platformę Azure. Umożliwia definiowanie niestandardowych interfejsów API, których można użyć do wzbogacania domyślnego środowiska platformy Azure. W tej dokumentacji opisano:

Jak skompilować i wdrożyć niestandardowego dostawcę zasobów platformy Azure.
Jak używać niestandardowych dostawców zasobów platformy Azure do rozszerzania istniejących przepływów pracy.
Gdzie znaleźć przewodniki i przykłady kodu, aby rozpocząć pracę.

Diagram niestandardowych dostawców zasobów platformy Azure, przedstawiający relację między usługą Azure Resource Manager, niestandardowymi dostawcami zasobów i zasobami.

Ważne

Niestandardowi dostawcy zasobów są obecnie w publicznej wersji zapoznawczej. Ta wersja zapoznawcza nie jest objęta umową dotyczącą poziomu usług i nie zalecamy korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą być nieobsługiwane lub ograniczone. Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.

Co mogą zrobić niestandardowi dostawcy zasobów

Oto kilka przykładów tego, co można osiągnąć za pomocą niestandardowych dostawców zasobów platformy Azure:

Rozszerzanie interfejsu API REST usługi Azure Resource Manager w celu uwzględnienia usług wewnętrznych i zewnętrznych.
Włącz niestandardowe scenariusze na podstawie istniejących przepływów pracy platformy Azure.
Dostosowywanie kontrolki i efektu szablonów usługi Azure Resource Manager.

Co to jest niestandardowy dostawca zasobów

Dostawcy zasobów niestandardowych platformy Azure są tworzone przez utworzenie kontraktu między platformą Azure i punktem końcowym. Ten kontrakt definiuje listę nowych zasobów i akcji za pomocą nowego zasobu Microsoft.CustomProviders/resourceProviders. Niestandardowy dostawca zasobów będzie następnie uwidaczniać te nowe interfejsy API na platformie Azure. Dostawcy zasobów niestandardowych platformy Azure składają się z trzech części: niestandardowego dostawcy zasobów, punktów końcowych i zasobów niestandardowych.

Jak tworzyć niestandardowych dostawców zasobów

Niestandardowi dostawcy zasobów to lista kontraktów między platformą Azure i punktami końcowymi. Te kontrakty opisują sposób interakcji platformy Azure z ich punktami końcowymi. Dostawcy zasobów działają jak serwer proxy i będą przekazywać żądania i odpowiedzi do i z określonego punktu końcowego. Dostawca zasobów może określić dwa typy kontraktów: resourceTypes i actions. Są one włączone za pośrednictwem definicji punktów końcowych. Definicja punktu końcowego składa się z trzech pól: name, routingType i endpoint.

Przykładowy punkt końcowy:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}

Właściwość	Wymagane	Opis
name	Tak	Nazwa definicji punktu końcowego. Platforma Azure uwidoczni tę nazwę za pomocą interfejsu API w obszarze "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/ resourceProviders/{resourceProviderName}/{endpointDefinitionName}"
routingType	Nr	Określa typ kontraktu z punktem końcowym. Jeśli nie zostanie określony, wartość domyślna to "Serwer proxy".
endpoint	Tak	Punkt końcowy do kierowania żądań do. Będzie to obsługiwać odpowiedź, a także wszelkie skutki uboczne żądania.

Tworzenie zasobów niestandardowych

ResourceTypes opisują nowe zasoby niestandardowe dodawane do platformy Azure. Uwidaczniają podstawowe metody CRUD RESTful. Zobacz więcej na temat tworzenia zasobów niestandardowych

Przykładowy niestandardowy dostawca zasobów z parametrami resourceTypes:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

Interfejsy API dodane do platformy Azure dla powyższego przykładu:

HttpMethod	Przykładowy identyfikator URI	Opis
PUT	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview	Wywołanie interfejsu API REST platformy Azure w celu utworzenia nowego zasobu.
DELETE	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview	Wywołanie interfejsu API REST platformy Azure w celu usunięcia istniejącego zasobu.
GET	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources/{customResourceName}?api-version=2018-09-01-preview	Wywołanie interfejsu API REST platformy Azure w celu pobrania istniejącego zasobu.
GET	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomResources?api-version=2018-09-01-preview	Wywołanie interfejsu API REST platformy Azure w celu pobrania listy istniejących zasobów.

Kompilowanie akcji niestandardowych

Akcje opisują nowe akcje dodawane do platformy Azure. Można je uwidocznić u dostawcy zasobów lub zagnieżdżać w obszarze resourceType. Zobacz więcej na temat tworzenia akcji niestandardowych

Przykładowy niestandardowy dostawca zasobów z akcjami:

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

Interfejsy API dodane do platformy Azure dla powyższego przykładu:

HttpMethod	Przykładowy identyfikator URI	Opis
POST	/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/ myCustomAction?api-version=2018-09-01-preview	Wywołanie interfejsu API REST platformy Azure w celu aktywowania akcji.

Szukasz pomocy

Jeśli masz pytania dotyczące tworzenia niestandardowego dostawcy zasobów platformy Azure, spróbuj zadać pytanie w witrynie Stack Overflow. Podobne pytanie mogło już zostać zadane i odpowiedziało, więc sprawdź najpierw przed opublikowaniem. Dodaj tag azure-custom-providers , aby uzyskać szybką odpowiedź!

Następne kroki

W tym artykule przedstawiono informacje o niestandardowych dostawcach zasobów. Przejdź do następnego artykułu, aby utworzyć niestandardowego dostawcę zasobów.

Udostępnij za pośrednictwem