확장 프로그램 정책을 사용하여 VM 확장 프로그램 관리

VM 확장 프로그램 관리자는 확장 프로그램 정책을 사용하여 VM 확장 프로그램을 대규모로 관리합니다. 자세한 내용은 VM 확장 프로그램 관리자 정보를 참고하세요. 이 문서에서는 프로젝트 수준 또는 폴더 및 조직 수준(프리뷰에서 사용 가능)에서 전역 및 영역 VM 확장 프로그램 정책을 업데이트하고 삭제하는 방법을 설명합니다. VM 인스턴스에서 확장 프로그램 정책, VM 확장 프로그램 및 버전, 런타임 확장 프로그램 상태를 보려면 VM 확장 프로그램 세부정보 및 상태 보기를 참조하세요. 설치 또는 런타임 문제를 진단하려면 VM 확장 프로그램 문제 해결을 참조하세요.

정책 관리 제한사항

Google Cloud CLI 또는 Compute Engine REST API를 사용해야만 폴더 범위 및 조직 범위 VM 확장 프로그램 정책을 업데이트하고 삭제할 수 있습니다.Google Cloud 콘솔에서는 폴더 범위 또는 조직 범위 정책을 관리할 수 없습니다.

VM 확장 프로그램 정책을 업데이트하여 확장 프로그램 수정

정책을 업데이트하면 VM 확장 프로그램 관리자가 일반적으로 1분 이내에 해당하는 모든 VM에 변경사항을 적용합니다. 포함 라벨을 수정하면 업데이트된 라벨과 일치하는지 여부에 따라 새 VM에 확장 프로그램이 설치되거나 기존 VM에서 제거될 수 있습니다.

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

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 조직 범위 확장 프로그램 정책을 업데이트하는 데 필요한 compute.orgVmExtensionPolicies.update 권한이 포함되어 있습니다.

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

조직 범위 전역 확장 프로그램 정책을 업데이트하려면 다음 옵션 중 하나를 선택합니다.

gcloud

--organization 플래그와 함께 gcloud preview compute global-vm-extension-policies update 명령어를 사용하여 기존 조직 범위 전역 VM 확장 프로그램 정책을 수정합니다. gcloud를 사용하여 정책을 업데이트하면 요청이 전체 교체로 작동합니다. 생략한 선택적 필드는 수정된 정책의 기존 값을 유지하는 대신 기본값으로 되돌아갑니다.

조직 범위 전역 VM 확장 프로그램 정책을 업데이트하려면 다음 명령어를 실행합니다.

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

다음을 바꿉니다.

• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• ORGANIZATION_ID: Google Cloud 조직 ID입니다.
• DESCRIPTION: 정책에 대한 설명입니다(선택사항).
• EXTENSION_NAME_1,EXTENSION_NAME_2: 정책에 추가할 확장 프로그램의 쉼표로 구분된 목록입니다. 확장 프로그램을 하나 이상 지정해야 합니다. 지원되는 다음 확장 프로그램 중 하나를 지정할 수 있습니다.
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: 쉼표로 구분된 키-값 쌍 목록으로, 키는 확장 프로그램 이름이고 값은 확장 프로그램 버전입니다. 확장 프로그램 버전을 지정하지 않으면 VM 확장 프로그램 관리자가 사용 가능한 최신 버전을 사용하고 새 버전이 제공되면 자동으로 업그레이드합니다.
  참고: ops-agent의 경우 VM 확장 프로그램 관리자는 버전 2.58.0 이상 설치를 지원합니다. google-cloud-sap-extension 및 google-cloud-workload-extension의 경우 VM 확장 프로그램 관리자는 최신 버전만 지원합니다.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: 쉼표로 구분된 키-값 쌍 목록입니다. 여기서 키는 확장 프로그램 이름이고 값은 해당 확장 프로그램의 구성 파일 경로입니다. 이 파일은 확장 프로그램을 설치하는 VM이 아닌 gcloud 명령어를 실행하는 VM에 있습니다.

  또는 구성을 인라인 문자열로 제공하려면 --config-from-file 대신 --config 플래그를 사용합니다(예: EXTENSION_NAME_1="CONFIG_1"). --config-from-file 또는 --config를 사용할 수 있지만 동일한 명령어에서 둘 다 사용할 수는 없습니다.

• KEY_1=VALUE_1: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. --inclusion-labels를 여러 번 지정하면 정책은 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). 이 플래그를 생략하면 정책은 조직의 모든 하위 프로젝트 및 영역에 있는 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.
• ROLLOUT_PLAN: slow_rollout 또는 fast_rollout를 지정합니다. 커스텀 출시 계획을 사용해야 하는 경우 다음 형식을 사용하여 --rollout-predefined-plan 대신 --rollout-custom-plan 플래그를 지정합니다.

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  다음을 바꿉니다.

  • ORGANIZATION_ID: 출시 계획이 정의된 조직입니다.
  • ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다.

  출시 계획 플래그를 지정하지 않으면 VM 확장 프로그램 관리자가 slow_rollout를 사용합니다.

• ROLLOUT_CONFLICT_BEHAVIOR: VM 확장 프로그램 관리자가 영역 정책과 전역 정책 간의 충돌을 감지할 때의 동작을 지정합니다. 다음 충돌 동작 중 하나를 지정할 수 있습니다.
  • ""(빈 문자열): 전역 정책이 이름이 동일한 충돌하는 영역 정책을 덮어쓰지 않습니다. 이 충돌 동작은 기본값입니다.
  • overwrite: 전역 정책이 이름이 동일한 영역 정책을 덮어쓴 다음 전역 정책이 영역의 정책 출시를 관리합니다.

  자세한 내용은 --rollout-conflict-behavior 플래그를 참조하세요.

• RETRY_UUID: 정책 업데이트 출시의 재시도 시도를 식별하는 UUID입니다. 이 UUID를 사용하면 변경 없이 업데이트를 재시도할 수 있습니다. 이 플래그를 설정하고 정책이 수정되면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

예시: 조직 범위 전역 정책 업데이트

다음 명령어는 123456789 조직의 정책 prod-frontend-policy을 업데이트하여 google-cloud-workload-extension 확장 프로그램을 추가하고 ops-agent의 고정을 해제하여 빠른 출시 계획을 사용하여 최신 버전을 추적합니다.

