빠른 시작: REST API를 사용하여 관리 그룹 만들기

아티클
10/16/2024

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

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

필수 조건

Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
아직 설치하지 않은 경우 ARMClient를 설치합니다. Azure Resource Manager 기반 REST API에 HTTP 요청을 전송하는 도구입니다.
계층 보호가 사용하도록 설정되지 않은 경우 테넌트의 모든 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를 선택하여 코드 또는 명령을 실행합니다.

REST API에서 만들기

REST API의 경우 관리 그룹 - 만들기 또는 업데이트 엔드포인트를 사용하여 새 관리 그룹을 만듭니다. 이 예제에서 관리 그룹 groupId는 Contoso입니다.

REST API URI

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

요청 본문 없음

groupId는 생성되는 고유 식별자입니다. 이 ID는 다른 명령에서 이 그룹을 참조하는 데 사용되며 나중에 변경할 수 없습니다.

관리 그룹이 Azure Portal 내에서 다른 이름을 표시하도록 하려면 요청 본문에 properties.displayName 속성을 추가합니다. 예를 들어, groupId가 Contoso이고 표시 이름이 Contoso Group인 관리 그룹을 만들려면 다음 엔드포인트와 요청 본문을 사용합니다.

REST API URI

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

요청 본문

{
  "properties": {
    "displayName": "Contoso Group"
  }
}

앞의 예제에서 새 관리 그룹은 루트 관리 그룹 아래에 생성됩니다. 다른 관리 그룹을 부모로 지정하려면 properties.parent.id 매개 속성을 사용합니다.

REST API URI

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

요청 본문

{
  "properties": {
    "displayName": "Contoso Group",
    "parent": {
      "id": "/providers/Microsoft.Management/managementGroups/HoldingGroup"
    }
  }
}

리소스 정리

위에서 만든 관리 그룹을 제거하려면 관리 그룹 - 삭제 엔드포인트를 사용합니다.

REST API URI

DELETE https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01

요청 본문 없음

다음 단계

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

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

관리 그룹으로 리소스 관리

다음을 통해 공유

빠른 시작: REST API를 사용하여 관리 그룹 만들기

필수 조건

Azure Cloud Shell

REST API에서 만들기

리소스 정리

다음 단계

피드백

추가 리소스