통합 액세스 정책 보기

통합 액세스 정책(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를 보는 데 필요한 권한을 얻으려면 관리자에게 보려는 UAP를 소유한 프로젝트, 폴더 또는 조직에 대한 액세스 정책 뷰어(roles/iam.accessPolicyViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

필수 권한

UAP를 보려면 다음 권한이 필요합니다.

  • iam.accesspolicies.get
  • iam.accessPolicies.list

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

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

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

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

이러한 사전 정의된 역할에는 바인딩을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

바인딩을 보려면 다음 권한이 필요합니다.

  • 단일 바인딩 보기: iam.policybindings.get
  • 프로젝트, 폴더 또는 조직이 상위 요소인 바인딩 나열: iam.policybindings.list

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

통합 액세스 정책의 모든 바인딩을 보는 데 필요한 역할

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

이 사전 정의된 역할에는 UAP의 모든 바인딩을 보는 데 필요한 iam.accesspolicies.searchPolicyBindings 권한이 포함되어 있습니다.

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

리소스의 모든 바인딩을 볼 수 있는 역할

특정 대상 리소스가 포함된 모든 바인딩을 보는 데 필요한 권한을 얻으려면 관리자에게 해당 리소스의 바인딩을 나열할 수 있는 역할을 부여해 달라고 요청하세요. 이 역할에는 SERVICE.RESOURCE.searchPolicyBindings 권한이 포함되어야 합니다. 여기서 RESOURCE은 대상 리소스 유형이고 SERVICE는 리소스를 소유하는 서비스입니다.

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

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

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

프로젝트, 폴더 또는 조직의 통합 액세스 정책 나열

Google Cloud 콘솔, gcloud CLI 또는 IAM REST API를 사용하여 특정 프로젝트, 폴더 또는 조직에서 상위 요소로 지정된 모든 UAP를 나열할 수 있습니다.

콘솔

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

    통합 액세스 정책으로 이동
  2. 보려는 UAP를 소유한 프로젝트, 폴더 또는 조직을 선택합니다.

Google Cloud 콘솔에 선택한 리소스의 상위 요소이거나 이 리소스에 바인딩된 UAP가 표시됩니다.

gcloud

gcloud iam access-policies list 명령어는 특정 리소스의 하위 요소인 모든 UAP를 나열합니다.

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

  • UAP_PARENT_RESOURCE_TYPE: 나열하려는 UAP를 소유한 Resource Manager 리소스(프로젝트, 폴더 또는 조직)의 유형입니다. project, folder, organization 값을 사용합니다.
  • UAP_PARENT_RESOURCE_ID: 나열하려는 UAP를 소유한 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • FORMAT: 응답 형식입니다. json 또는 yaml을 사용합니다.

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

Linux, macOS 또는 Cloud Shell

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows(PowerShell)

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows(cmd.exe)

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

응답에는 요청의 리소스의 하위 요소인 UAP가 포함됩니다.

{
  "accessPolicies": [
    {
      "createTime": "2026-08-31T21:43:39.822441Z",
      "details": {
        "rules": [
          {
            "conditions": {
              "iam.googleapis.com": {
                "expression": "resource.matchTag('environment', 'prod')"
              }
            },
            "description": "Grant non-delete compute permissions to compute admins in prod",
            "effect": "ALLOW",
            "excludedPrincipals": [
              "principal://goog/subject/access-restricted@example.com"
            ],
            "operation": {
              "excludedPermissions": [
                "*/*.delete"
              ],
              "permissions": [
                "role:roles/compute.admin"
              ]
            },
            "principals": [
              "principalSet://goog/group/compute-admins@example.com"
            ]
          }
        ]
      },
      "displayName": "Example policy 1",
      "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
      "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
      "uid": "puid_0123456789012345678",
      "updateTime": "2026-08-31T21:43:39.822441Z"
    },
    {
      "createTime": "2026-05-29T23:25:01.606730Z",
      "details": {
        "rules": [
          {
            "description": "Deny group from publishing to message buses",
            "effect": "DENY",
            "operation": {
              "permissions": [
                "eventarc.googleapis.com/messageBuses.publish"
              ]
            },
            "principals": [
              "principalSet://goog/group/example-group@example.com"
            ]
          }
        ]
      },
      "displayName": "Example policy 2",
      "etag": "d6BJBTsk2+oDCygmr5ANxA==",
      "name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
      "uid": "puid_13064942519001808897",
      "updateTime": "2026-05-29T23:25:01.606730Z"
    }
  ]
}

REST

accessPolicies.list 메서드는 특정 리소스의 하위 요소인 모든 UAP를 나열합니다.

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

  • UAP_PARENT_RESOURCE_TYPE: 나열하려는 UAP를 소유한 Resource Manager 리소스(프로젝트, 폴더 또는 조직)의 유형입니다. projects, folders, organizations 값을 사용합니다.
  • UAP_PARENT_RESOURCE_ID: 나열하려는 UAP를 소유한 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

HTTP 메서드 및 URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies

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

응답에는 요청의 리소스의 하위 요소인 UAP가 포함됩니다.

{
  "accessPolicies": [
    {
      "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
      "uid": "puid_0123456789012345678",
      "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
      "displayName": "Example policy",
      "createTime": "2026-08-31T21:43:39.822441Z",
      "updateTime": "2026-08-31T21:43:39.822441Z",
      "details": {
        "rules": [
          {
            "principals": [
              "principalSet://goog/group/compute-admins@example.com"
            ],
            "excludedPrincipals": [
              "principal://goog/subject/access-restricted@example.com"
            ],
            "operation": {
              "permissions": [
                "role:roles/compute.admin"
              ],
              "excludedPermissions": [
                "*/*.delete"
              ]
            },
            "conditions": {
              "iam.googleapis.com": {
                "expression": "resource.matchTag('environment', 'prod')"
              }
            },
            "description": "Grant non-delete compute permissions to compute admins in prod",
            "effect": "ALLOW"
          }
        ]
      }
    },
    {
      "name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
      "uid": "puid_13064942519001808897",
      "etag": "d6BJBTsk2+oDCygmr5ANxA==",
      "displayName": "Example policy 2",
      "createTime": "2026-05-29T23:25:01.606730Z",
      "updateTime": "2026-05-29T23:25:01.606730Z",
      "details": {
        "rules": [
          {
            "description": "Deny group from publishing to message buses",
            "principals": [
              "principalSet://goog/group/example-group@example.com"
            ],
            "operation": {
              "permissions": [
                "eventarc.googleapis.com/messageBuses.publish"
              ]
            },
            "effect": "DENY"
          }
        ]
      }
    }
  ]
}

단일 통합 액세스 정책 가져오기

Google Cloud 콘솔, gcloud CLI 또는 IAM REST API를 사용하여 단일 UAP의 세부정보를 가져올 수 있습니다.

콘솔

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

    통합 액세스 정책으로 이동
  2. 세부정보를 보려는 UAP를 소유한 프로젝트, 폴더 또는 조직을 선택합니다.
  3. 세부정보를 보려는 UAP의 정책 ID를 클릭합니다.

Google Cloud 콘솔에 ID, 생성 시간, 최종 업데이트 시간, 규칙 목록을 포함한 UAP 세부정보가 표시됩니다.

gcloud

gcloud iam access-policies describe 명령어는 단일 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와 같은 숫자입니다.
  • FORMAT: 응답 형식입니다. json 또는 yaml을 사용합니다.

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

Linux, macOS 또는 Cloud Shell

gcloud iam access-policies describe UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows(PowerShell)

gcloud iam access-policies describe UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows(cmd.exe)

gcloud iam access-policies describe UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

응답에는 요청에 지정된 UAP가 포함됩니다.

{
  "createTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW",
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "excludedPermissions": [
            "*/*.delete"
          ],
          "permissions": [
            "role:roles/compute.admin"
          ]
        },
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ]
      }
    ]
  },
  "displayName": "Example policy",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "updateTime": "2026-08-31T21:43:39.822441Z"
}