gcloud preview compute global-vm-extension-policies update prod-frontend-policy \
  --organization=organizations/123456789 \
  --description="Updated policy: ops-agent + workload extension, unpinned" \
  --extensions=ops-agent,google-cloud-workload-extension \
  --config=ops-agent="updated-monitoring-config" \
  --inclusion-labels="env=prod,workload=frontend" \
  --priority=100 \
  --rollout-predefined-plan=fast_rollout

REST

조직 범위 전역 확장 프로그램 정책을 업데이트하려면 organizationGlobalVmExtensionPolicies.update 메서드에 PATCH 요청을 보냅니다. REST를 사용하여 정책을 업데이트할 때는 업데이트할 필드만 제공하면 됩니다. 생략한 필드는 기존 값을 유지합니다.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

다음을 바꿉니다.

• ORGANIZATION_ID: Google Cloud 조직 ID입니다.
• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• DESCRIPTION: VM 확장 프로그램 정책에 대한 설명입니다.
• EXTENSION_NAME: 업데이트할 확장 프로그램의 이름으로, extensionPolicies 맵에서 키로 사용됩니다. 여러 확장 프로그램을 업데이트하려면 extensionPolicies 맵에 여러 항목을 포함합니다.
• EXTENSION_NAME_VERSION: VM 확장 프로그램의 버전입니다.
• EXTENSION_NAME_CONFIG: VM 확장 프로그램의 구성 설정(인라인 문자열)
• KEY_1:VALUE_1, KEY_2:VALUE_2: 선택기의 포함 라벨을 정의하는 키-값 쌍입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. 여러 선택기를 지정하려면 instanceSelectors 배열에 여러 객체를 포함하고 각 객체에 labelSelector 필드를 포함합니다. 이 경우 VM 확장 프로그램 관리자는 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). instanceSelectors를 생략하면 정책은 조직의 모든 하위 프로젝트 및 영역에 있는 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.
• ROLLOUT_CONFLICT_BEHAVIOR: VM 확장 프로그램 관리자가 영역 정책과 전역 정책 간의 충돌을 감지할 때의 동작을 지정합니다. 다음 충돌 동작 중 하나를 지정할 수 있습니다.
  • ""(빈 문자열): 전역 정책이 이름이 동일한 충돌하는 영역 정책을 덮어쓰지 않습니다. 이 충돌 동작은 기본값입니다.
  • overwrite: 전역 정책이 이름이 동일한 영역 정책을 덮어쓴 다음 전역 정책이 영역의 정책 출시를 관리합니다.

  자세한 내용은 --rollout-conflict-behavior 플래그를 참조하세요.

• ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다. 사전 정의된 출시 계획을 사용하려면 name 필드를 predefinedRolloutPlan로 바꾸고 다음 값 중 하나를 지정합니다.
  • SLOW_ROLLOUT: 5일에 걸쳐 정책을 출시합니다. 이 사전 정의된 계획은 계획을 지정하지 않은 경우 기본 출시 계획입니다.
  • FAST_ROLLOUT: 정책을 모든 영역에 즉시 출시합니다.
• RETRY_UUID: 정책 업데이트 출시의 재시도 시도를 식별하는 UUID입니다.

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

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 폴더 범위 확장 프로그램 정책을 업데이트하는 데 필요한 compute.folderVmExtensionPolicies.update 권한이 포함되어 있습니다.

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

폴더 범위 전역 확장 프로그램 정책을 업데이트하려면 다음 옵션 중 하나를 선택합니다.

gcloud

gcloud preview compute global-vm-extension-policies update 명령어를 --folder 플래그와 함께 사용하여 기존 폴더 범위 전역 VM 확장 프로그램 정책을 수정합니다. gcloud를 사용하여 정책을 업데이트하면 요청이 전체 교체로 작동합니다. 생략한 선택적 필드는 수정된 정책의 기존 값을 유지하는 대신 기본값으로 되돌아갑니다.

폴더 범위 전역 VM 확장 프로그램 정책을 업데이트하려면 다음 명령어를 실행합니다.

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

다음을 바꿉니다.

• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• FOLDER_ID: Google Cloud 폴더 ID입니다.
• DESCRIPTION: 정책에 대한 설명입니다(선택사항).
• EXTENSION_NAME_1,EXTENSION_NAME_2: 정책에 추가할 확장 프로그램의 쉼표로 구분된 목록입니다. 확장 프로그램을 하나 이상 지정해야 합니다. 지원되는 다음 확장 프로그램 중 하나를 지정할 수 있습니다.
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: 쉼표로 구분된 키-값 쌍 목록으로, 키는 확장 프로그램 이름이고 값은 확장 프로그램 버전입니다. 확장 프로그램 버전을 지정하지 않으면 VM 확장 프로그램 관리자가 사용 가능한 최신 버전을 사용하고 새 버전이 제공되면 자동으로 업그레이드합니다.
  참고: ops-agent의 경우 VM 확장 프로그램 관리자는 버전 2.58.0 이상 설치를 지원합니다. google-cloud-sap-extension 및 google-cloud-workload-extension의 경우 VM 확장 프로그램 관리자는 최신 버전만 지원합니다.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: 쉼표로 구분된 키-값 쌍 목록입니다. 여기서 키는 확장 프로그램 이름이고 값은 해당 확장 프로그램의 구성 파일 경로입니다. 이 파일은 확장 프로그램을 설치하는 VM이 아닌 gcloud 명령어를 실행하는 VM에 있습니다.

  또는 구성을 인라인 문자열로 제공하려면 --config-from-file 대신 --config 플래그를 사용합니다(예: EXTENSION_NAME_1="CONFIG_1"). --config-from-file 또는 --config를 사용할 수 있지만 동일한 명령어에서 둘 다 사용할 수는 없습니다.

• KEY_1=VALUE_1: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. --inclusion-labels를 여러 번 지정하면 정책은 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). 이 플래그를 생략하면 정책은 폴더 내의 모든 하위 프로젝트 및 영역에 있는 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.
• ROLLOUT_PLAN: slow_rollout 또는 fast_rollout를 지정합니다. 커스텀 출시 계획을 사용해야 하는 경우 다음 형식을 사용하여 --rollout-predefined-plan 대신 --rollout-custom-plan 플래그를 지정합니다.

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  다음을 바꿉니다.

  • FOLDER_ID: 출시 계획이 정의된 폴더입니다.
  • ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다.

  출시 계획 플래그를 지정하지 않으면 VM 확장 프로그램 관리자가 slow_rollout를 사용합니다.

