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

Регистрация клиентов для отслеживания использования в Azure Stack Hub

В этой статье содержатся сведения об операциях регистрации. Эти операции можно использовать для:

  • Управление регистрацией клиентов.
  • Управление отслеживанием использования арендатора.

Добавление арендатора в реестр

Эту операцию можно использовать при добавлении нового клиента в регистрацию. Использование арендатора отражается в подписке Azure, связанной с тентантом Microsoft Entra.

Эту операцию можно также использовать для изменения подписки, связанной с клиентом. Вызовите PUT или PowerShell-командлет New-AzResource, чтобы перезаписать предыдущее сопоставление. Если вы используете модуль AzureRM PowerShell, используйте командлет New-AzureRMResource PowerShell.

Вы можете связать одну подписку Azure с клиентом. Если вы попытаетесь добавить вторую подписку к существующему арендатору, первая подписка перезаписывается.

Использование профилей API

Для выполнения следующих командлетов регистрации необходимо указать профиль API при запуске PowerShell. Профили API представляют набор поставщиков ресурсов Azure и их версий API. Они помогают использовать правильную версию API при взаимодействии с несколькими облаками Azure. Например, если вы работаете с несколькими облаками при работе с глобальной средой Azure и Azure Stack Hub, профили API указывают имя, соответствующее дате выпуска. Вы используете профиль от 2017-09-03.

Дополнительные сведения о профилях Azure Stack Hub и API см. в статье Управление профилями версий API в Azure Stack Hub.

Параметры

Параметр Описание
идентификаторРегистрационнойПодписки Подписка Azure, используемая для начальной регистрации.
ID подписки клиента Подписка Azure (а не Azure Stack Hub), принадлежащая клиенту, которая должна быть зарегистрирована. Необходимо создать предложение в рамках поставщика облачных решений (CSP) через Центр партнеров. Если у клиента несколько клиентов, создайте подписку для клиента, чтобы войти в Azure Stack Hub. Идентификатор подписки клиента чувствителен к регистру.
resourceGroup Группа ресурсов в Azure, в которой хранится регистрация.
имя регистрации Имя регистрации Azure Stack Hub. Это объект, хранящийся в Azure. Имя обычно находится в виде azurestack-CloudID, где CloudID — это идентификатор облака развертывания Azure Stack Hub.

Заметка

Клиенты должны быть зарегистрированы в каждом развертывании Azure Stack Hub, которое они используют. Если клиент использует несколько Azure Stack Hub, обновите начальные регистрации каждого развертывания в подписке клиента.

PowerShell

Используйте командлет New-AzResource для добавления арендатора. Подключитесь к Azure, а затем из командной строки с повышенными правами выполните следующую команду:

New-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

Вызов API

операции: PUT
запроса: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
ответа: создано 201
текст ответа: пустой

Список всех зарегистрированных клиентов

Получите список всех клиентов, добавленных в регистрацию.

Заметка

Если клиент не зарегистрирован, вы не получите ответ.

Параметры

Параметр Описание
идентификаторПодпискиРегистрации Подписка Azure, используемая для начальной регистрации.
resourceGroup Группа ресурсов в Azure, в которой хранится регистрация.
имя регистрации Имя регистрации вашего развертывания Azure Stack Hub. Это объект, хранящийся в Azure. Имя обычно находится в виде azurestack-CloudID, где CloudID — это идентификатор облака развертывания Azure Stack Hub.

PowerShell

Используйте командлет Get-AzResource для перечисления всех зарегистрированных арендаторов. Подключитесь к Azure Stack Hub— а затем в командной строке с повышенными правами выполните следующий командлет:

Get-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions" -ApiVersion 2017-06-01

Вызов API

Список всех сопоставлений арендаторов можно получить с помощью операции GET.

операция: GET
запроса: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
ответ: 200
Содержимое ответа:

{
    "value": [{
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 1}",
            "name": " cspSubscriptionId 1",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId1" }
        },
        {
            "id": " subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{ cspSubscriptionId 2}",
            "name": " cspSubscriptionId2 ",
            "type": "Microsoft.AzureStack\customerSubscriptions",
            "properties": { "tenantId": "tId2" }
        }
    ],
    "nextLink": "{originalRequestUrl}?$skipToken={opaqueString}"
}

Удалить сопоставление арендатора

Вы можете удалить арендатора, который был добавлен в регистрацию. Если этот клиент по-прежнему использует ресурсы в Azure Stack Hub, их использование взимается с подписки, используемой в первоначальной регистрации Azure Stack Hub.

Параметры

Параметр Описание
идентификаторПодпискиРегистрации Идентификатор подписки для регистрации.
resourceGroup Группа ресурсов для регистрации.
имя регистрации Название регистрации.
ИдентификаторПодпискиКлиента Идентификатор подписки клиента. Идентификатор подписки клиента чувствителен к регистру.

PowerShell

Используйте командлет Remove-AzResource для удаления арендатора. Подключитесь к Azure Stack Hub— а затем в командной строке с повышенными правами выполните следующий командлет:

Remove-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01

Вызов API

Сопоставления арендаторов можно удалить с помощью операции DELETE.

операции: УДАЛИТЬ
запроса: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
ответ: 204 Нет содержимого
текст ответа: пустой

Дальнейшие действия