REST

accessPolicies.get 메서드는 단일 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).

HTTP 메서드 및 URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

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

응답에는 요청에 지정된 UAP가 포함됩니다.

{
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "displayName": "Example policy",
  "createTime": "2026-08-31T21:43:39.822441Z",
  "updateTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ],
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "permissions": [
            "role:roles/compute.admin"
          ],
          "excludedPermissions": [
            "*/*.delete"
          ]
        },
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW"
      }
    ]
  }
}

통합 액세스 정책의 바인딩 나열

여러 가지 방법으로 UAP의 바인딩을 나열할 수 있습니다.

통합 액세스 정책의 바인딩 나열

특정 UAP가 포함된 모든 바인딩을 보려면 UAP의 바인딩을 검색합니다.

Google Cloud 콘솔, gcloud CLI 또는 IAM REST API를 사용하여 UAP의 모든 바인딩을 볼 수 있습니다.

콘솔

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

    통합 액세스 정책으로 이동
  2. 바인딩을 보려는 UAP를 소유한 프로젝트, 폴더 또는 조직을 선택합니다.
  3. 바인딩을 보려는 UAP의 정책 ID를 클릭합니다.
  4. 바인딩 탭을 선택합니다.

Google Cloud 콘솔에 UAP의 바인딩 목록과 각 바인딩의 표시 이름 및 대상 리소스가 표시됩니다.

gcloud

gcloud iam access-policies search-policy-bindings 명령어는 지정된 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와 같은 숫자입니다.
  • FORMAT: 응답 형식입니다. json 또는 yaml을 사용합니다.

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