• ROLLOUT_CONFLICT_BEHAVIOR: VM 확장 프로그램 관리자가 영역 정책과 전역 정책 간의 충돌을 감지할 때의 동작을 지정합니다. 다음 충돌 동작 중 하나를 지정할 수 있습니다.
  • ""(빈 문자열): 전역 정책이 이름이 동일한 충돌하는 영역 정책을 덮어쓰지 않습니다. 이 충돌 동작은 기본값입니다.
  • overwrite: 전역 정책이 이름이 동일한 영역 정책을 덮어쓴 다음 전역 정책이 영역의 정책 출시를 관리합니다.

  자세한 내용은 --rollout-conflict-behavior 플래그를 참조하세요.

• RETRY_UUID: 정책 업데이트 출시의 재시도 시도를 식별하는 UUID입니다. 이 UUID를 사용하면 변경 없이 업데이트를 재시도할 수 있습니다. 이 플래그를 설정하고 정책이 수정되면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

REST

폴더 범위 전역 확장 프로그램 정책을 업데이트하려면 folderGlobalVmExtensionPolicies.update 메서드에 PATCH 요청을 보냅니다. REST를 사용하여 정책을 업데이트할 때는 업데이트할 필드만 제공하면 됩니다. 생략한 필드는 기존 값을 유지합니다.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

다음을 바꿉니다.

• FOLDER_ID: Google Cloud 폴더 ID입니다.
• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• DESCRIPTION: VM 확장 프로그램 정책에 대한 설명입니다.
• EXTENSION_NAME: 업데이트할 확장 프로그램의 이름으로, extensionPolicies 맵에서 키로 사용됩니다. 여러 확장 프로그램을 업데이트하려면 extensionPolicies 맵에 여러 항목을 포함합니다.
• EXTENSION_NAME_VERSION: VM 확장 프로그램의 버전입니다.
• EXTENSION_NAME_CONFIG: VM 확장 프로그램의 구성 설정(인라인 문자열)
• KEY_1:VALUE_1, KEY_2:VALUE_2: 선택기의 포함 라벨을 정의하는 키-값 쌍입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. 여러 선택기를 지정하려면 instanceSelectors 배열에 여러 객체를 포함하고 각 객체에 labelSelector 필드를 포함합니다. 이 경우 VM 확장 프로그램 관리자는 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). instanceSelectors를 생략하면 정책은 폴더 내의 모든 하위 프로젝트 및 영역에 있는 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.
• ROLLOUT_CONFLICT_BEHAVIOR: VM 확장 프로그램 관리자가 영역 정책과 전역 정책 간의 충돌을 감지할 때의 동작을 지정합니다. 다음 충돌 동작 중 하나를 지정할 수 있습니다.
  • ""(빈 문자열): 전역 정책이 이름이 동일한 충돌하는 영역 정책을 덮어쓰지 않습니다. 이 충돌 동작은 기본값입니다.
  • overwrite: 전역 정책이 이름이 동일한 영역 정책을 덮어쓴 다음 전역 정책이 영역의 정책 출시를 관리합니다.

  자세한 내용은 --rollout-conflict-behavior 플래그를 참조하세요.

• ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다. 사전 정의된 출시 계획을 사용하려면 name 필드를 predefinedRolloutPlan로 바꾸고 다음 값 중 하나를 지정합니다.
  • SLOW_ROLLOUT: 5일에 걸쳐 정책을 출시합니다. 이 사전 정의된 계획은 계획을 지정하지 않은 경우 기본 출시 계획입니다.
  • FAST_ROLLOUT: 정책을 모든 영역에 즉시 출시합니다.
• RETRY_UUID: 정책 업데이트 출시의 재시도 시도를 식별하는 UUID입니다.

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

필수 IAM 권한

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

이 사전 정의된 역할에는 프로젝트 범위 확장 프로그램 정책을 업데이트하는 데 필요한 compute.vmExtensionPolicies.update 권한이 포함되어 있습니다.

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

프로젝트 범위 전역 확장 프로그램 정책을 업데이트하려면 다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 프로젝트 범위 전역 VM 확장 프로그램 정책을 업데이트하려면 다음 단계를 완료하세요.

1. Google Cloud 콘솔에서 VM 확장 프로그램 정책 페이지로 이동합니다.

   VM 확장 프로그램 정책으로 이동

2. 전역 정책을 클릭한 다음 수정할 정책을 선택합니다.
3. 수정을 클릭합니다.
4. 우선순위 필드에서 정책 간 충돌을 해결하기 위한 우선순위 번호를 지정합니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1,000입니다.
5. 확장 프로그램 관리 섹션에서 다음을 수행합니다.
   • 확장 프로그램을 더 추가하려면 확장 프로그램 추가를 클릭하고 확장 프로그램과 버전을 선택합니다.
   • 이 정책으로 관리되는 확장 프로그램을 삭제하려면 확장 프로그램 이름 옆에 있는 삭제 버튼을 클릭합니다.
6. 라벨을 적용하려면 대상 VM 인스턴스 섹션에서 대상 VM의 라벨을 추가합니다.
7. 저장을 클릭합니다.

참고: Google Cloud 콘솔은 출시 수정을 지원하지 않습니다. 출시를 수정하려면 gcloud CLI 또는 REST API를 사용합니다.

gcloud

gcloud compute global-vm-extension-policies update 명령어를 사용하여 기존 프로젝트 범위 전역 VM 확장 프로그램 정책을 수정합니다. gcloud를 사용하여 정책을 업데이트하면 요청이 전체 교체로 작동합니다. 생략한 선택적 필드는 수정된 정책의 기존 값을 유지하는 대신 기본값으로 되돌아갑니다.

프로젝트 범위 전역 VM 확장 프로그램 정책을 업데이트하려면 다음 명령어를 실행합니다.

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

다음을 바꿉니다.

• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: Google Cloud 프로젝트 ID입니다.
• DESCRIPTION: 정책에 대한 설명입니다(선택사항).
• EXTENSION_NAME_1,EXTENSION_NAME_2: 정책에 추가할 확장 프로그램의 쉼표로 구분된 목록입니다. 확장 프로그램을 하나 이상 지정해야 합니다. 지원되는 다음 확장 프로그램 중 하나를 지정할 수 있습니다.
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: 쉼표로 구분된 키-값 쌍 목록으로, 키는 확장 프로그램 이름이고 값은 확장 프로그램 버전입니다. 확장 프로그램 버전을 지정하지 않으면 VM 확장 프로그램 관리자가 사용 가능한 최신 버전을 사용하고 새 버전이 제공되면 자동으로 업그레이드합니다.
  참고: ops-agent의 경우 VM 확장 프로그램 관리자는 버전 2.58.0 이상 설치를 지원합니다. google-cloud-sap-extension 및 google-cloud-workload-extension의 경우 VM 확장 프로그램 관리자는 최신 버전만 지원합니다.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: 쉼표로 구분된 키-값 쌍 목록입니다. 여기서 키는 확장 프로그램 이름이고 값은 해당 확장 프로그램의 구성 파일 경로입니다. 이 파일은 확장 프로그램을 설치하는 VM이 아닌 gcloud 명령어를 실행하는 VM에 있습니다.

  또는 구성을 인라인 문자열로 제공하려면 --config-from-file 대신 --config 플래그를 사용합니다(예: EXTENSION_NAME_1="CONFIG_1"). --config-from-file 또는 --config를 사용할 수 있지만 동일한 명령어에서 둘 다 사용할 수는 없습니다.

• KEY_1=VALUE_1: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. --inclusion-labels를 여러 번 지정하면 정책은 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). 이 플래그를 생략하면 정책은 프로젝트의 모든 영역에 있는 모든 VM을 대상으로 합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.
• ROLLOUT_PLAN: slow_rollout 또는 fast_rollout를 지정합니다. 커스텀 출시 계획을 사용해야 하는 경우 다음 형식을 사용하여 --rollout-predefined-plan 대신 --rollout-custom-plan 플래그를 지정합니다.

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  다음을 바꿉니다.

  • PROJECT_NUMBER: 출시 계획이 정의된 프로젝트입니다.
  • ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다.

  출시 계획 플래그를 지정하지 않으면 VM 확장 프로그램 관리자가 slow_rollout를 사용합니다.

• ROLLOUT_CONFLICT_BEHAVIOR: VM 확장 프로그램 관리자가 영역 정책과 전역 정책 간의 충돌을 감지할 때의 동작을 지정합니다. 다음 충돌 동작 중 하나를 지정할 수 있습니다.
  • ""(빈 문자열): 전역 정책이 이름이 동일한 충돌하는 영역 정책을 덮어쓰지 않습니다. 이 충돌 동작은 기본값입니다.
  • overwrite: 전역 정책이 이름이 동일한 영역 정책을 덮어쓴 다음 전역 정책이 영역의 정책 출시를 관리합니다.

  자세한 내용은 --rollout-conflict-behavior 플래그를 참조하세요.

• RETRY_UUID: 정책 업데이트 출시의 재시도 시도를 식별하는 UUID입니다. 이 UUID를 사용하면 변경 없이 업데이트를 재시도할 수 있습니다. 이 플래그를 설정하고 정책이 수정되면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

REST

프로젝트 범위 전역 확장 프로그램 정책을 업데이트하려면 globalVmExtensionPolicies.update 메서드에 PATCH 요청을 보냅니다. REST를 사용하여 정책을 업데이트할 때는 업데이트할 필드만 제공하면 됩니다. 생략한 필드는 기존 값을 유지합니다.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트 ID입니다.
• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• DESCRIPTION: VM 확장 프로그램 정책에 대한 설명입니다.
• EXTENSION_NAME: 업데이트할 확장 프로그램의 이름으로, extensionPolicies 맵에서 키로 사용됩니다. 여러 확장 프로그램을 업데이트하려면 extensionPolicies 맵에 여러 항목을 포함합니다.
• EXTENSION_NAME_VERSION: VM 확장 프로그램의 버전입니다.
• EXTENSION_NAME_CONFIG: VM 확장 프로그램의 구성 설정(인라인 문자열)
• KEY_1:VALUE_1, KEY_2:VALUE_2: 선택기의 포함 라벨을 정의하는 키-값 쌍입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. 여러 선택기를 지정하려면 instanceSelectors 배열에 여러 객체를 포함하고 각 객체에 labelSelector 필드를 포함합니다. 이 경우 VM 확장 프로그램 관리자는 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). instanceSelectors를 생략하면 정책은 프로젝트의 모든 영역에 있는 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.
• ROLLOUT_CONFLICT_BEHAVIOR: VM 확장 프로그램 관리자가 영역 정책과 전역 정책 간의 충돌을 감지할 때의 동작을 지정합니다. 다음 충돌 동작 중 하나를 지정할 수 있습니다.
  • ""(빈 문자열): 전역 정책이 이름이 동일한 충돌하는 영역 정책을 덮어쓰지 않습니다. 이 충돌 동작은 기본값입니다.
  • overwrite: 전역 정책이 이름이 동일한 영역 정책을 덮어쓴 다음 전역 정책이 영역의 정책 출시를 관리합니다.

  자세한 내용은 --rollout-conflict-behavior 플래그를 참조하세요.

• PROJECT_NUMBER: 커스텀 출시 계획이 정의된 프로젝트입니다.
• ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다. 사전 정의된 출시 계획을 사용하려면 name 필드를 predefinedRolloutPlan로 바꾸고 다음 값 중 하나를 지정합니다.
  • SLOW_ROLLOUT: 5일에 걸쳐 정책을 출시합니다. 이 사전 정의된 계획은 계획을 지정하지 않은 경우 기본 출시 계획입니다.
  • FAST_ROLLOUT: 정책을 모든 영역에 즉시 출시합니다.
• RETRY_UUID: 정책 업데이트 출시의 재시도 시도를 식별하는 UUID입니다.

조직 전체의 영역에서 VM 확장 프로그램 수정

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 조직 범위 확장 프로그램 정책을 업데이트하는 데 필요한 compute.orgVmExtensionPolicies.update 권한이 포함되어 있습니다.

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

조직 범위 영역 확장 정책을 업데이트하려면 다음 옵션 중 하나를 선택합니다.

gcloud

