Azure Stack Hub에서 사용 추적에 대 한 테 넌 트 등록Register tenants for usage tracking in Azure Stack Hub

이 문서에는 등록 작업에 대 한 세부 정보가 포함 되어 있습니다.This article contains details about registration operations. 이러한 작업을 사용 하 여 다음 작업을 수행할 수 있습니다.You can use these operations to:

  • 테 넌 트 등록을 관리 합니다.Manage tenant registrations.
  • 테 넌 트 사용 추적을 관리 합니다.Manage tenant usage tracking.

등록에 테 넌 트 추가Add tenant to registration

등록에 새 테 넌 트를 추가 하려는 경우이 작업을 사용할 수 있습니다.You can use this operation when you want to add a new tenant to your registration. 테 넌 트 사용은 Azure Active Directory (Azure AD) 테 넌 트와 연결 된 Azure 구독에서 보고 됩니다.Tenant usage is reported under an Azure subscription connected with the Azure Active Directory (Azure AD) tenant.

이 작업을 사용 하 여 테 넌 트와 연결 된 구독을 변경할 수도 있습니다.You can also use this operation to change the subscription associated with a tenant. PUT 또는 AzResource PowerShell cmdlet을 호출 하 여 이전 매핑을 덮어씁니다.Call PUT or the New-AzResource PowerShell cmdlet to overwrite the previous mapping. AzureRM PowerShell 모듈을 사용 하는 경우 Remove-azureresource powershell cmdlet을 사용 합니다.If you are using the AzureRM PowerShell module, use New-AzureResource PowerShell cmdlet.

단일 Azure 구독을 테 넌 트와 연결할 수 있습니다.You can associate a single Azure subscription with a tenant. 기존 테 넌 트에 두 번째 구독을 추가 하려고 하면 첫 번째 구독을 덮어씁니다.If you try to add a second subscription to an existing tenant, the first subscription is overwritten.

API 프로필 사용Use API profiles

다음 등록 cmdlet은 PowerShell을 실행 하는 경우 API 프로필을 지정 해야 합니다.The following registration cmdlets require that you specify an API profile when running PowerShell. API 프로필은 Azure 리소스 공급자 및 해당 API 버전의 집합을 나타냅니다.API profiles represent a set of Azure resource providers and their API versions. 여러 Azure 클라우드와 상호 작용할 때 적절 한 버전의 API를 사용 하는 데 도움이 됩니다.They help you use the right version of the API when interacting with multiple Azure clouds. 예를 들어, 글로벌 Azure 및 Azure Stack 허브로 작업 하는 경우 여러 클라우드로 작업 하는 경우 API 프로필은 릴리스 날짜와 일치 하는 이름을 지정 합니다.For example, if you work with multiple clouds when working with global Azure and Azure Stack Hub, API profiles specify a name that matches their release date. 2017-09-03 프로필을 사용 합니다.You use the 2017-09-03 profile.

Azure Stack 허브 및 API 프로필에 대 한 자세한 내용은 Azure Stack 허브에서 api 버전 프로필 관리를 참조 하세요.For more information about Azure Stack Hub and API profiles, see Manage API version profiles in Azure Stack Hub.

매개 변수Parameters

매개 변수Parameter 설명Description
registrationSubscriptionIDregistrationSubscriptionID 초기 등록에 사용 된 Azure 구독입니다.The Azure subscription that was used for the initial registration.
customerSubscriptionIDcustomerSubscriptionID 등록할 고객에 속하는 Azure 구독 (Azure Stack 허브가 아님)입니다.The Azure subscription (not Azure Stack Hub) belonging to the customer to be registered. 파트너 센터를 통해 CSP (클라우드 솔루션 공급자) 제품에서 만들어야 합니다.Must be created in the Cloud Solution Provider (CSP) offer through the Partner Center. 고객에 게 둘 이상의 테 넌 트가 있는 경우 테 넌 트에 대 한 구독을 만들어 Azure Stack 허브에 로그인 합니다.If a customer has more than one tenant, create a subscription for the tenant to sign in to Azure Stack Hub. 고객 구독 ID는 대/소문자를 구분 합니다.The customer subscription ID is case sensitive.
resourceGroupresourceGroup Azure에서 등록이 저장 된 리소스 그룹입니다.The resource group in Azure in which your registration is stored.
registrationNameregistrationName Azure Stack 허브 등록의 이름입니다.The name of the registration of your Azure Stack Hub. Azure에 저장 된 개체입니다.It's an object stored in Azure. 이름은 일반적으로 azurestack-CloudID 형식입니다. 여기서 CloudID 은 Azure Stack HUB 배포의 클라우드 ID입니다.The name is usually in the form azurestack-CloudID, where CloudID is the cloud ID of your Azure Stack Hub deployment.

