VM 확장 프로그램 세부정보 및 상태 보기

조직, 폴더 또는 프로젝트 수준에서 전역 또는 영역 확장 프로그램 정책을 만들어 Compute Engine 가상 머신(VM) 인스턴스에 VM 확장 프로그램을 설치합니다. 단일 정책으로 단일 VM에 여러 확장 프로그램을 설치할 수 있으며 동일한 VM에 여러 정책을 적용할 수 있습니다.

이 문서에서는 Cloud de Confiance by S3NS 리소스 계층 구조에서 읽기 전용 get 및 list 메서드를 사용하여 다음 작업을 수행하는 방법을 설명합니다.

• 리소스 계층 구조에서 확장 프로그램 정책 보기 전역 또는 영역 VM 확장 프로그램 정책을 나열하여 조직, 폴더 또는 프로젝트 전반의 정책 세부정보와 출시 상태를 확인합니다.
• VM 확장 프로그램 및 버전 보기 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램을 나열하거나 조직, 폴더 또는 프로젝트의 모든 영역 또는 특정 영역에서 버전 번호 및 지원 수준을 포함한 확장 프로그램 세부정보를 확인합니다.
• 각 VM에 설치된 확장 프로그램의 상태를 확인합니다. 정책이 VM에 여러 확장 프로그램을 설치할 때 인스턴스에 설치된 모든 VM 확장 프로그램과 해당 런타임 상태를 나열하거나, 동일한 VM에 여러 정책이 적용될 때 최종 유효 구성 및 관리 정책(policyId)을 확인합니다.
• 인스턴스의 확장 프로그램 문제 해결 예기치 않은 확장 프로그램이 설치되거나 VM 인스턴스에서 확장 프로그램이 실패할 때 설치 진행 상황, 런타임 상태, 진단 메시지를 확인합니다.

시작하기 전에

VM 확장 프로그램 정책을 보거나, VM 확장 프로그램 세부정보를 가져오거나, VM 인스턴스에서 확장 프로그램 상태를 검사하기 전에 다음 기본 요건을 완료하세요.

• VM 확장 프로그램 관리자 정보를 읽고 확장 프로그램 정책이 VM Fleet 전반에서 게스트 에이전트 플러그인을 관리하는 방법을 알아보세요.
• 아직 인스턴스에 확장 프로그램을 배포하지 않았다면 먼저 정책을 만드세요. 자세한 내용은 확장 프로그램 정책을 만들어 VM 확장 프로그램 설치를 참조하세요.
• 확장 프로그램 정책을 보고, 확장 프로그램 세부정보를 가져오고, 인스턴스 확장 프로그램 상태를 검사하는 데 필요한 Identity and Access Management 권한이 있는지 확인합니다.

정책 및 확장 프로그램 보기 제한사항

VM 확장 프로그램 정책, 확장 프로그램 세부정보, 인스턴스 상태를 볼 때는 다음 운영 제약 조건을 고려하세요.

• Google Cloud CLI 또는 Compute Engine REST API를 사용해야만 폴더 범위 및 조직 범위 VM 확장 프로그램 정책을 볼 수 있습니다.
• Google Cloud CLI 또는 Compute Engine REST API를 사용해야만 VM 확장 프로그램 세부정보와 인스턴스 확장 프로그램 상태를 검색할 수 있습니다.Cloud de Confiance 콘솔에서 VM 확장 프로그램 세부정보 또는 인스턴스별 확장 프로그램 상태를 볼 수 없습니다.
• 인스턴스 확장 프로그램 상태 API(getVmExtensionState 및 listVmExtensionStates)는 VM 확장 프로그램 관리자 정책이 설치하고 관리하는 확장 프로그램의 런타임 상태만 보고합니다. 이러한 API는 VM 확장 프로그램 관리자 외부에서 수동으로 설치하는 독립형 에이전트의 상태를 보고하지 않습니다.

확장 프로그램 정책 보기

조직, 폴더 또는 프로젝트 수준에서 VM 확장 프로그램 정책을 나열하거나 특정 정책의 구성 세부정보를 검사할 수 있습니다.

조직의 모든 영역에서 전역 확장 프로그램 정책 보기

조직의 모든 전역 VM 확장 프로그램 정책을 나열하거나 특정 조직 범위의 전역 정책을 검사하여 Fleet 전체의 확장 프로그램 출시를 감사할 수 있습니다.

