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

В этой статье содержатся сведения об операциях регистрации. Они позволяют выполнить такие задачи:

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

Добавление клиента в регистрацию

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

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

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

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

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

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

Параметры

Параметр Описание
registrationSubscriptionID Подписка Azure, которая использовалась для первоначальной регистрации.
customerSubscriptionID Подписка Azure (не Azure Stack Hub), принадлежащая пользователю, для которого выполняется регистрация. Ее нужно создать в предложении поставщика облачных решений через Центр партнеров. Если у пользователя имеется несколько клиентов, подписку нужно создать в клиенте, который будет использоваться для входа в Azure Stack Hub. В идентификаторе подписки клиента учитывается регистр.
resourceGroup Группа ресурсов Azure, в которой хранятся данные об этой регистрации.
registrationName Имя регистрации 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

Operation: ОТПРАВКА
URI запроса: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Ответ: 201 Создано
Текст ответа: Empty

Перечисление всех зарегистрированных клиентов

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

Примечание

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

Параметры

Параметр Описание
registrationSubscriptionId Подписка Azure, которая использовалась для первоначальной регистрации.
resourceGroup Группа ресурсов Azure, в которой хранятся данные об этой регистрации.
registrationName Имя регистрации для развертывания 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.

Operation: GET
URI запроса: 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.

Параметры

Параметр Описание
registrationSubscriptionId Идентификатор подписки для регистрации.
resourceGroup Группа ресурсов для регистрации.
registrationName Имя регистрации.
customerSubscriptionId Идентификатор подписки клиента. В идентификаторе подписки клиента учитывается регистр.

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.

Operation: DELETE
URI запроса: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Ответ: 204 No Content (содержимое отсутствует)
Текст ответа: Empty

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