Udostępnij przez


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

Ważne

Dostosowani 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ą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.

W 2026 r. usługa Niestandardowego dostawcy zasobów (CuRP) zostanie wycofana przez Azure Resource Manager.

Funkcja zostanie wycofana do 31 października 2026 r. Będziemy przeprowadzać test ciszy 24 lutego 2026 w ramach tego procesu wycofywania. 31 lipca 2026 r. zostanie zablokowane tworzenie, aktualizowanie, poprawki i akcje dla zasobów niestandardowych i dostawców zasobów. Będzie można odczytywać i usuwać tylko zasoby niestandardowe i dostawców zasobów.

Rozumiemy, że wycofanie może być niedogodnością dla Ciebie i Twojego zespołu. Poniżej przedstawiono niektóre potencjalne alternatywy CuRP, których można użyć do obsługi istniejących przepływów pracy.

Jeśli scenariusz CuRP jest następujący:

  • Wymaga tylko wyzwolenia punktu końcowego bez konieczności trwałego zarządzania zasobami, rozważ użycie skryptów wdrażania.
  • Jeśli obejmuje to tylko wyzwalanie punktu końcowego bez potrzeby trwałego zarządzania zasobami, a używasz Bicep, rozważ użycie rozszerzeń Bicep.
  • Obejmuje wyzwalanie kilku różnych punktów końcowych lub usług dla rozwiązania, rozważ użycie usługi Azure Functions.

Jeśli masz jakiekolwiek pytania, poproś menedżera kont Microsoft, aby przesłał email na curpdeprecation@microsoft.com zawierający twoje imię, nazwę firmy, kontakt e-mail i identyfikator subskrypcji.

Dostosowani dostawcy zasobów Azure to platforma do rozszerzania możliwości Azure. Umożliwia zdefiniowanie niestandardowych interfejsów API, których można użyć do wzbogacania domyślnego środowiska platformy Azure. W tej dokumentacji opisano:

  • Jak utworzyć 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.

Co mogą zrobić dostawcy zasobów niestandardowych

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 scenariusze niestandardowe w oparciu o istniejące przepływy 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ą tworzeni przez utworzenie kontraktu między platformą Azure i punktem końcowym. Ten kontrakt definiuje listę nowych zasobów i akcji za pośrednictwem nowego zasobu Microsoft.CustomProviders/resourceProviders. Niestandardowy dostawca zasobów będzie następnie udostępniać te nowe interfejsy API w 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 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 pomocą 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}/"
}
Majątek Wymagania Description
nazwa tak Nazwa definicji punktu końcowego. Platforma Azure uwidacznia tę nazwę za pośrednictwem interfejsu API w obszarze "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/
resourceProviders/{resourceProviderName}/{endpointDefinitionName}"
routingType (typ trasy) bez Określa typ kontraktu z punktem końcowym. Jeśli nie zostanie określony, domyślnie będzie to "Serwer proxy".
punkt końcowy tak Punkt końcowy do kierowania żądań. 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ą one podstawowe metody CRUD RESTful. Zobacz więcej na temat tworzenia zasobów niestandardowych

Przykładowy niestandardowy dostawca zasobów z typami zasobów:

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

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

Metoda HTTP Przykładowy identyfikator URI Description
POŁÓŻ /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.
USUŃ /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.

Tworzenie akcji niestandardowych

Akcje opisują nowe akcje dodawane do platformy Azure. Można je uwidocznić na wierzchu dostawcy zasobów lub zagnieżdżone 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:

Metoda HTTP Przykładowy identyfikator URI Description
Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST". /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomAction?api-version=2018-09-01-preview
Wywołanie interfejsu API REST platformy Azure, aby aktywować akcję.

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 udzielono odpowiedzi, więc sprawdź najpierw przed opublikowaniem. Dodaj tag azure-custom-providers , aby uzyskać szybką odpowiedź!

Dalsze kroki

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