통합 액세스 정책 삭제

통합 액세스 정책(UAP)을 사용하면 주 구성원에게Google Cloud 리소스에 대한 액세스 권한을 부여하거나 거부할 수 있습니다. UAP를 리소스에 더 이상 적용하지 않으려면 정책을 리소스에 바인딩하는 정책 바인딩을 삭제하면 됩니다. 바인딩된 모든 리소스에서 정책을 삭제하려면 정책을 삭제하면 됩니다.

시작하기 전에

  1. 인증을 설정합니다.

    이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.

    콘솔

    Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.

    gcloud

    Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

    Cloud Shell 활성화

    Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

    REST

    로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

      Google Cloud CLI를 설치합니다.

      외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

    자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

  2. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  3. 선택사항: UAP 개요를 읽습니다.

통합 액세스 정책 바인딩을 삭제하는 데 필요한 역할

UAP의 바인딩을 삭제하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

  • UAP를 소유한 리소스에 대한 액세스 정책 사용자(roles/iam.accessPolicyUser) 이 역할에는 바인딩을 삭제하는 데 필요한 iam.accesspolicies.unbind 권한이 포함되어 있습니다.
  • SERVICE.RESOURCE.deletePolicyBinding 권한이 포함된 역할. 여기서 RESOURCE는 UAP가 바인딩된 리소스 유형이고 SERVICE는 리소스를 소유하는 서비스입니다.

    필요한 권한이 포함된 역할을 찾으려면 역할 및 권한 참조에서 권한을 검색하고 권한 이름을 클릭한 후 권한이 포함된 역할을 검토합니다.

    리소스 또는 상위 리소스 중 하나에 이 역할이 필요합니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

통합 액세스 정책을 삭제하는 데 필요한 역할