gcloud preview compute zone-vm-extension-policies update 명령어를 --organization 플래그와 함께 사용하여 기존 조직 범위 영역 VM 확장 정책을 수정합니다. gcloud를 사용하여 정책을 업데이트하면 요청이 완전한 대체로 작동합니다. 생략한 선택적 필드는 수정된 정책의 기존 값을 유지하는 대신 기본값으로 되돌아갑니다.

조직 범위 영역 VM 확장 프로그램 정책을 업데이트하려면 다음 명령어를 실행합니다.

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

다음을 바꿉니다.

• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• ORGANIZATION_ID: Google Cloud 조직 ID입니다.
• ZONE: 정책이 적용되는 Google Cloud 영역
• DESCRIPTION: 정책에 대한 설명입니다(선택사항).
• EXTENSION_NAME_1,EXTENSION_NAME_2: 정책에 추가할 확장 프로그램의 쉼표로 구분된 목록입니다. 확장 프로그램을 하나 이상 지정해야 합니다. 지원되는 다음 확장 프로그램 중 하나를 지정할 수 있습니다.
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: 쉼표로 구분된 키-값 쌍 목록으로, 키는 확장 프로그램 이름이고 값은 확장 프로그램 버전입니다. 확장 프로그램 버전을 지정하지 않으면 VM 확장 프로그램 관리자가 사용 가능한 최신 버전을 사용하고 새 버전이 제공되면 자동으로 업그레이드합니다.
  참고: ops-agent의 경우 VM 확장 프로그램 관리자는 버전 2.58.0 이상 설치를 지원합니다. google-cloud-sap-extension 및 google-cloud-workload-extension의 경우 VM 확장 프로그램 관리자는 최신 버전만 지원합니다.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: 쉼표로 구분된 키-값 쌍 목록입니다. 여기서 키는 확장 프로그램 이름이고 값은 해당 확장 프로그램의 구성 파일 경로입니다. 이 파일은 확장 프로그램을 설치하는 VM이 아닌 gcloud 명령어를 실행하는 VM에 있습니다.

  또는 구성을 인라인 문자열로 제공하려면 --config-from-file 대신 --config 플래그를 사용합니다(예: EXTENSION_NAME_1="CONFIG_1"). --config-from-file 또는 --config를 사용할 수 있지만 동일한 명령어에서 둘 다 사용할 수는 없습니다.

• KEY_1=VALUE_1: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. --inclusion-labels를 여러 번 지정하면 정책은 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). 이 플래그를 생략하면 정책은 조직의 모든 하위 프로젝트에서 지정된 영역의 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.

REST

조직 범위 영역 확장 정책을 업데이트하려면 organizationZoneVmExtensionPolicies.update 메서드에 PATCH 요청을 보냅니다. REST를 사용하여 정책을 업데이트할 때는 업데이트할 필드만 제공하면 됩니다. 생략한 필드는 기존 값을 유지합니다.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

다음을 바꿉니다.

• ORGANIZATION_ID: Google Cloud 조직 ID입니다.
• ZONE: VM 확장 정책이 있는 Google Cloud 영역입니다.
• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• DESCRIPTION: VM 확장 프로그램 정책에 대한 설명입니다.
• EXTENSION_NAME: 업데이트할 확장 프로그램의 이름으로, extensionPolicies 맵에서 키로 사용됩니다. 여러 확장 프로그램을 업데이트하려면 extensionPolicies 맵에 여러 항목을 포함합니다.
• EXTENSION_NAME_VERSION: VM 확장 프로그램의 버전입니다.
• EXTENSION_NAME_CONFIG: VM 확장 프로그램의 구성 설정(인라인 문자열)
• KEY_1:VALUE_1, KEY_2:VALUE_2: 선택기의 포함 라벨을 정의하는 키-값 쌍입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. 여러 선택기를 지정하려면 instanceSelectors 배열에 여러 객체를 포함하고 각 객체에 labelSelector 필드를 포함합니다. 이 경우 VM 확장 프로그램 관리자는 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). instanceSelectors를 생략하면 정책은 조직의 모든 하위 프로젝트에서 지정된 영역의 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.

폴더 전체의 영역에서 VM 확장 프로그램 수정

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 폴더 범위 확장 프로그램 정책을 업데이트하는 데 필요한 compute.folderVmExtensionPolicies.update 권한이 포함되어 있습니다.

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

폴더 범위 영역 확장 정책을 업데이트하려면 다음 옵션 중 하나를 선택합니다.

gcloud

--folder 플래그와 함께 gcloud preview compute zone-vm-extension-policies update 명령어를 사용하여 기존 폴더 범위 영역 VM 확장 정책을 수정합니다. gcloud를 사용하여 정책을 업데이트하면 요청이 완전한 대체로 작동합니다. 생략한 선택적 필드는 수정된 정책의 기존 값을 유지하는 대신 기본값으로 되돌아갑니다.

폴더 범위 영역 VM 확장 프로그램 정책을 업데이트하려면 다음 명령어를 실행합니다.

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

다음을 바꿉니다.

• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• FOLDER_ID: Google Cloud 폴더 ID입니다.
• ZONE: 정책이 적용되는 Google Cloud 영역
• DESCRIPTION: 정책에 대한 설명입니다(선택사항).
• EXTENSION_NAME_1,EXTENSION_NAME_2: 정책에 추가할 확장 프로그램의 쉼표로 구분된 목록입니다. 확장 프로그램을 하나 이상 지정해야 합니다. 지원되는 다음 확장 프로그램 중 하나를 지정할 수 있습니다.
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: 쉼표로 구분된 키-값 쌍 목록으로, 키는 확장 프로그램 이름이고 값은 확장 프로그램 버전입니다. 확장 프로그램 버전을 지정하지 않으면 VM 확장 프로그램 관리자가 사용 가능한 최신 버전을 사용하고 새 버전이 제공되면 자동으로 업그레이드합니다.
  참고: ops-agent의 경우 VM 확장 프로그램 관리자는 버전 2.58.0 이상 설치를 지원합니다. google-cloud-sap-extension 및 google-cloud-workload-extension의 경우 VM 확장 프로그램 관리자는 최신 버전만 지원합니다.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: 쉼표로 구분된 키-값 쌍 목록입니다. 여기서 키는 확장 프로그램 이름이고 값은 해당 확장 프로그램의 구성 파일 경로입니다. 이 파일은 확장 프로그램을 설치하는 VM이 아닌 gcloud 명령어를 실행하는 VM에 있습니다.

  또는 구성을 인라인 문자열로 제공하려면 --config-from-file 대신 --config 플래그를 사용합니다(예: EXTENSION_NAME_1="CONFIG_1"). --config-from-file 또는 --config를 사용할 수 있지만 동일한 명령어에서 둘 다 사용할 수는 없습니다.

