이 페이지에서는 버킷 IP 필터링 규칙을 나열하는 방법을 설명합니다. 버킷 IP 필터링 규칙 나열 작업을 사용하면 버킷에서 IP 필터링이 사용 설정되어 있는지 또는 사용 중지되어 있는지 확인할 수 있습니다. 허용되는 특정 네트워크 소스에 관한 정보를 확인해야 하는 경우 버킷 IP 필터링 규칙 가져오기 작업을 사용하세요.
필요한 역할
버킷 IP 필터링 규칙을 나열하는 데 필요한 권한을 얻으려면 관리자에게 버킷에 대한 스토리지 관리자(roles/storage.admin) 역할을 부여해 달라고 요청하세요. 이 역할에는 버킷 IP 필터링 규칙을 나열하는 데 필요한 storage.buckets.list 권한이 포함되어 있습니다.
또한 커스텀 역할로 이 권한을 얻을 수 있습니다. 다른 사전 정의된 역할로도 이 권한을 부여받을 수 있습니다. 어떤 역할이 어떤 권한과 연결되어 있는지 확인하려면 Cloud Storage에 대한 IAM 역할을 참조하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["# List bucket IP filtering rules\n\nThis page describes how to list the [bucket IP filtering](/storage/docs/ip-filtering-overview) rules. With the list bucket IP filtering rules operation, you can check if IP filtering is enabled or disabled on a bucket. If you need to view information about the specific network sources that are allowed, use the [Get bucket IP filtering rules](/storage/docs/get-ip-filter) operation.\n\nRequired roles\n--------------\n\nTo get the required permissions for listing the bucket IP filtering rules, ask your administrator to grant you the Storage Admin (`roles/storage.admin`)\nrole on the bucket. This role contains the `storage.buckets.list` permission required to list bucket IP filtering rules.\n\nYou can also get this permission with [custom roles](/iam/docs/creating-custom-roles). You might be able to get this permission with other predefined roles as well. To see which roles are associated with which permissions,\nrefer to [IAM roles for Cloud Storage](/iam/docs/understanding-roles).\n\nFor instructions on granting roles for projects, see [Manage access to\nprojects](/iam/docs/granting-changing-revoking-access).\n\nList bucket IP filtering rules\n------------------------------\n\n### gcloud\n\n1. Verify that you have the Google Cloud CLI version 526.0.0 or later installed:\n\n gcloud version | head -n1\n\n2. If you have an earlier gcloud CLI version installed, update the version:\n\n gcloud components update --version=526.0.0\n\n3. To list the bucket IP filtering rules, run the command [`gcloud\n alpha storage buckets describe`](/sdk/gcloud/reference/alpha/storage/buckets/describe) in your development\n environment:\n\n ```\n gcloud alpha storage buckets describe gs://BUCKET_NAME --format=\"default(ip_filter_config)\"\n ```\n\n Where:\n\n \u003cvar translate=\"no\"\u003eBUCKET_NAME\u003c/var\u003e is the name of your bucket. For example, `my-bucket`.\n\n### REST APIs\n\n### JSON API\n\n1. Have gcloud CLI [installed and initialized](/sdk/docs/install), which lets\n you generate an access token for the `Authorization` header.\n\n\n2.\n\n Use [`cURL`](http://curl.haxx.se/) to call the [JSON API](/storage/docs/json_api) with a [`List` bucket](/storage/docs/json_api/v1/buckets/list) request: \n\n ```\n curl -X GET \\\n -H \"Authorization: Bearer $(gcloud auth print-access-token)\" \\\n \"https://storage.googleapis.com/storage/v1/b?PROJECT_ID\"\n ```\n\n Where:\n\n \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e is the ID or number of the project containing the buckets you want to list. For example, `my-project`.\n\n The response looks like the following example: \n\n ```json\n {\n \"kind\": \"storage#buckets\",\n \"items\":\n {\n \"kind\": \"storage#bucket\",\n \"selfLink\": \"https://www.googleapis.com/storage/v1/b/my-bucket1\",\n \"id\": \"my-bucket1\",\n \"name\": \"my-bucket1\",\n \"projectNumber\": \"123456789012\",\n ...\n },\n \"ipFilter\": {\n \"mode\": \"Disabled\"\n }\n {\n \"kind\": \"storage#bucket\",\n \"selfLink\": \"https://www.googleapis.com/storage/v1/b/my-bucket2\",\n \"id\": \"my-bucket2\",\n \"name\": \"my-bucket2\",\n \"projectNumber\": \"123456789013\",\n ...\n },\n \"ipFilter\": {\n \"mode\": \"Enabled\"\n }\n },\n ```\n\nWhat's next\n-----------\n\n- [Create or update IP filtering rules on an existing bucket](/storage/docs/update-ip-filter).\n- [Get bucket IP filtering rules](/storage/docs/get-ip-filter).\n- [Disable bucket IP filtering rules](/storage/docs/disable-ip-filtering).\n\nTry it for yourself\n-------------------\n\n\nIf you're new to Google Cloud, create an account to evaluate how\nCloud Storage performs in real-world\nscenarios. New customers also get $300 in free credits to run, test, and\ndeploy workloads.\n[Try Cloud Storage free](https://console.cloud.google.com/freetrial)"]]