UAP를 삭제하는 데 필요한 권한을 얻으려면 관리자에게 삭제하려는 UAP를 소유한 프로젝트, 폴더 또는 조직에 대한 액세스 정책 관리자(roles/iam.accessPolicyAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 UAP를 삭제하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

UAP를 삭제하려면 다음 권한이 필요합니다.

  • iam.accesspolicies.delete
  • Google Cloud 콘솔에서 UAP를 삭제합니다.
    • iam.accesspolicies.get
    • iam.accessPolicies.list

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

리소스에서 통합 액세스 정책 삭제

리소스에서 UAP를 삭제하려면 UAP를 리소스에 바인딩하는 바인딩을 삭제합니다. 바인딩을 삭제하면 UAP가 더 이상 리소스 또는 리소스의 하위 요소에 적용되지 않습니다. 하지만 UAP는 삭제되지 않으며 다른 바인딩은 영향을 받지 않습니다.

Google Cloud 콘솔, gcloud CLI 또는 IAM REST API를 사용하여 프로젝트, 폴더, 조직의 바인딩을 삭제할 수 있습니다. 다른 리소스의 바인딩을 삭제하려면 gcloud CLI 또는 IAM REST API를 사용해야 합니다.

콘솔

  1. Google Cloud 콘솔에서 통합 액세스 정책 페이지로 이동합니다.

    통합 액세스 정책으로 이동
  2. 삭제하려는 UAP를 소유한 프로젝트, 폴더 또는 조직을 선택합니다.
  3. 삭제하려는 UAP의 정책 ID를 클릭합니다.
  4. 바인딩 탭을 선택합니다.
  5. 바인딩 테이블에서 삭제하려는 바인딩이 포함된 행을 찾습니다.
  6. 해당 행에서 작업 메뉴를 클릭한 후 바인딩 삭제를 클릭합니다.
  7. 바인딩 삭제 대화상자에서 삭제를 클릭합니다.

gcloud

gcloud iam policy-bindings delete 명령어는 바인딩을 삭제합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

  • BINDING_ID: 삭제하려는 바인딩의 ID입니다(예: example-binding).
  • BINDING_PARENT_RESOURCE_TYPE: 바인딩이 하위 요소인 Resource Manager 리소스(프로젝트, 폴더 또는 조직)의 유형입니다. project, folder, organization 값을 사용합니다.

    바인딩의 상위 리소스는 바인딩의 대상 리소스에 따라 다릅니다. 자세한 내용은 지원 리소스를 참조하세요.

  • BINDING_PARENT_RESOURCE_ID: 정책 바인딩이 하위 요소인 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud iam policy-bindings delete BINDING_ID \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global

Windows(PowerShell)

gcloud iam policy-bindings delete BINDING_ID `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global

Windows(cmd.exe)

gcloud iam policy-bindings delete BINDING_ID ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global

응답에는 요청에 해당하는 장기 실행 작업이 포함됩니다. 장기 실행 작업의 상태를 가져오는 방법을 알아보려면 이 페이지의 장기 실행 작업의 상태 확인을 참조하세요.

Delete request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done.
Deleted policyBinding [example-binding].

REST

policyBindings.delete 메서드는 바인딩을 삭제합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • BINDING_PARENT_RESOURCE_TYPE: 바인딩이 하위 요소인 Resource Manager 리소스(프로젝트, 폴더 또는 조직)의 유형입니다. projects, folders, organizations 값을 사용합니다.

    바인딩의 상위 리소스는 바인딩의 대상 리소스에 따라 다릅니다. 자세한 내용은 지원 리소스를 참조하세요.

  • BINDING_PARENT_RESOURCE_ID: 정책 바인딩이 하위 요소인 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • BINDING_ID: 삭제하려는 바인딩의 ID입니다(예: example-binding).

HTTP 메서드 및 URL:

DELETE https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

응답에는 요청에 해당하는 장기 실행 작업이 포함됩니다. 장기 실행 작업의 상태를 가져오는 방법을 알아보려면 이 페이지의 장기 실행 작업의 상태 확인을 참조하세요.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

통합 액세스 정책 삭제

UAP를 삭제하기 전에 UAP를 참조하는 모든 기존 바인딩을 식별하고 삭제합니다. 기존 바인딩을 삭제하지 않고 UAP를 삭제하려고 하면 오류가 발생합니다.

기존 바인딩을 삭제하지 않고 UAP를 삭제하려면 UAP를 강제로 삭제하면 됩니다. UAP를 강제로 삭제하면 바인딩된 모든 리소스에서 삭제됩니다. UAP를 참조하는 모든 바인딩은 결국 삭제됩니다. 그러나 삭제될 때까지 바인딩은 단일 리소스를 참조할 수 있는 바인딩 수 한도에 포함됩니다.

Google Cloud 콘솔, gcloud CLI 또는 IAM REST API를 사용하여 UAP를 삭제할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 통합 액세스 정책 페이지로 이동합니다.

    통합 액세스 정책으로 이동
  2. 삭제하려는 UAP를 소유한 프로젝트, 폴더 또는 조직을 선택합니다.
  3. 삭제하려는 UAP의 정책 ID를 클릭합니다.
  4. 정책 삭제를 클릭합니다.
  5. UAP에 기존 바인딩이 있는 경우 이 정책 및 정책의 모든 바인딩 삭제를 선택합니다. 이 옵션을 선택하지 않고 기존 바인딩이 있는 UAP를 삭제하려고 하면 요청이 실패합니다.
  6. 정책 삭제 대화상자에서 삭제를 클릭합니다.

gcloud

gcloud iam access-policies delete 명령어는 UAP 및 연결된 모든 바인딩을 삭제합니다.

아래의 명령어 데이터를 사용하기 전에 다음을 바꿉니다.

  • UAP_ID: 삭제하려는 UAP의 ID입니다(예: example-policy).
  • UAP_PARENT_RESOURCE_TYPE: 삭제하려는 UAP를 소유한 Resource Manager 리소스(프로젝트, 폴더 또는 조직)의 유형입니다. project, folder, organization 값을 사용합니다.
  • UAP_PARENT_RESOURCE_ID: 삭제하려는 UAP를 소유한 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • FORCE_FLAG: 선택사항. 명령어에서 정책을 강제로 삭제하게 하려면 정책이 기존 바인딩에서 참조되더라도 --force 플래그를 사용합니다. 이 플래그가 설정되지 않고 정책이 기존 바인딩에서 참조되면 명령어가 실패합니다.

다음 명령어를 실행합니다.

Linux, macOS 또는 Cloud Shell

gcloud iam access-policies delete UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \
    FORCE_FLAG

Windows(PowerShell)

gcloud iam access-policies delete UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global `
    FORCE_FLAG

Windows(cmd.exe)

gcloud iam access-policies delete UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^
    FORCE_FLAG

응답에는 요청에 해당하는 장기 실행 작업이 포함됩니다. 장기 실행 작업의 상태를 가져오는 방법을 알아보려면 이 페이지의 장기 실행 작업의 상태 확인을 참조하세요.

Delete request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done.
Deleted accessPolicy [example-policy].

REST

accessPolicies.delete 메서드는 UAP와 연결된 모든 바인딩을 삭제합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • UAP_PARENT_RESOURCE_TYPE: 삭제하려는 UAP를 소유한 Resource Manager 리소스(프로젝트, 폴더 또는 조직)의 유형입니다. projects, folders, organizations 값을 사용합니다.
  • UAP_PARENT_RESOURCE_ID: 삭제하려는 UAP를 소유한 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • UAP_ID: 삭제하려는 UAP의 ID입니다(예: example-policy).
  • FORCE_DELETE: 선택사항. 정책 삭제 요청을 강제하려면 정책이 기존 바인딩에서 참조되더라도 쿼리 매개변수 force=true를 추가합니다. 이 쿼리 매개변수가 설정되지 않고 정책이 기존 바인딩에서 참조되면 요청이 실패합니다.

HTTP 메서드 및 URL:

DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

응답에는 요청에 해당하는 장기 실행 작업이 포함됩니다. 장기 실행 작업의 상태를 가져오는 방법을 알아보려면 이 페이지의 장기 실행 작업의 상태 확인을 참조하세요.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

장기 실행 작업의 상태 확인

REST API 또는 클라이언트 라이브러리를 사용할 때 정책 또는 바인딩을 변경하는 메서드는 장기 실행 작업(LRO)을 반환합니다. 장기 실행 작업은 요청의 상태를 추적하고 정책이나 바인딩 변경이 완료되었는지 여부를 나타냅니다.

REST

operations.get 메서드는 장기 실행 작업 상태를 반환합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • OPERATION_NAME: 작업의 전체 이름입니다. 원래 요청에 대한 응답으로 이 이름을 받습니다.

    작업 이름은 다음 형식입니다.

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

HTTP 메서드 및 URL:

GET https://iam.googleapis.com/v3/OPERATION_NAME

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

작업의 done 필드가 없으면 작업을 반복적으로 가져와서 해당 상태를 계속 모니터링합니다. 잘린 지수 백오프를 사용하여 각 요청 간에 지연을 일으킵니다. done 필드가 true로 설정되었으면 작업이 완료되었고 작업 가져오기를 중지할 수 있습니다.

다음 단계