• KEY_1=VALUE_1: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. --inclusion-labels를 여러 번 지정하면 정책은 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). 이 플래그를 생략하면 정책은 폴더 내의 모든 하위 프로젝트에서 지정된 영역의 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.

REST

폴더 범위 영역 확장 정책을 업데이트하려면 folderZoneVmExtensionPolicies.update 메서드에 PATCH 요청을 보냅니다. REST를 사용하여 정책을 업데이트할 때는 업데이트할 필드만 제공하면 됩니다. 생략한 필드는 기존 값을 유지합니다.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

다음을 바꿉니다.

• FOLDER_ID: Google Cloud 폴더 ID입니다.
• ZONE: VM 확장 정책이 있는 Google Cloud 영역입니다.
• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• DESCRIPTION: VM 확장 프로그램 정책에 대한 설명입니다.
• EXTENSION_NAME: 업데이트할 확장 프로그램의 이름으로, extensionPolicies 맵에서 키로 사용됩니다. 여러 확장 프로그램을 업데이트하려면 extensionPolicies 맵에 여러 항목을 포함합니다.
• EXTENSION_NAME_VERSION: VM 확장 프로그램의 버전입니다.
• EXTENSION_NAME_CONFIG: VM 확장 프로그램의 구성 설정(인라인 문자열)
• KEY_1:VALUE_1, KEY_2:VALUE_2: 선택기의 포함 라벨을 정의하는 키-값 쌍입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. 여러 선택기를 지정하려면 instanceSelectors 배열에 여러 객체를 포함하고 각 객체에 labelSelector 필드를 포함합니다. 이 경우 VM 확장 프로그램 관리자는 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). instanceSelectors를 생략하면 정책은 폴더 내의 모든 하위 프로젝트에서 지정된 영역의 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.

프로젝트의 영역에서 VM 확장 프로그램 수정

필수 IAM 권한

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

이 사전 정의된 역할에는 프로젝트 범위 확장 프로그램 정책을 업데이트하는 데 필요한 compute.vmExtensionPolicies.update 권한이 포함되어 있습니다.

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

프로젝트 범위 영역 확장 정책을 업데이트하려면 다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 프로젝트 범위 영역 VM 확장 프로그램 정책을 업데이트하려면 다음 단계를 완료하세요.

1. Google Cloud 콘솔에서 VM 확장 프로그램 정책 페이지로 이동합니다.

   VM 확장 프로그램 정책으로 이동

2. 업데이트할 정책을 선택합니다.
3. 수정을 클릭합니다.
4. 설명, 우선순위, 확장 프로그램 또는 대상 VM 인스턴스를 수정합니다.
5. 저장을 클릭합니다.

gcloud

gcloud compute zone-vm-extension-policies update 명령어를 사용하여 기존 프로젝트 범위 영역 VM 확장 정책을 수정합니다. gcloud를 사용하여 정책을 업데이트하면 요청이 완전한 대체로 작동합니다. 생략한 선택적 필드는 수정된 정책의 기존 값을 유지하는 대신 기본값으로 되돌아갑니다.

프로젝트 범위 영역 VM 확장 프로그램 정책을 업데이트하려면 다음 명령어를 실행합니다.

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

다음을 바꿉니다.

• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: Google Cloud 프로젝트 ID입니다.
• ZONE: 정책이 적용되는 Google Cloud 영역
• DESCRIPTION: 정책에 대한 설명입니다(선택사항).
• EXTENSION_NAME_1,EXTENSION_NAME_2: 정책에 추가할 확장 프로그램의 쉼표로 구분된 목록입니다. 확장 프로그램을 하나 이상 지정해야 합니다. 지원되는 다음 확장 프로그램 중 하나를 지정할 수 있습니다.
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: 쉼표로 구분된 키-값 쌍 목록으로, 키는 확장 프로그램 이름이고 값은 확장 프로그램 버전입니다. 확장 프로그램 버전을 지정하지 않으면 VM 확장 프로그램 관리자가 사용 가능한 최신 버전을 사용하고 새 버전이 제공되면 자동으로 업그레이드합니다.
  참고: ops-agent의 경우 VM 확장 프로그램 관리자는 버전 2.58.0 이상 설치를 지원합니다. google-cloud-sap-extension 및 google-cloud-workload-extension의 경우 VM 확장 프로그램 관리자는 최신 버전만 지원합니다.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: 쉼표로 구분된 키-값 쌍 목록입니다. 여기서 키는 확장 프로그램 이름이고 값은 해당 확장 프로그램의 구성 파일 경로입니다. 이 파일은 확장 프로그램을 설치하는 VM이 아닌 gcloud 명령어를 실행하는 VM에 있습니다.

  또는 구성을 인라인 문자열로 제공하려면 --config-from-file 대신 --config 플래그를 사용합니다(예: EXTENSION_NAME_1="CONFIG_1"). --config-from-file 또는 --config를 사용할 수 있지만 동일한 명령어에서 둘 다 사용할 수는 없습니다.

• KEY_1=VALUE_1: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. --inclusion-labels를 여러 번 지정하면 정책은 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). 이 플래그를 생략하면 정책은 프로젝트 내 지정된 영역의 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.

REST

