バケットの IP フィルタリング ルールを一覧表示する

このページでは、バケット IP フィルタリング ルールを一覧表示する方法について説明します。list bucket IP filtering rules オペレーションを使用すると、バケットで IP フィルタリングが有効になっているかどうかを確認できます。許可されている特定のネットワーク ソースに関する情報を表示する必要がある場合は、バケット IP フィルタリング ルールを取得するオペレーションを使用します。

必要なロール

バケットの IP フィルタリング ルールを一覧表示するために必要な権限を取得するには、バケットに対するストレージ管理者(roles/storage.admin)ロールを付与するよう管理者に依頼してください。このロールには、バケット IP フィルタリング ルールを一覧表示するために必要な storage.buckets.list 権限が含まれています。

カスタムロールを使用してこの権限を取得することもできます。この権限は、他の事前定義ロールで取得することもできます。どのロールがどの権限に関連付けられているかを確認するには、Cloud Storage に適用される IAM のロールをご覧ください。

プロジェクトにロールを付与する手順については、プロジェクトへのアクセス権を管理するをご覧ください。

バケットの IP フィルタリング ルールを一覧表示する

コマンドライン

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. バケットの IP フィルタリング ルールを一覧表示するには、開発環境で gcloud alpha storage buckets describe コマンドを実行します。

    gcloud alpha storage buckets describe gs://BUCKET_NAME --format="default(ip_filter_config)"

    ここで

    BUCKET_NAME はバケットの名前です。例: my-bucket

REST API

JSON API

  1. gcloud CLI のインストールと初期化を行います。これにより、Authorization ヘッダーのアクセス トークンを生成できます。

  2. cURL を使用して、List Bucket リクエストで JSON API を呼び出します。

    curl -X GET \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b?PROJECT_ID?projection=full"

    ここで

    PROJECT_ID は、一覧表示するバケットを含むプロジェクトの ID または番号です。例: my-project

    次の例のようなレスポンスになります。

    {
      "kind": "storage#buckets",
      "items":
            {
            "kind": "storage#bucket",
            "selfLink": "https://www.googleapis.com/storage/v1/b/my-bucket1",
            "id": "my-bucket1",
            "name": "my-bucket1",
            "projectNumber": "123456789012",
            ...
             },
            "ipFilter": {
              "mode": "Disabled"
            }
            {
            "kind": "storage#bucket",
            "selfLink": "https://www.googleapis.com/storage/v1/b/my-bucket2",
            "id": "my-bucket2",
            "name": "my-bucket2",
            "projectNumber": "123456789013",
            ...
            },
            "ipFilter": {
              "mode": "Enabled"
            }
    },

次のステップ

使ってみる

Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Cloud Storage のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

Cloud Storage を無料で試す