Azure Stack Hub에서 사용량 추적을 위한 테넌트 등록

  • 아티클

이 문서에는 등록 작업에 대한 세부 정보가 포함되어 있습니다. 다음 작업을 사용하여 다음을 수행할 수 있습니다.

  • 테넌트 등록을 관리합니다.
  • 테넌트 사용량 추적을 관리합니다.

등록에 테넌트 추가

등록에 새 테넌트 추가하려는 경우 이 작업을 사용할 수 있습니다. 테넌트 사용량은 Microsoft Entra 테넌트와 연결된 Azure 구독에서 보고됩니다.

이 작업을 사용하여 테넌트와 연결된 구독을 변경할 수도 있습니다. PUT 또는 New-AzResource PowerShell cmdlet을 호출하여 이전 매핑을 덮어씁 수 있습니다. AzureRM PowerShell 모듈을 사용하는 경우 New-AzureRMResource PowerShell cmdlet을 사용합니다.

단일 Azure 구독을 테넌트와 연결할 수 있습니다. 기존 테넌트에서 두 번째 구독을 추가하려고 하면 첫 번째 구독을 덮어씁니다.

API 프로필 사용

다음 등록 cmdlet을 사용하려면 PowerShell을 실행할 때 API 프로필을 지정해야 합니다. API 프로필은 Azure 리소스 공급자 및 해당 API 버전 집합을 나타냅니다. 여러 Azure 클라우드와 상호 작용할 때 올바른 버전의 API를 사용하는 데 도움이 됩니다. 예를 들어 전역 Azure 및 Azure Stack Hub로 작업할 때 여러 클라우드로 작업하는 경우 API 프로필은 릴리스 날짜와 일치하는 이름을 지정합니다. 2017-09-03 프로필을 사용합니다.

Azure Stack Hub 및 API 프로필에 대한 자세한 내용은 Azure Stack Hub에서 API 버전 프로필 관리를 참조하세요.

매개 변수

매개 변수 Description
registrationSubscriptionID 초기 등록에 사용된 Azure 구독입니다.
customerSubscriptionID 등록할 고객에게 속한 Azure 구독(Azure Stack Hub 아님)입니다. 파트너 센터를 통해 CSP(클라우드 솔루션 공급자) 제품에서 만들어야 합니다. 고객에게 둘 이상의 테넌트가 있는 경우 테넌트가 Azure Stack Hub에 로그인할 구독을 만듭니다. 고객 구독 ID는 대/소문자를 구분합니다.
resourceGroup 등록이 저장되는 Azure의 리소스 그룹입니다.
registrationName Azure Stack Hub 등록의 이름입니다. Azure에 저장된 개체입니다. 이름은 일반적으로 azurestack-CloudID 형식입니다. 여기서 CloudID 는 Azure Stack Hub 배포의 클라우드 ID입니다.

참고

테넌트는 사용하는 각 Azure Stack Hub 배포에 등록해야 합니다. 테넌트가 둘 이상의 Azure Stack Hub를 사용하는 경우 각 배포의 초기 등록을 테넌트 구독으로 업데이트합니다.

PowerShell

New-AzResource cmdlet을 사용하여 테넌트 추가 Azure에 연결한 다음 관리자 권한 프롬프트에서 다음 명령을 실행합니다.

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

API 호출

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

등록된 모든 테넌트 나열

등록에 추가된 모든 테넌트 목록을 가져옵니다.

참고

테넌트가 등록되지 않은 경우 응답을 받지 않습니다.

매개 변수

매개 변수 Description
registrationSubscriptionId 초기 등록에 사용된 Azure 구독입니다.
resourceGroup 등록이 저장되는 Azure의 리소스 그룹입니다.
registrationName Azure Stack Hub 배포 등록의 이름입니다. Azure에 저장된 개체입니다. 이름은 일반적으로 azurestack-CloudID 형식입니다. 여기서 CloudID 는 Azure Stack Hub 배포의 클라우드 ID입니다.

PowerShell

Get-AzResource cmdlet을 사용하여 등록된 모든 테넌트 목록을 표시합니다. Azure Stack Hub에 연결한 다음 관리자 권한 프롬프트에서 다음 cmdlet을 실행합니다.

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

API 호출

GET 작업을 사용하여 모든 테넌트 매핑 목록을 가져올 수 있습니다.

작업: GET
RequestURI: 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 등록에 사용된 구독에 대한 사용 요금이 청구됩니다.

매개 변수

매개 변수 Description
registrationSubscriptionId 등록에 대한 구독 ID입니다.
resourceGroup 등록에 대한 리소스 그룹입니다.
registrationName 등록의 이름입니다.
customerSubscriptionId 고객 구독 ID입니다. 고객 구독 ID는 대/소문자를 구분합니다.

PowerShell

Remove-AzResource cmdlet을 사용하여 테넌트 제거 Azure Stack Hub에 연결한 다음 관리자 권한 프롬프트에서 다음 cmdlet을 실행합니다.

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

API 호출

DELETE 작업을 사용하여 테넌트 매핑을 제거할 수 있습니다.

작업: DELETE
RequestURI: subscriptions/{registrationSubscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.AzureStack/registrations/{registrationName}/customerSubscriptions/{customerSubscriptionId}?api-version=2017-06-01 HTTP/1.1
응답: 204 콘텐츠 없음
응답 본문: 비어 있음

다음 단계