프로젝트 범위 영역 확장 정책을 업데이트하려면 zoneVmExtensionPolicies.update 메서드에 PATCH 요청을 실행합니다. REST를 사용하여 정책을 업데이트할 때는 업데이트할 필드만 제공하면 됩니다. 생략한 필드는 기존 값을 유지합니다.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트 ID입니다.
• ZONE: VM 확장 정책이 있는 Google Cloud 영역입니다.
• POLICY_NAME: 업데이트할 VM 확장 프로그램 정책의 이름입니다.
• DESCRIPTION: VM 확장 프로그램 정책에 대한 설명입니다.
• EXTENSION_NAME: 업데이트할 확장 프로그램의 이름으로, extensionPolicies 맵에서 키로 사용됩니다. 여러 확장 프로그램을 업데이트하려면 extensionPolicies 맵에 여러 항목을 포함합니다.
• EXTENSION_NAME_VERSION: VM 확장 프로그램의 버전입니다.
• EXTENSION_NAME_CONFIG: VM 확장 프로그램의 구성 설정(인라인 문자열)
• KEY_1:VALUE_1, KEY_2:VALUE_2: 선택기의 포함 라벨을 정의하는 키-값 쌍입니다. VM은 타겟팅할 선택기에 지정된 모든 라벨을 포함해야 합니다. 여러 선택기를 지정하려면 instanceSelectors 배열에 여러 객체를 포함하고 각 객체에 labelSelector 필드를 포함합니다. 이 경우 VM 확장 프로그램 관리자는 제공된 선택기 중 하나와 일치하는 VM을 타겟팅합니다(논리적 OR). instanceSelectors를 생략하면 정책은 프로젝트 내 지정된 영역의 모든 VM을 타겟팅합니다.
• PRIORITY: 정책의 우선순위를 정의하는 0에서 65535 사이의 정수입니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1000입니다. 여러 정책의 우선순위가 동일한 경우 VM 확장 프로그램 관리자는 가장 최근에 업데이트된 정책을 VM에 적용합니다.

VM 확장 프로그램 정책을 삭제하여 확장 프로그램 제거

정책을 삭제하면 VM 확장 프로그램 관리자가 해당 정책으로 관리되는 모든 VM에서 확장 프로그램을 제거합니다. 그러나 우선순위가 낮은 다른 활성 정책이 VM에 적용되고 동일한 확장 프로그램을 선언하는 경우 확장 프로그램은 우선순위가 낮은 정책에 따라 해당 VM에 설치된 상태로 유지됩니다.

VM 확장 프로그램 관리자는 정책 삭제 후 1분 이내에 액세스 가능한 모든 VM에서 확장 프로그램을 삭제합니다. 게스트 에이전트가 삭제되거나 VM이 삭제되어 VM에 액세스할 수 없는 경우 VM 확장 프로그램 관리자는 확장 프로그램 삭제를 건너뜁니다. 이러한 VM을 다시 사용할 수 있게 되면 VM 확장 프로그램 관리자가 해당 시점에 확장 프로그램을 삭제합니다.

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

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 조직 범위 확장 프로그램 정책을 삭제하는 데 필요한 compute.orgVmExtensionPolicies.delete 권한이 포함되어 있습니다.

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

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

gcloud

--organization 플래그와 함께 gcloud preview compute global-vm-extension-policies delete 명령어를 사용하여 기존 조직 범위 전역 VM 확장 프로그램 정책을 삭제합니다.

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• ORGANIZATION_ID: Google Cloud 조직의 ID입니다.
• ROLLOUT_PLAN: slow_rollout 또는 fast_rollout를 지정합니다. 커스텀 출시 계획을 사용해야 하는 경우 다음 형식을 사용하여 --rollout-predefined-plan 대신 --rollout-custom-plan 플래그를 지정합니다.

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  다음을 바꿉니다.

  • ORGANIZATION_ID: 출시 계획이 정의된 조직입니다.
  • ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다.

  출시 계획 플래그를 지정하지 않으면 VM 확장 프로그램 관리자가 slow_rollout를 사용합니다.

• RETRY_UUID: 확장 프로그램 정책 삭제를 재시도하는 UUID입니다. DELETING 상태인 기존 정책의 삭제 요청을 다시 시도하는 경우에만 이 필드를 설정합니다. 정책이 DELETING 상태가 아닐 때 이 필드를 설정하면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

REST

조직 범위 전역 확장 프로그램 정책을 삭제하려면 organizationGlobalVmExtensionPolicies.delete 메서드에 POST 요청을 보냅니다.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• ORGANIZATION_ID: Google Cloud 조직 ID입니다.
• ROLLOUT_PLAN: SLOW_ROLLOUT 또는 FAST_ROLLOUT를 지정합니다. 커스텀 출시 계획을 사용하려면 predefinedRolloutPlan을 "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"로 바꿉니다.
• RETRY_UUID: 확장 프로그램 정책 삭제를 재시도하는 UUID입니다. DELETING 상태인 기존 정책의 삭제 요청을 다시 시도하는 경우에만 이 필드를 설정합니다. 정책이 DELETING 상태가 아닐 때 이 필드를 설정하면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

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

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 폴더 범위 확장 프로그램 정책을 삭제하는 데 필요한 compute.folderVmExtensionPolicies.delete 권한이 포함되어 있습니다.

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

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

gcloud

--folder 플래그와 함께 gcloud preview compute global-vm-extension-policies delete 명령어를 사용하여 기존 폴더 범위 전역 VM 확장 프로그램 정책을 삭제합니다.

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• FOLDER_ID: Google Cloud 폴더의 ID입니다.
• ROLLOUT_PLAN: slow_rollout 또는 fast_rollout를 지정합니다. 커스텀 출시 계획을 사용해야 하는 경우 다음 형식을 사용하여 --rollout-predefined-plan 대신 --rollout-custom-plan 플래그를 지정합니다.

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  다음을 바꿉니다.

  • FOLDER_ID: 출시 계획이 정의된 폴더입니다.
  • ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다.

  출시 계획 플래그를 지정하지 않으면 VM 확장 프로그램 관리자가 slow_rollout를 사용합니다.

• RETRY_UUID: 확장 프로그램 정책 삭제를 재시도하는 UUID입니다. DELETING 상태인 기존 정책의 삭제 요청을 다시 시도하는 경우에만 이 필드를 설정합니다. 정책이 DELETING 상태가 아닐 때 이 필드를 설정하면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

REST

폴더 범위 전역 확장 프로그램 정책을 삭제하려면 folderGlobalVmExtensionPolicies.delete 메서드에 POST 요청을 보냅니다.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• FOLDER_ID: Google Cloud 폴더 ID입니다.
• ROLLOUT_PLAN: SLOW_ROLLOUT 또는 FAST_ROLLOUT를 지정합니다. 커스텀 출시 계획을 사용하려면 predefinedRolloutPlan을 "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"로 바꿉니다.
• RETRY_UUID: 확장 프로그램 정책 삭제를 재시도하는 UUID입니다. DELETING 상태인 기존 정책의 삭제 요청을 다시 시도하는 경우에만 이 필드를 설정합니다. 정책이 DELETING 상태가 아닐 때 이 필드를 설정하면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

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