필수 IAM 권한

조직 범위 확장 프로그램 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 조직에 대한 조직 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.orgVmExtensionPolicyViewer) 또는 조직 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.orgVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 조직 범위 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

조직의 전역 확장 프로그램 정책을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute global-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --page-size=PAGE_SIZE

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME

폴더의 모든 영역에서 전역 확장 프로그램 정책 보기

폴더의 모든 전역 VM 확장 프로그램 정책을 나열하거나 특정 폴더 범위 전역 정책을 검사하여 해당 폴더의 프로젝트에 적용되는 확장 프로그램을 확인할 수 있습니다.

필수 IAM 권한

폴더 범위 확장 프로그램 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 폴더에 대한 폴더 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.folderVmExtensionPolicyViewer) 또는 폴더 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.folderVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 폴더 범위 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

폴더에서 전역 확장 프로그램 정책을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute global-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --page-size=PAGE_SIZE

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME

프로젝트의 모든 영역에서 전역 확장 프로그램 정책 보기

프로젝트에서 전역 VM 확장 프로그램 정책을 확인하여 출시 진행 상황을 모니터링하고 해당 프로젝트의 모든 영역에서 확장 프로그램 구성을 검사할 수 있습니다.

필수 IAM 권한

프로젝트 범위 확장 프로그램 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute VM 확장 프로그램 정책 뷰어(roles/compute.vmExtensionPolicyViewer) 또는 Compute VM 확장 프로그램 정책 관리자(roles/compute.vmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 프로젝트 범위 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

프로젝트에서 전역 확장 프로그램 정책을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME

조직 전체의 영역에서 영역 확장 프로그램 정책 보기

특정 영역에서 조직 범위 VM 확장 프로그램 정책을 나열하거나 단일 정책을 검사하여 조직 전체의 영역 수준 시행 규칙을 감사할 수 있습니다.

필수 IAM 권한

조직 범위 확장 프로그램 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 조직에 대한 조직 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.orgVmExtensionPolicyViewer) 또는 조직 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.orgVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 조직 범위 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

조직의 영역 확장 정책을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute zone-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

폴더 전체의 영역에서 영역 확장 프로그램 정책 보기

특정 영역의 폴더 범위 VM 확장 프로그램 정책을 나열하거나 단일 정책을 검사하여 폴더에 있는 프로젝트의 영역 수준 확장 프로그램 규칙을 확인할 수 있습니다.

필수 IAM 권한

폴더 범위 확장 프로그램 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 폴더에 대한 폴더 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.folderVmExtensionPolicyViewer) 또는 폴더 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.folderVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 폴더 범위 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

폴더의 영역 확장 정책을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute zone-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

프로젝트의 영역에서 영역 확장 프로그램 정책 보기

특정 영역의 프로젝트 범위 VM 확장 프로그램 정책을 나열하거나 단일 정책을 검사하여 해당 영역의 인스턴스에 적용되는 확장 프로그램을 확인할 수 있습니다.

필수 IAM 권한

프로젝트 범위 확장 프로그램 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute VM 확장 프로그램 정책 뷰어(roles/compute.vmExtensionPolicyViewer) 또는 Compute VM 확장 프로그램 정책 관리자(roles/compute.vmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 프로젝트 범위 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

프로젝트에서 영역 확장 정책을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

VM 확장 프로그램 및 버전 보기

읽기 전용 get 및 list 메서드를 사용하여 VM 확장 프로그램 관리자가 조직, 폴더 또는 프로젝트에서 지원하는 VM 확장 프로그램을 볼 수 있습니다. 모든 영역 또는 특정 영역에서 확장 프로그램 이름, 버전 번호, 확장 프로그램 지원 수준을 볼 수 있습니다.

조직의 모든 영역에서 VM 확장 프로그램 보기

읽기 전용 get 및 list 메서드를 사용하여 VM 확장 프로그램 관리자가 조직의 모든 영역에서 지원하는 VM 확장 프로그램(버전 번호 및 지원 수준 포함)을 확인합니다.

필수 IAM 권한

조직 전체에서 VM 확장 프로그램을 보는 데 필요한 권한을 얻으려면 관리자에게 조직에 대한 조직 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.orgVmExtensionPolicyViewer) 또는 조직 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.orgVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 조직 전체에서 VM 확장 프로그램을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