참고

테 넌 트는 사용 하는 각 Azure Stack 허브 배포에 등록 되어야 합니다.Tenants must be registered with each Azure Stack Hub deployment that they use. 테 넌 트가 둘 이상의 Azure Stack Hub를 사용 하는 경우 테 넌 트 구독을 사용 하 여 각 배포의 초기 등록을 업데이트 합니다.If a tenant uses more than one Azure Stack Hub, update the initial registrations of each deployment with the tenant subscription.

PowerShellPowerShell

AzResource cmdlet을 사용 하 여 테 넌 트를 추가 합니다.Use the New-AzResource cmdlet to add a tenant. Azure에 연결한다음 관리자 권한 프롬프트에서 다음 명령을 실행 합니다.Connect to Azure, and then from an elevated prompt run the following command:

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

API 호출API call

작업: PUTOperation: PUT
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
응답: 201 생성Response: 201 Created
응답 본문: 비어 있습니다.Response Body: Empty

등록 된 모든 테 넌 트 나열List all registered tenants

등록에 추가 된 모든 테 넌 트 목록을 가져옵니다.Get a list of all tenants that have been added to a registration.

참고

등록 된 테 넌 트가 없으면 응답이 수신 되지 않습니다.If no tenants have been registered, you won't receive a response.

매개 변수Parameters

매개 변수Parameter 설명Description
registrationSubscriptionIdregistrationSubscriptionId 초기 등록에 사용 된 Azure 구독입니다.The Azure subscription that was used for the initial registration.
resourceGroupresourceGroup Azure에서 등록이 저장 된 리소스 그룹입니다.The resource group in Azure in which your registration is stored.
registrationNameregistrationName Azure Stack Hub 배포의 등록 이름입니다.The name of the registration of your Azure Stack Hub deployment. Azure에 저장 된 개체입니다.It's an object stored in Azure. 이 이름은 일반적으로 azurestack-CloudID 형식입니다. 여기서 CloudID 는 Azure Stack HUB 배포의 클라우드 ID입니다.The name is usually in the form of azurestack-CloudID, where CloudID is the cloud ID of your Azure Stack Hub deployment.

PowerShellPowerShell

AzResource cmdlet을 사용 하 여 등록 된 모든 테 넌 트를 나열 합니다.Use the Get-AzResource cmdlet to list all registered tenants. Azure Stack Hub에 연결한다음 관리자 권한 프롬프트에서 다음 cmdlet을 실행 합니다.Connect to Azure Stack Hub, and then from an elevated prompt run the following cmdlet:

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

API 호출API call

가져오기 작업을 사용 하 여 모든 테 넌 트 매핑의 목록을 가져올 수 있습니다.You can get a list of all tenant mappings using the GET operation.

작업: 가져오기Operation: GET
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions?api-version=2017-06-01 HTTP/1.1
응답: 200Response: 200
응답 본문:Response Body:

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

테 넌 트 매핑 제거Remove a tenant mapping

등록에 추가 된 테 넌 트를 제거할 수 있습니다.You can remove a tenant that has been added to a registration. 해당 테 넌 트가 Azure Stack 허브에서 계속 리소스를 사용 하는 경우 초기 Azure Stack 허브 등록에 사용 되는 구독에 대 한 사용 요금이 청구 됩니다.If that tenant is still using resources on Azure Stack Hub, their usage is charged to the subscription used in the initial Azure Stack Hub registration.

매개 변수Parameters

매개 변수Parameter 설명Description
registrationSubscriptionIdregistrationSubscriptionId 등록에 대 한 구독 ID입니다.Subscription ID for the registration.
resourceGroupresourceGroup 등록에 대 한 리소스 그룹입니다.The resource group for the registration.
registrationNameregistrationName 등록의 이름입니다.The name of the registration.
customerSubscriptionIdcustomerSubscriptionId 고객 구독 ID입니다.The customer subscription ID. 고객 구독 ID는 대/소문자를 구분 합니다.The customer subscription ID is case sensitive.

PowerShellPowerShell

AzResource cmdlet을 사용 하 여 테 넌 트를 제거 합니다.Use the Remove-AzResource cmdlet to remove a tenant. Azure Stack Hub에 연결한다음 관리자 권한 프롬프트에서 다음 cmdlet을 실행 합니다.Connect to Azure Stack Hub, and then from an elevated prompt run the following cmdlet:

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

API 호출API call

삭제 작업을 사용 하 여 테 넌 트 매핑을 제거할 수 있습니다.You can remove tenant mappings using the DELETE operation.

작업: 삭제Operation: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
응답: 204 내용 없음Response: 204 No Content
응답 본문: 비어 있습니다.Response Body: Empty

다음 단계Next steps