Linux, macOS 또는 Cloud Shell

gcloud iam access-policies search-policy-bindings UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows(PowerShell)

gcloud iam access-policies search-policy-bindings UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows(cmd.exe)

gcloud iam access-policies search-policy-bindings UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

응답에는 지정된 UAP의 바인딩이 포함됩니다.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "createTime": "2026-05-07T07:05:06.203861Z",
      "displayName": "Example binding 2",
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

REST

accessPolicies.searchPolicyBindings 메서드는 지정된 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).

HTTP 메서드 및 URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings

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

응답에는 지정된 UAP의 바인딩이 포함됩니다.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-07T07:05:06.203861Z",
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

리소스의 모든 바인딩 나열

특정 대상 리소스가 포함된 모든 바인딩을 보려면 해당 리소스의 바인딩을 검색합니다.

각 바인딩에는 리소스에 바인딩된 UAP의 ID가 포함됩니다. 정책 세부정보를 보려면 정책 ID를 사용하여 정책 세부정보를 가져옵니다.

Google Cloud 콘솔, gcloud CLI 또는 IAM REST API를 사용하여 리소스의 모든 바인딩을 볼 수 있습니다.

콘솔

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

    통합 액세스 정책으로 이동
  2. 바인딩을 보려는 프로젝트, 폴더 또는 조직을 선택합니다.
  3. 필터 필드에 시행: 시행됨 필터를 입력합니다.

테이블에는 리소스에 바인딩된 모든 UAP가 표시됩니다.

gcloud

gcloud iam policy-bindings search-target-policy-bindings 명령어는 리소스가 포함된 모든 UAP 바인딩을 가져옵니다.

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

  • BINDING_PARENT_RESOURCE_TYPE: 대상 리소스의 바인딩을 보유하는 Resource Manager 리소스(프로젝트, 폴더 또는 조직)의 유형입니다. project, folder, organization 값을 사용합니다.

    어떤 리소스가 어떤 바인딩의 상위 요소인지 알아보려면 지원되는 리소스를 참조하세요.

  • BINDING_PARENT_RESOURCE_ID: 대상 리소스의 바인딩을 상위 요소로 하는 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • TARGET_RESOURCE: 바인딩을 나열할 리소스입니다. 유효한 리소스 목록은 지원되는 리소스를 참조하세요.
  • FORMAT: 응답 형식입니다. json 또는 yaml을 사용합니다.

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

Linux, macOS 또는 Cloud Shell

gcloud iam policy-bindings search-target-policy-bindings \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --target=TARGET_RESOURCE \
    --format=FORMAT

Windows(PowerShell)

gcloud iam policy-bindings search-target-policy-bindings `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --target=TARGET_RESOURCE `
    --format=FORMAT

Windows(cmd.exe)

gcloud iam policy-bindings search-target-policy-bindings ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --target=TARGET_RESOURCE ^
    --format=FORMAT

응답에는 대상 리소스를 포함하는 모든 UAP 바인딩이 포함됩니다.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:11:16.798841Z"
    },
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 2",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
      "policyKind": "ACCESS",
      "policyUid": "puid_10358560617928851457",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-06T18:11:16.798841Z"
    }
  ]
}

REST

SearchTargetPolicyBindings.search 메서드는 리소스가 포함된 모든 UAP 바인딩을 가져옵니다.

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

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

    어떤 리소스가 어떤 바인딩의 상위 요소인지 알아보려면 지원되는 리소스를 참조하세요.

  • BINDING_PARENT_RESOURCE_ID: 대상 리소스의 바인딩을 상위 요소로 하는 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • TARGET_RESOURCE: 바인딩을 나열할 리소스입니다. 유효한 리소스 목록은 지원되는 리소스를 참조하세요.

HTTP 메서드 및 URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE

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

응답에는 대상 리소스를 포함하는 모든 UAP 바인딩이 포함됩니다.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:11:16.798841Z",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:11:16.798841Z",
      "policyKind": "ACCESS",
      "policyUid": "puid_10358560617928851457"
    }
  ]
}

프로젝트, 폴더 또는 조직의 모든 바인딩 나열

gcloud CLI 또는 IAM REST API를 사용하여 바인딩을 보는 경우 특정 프로젝트, 폴더 또는 조직의 하위 요소인 모든 바인딩을 나열할 수도 있습니다.

프로젝트, 폴더 또는 조직의 바인딩을 나열하는 것은 해당 리소스의 바인딩을 검색하는 것과 비슷합니다. 하지만 바인딩 검색과 달리 리소스의 바인딩을 나열하면 해당 리소스의 직계 하위 요소인 모든 바인딩도 포함됩니다.