조직의 모든 영역에서 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램 및 버전을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute global-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions/EXTENSION_NAME

폴더의 모든 영역에서 VM 확장 프로그램 보기

읽기 전용 get 및 list 메서드를 사용하여 VM 확장 프로그램 관리자가 폴더의 모든 영역에서 지원하는 VM 확장 프로그램(버전 번호 및 지원 수준 포함)을 확인합니다.

필수 IAM 권한

폴더에서 VM 확장 프로그램을 보는 데 필요한 권한을 얻으려면 관리자에게 폴더에 대한 폴더 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.folderVmExtensionPolicyViewer) 또는 폴더 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.folderVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 폴더 전체에서 VM 확장 프로그램을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

폴더의 모든 영역에서 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램 및 버전을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute global-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions/EXTENSION_NAME

프로젝트의 모든 영역에서 VM 확장 프로그램 보기

읽기 전용 get 및 list 메서드를 사용하여 버전 번호와 지원 수준을 포함하여 VM 확장 프로그램 관리자가 프로젝트의 모든 영역에서 지원하는 VM 확장 프로그램을 확인합니다.

필수 IAM 권한

프로젝트에서 VM 확장 프로그램을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute VM 확장 프로그램 정책 뷰어(roles/compute.vmExtensionPolicyViewer) 또는 Compute VM 확장 프로그램 정책 관리자(roles/compute.vmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 프로젝트에서 VM 확장 프로그램을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

프로젝트의 모든 영역에서 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램 및 버전을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions

{
  "kind": "compute#globalVmExtensionList",
  "items": [
    {
      "kind": "compute#globalVmExtension",
      "name": "ops-agent",
      "versions": [
        "2.58.0",
        "2.57.0"
      ],
      "supportLevel": "GA",
      "selfLink": "https://www.googleapis.com/compute/2026-10-01-preview/projects/my-project/global/vmExtensions/ops-agent"
    }
  ]
}

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions/EXTENSION_NAME

조직의 영역에서 VM 확장 프로그램 보기

읽기 전용 get 및 list 메서드를 사용하여 VM 확장 프로그램 관리자가 조직 전반의 특정 영역에서 지원하는 VM 확장 프로그램(버전 번호 및 지원 수준 포함)을 확인합니다.

필수 IAM 권한

조직 전체의 영역에서 VM 확장 프로그램을 보는 데 필요한 권한을 얻으려면 관리자에게 조직에 대한 조직 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.orgVmExtensionPolicyViewer) 또는 조직 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.orgVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 조직 전체의 영역에서 VM 확장 프로그램을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

조직 전체의 영역에서 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램 및 버전을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute zone-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

폴더의 영역에 있는 VM 확장 프로그램 보기

읽기 전용 get 및 list 메서드를 사용하여 VM 확장 프로그램 관리자가 특정 영역에서 지원하는 VM 확장 프로그램(버전 번호 및 지원 수준 포함)을 폴더 전체에서 확인합니다.

필수 IAM 권한

