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

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

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

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

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

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

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

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

Портал

Примечание.

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

1. Войдите на портал Azure.

2. В поле поиска введите подписки и выберите Подписки.

   

3. Выберите ссылку в соответствии с названием своей подписки.

   

4. В меню слева в разделе "Параметры" выберите пункт "Предварительный просмотр функций".

   

5. Отобразится список доступных предварительных версий функций и текущее состояние регистрации.

   

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

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

   

Azure CLI

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

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

az feature list

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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

Azure PowerShell

Чтобы перечислить все предварительные версии функций для подписки, используйте командлет 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.
  • После утверждения регистрации текущее состояние предварительной версии функции заменится состоянием Зарегистрирована.

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

Портал

1. Войдите на портал Azure.

2. В поле поиска введите подписки и выберите Подписки.

3. Выберите ссылку в соответствии с названием своей подписки.

4. В меню слева выберите Предварительные версии функций в разделе Параметры.

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

6. Выберите Зарегистрировать.

   

7. Нажмите ОК.

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

Azure CLI

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

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

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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> после регистрации функции для распространения изменений.

Azure PowerShell

Чтобы зарегистрировать предварительную версию функции, воспользуйтесь командлетом 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 состояние отменяется. Состояние отличается, так как портал удаляет регистрацию функции, а команды отменяют ее регистрацию. В обоих случаях эта функция больше не доступна для вашей подписки. Вы можете снова войти в функцию, повторно зарегистрируя ее.

Портал

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

1. Войдите на портал Azure.

2. В поле поиска введите подписки и выберите Подписки.

3. Выберите ссылку в соответствии с названием своей подписки.

4. В меню слева в разделе "Параметры" выберите пункт "Предварительный просмотр функций".

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

6. Выберите Отмена регистрации.

   

7. Нажмите ОК.

Azure CLI

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

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

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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

Azure PowerShell

Чтобы отменить регистрацию предварительной версии функции, воспользуйтесь командлетом 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

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

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

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

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

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

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

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