필수 IAM 권한

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

이 사전 정의된 역할에는 프로젝트 범위 확장 프로그램 정책을 삭제하는 데 필요한 compute.vmExtensionPolicies.delete 권한이 포함되어 있습니다.

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

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

콘솔

Google Cloud 콘솔에서 프로젝트 범위 전역 VM 확장 프로그램 정책을 삭제하려면 다음 단계를 완료합니다.

1. Google Cloud 콘솔에서 VM 확장 프로그램 정책 페이지로 이동합니다.

   VM 확장 프로그램 정책으로 이동

2. 전역 정책을 클릭한 후 삭제할 정책을 선택합니다.
3. 삭제를 클릭합니다.
4. 확인 대화상자에서 정책 이름을 입력한 후 삭제를 클릭합니다.

gcloud

gcloud compute global-vm-extension-policies delete 명령어를 사용하여 기존 프로젝트 범위 전역 VM 확장 프로그램 정책을 삭제합니다.

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• ROLLOUT_PLAN: slow_rollout 또는 fast_rollout를 지정합니다. 커스텀 출시 계획을 사용해야 하는 경우 다음 형식을 사용하여 --rollout-predefined-plan 대신 --rollout-custom-plan 플래그를 지정합니다.

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  다음을 바꿉니다.

  • PROJECT_NUMBER: 출시 계획이 정의된 프로젝트입니다.
  • ROLLOUT_PLAN_NAME: 정의한 커스텀 출시 계획의 이름입니다.

  출시 계획 플래그를 지정하지 않으면 VM 확장 프로그램 관리자가 slow_rollout를 사용합니다.

• RETRY_UUID: 확장 프로그램 정책 삭제를 재시도하는 UUID입니다. DELETING 상태인 기존 정책의 삭제 요청을 다시 시도하는 경우에만 이 필드를 설정합니다. 정책이 DELETING 상태가 아닐 때 이 필드를 설정하면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

REST

프로젝트 범위 전역 확장 프로그램 정책을 삭제하려면 globalVmExtensionPolicies.delete 메서드에 POST 요청을 보냅니다.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• PROJECT_ID: Google Cloud 프로젝트 ID입니다.
• ROLLOUT_PLAN: SLOW_ROLLOUT 또는 FAST_ROLLOUT를 지정합니다. 커스텀 출시 계획을 사용하려면 predefinedRolloutPlan을 "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"로 바꿉니다.
• RETRY_UUID: 확장 프로그램 정책 삭제를 재시도하는 UUID입니다. DELETING 상태인 기존 정책의 삭제 요청을 다시 시도하는 경우에만 이 필드를 설정합니다. 정책이 DELETING 상태가 아닐 때 이 필드를 설정하면 오류가 발생합니다. 자세한 내용은 출시 재시도를 참조하세요.

조직 전체의 영역에서 VM 확장 프로그램 제거

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 조직 범위 확장 프로그램 정책을 삭제하는 데 필요한 compute.orgVmExtensionPolicies.delete 권한이 포함되어 있습니다.

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

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

gcloud

--organization 플래그와 함께 gcloud preview compute zone-vm-extension-policies delete 명령어를 사용하여 기존 조직 범위 영역 VM 확장 정책을 삭제합니다.

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

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• ORGANIZATION_ID: Google Cloud 조직의 ID입니다.
• ZONE: 정책이 있는 Google Cloud 영역입니다.

REST

조직 범위 영역 확장 정책을 삭제하려면 organizationZoneVmExtensionPolicies.delete 메서드에 DELETE 요청을 보냅니다.

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

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• ORGANIZATION_ID: Google Cloud 조직 ID입니다.
• ZONE: 정책이 있는 Google Cloud 영역입니다.

폴더 전체의 영역에서 VM 확장 프로그램 제거

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제품 또는 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

필수 IAM 권한

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

이 사전 정의된 역할에는 폴더 범위 확장 프로그램 정책을 삭제하는 데 필요한 compute.folderVmExtensionPolicies.delete 권한이 포함되어 있습니다.

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

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

gcloud

--folder 플래그와 함께 gcloud preview compute zone-vm-extension-policies delete 명령어를 사용하여 기존 폴더 범위 영역 VM 확장 정책을 삭제합니다.

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

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• FOLDER_ID: Google Cloud 폴더의 ID입니다.
• ZONE: 정책이 있는 Google Cloud 영역입니다.

REST

폴더 범위 영역 확장 정책을 삭제하려면 folderZoneVmExtensionPolicies.delete 메서드에 DELETE 요청을 보냅니다.

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

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• FOLDER_ID: Google Cloud 폴더 ID입니다.
• ZONE: 정책이 있는 Google Cloud 영역입니다.

프로젝트의 영역에서 VM 확장 프로그램 제거

필수 IAM 권한

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

이 사전 정의된 역할에는 프로젝트 범위 확장 프로그램 정책을 삭제하는 데 필요한 compute.vmExtensionPolicies.delete 권한이 포함되어 있습니다.

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

프로젝트 범위 영역 확장 정책을 삭제하려면 다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 프로젝트 범위 영역 VM 확장 프로그램 정책을 삭제하려면 다음 단계를 완료하세요.

1. Google Cloud 콘솔에서 VM 확장 프로그램 정책 페이지로 이동합니다.

   VM 확장 프로그램 정책으로 이동

2. 삭제할 정책을 클릭합니다.
3. 삭제를 클릭합니다.
4. 확인 대화상자에서 삭제를 클릭합니다.

gcloud

gcloud compute zone-vm-extension-policies delete 명령어를 사용하여 기존 프로젝트 범위 영역 VM 확장 프로그램 정책을 삭제합니다.

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

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• ZONE: 정책이 있는 Google Cloud 영역입니다.

REST

프로젝트 범위 영역 확장 정책을 삭제하려면 zoneVmExtensionPolicies.delete 메서드에 DELETE 요청을 수행합니다.

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

다음을 바꿉니다.

• POLICY_NAME: 삭제할 VM 확장 정책의 이름입니다.
• PROJECT_ID: Google Cloud 프로젝트 ID입니다.
• ZONE: 정책이 있는 Google Cloud 영역입니다.

다음 단계

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