Настройка предварительных версий функций для подписки Azure

Статья
03/19/2024

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

Azure Feature Exposure Control (AFEC) доступна в пространстве имен Microsoft.Features. Предварительные версии функций имеют следующий формат для ИД ресурса:

Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}

Требуемый доступ

Чтобы перечислить и зарегистрировать предварительные версии функций в вашей подписке Azure, а также отменить их регистрацию, требуется доступ к действиям Microsoft.Features/*. Это разрешение могут предоставить встроенные роли Участник и Владелец. Вы также можете указать требуемый уровень доступа с помощью настраиваемой роли.

Предварительные версии функций

Вы можете получить список всех предварительных версий функций и их состояний регистрации для подписки Azure.

На портале отображается предварительная версия функции, только когда для службы с этой функцией явно указана возможность работы с предварительными версиями функций.

Войдите на портал Azure.
В поле поиска введите подписки и выберите Подписки.
Выберите ссылку в соответствии с названием своей подписки.
В меню слева выберите Предварительные версии функций в разделе Параметры.
Отобразится список доступных предварительных версий функций и текущее состояние регистрации.
Открыв раздел Предварительные версии функций, можно отфильтровать список по названию, состоянию илитипу:
- Фильтрация по названию: должен использоваться текст из названия предварительной версии функции, а не отображаемое имя.
- Фильтрация по состоянию: выберите раскрывающееся меню, затем выберите состояние. Портал не позволяет выполнять фильтрацию по состоянию Отмена регистрации.
- Фильтрация по типу: выберите раскрывающееся меню, затем выберите тип.

Чтобы перечислить все предварительные версии функций для подписки, используйте команду az feature list.

Форматом выходных данных по умолчанию для Azure CLI является JSON. См. дополнительные сведения о других форматах выходных данных в разделе Форматы выходных данных для команд Azure CLI.

az feature list

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "NotRegistered"
  },
  "type": "Microsoft.Features/providers/features"
}

Чтобы отфильтровать выходные данные определенного поставщика ресурсов, используйте параметр namespace. В этом примере параметр output определяет формат таблицы.

az feature list --namespace Microsoft.Compute --output table

Name                                                RegistrationState
-------------------------------------------------   -------------------
Microsoft.Compute/AHUB                              Unregistered
Microsoft.Compute/AllowManagedDisksReplaceOSDisk    Registered
Microsoft.Compute/AllowPreReleaseRegions            Pending
Microsoft.Compute/InGuestPatchVMPreview             NotRegistered

Чтобы отфильтровать выходные данные в случае определенной предварительной версии функции, используйте команду az feature show.

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  NotRegistered

Чтобы перечислить все предварительные версии функций для подписки, используйте командлет Get-AzProviderFeature.

Get-AzProviderFeature -ListAvailable

FeatureName      ProviderName     RegistrationState
-----------      ------------     -----------------
betaAccess       Microsoft.AAD    NotRegistered
previewAccess    Microsoft.AAD    Registered
tipAccess        Microsoft.AAD    Pending
testAccess       Microsoft.AAD    Unregistered

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

Get-AzProviderFeature -ProviderNamespace "Microsoft.Compute" -ListAvailable

FeatureName                          ProviderName        RegistrationState
-----------                          ------------        -----------------
AHUB                                 Microsoft.Compute   Unregistered
AllowManagedDisksReplaceOSDisk       Microsoft.Compute   Registered
AllowPreReleaseRegions               Microsoft.Compute   Pending
InGuestPatchVMPreview                Microsoft.Compute   NotRegistered

Вы можете отфильтровать выходные данные для определенной предварительной версии функции с помощью параметра FeatureName.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   NotRegistered

Регистрация предварительной версии функции

Зарегистрируйте предварительную версию функции для подписки Azure, чтобы предоставить больше возможностей для поставщика ресурсов. Некоторые предварительные версии функций требуют утверждения.

После регистрации предварительной версии функции для подписки отобразится одно из двух состояний: Зарегистрирована или Ожидание.

Состояние предварительной версии функции, которая не требует утверждения, — Зарегистрирована.
Если предварительная версия функции требует утверждения, состояние ее регистрации — Ожидание. Необходимо запросить утверждение от службы Azure, предлагающей предварительную версию функции. Как правило, доступ запрашивается через службу поддержки.
- Чтобы запросить утверждение, отправьте запрос на поддержку Azure.
- После утверждения регистрации текущее состояние предварительной версии функции заменится состоянием Зарегистрирована.

Некоторые службы должны использовать другие методы для получения утверждения по ожидающему запросу, например электронную почту. Проверьте объявления о предварительной версии функции, чтобы узнать, как получить доступ.

Войдите на портал Azure.
В поле поиска введите подписки и выберите Подписки.
Выберите ссылку в соответствии с названием своей подписки.
В меню слева выберите Предварительные версии функций в разделе Параметры.
Выберите ссылку в соответствии с предварительной версией функции, которую необходимо зарегистрировать.
Выберите Зарегистрировать.
Щелкните ОК.

Экран Предварительные версии функций обновится, и отобразится параметр Состояние предварительной версии функции.

Чтобы зарегистрировать предварительную версию функции, воспользуйтесь командой az feature register.

az feature register --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Registering"
  },
  "type": "Microsoft.Features/providers/features"
}

Для просмотра состояния регистрации воспользуйтесь командой az feature show.

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Registered

Примечание

При выполнении команды регистрации отображается сообщение о том, что после регистрации функции необходимо выполнить az provider register --namespace <provider-name> для распространения изменений.

Чтобы зарегистрировать предварительную версию функции, воспользуйтесь командлетом Register-AzProviderFeature.

Register-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registering

Для просмотра состояния регистрации воспользуйтесь командлетом Get-AzProviderFeature.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registered

Отмена регистрации предварительной версии функции

Завершив использование предварительной версии функции, отмените ее регистрацию для подписки Azure. После отмены регистрации функции могут отобразиться два разных состояния. При отмене регистрации на портале будет задано значение состояния Не зарегистрирована. Если вы отменяете регистрацию с помощью Azure CLI, PowerShell или REST API, для параметра состояния будет задано значение Отмена регистрации. Состояние отличается, так как портал удаляет регистрацию функции, а команды отменяют ее регистрацию. В обоих случаях эта функция больше не доступна для вашей подписки. В обоих случаях можно вернуться к использованию функции, повторно зарегистрировав ее.

Отменить регистрацию предварительных версий функций можно в разделе Предварительные версии функций. Значение Состояние заменяется значением Не зарегистрирована.

Войдите на портал Azure.
В поле поиска введите подписки и выберите Подписки.
Выберите ссылку в соответствии с названием своей подписки.
В меню слева выберите Предварительные версии функций в разделе Параметры.
Выберите ссылку в соответствии с предварительной версией функции, для которой необходимо отменить регистрацию.
Выберите Отмена регистрации.
Щелкните ОК.

Чтобы отменить регистрацию предварительной версии функции, воспользуйтесь командой az feature unregister. Состояние RegistrationState заменяется значением Отмена регистрации.

az feature unregister --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Unregistering"
  },
  "type": "Microsoft.Features/providers/features"
}

Для просмотра состояния отмены регистрации воспользуйтесь командой az feature show.

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Unregistered

Примечание

При выполнении команды отмены регистрации отображается сообщение о том, что после отмены регистрации функции необходимо выполнить az provider register --namespace <provider-name> для распространения изменений.

Чтобы найти предварительные версии функций с состоянием Отмена регистрации, воспользуйтесь указанной далее командой. Замените <ResourceProvider.Name> названием поставщика, таким как Microsoft.Compute.

В приведенном ниже примере показана предварительная версия функции с состоянием Отмена регистрации для поставщика ресурсов Microsoft.Compute.

az feature list --namespace <ResourceProvider.Name> --query "[?properties.state=='Unregistered'].{Name:name, RegistrationState:properties.state}" --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Unregistered

Чтобы отменить регистрацию предварительной версии функции, воспользуйтесь командлетом Unregister-AzProviderFeature. Состояние RegistrationState заменяется значением Отмена регистрации.

Unregister-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistering

Для просмотра состояния отмены регистрации воспользуйтесь командлетом Get-AzProviderFeature.

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

Get-AzProviderFeature  -ProviderNamespace "Microsoft.Compute" -ListAvailable | Where-Object { $_.RegistrationState -eq "Unregistered" }

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

Следующие шаги

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