빠른 시작: Python을 사용하여 관리 그룹 만들기

아티클
10/16/2024

관리 그룹은 여러 구독에서 액세스, 정책 및 규정 준수를 관리하는 데 도움이 되는 컨테이너입니다. 이러한 컨테이너를 만들어 Azure 정책 및 Azure 역할 기반 액세스 제어와 함께 사용할 수 있는 효과적이고 효율적인 계층을 구축합니다. 관리 그룹에 대한 자세한 내용은 Azure 관리 그룹으로 리소스 구성을 참조하세요.

디렉터리에서 만드는 첫 번째 관리 그룹을 완료하려면 최대 15분이 소요될 수 있습니다. 디렉터리에 대해 Azure 내의 관리 그룹 서비스를 설정하기 위해 처음으로 실행되는 프로세스가 있습니다. 프로세스가 완료되면 알림이 수신됩니다. 자세한 내용은 관리 그룹의 초기 설정을 참조하세요.

필수 조건

Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
계층 보호가 사용하도록 설정되지 않은 경우 테넌트의 모든 Microsoft Entra ID 사용자는 해당 사용자에게 할당된 관리 그룹 쓰기 권한 없이 관리 그룹을 만들 수 있습니다. 이 새 관리 그룹은 루트 관리 그룹 또는 기본 관리 그룹의 자식이 되고 작성자는 소유자 역할을 할당 받습니다. 관리 그룹 서비스는 이 기능을 허용하므로 루트 수준에서 역할 할당이 필요하지 않습니다. 루트 관리 그룹이 생성되면 사용자는 해당 그룹에 액세스할 수 없습니다. 관리 그룹 사용을 시작하려면 서비스를 통해 루트 수준에서 초기 관리 그룹을 만들 수 있습니다. 자세한 내용은 각 디렉터리의 루트 관리 그룹을 참조하세요.

Azure Cloud Shell

Azure는 브라우저를 통해 사용할 수 있는 대화형 셸 환경인 Azure Cloud Shell을 호스트합니다. Cloud Shell에서 Bash 또는 PowerShell을 사용하여 Azure 서비스 작업을 수행할 수 있습니다. 로컬 환경에 아무 것도 설치할 필요 없이 Azure Cloud Shell의 미리 설치된 명령을 사용하여 이 문서의 코드를 실행할 수 있습니다.

Azure Cloud Shell을 시작하려면 다음을 수행합니다.

옵션	예제/링크
코드 또는 명령 블록의 오른쪽 상단에서 시도를 선택합니다. 시도를 선택해도 코드 또는 명령이 Cloud Shell에 자동으로 복사되지 않습니다.
https://shell.azure.com으로 이동하거나 Cloud Shell 시작 단추를 선택하여 브라우저에서 Cloud Shell을 엽니다.
Azure Portal의 오른쪽 위에 있는 메뉴 모음에서 Cloud Shell 단추를 선택합니다.

Azure Cloud Shell을 사용하려면:

Cloud Shell을 시작합니다.
코드 블록(또는 명령 블록)에서 복사 단추를 선택하여 코드 또는 명령을 복사합니다.
Windows 및 Linux에서 Ctrl+Shift+V를 선택하거나 macOS에서 Cmd+Shift+V를 선택하여 코드 또는 명령을 Cloud Shell 세션에 붙여넣습니다.
Enter를 선택하여 코드 또는 명령을 실행합니다.

Resource Graph 라이브러리 추가

Python에서 관리 그룹을 관리할 수 있도록 하려면 라이브러리를 추가해야 합니다. 이 라이브러리는 Windows 10의 bash 또는 로컬로 설치된 경우를 포함하여 Python을 사용할 수 있을 때마다 작동합니다.

최신 Python이 설치되었는지 확인합니다(3.8 이상). 아직 설치되지 않았으면 Python.org에서 다운로드합니다.
최신 Azure CLI가 설치되었는지 확인합니다(2.5.1 이상). 아직 설치되지 않았으면 Azure CLI 설치를 참조하세요.

참고 항목

다음 예시에서 CLI 기반 인증을 사용하도록 Python을 설정하려면 Azure CLI가 필요합니다. 다른 옵션들에 대한 자세한 내용은 Python용 Azure 관리 라이브러리를 사용하여 인증을 참조하세요.
Azure CLI를 통해 인증을 수행합니다.
```
az login
```

선택한 Python 환경에서 관리 그룹에 필요한 라이브러리를 설치합니다.

# Add the management groups library for Python
pip install azure-mgmt-managementgroups

# Add the Resources library for Python
pip install azure-mgmt-resource

# Add the CLI Core library for Python for authentication (development only!)
pip install azure-cli-core

참고 항목

모든 사용자용으로 Python이 설치된 경우에는 이러한 명령은 관리자 권한 콘솔에서 실행해야 합니다.

라이브러리가 설치되어 있는지 확인 합니다. azure-mgmt-managementgroups는 0.2.0 이상이고, azure-mgmt-resource는 9.0.0 이상이고, azure-cli-core는 2.5.0 이상이어야 합니다.
```
# Check each installed library
pip show azure-mgmt-managementgroups azure-mgmt-resource azure-cli-core
```

관리 그룹 만들기

Python 스크립트를 만들고 mgCreate.py로 다음 원본을 저장합니다.

# Import management group classes
from azure.mgmt.managementgroups import ManagementGroupsAPI

# Import specific methods and models from other libraries
from azure.common.credentials import get_azure_cli_credentials
from azure.common.client_factory import get_client_from_cli_profile
from azure.mgmt.resource import ResourceManagementClient, SubscriptionClient

# Wrap all the work in a function
def createmanagementgroup( strName ):
    # Get your credentials from Azure CLI (development only!) and get your subscription list
    subsClient = get_client_from_cli_profile(SubscriptionClient)
    subsRaw = []
    for sub in subsClient.subscriptions.list():
        subsRaw.append(sub.as_dict())
    subsList = []
    for sub in subsRaw:
        subsList.append(sub.get('subscription_id'))

    # Create management group client and set options
    mgClient = get_client_from_cli_profile(ManagementGroupsAPI)
    mg_request = {'name': strName, 'display_name': strName}

    # Create management group
    mg = mgClient.management_groups.create_or_update(group_id=strName,create_management_group_request=mg_request)

    # Show results
    print(mg)

createmanagementgroup("MyNewMG")

az login을 사용하여 Azure CLI로 인증합니다.
터미널에서 다음 명령을 입력합니다.
```
py mgCreate.py
```

관리 그룹 생성 결과는 콘솔에 LROPoller 개체로 출력됩니다.

리소스 정리

Python 환경에서 설치된 라이브러리를 제거하려면 다음 명령을 사용할 수 있습니다.

# Remove the installed libraries from the Python environment
pip uninstall azure-mgmt-managementgroups azure-mgmt-resource azure-cli-core

다음 단계

이 빠른 시작에서는 리소스 계층 구조를 구성하기 위한 관리 그룹을 만들었습니다. 관리 그룹은 구독 또는 기타 관리 그룹을 포함할 수 있습니다.

관리 그룹 및 리소스 계층 구조를 관리하는 방법에 대해 자세히 알아보려면 다음을 계속 진행하세요.

관리 그룹으로 리소스 관리

다음을 통해 공유