Registrace tenantů pro sledování využití ve službě Azure Stack Hub
Tento článek obsahuje podrobnosti o operacích registrace. Tyto operace můžete použít k těmto operacím:
- Správa registrací tenantů
- Správa sledování využití tenanta
Přidání tenanta k registraci
Tuto operaci můžete použít, když chcete k registraci přidat nového tenanta. Využití tenanta se hlásí v rámci předplatného Azure připojeného k tenantovi Microsoft Entra.
Tuto operaci můžete použít také ke změně předplatného přidruženého k tenantovi. Pokud chcete přepsat předchozí mapování, zavolejte put nebo rutinu PowerShellu New-AzResource . Pokud používáte modul AzureRM PowerShell, použijte rutinu PowerShellu New-AzureRMResource .
K tenantovi můžete přidružit jedno předplatné Azure. Pokud se pokusíte přidat druhé předplatné do existujícího tenanta, první předplatné se přepíše.
Použití profilů rozhraní API
Následující registrační rutiny vyžadují, abyste při spuštění PowerShellu zadali profil rozhraní API. Profily rozhraní API představují sadu poskytovatelů prostředků Azure a jejich verzí rozhraní API. Pomáhají používat správnou verzi rozhraní API při interakci s více cloudy Azure. Pokud například při práci s globálními službami Azure a Azure Stack Hub pracujete s více cloudy, profily rozhraní API určují název, který odpovídá datu vydání. Použijete profil z 3. 9. 2017 .
Další informace o službě Azure Stack Hub a profilech rozhraní API najdete v tématu Správa profilů verzí rozhraní API ve službě Azure Stack Hub.
Parametry
Parametr | Popis |
---|---|
registrationSubscriptionID | Předplatné Azure, které se použilo k počáteční registraci. |
customerSubscriptionID | Předplatné Azure (ne Azure Stack Hub), které patří zákazníkovi, které se má zaregistrovat. Musí se vytvořit v nabídce CSP (Cloud Solution Provider) prostřednictvím Partnerského centra. Pokud má zákazník více než jednoho tenanta, vytvořte předplatné, aby se tenant přihlásil ke službě Azure Stack Hub. V ID předplatného zákazníka se rozlišují velká a malá písmena. |
resourceGroup | Skupina prostředků v Azure, ve které je vaše registrace uložená. |
registrationName | Název registrace služby Azure Stack Hub. Jedná se o objekt uložený v Azure. Název je obvykle ve formátu azurestack-CloudID, kde CloudID je ID cloudu vašeho nasazení služby Azure Stack Hub. |
Poznámka
Tenanti musí být zaregistrovaní v každém nasazení služby Azure Stack Hub, které používají. Pokud tenant používá více než jednu službu Azure Stack Hub, aktualizujte počáteční registrace každého nasazení pomocí předplatného tenanta.
PowerShell
Pomocí rutiny New-AzResource přidejte tenanta. Připojte se k Azure a pak na příkazovém řádku se zvýšenými oprávněními spusťte následující příkaz:
New-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01
Volání rozhraní API
Operace: PUT
Identifikátor RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Odpověď: 201 Vytvořeno
Text odpovědi: Prázdné
Výpis všech registrovaných tenantů
Získejte seznam všech tenantů, kteří byli přidáni k registraci.
Poznámka
Pokud nejsou zaregistrovaní žádní tenanti, nedostanete odpověď.
Parametry
Parametr | Popis |
---|---|
registrationSubscriptionId | Předplatné Azure, které se použilo k počáteční registraci. |
resourceGroup | Skupina prostředků v Azure, ve které je vaše registrace uložená. |
registrationName | Název registrace vašeho nasazení služby Azure Stack Hub. Jedná se o objekt uložený v Azure. Název je obvykle ve formě azurestack-CloudID, kde CloudID je ID cloudu vašeho nasazení služby Azure Stack Hub. |
PowerShell
Pomocí rutiny Get-AzResource vypište seznam všech registrovaných tenantů. Připojte se ke službě Azure Stack Hub a potom z výzvy se zvýšenými oprávněními spusťte následující rutinu:
Get-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions" -ApiVersion 2017-06-01
Volání rozhraní API
Seznam všech mapování tenantů můžete získat pomocí operace GET.
Operace: GET
Identifikátor RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
Odpověď: 200
Text odpovědi:
{
"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}"
}
Odebrání mapování tenanta
Tenanta přidaného k registraci můžete odebrat. Pokud tento tenant stále používá prostředky ve službě Azure Stack Hub, jejich využití se účtuje do předplatného použitého při počáteční registraci služby Azure Stack Hub.
Parametry
Parametr | Popis |
---|---|
registrationSubscriptionId | ID předplatného pro registraci. |
resourceGroup | Skupina prostředků pro registraci. |
registrationName | Název registrace. |
customerSubscriptionId | ID předplatného zákazníka. V ID předplatného zákazníka se rozlišují velká a malá písmena. |
PowerShell
K odebrání tenanta použijte rutinu Remove-AzResource . Připojte se ke službě Azure Stack Hub a pak na příkazovém řádku se zvýšenými oprávněními spusťte následující rutinu:
Remove-AzResource -ResourceId "subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}" -ApiVersion 2017-06-01
Volání rozhraní API
Mapování tenantů můžete odebrat pomocí operace DELETE.
Operace: DELETE
Identifikátor RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
Odpověď: 204 Žádný obsah
Text odpovědi: Prázdné