예를 들어 Network Services API Agent Gateway에 정책을 연결하는 바인딩이 있다고 가정해 보겠습니다. 이 바인딩의 상위 리소스는 Agent Gateway의 상위 프로젝트입니다. 즉, 바인딩은 프로젝트의 직계 하위 요소입니다. 따라서 해당 프로젝트의 바인딩을 나열하면 응답에 Agent Gateway의 바인딩이 포함됩니다. 하지만 프로젝트의 상위 조직에 대한 바인딩을 나열하면 응답에 바인딩이 포함되지 않습니다. 바인딩이 조직의 하위 요소이지만 조직의 직계 하위 요소가 아니기 때문입니다.

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

각 바인딩에는 리소스에 바인딩된 UAP의 ID가 포함됩니다. 정책 세부정보를 보려면 정책 ID를 사용하여 정책 세부정보를 가져옵니다.

gcloud CLI 또는 IAM REST API를 사용하여 프로젝트, 폴더 또는 조직의 하위 요소인 모든 바인딩을 볼 수 있습니다.

gcloud

gcloud iam policy-bindings list 명령어는 특정 리소스의 하위 요소인 모든 UAP 바인딩을 나열합니다.

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

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

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

  • BINDING_PARENT_RESOURCE_ID: 정책 바인딩이 하위 요소인 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • FORMAT: 응답 형식입니다. json 또는 yaml을 사용합니다.

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

Linux, macOS 또는 Cloud Shell

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --location=global \
    --filter=policyKind:ACCESS \
    --format=FORMAT

Windows(PowerShell)

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --location=global `
    --filter=policyKind:ACCESS `
    --format=FORMAT

Windows(cmd.exe)

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --location=global ^
    --filter=policyKind:ACCESS ^
    --format=FORMAT

응답에는 명령어의 리소스의 하위 요소인 UAP 바인딩이 포함됩니다.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "createTime": "2026-05-07T07:05:06.203861Z",
      "displayName": "Example binding 2",
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
      "policyKind": "ACCESS",
      "policyUid": "puid_1566408245394800641",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

REST

policyBindings.list 메서드는 특정 리소스의 하위 요소인 모든 UAP 바인딩을 나열합니다.

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

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

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

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

HTTP 메서드 및 URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS

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

응답에는 요청의 리소스의 하위 요소인 UAP 바인딩이 포함됩니다.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
      "policyUid": "puid_1566408245394800641",
      "createTime": "2026-05-07T07:05:06.203861Z",
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

통합 액세스 정책의 바인딩 가져오기

Google Cloud 콘솔, gcloud CLI 또는 IAM REST API를 사용하여 바인딩 세부정보를 가져올 수 있습니다.

콘솔

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

    통합 액세스 정책으로 이동
  2. 바인딩을 보려는 UAP를 소유한 프로젝트, 폴더 또는 조직을 선택합니다.
  3. 바인딩을 보려는 UAP의 정책 ID를 클릭합니다.
  4. 바인딩 탭을 선택합니다.
  5. 바인딩 ID 또는 바인딩 이름을 사용하여 바인딩을 찾습니다.

테이블에는 바인딩 ID, 바인딩 이름, 바인딩의 대상 리소스를 포함한 바인딩 세부정보가 표시됩니다.

gcloud

gcloud iam policy-bindings describe 명령어는 바인딩을 가져옵니다.

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

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

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

  • BINDING_PARENT_RESOURCE_ID: 정책 바인딩이 하위 요소인 프로젝트, 폴더 또는 조직의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
  • FORMAT: 응답 형식입니다. json 또는 yaml을 사용합니다.

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

Linux, macOS 또는 Cloud Shell

gcloud iam policy-bindings describe BINDING_ID \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows(PowerShell)

gcloud iam policy-bindings describe BINDING_ID `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows(cmd.exe)

gcloud iam policy-bindings describe BINDING_ID ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

응답에 바인딩이 포함됩니다.

{
  "createTime": "2026-05-06T18:08:24.729843Z",
  "displayName": "Example binding",
  "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
  "name": "organizations/123456789012/locations/global/policyBindings/example-binding",
  "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
  "policyKind": "ACCESS",
  "policyUid": "puid_9519202237377675265",
  "target": {
    "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
  },
  "uid": "buid_9904260005517852673", 
  "updateTime": "2026-05-06T18:08:24.729843Z"
}

REST

policyBindings.get 메서드는 바인딩을 가져옵니다.

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

  • 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:

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

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

응답에 바인딩이 포함됩니다.

{
  "name": "organizations/123456789012/locations/global/policyBindings/example-binding",
  "uid": "buid_9904260005517852673", 
  "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
  "displayName": "Example binding",
  "target": {
    "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
  },
  "policyKind": "ACCESS",
  "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
  "policyUid": "puid_9519202237377675265",
  "createTime": "2026-05-06T18:08:24.729843Z",
  "updateTime": "2026-05-06T18:08:24.729843Z"
}

다음 단계