Udostępnij za pośrednictwem

Rejestrowanie dzierżaw na potrzeby śledzenia użycia w usłudze Azure Stack Hub

  • Artykuł

Ten artykuł zawiera szczegółowe informacje o operacjach rejestracji. Za pomocą tych operacji można wykonywać następujące operacje:

  • Zarządzanie rejestracjami dzierżawy.
  • Zarządzanie śledzeniem użycia dzierżawy.

Dodawanie dzierżawy do rejestracji

Możesz użyć tej operacji, gdy chcesz dodać nową dzierżawę do rejestracji. Użycie dzierżawy jest zgłaszane w ramach subskrypcji platformy Azure połączonej z dzierżawą Microsoft Entra.

Tej operacji można również użyć do zmiany subskrypcji skojarzonej z dzierżawą. Wywołaj polecenie PUT lub polecenie cmdlet new-AzResource programu PowerShell, aby zastąpić poprzednie mapowanie. Jeśli używasz modułu AzureRM PowerShell, użyj polecenia cmdlet New-AzureRMResource programu PowerShell.

Możesz skojarzyć pojedynczą subskrypcję platformy Azure z dzierżawą. Jeśli spróbujesz dodać drugą subskrypcję do istniejącej dzierżawy, pierwsza subskrypcja zostanie zastąpiona.

Korzystanie z profilów interfejsu API

Następujące polecenia cmdlet rejestracji wymagają określenia profilu interfejsu API podczas uruchamiania programu PowerShell. Profile interfejsów API reprezentują zestaw dostawców zasobów platformy Azure i ich wersji interfejsu API. Ułatwiają one korzystanie z odpowiedniej wersji interfejsu API podczas interakcji z wieloma chmurami platformy Azure. Jeśli na przykład pracujesz z wieloma chmurami podczas pracy z globalną platformą Azure i usługą Azure Stack Hub, profile interfejsu API określają nazwę zgodną z datą wydania. Profil 2017-09-03 jest używany.

Aby uzyskać więcej informacji na temat profilów usługi Azure Stack Hub i interfejsu API, zobacz Zarządzanie profilami wersji interfejsu API w usłudze Azure Stack Hub.

Parametry

Parametr Opis
registrationSubscriptionID Subskrypcja platformy Azure, która została użyta do początkowej rejestracji.
customerSubscriptionID Subskrypcja platformy Azure (a nie Azure Stack Hub) należąca do klienta do zarejestrowania. Należy utworzyć w ofercie dostawcy rozwiązań w chmurze (CSP) za pośrednictwem Centrum partnerskiego. Jeśli klient ma więcej niż jedną dzierżawę, utwórz subskrypcję dla dzierżawy, aby zalogować się do usługi Azure Stack Hub. W identyfikatorze subskrypcji klienta jest rozróżniana wielkość liter.
resourceGroup Grupa zasobów na platformie Azure, w której jest przechowywana rejestracja.
registrationName Nazwa rejestracji usługi Azure Stack Hub. Jest to obiekt przechowywany na platformie Azure. Nazwa jest zwykle w postaci azurestack-CloudID, gdzie CloudID jest identyfikatorem chmury wdrożenia usługi Azure Stack Hub.

Uwaga

Dzierżawy muszą być zarejestrowane w każdym wdrożeniu usługi Azure Stack Hub, którego używają. Jeśli dzierżawa używa więcej niż jednej usługi Azure Stack Hub, zaktualizuj początkowe rejestracje każdego wdrożenia przy użyciu subskrypcji dzierżawy.

PowerShell

Użyj polecenia cmdlet New-AzResource , aby dodać dzierżawę. Połącz się z platformą Azure, a następnie w wierszu polecenia z podwyższonym poziomem uprawnień uruchom następujące polecenie:

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

Wywołanie interfejsu API

Operacja: PUT
Identyfikator REQUESTURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Odpowiedź: Utworzono 201
Treść odpowiedzi: puste

Wyświetlanie listy wszystkich zarejestrowanych dzierżaw

Pobierz listę wszystkich dzierżaw, które zostały dodane do rejestracji.

Uwaga

Jeśli nie zarejestrowano żadnych dzierżaw, nie otrzymasz odpowiedzi.

Parametry

Parametr Opis
registrationSubscriptionId Subskrypcja platformy Azure, która została użyta do początkowej rejestracji.
resourceGroup Grupa zasobów na platformie Azure, w której jest przechowywana rejestracja.
registrationName Nazwa rejestracji wdrożenia usługi Azure Stack Hub. Jest to obiekt przechowywany na platformie Azure. Nazwa jest zwykle w postaci azurestack-CloudID, gdzie CloudID jest identyfikatorem chmury wdrożenia usługi Azure Stack Hub.

PowerShell

Użyj polecenia cmdlet Get-AzResource , aby wyświetlić listę wszystkich zarejestrowanych dzierżaw. Połącz się z usługą Azure Stack Hub, a następnie z poziomu wiersza polecenia z podwyższonym poziomem uprawnień uruchom następujące polecenie cmdlet:

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

Wywołanie interfejsu API

Listę wszystkich mapowań dzierżawy można uzyskać przy użyciu operacji GET.

Operacja: GET
Identyfikator REQUESTURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Odpowiedź: 200
Treść odpowiedzi:

{
    "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}"
}

Usuwanie mapowania dzierżawy

Możesz usunąć dzierżawę, która została dodana do rejestracji. Jeśli ta dzierżawa nadal korzysta z zasobów w usłudze Azure Stack Hub, ich użycie jest naliczane do subskrypcji używanej w początkowej rejestracji usługi Azure Stack Hub.

Parametry

Parametr Opis
registrationSubscriptionId Identyfikator subskrypcji rejestracji.
resourceGroup Grupa zasobów rejestracji.
registrationName Nazwa rejestracji.
customerSubscriptionId Identyfikator subskrypcji klienta. W identyfikatorze subskrypcji klienta jest rozróżniana wielkość liter.

PowerShell

Użyj polecenia cmdlet Remove-AzResource , aby usunąć dzierżawę. Połącz się z usługą Azure Stack Hub, a następnie z poziomu wiersza polecenia z podwyższonym poziomem uprawnień uruchom następujące polecenie cmdlet:

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

Wywołanie interfejsu API

Mapowania dzierżawy można usunąć przy użyciu operacji DELETE.

Operacja: DELETE
Identyfikator REQUESTURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Odpowiedź: 204 Brak zawartości
Treść odpowiedzi: puste

Następne kroki