폴더 전체의 영역에서 VM 확장 프로그램을 보는 데 필요한 권한을 얻으려면 관리자에게 폴더에 대한 폴더 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.folderVmExtensionPolicyViewer) 또는 폴더 수준 Compute VM 확장 프로그램 정책 관리자(roles/compute.folderVmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 폴더 전체의 영역에서 VM 확장 프로그램을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

폴더 전체의 영역에서 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램 및 버전을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute zone-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

프로젝트의 영역에서 VM 확장 프로그램 보기

읽기 전용 get 및 list 메서드를 사용하여 프로젝트의 특정 영역에서 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램(버전 번호 및 지원 수준 포함)을 확인합니다.

필수 IAM 권한

프로젝트의 영역에서 VM 확장 프로그램을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute VM 확장 프로그램 정책 뷰어(roles/compute.vmExtensionPolicyViewer) 또는 Compute VM 확장 프로그램 정책 관리자(roles/compute.vmExtensionPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 프로젝트의 영역에서 VM 확장 프로그램을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

프로젝트의 영역에서 VM 확장 프로그램 관리자가 지원하는 VM 확장 프로그램 및 버전을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud preview compute zone-vm-extension-policies extensions list \
  --zone=ZONE \
  --project=PROJECT_ID

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --zone=ZONE \
  --project=PROJECT_ID

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

인스턴스에서 VM 확장 프로그램 상태 보기

조직, 폴더 또는 프로젝트 수준에서 전역 또는 영역 확장 프로그램 정책을 만들어 VM에 VM 확장 프로그램을 설치합니다. 단일 정책으로 단일 VM에 여러 확장 프로그램을 설치할 수 있으며 리소스 계층 구조 전반의 여러 정책을 동일한 VM에 적용할 수 있습니다. 읽기 전용 인스턴스 확장 프로그램 상태 list 및 get 메서드를 사용하여 개별 머신에 연결하지 않고도 각 VM에 설치된 확장 프로그램의 런타임 상태를 확인합니다. 이러한 메서드를 사용하면 설치된 각 확장 프로그램의 최종 유효 구성 및 관리 정책(policyId)을 확인하거나, 예기치 않은 확장 프로그램이 설치되거나 인스턴스에서 확장 프로그램이 실패하는 경우 문제를 해결할 수 있습니다.

필수 IAM 권한

인스턴스에서 VM 확장 프로그램 상태를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 뷰어(roles/compute.viewer), Compute 인스턴스 관리자(v1)(roles/compute.instanceAdmin.v1) 또는 Compute 관리자(roles/compute.admin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 인스턴스에서 VM 확장 프로그램 상태를 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

인스턴스의 모든 VM 확장 프로그램 상태 나열

정책이 VM에 여러 확장 프로그램을 설치하거나, 동일한 인스턴스에 여러 정책이 적용되거나, 문제 해결 중에 예기치 않은 확장 프로그램을 발견한 경우 VM의 모든 확장 프로그램 상태를 나열하여 설치된 모든 확장 프로그램의 최종 유효 구성과 런타임 상태를 확인합니다. 응답에는 각 확장 프로그램의 활성 버전, 시행 상태, 상태, 관리 정책(policyId)이 표시됩니다.

인스턴스에 설치된 모든 VM 확장 프로그램의 상태를 보려면 다음 옵션 중 하나를 선택합니다.

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates

{
  "kind": "compute#vmExtensionStatesList",
  "items": [
    {
      "name": "ops-agent",
      "version": "2.58.0",
      "healthStatus": "RUNNING",
      "enforcementState": "INSTALLED",
      "healthMsg": "Plugin is running ok",
      "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
    }
  ]
}

인스턴스에서 특정 VM 확장 프로그램의 상태 보기

여러 정책이 VM을 타겟팅하거나 설치된 확장 프로그램이 예상대로 실행되지 않는 경우 해당 확장 프로그램의 상태를 확인하여 최종 유효 구성(policyId 및 버전)과 진단 상태 메시지를 확인하세요.

인스턴스에서 특정 VM 확장 프로그램의 유효 상태 및 관리 정책을 보려면 다음 옵션 중 하나를 선택합니다.

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --extension-name=EXTENSION_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates/EXTENSION_NAME

{
  "name": "ops-agent",
  "version": "2.58.0",
  "healthStatus": "RUNNING",
  "enforcementState": "INSTALLED",
  "enforcementMsg": "",
  "healthMsg": "Plugin is running ok",
  "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
}

VM 확장 프로그램 상태 필드 해석

인스턴스에서 VM 확장 프로그램의 상태를 가져오면 응답에 플러그인의 시행된 정책, 활성 버전, 설치 진행 상황, 런타임 상태를 보고하는 필드가 포함됩니다.

다음 표에서는 VmExtensionState 리소스가 반환하는 필드를 설명합니다.

다음 단계

• 실패한 출시를 진단하거나, 실행 중인 게스트 프로세스를 확인하거나, 게스트 에이전트 디버그 로그를 검사하려면 VM 확장 프로그램 문제 해결을 참고하세요.
• Cloud Logging에서 이전 시행 이벤트와 감사 설치 또는 비정상 종료 기록을 쿼리하려면 VM 확장 프로그램 로그 보기를 참조하세요.
• Cloud Monitoring 대시보드를 빌드하고 에이전트 상태, CPU, 메모리 사용량에 대한 알림을 설정하려면 VM 확장 프로그램 모니터링을 참조하세요.
• 구성 설정을 수정하거나, 고정된 버전을 변경하거나, 배포된 에이전트를 삭제하려면 확장 프로그램 정책을 사용하여 VM 확장 프로그램 관리를 참조하세요.