Поделиться через

Общие сведения о пользовательских поставщиках ресурсов Azure

Это важно

Пользовательские провайдеры ресурсов в настоящее время находятся в общедоступной версии предварительного просмотра. Эта предварительная версия предоставляется без соглашения об уровне обслуживания и не рекомендована для использования рабочей среде. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Для получения дополнительной информации см. Дополнительные условия использования для предварительных версий Microsoft Azure.

В 2026 году Azure Resource Manager прекратит управление службой настраиваемого поставщика ресурсов (CuRP).

Мы отменим функцию к 31 октября 2026 года. Мы будем выполнять тест крика 24 февраля 2026 года, как часть этого нерекомендуемого. 31 июля 2026 г. создание, обновление, исправления и действия для пользовательских ресурсов и поставщиков ресурсов будут заблокированы. Вы сможете только читать и удалять пользовательские ресурсы и их поставщиков.

Мы понимаем, что это устаревание может причинить неудобства вам и вашей команде. Ниже приведены некоторые потенциальные варианты CuRP, которые можно использовать для поддержки существующих рабочих процессов.

Если ваш сценарий CuRP:

  • Включает только активацию конечной точки без необходимости постоянного управления ресурсами, рассмотрим сценарии развертывания.
  • Только включает активацию конечной точки без необходимости постоянного управления ресурсами. Если вы используете Bicep, рассмотрите возможность использования Bicep Extensions.
  • Включает в себя активацию нескольких различных конечных точек или служб для решения, рассмотрим функции Azure.

Если у вас есть вопросы, попросите своего менеджера по работе с клиентами в Microsoft отправить электронное письмо на [email protected], указав ваше имя, название компании, электронный адрес и идентификатор подписки.

Специальные поставщики ресурсов Azure — это платформа расширяемости для Azure. Он позволяет определять пользовательские API, которые можно использовать для обогащения интерфейса Azure по умолчанию. В этой документации описано:

  • Создание и развертывание пользовательского поставщика ресурсов Azure.
  • Использование настраиваемых поставщиков ресурсов Azure для расширения существующих рабочих процессов.
  • Где найти руководства и примеры кода для начала работы.

Схема настраиваемых поставщиков ресурсов Azure, отображающая связь между Azure Resource Manager, настраиваемыми поставщиками ресурсов и ресурсами.

Что может сделать настраиваемые поставщики ресурсов

Ниже приведены некоторые примеры того, что можно достичь с помощью пользовательских поставщиков ресурсов Azure:

  • Расширение REST API Azure Resource Manager для включения внутренних и внешних служб.
  • Включите пользовательские сценарии на основе существующих рабочих процессов Azure.
  • Настройте управление и действие в шаблонах Azure Resource Manager.

Что такое настраиваемый поставщик ресурсов

Пользовательские поставщики ресурсов Azure создаются путем заключения контракта между Azure и конечной точкой соединения. Этот контракт определяет список новых ресурсов и действий с помощью нового ресурса Microsoft.CustomProviders/resourceProviders. Затем настраиваемый поставщик ресурсов предоставит эти новые API в Azure. Настраиваемые поставщики ресурсов Azure состоят из трех частей: настраиваемого поставщика ресурсов, конечных точек и пользовательских ресурсов.

Создание настраиваемых поставщиков ресурсов

Настраиваемые поставщики ресурсов — это список контрактов между Azure и конечными точками. Эти контракты описывают взаимодействие Azure с конечными точками. Поставщики ресурсов действуют как прокси и будут перенаправлять запросы и ответы на указанные конечные точки и из них. Поставщик ресурсов может указать два типа контрактов: resourceTypes и действия. Они активируются через определения конечных точек. Определение конечной точки состоит из трех полей: имя, тип маршрутизации, и конечная точка.

Пример конечной точки:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}
Недвижимость Обязательно Description
имя да Имя определения конечной точки. Azure предоставит это имя через свой API в разделе "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomProviders/
resourceProviders/{resourceProviderName}/{endpointDefinitionName}'
routingType нет Определяет тип контракта с конечной точкой. Если он не указан, по умолчанию используется значение Proxy.
endpoint да Конечная точка для маршрутизации запросов. Это будет обрабатывать ответ, а также любые побочные эффекты запроса.

Создание пользовательских ресурсов

ResourceTypes описывает новые настраиваемые ресурсы, добавленные в Azure. Эти методы предоставляют основные методы RESTful CRUD. Узнайте больше о создании пользовательских ресурсов

Пример пользовательского поставщика ресурсов с resourceTypes:

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

API, добавленные в Azure для приведенного выше примера:

Метод HTTP Пример универсального кода ресурса Description
ПОСТАВИТЬ /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Вызов REST API Azure для создания нового ресурса.
Удалить /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Вызов REST API Azure для удаления существующего ресурса.
ПОЛУЧАЙ /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources/{customResourceName}?api-version=2018-09-01-preview		 Вызов REST API Azure для получения существующего ресурса.
ПОЛУЧАЙ /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomResources?api-version=2018-09-01-preview		 Вызов REST API Azure для получения списка существующих ресурсов.

Создание пользовательских действий

Действия описывают новые действия, добавленные в Azure. Они могут быть представлены поверх поставщика ресурсов или вложены в тип ресурса. Узнайте больше о создании пользовательских действий

Пример пользовательского поставщика ресурсов с действиями:

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

API, добавленные в Azure для приведенного выше примера:

Метод HTTP Пример универсального кода ресурса Description
ПОСТ /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/
providers/Microsoft.CustomProviders/resourceProviders/{resourceProviderName}/
myCustomAction?api-version=2018-09-01-preview		 Вызов REST API Azure для активации действия.

Ищу помощь

Если у вас есть вопросы о разработке пользовательского поставщика ресурсов Azure, попробуйте задать запрос в Stack Overflow. Возможно, аналогичный вопрос уже был задан и на него уже был дан ответ, поэтому сначала убедитесь, проверив, перед публикацией. Добавьте тег azure-custom-providers , чтобы получить быстрый ответ!

Дальнейшие шаги

В этой статье вы узнали о настраиваемых поставщиках ресурсов. Перейдите к следующей статье, чтобы создать настраиваемый поставщик ресурсов.

  • Last updated on