Listar regras de filtragem de IP do bucket

Esta página descreve como listar as regras de filtragem de IP do bucket. Com a operação de regras de filtragem de IP do bucket de lista, você pode verificar se a filtragem de IP está ativada ou desativada em um bucket. Se você precisar conferir informações sobre as fontes de rede específicas que são permitidas, use a operação Get bucket IP filtering rules.

Funções exigidas

Para ter as permissões necessárias para listar as regras de filtragem de IP do bucket, peça ao administrador para conceder a você o papel de Administrador do Storage (roles/storage.admin) no bucket. Esse papel contém a permissão storage.buckets.list necessária para listar as regras de filtragem de IP do bucket.

Também é possível ter essa permissão com funções personalizadas. Talvez você também possa receber essa permissão com outros papéis predefinidos. Para conferir quais papéis estão associados a quais permissões, consulte Papéis do IAM para o Cloud Storage.

Para instruções sobre como conceder papéis a projetos, consulte Gerenciar o acesso a projetos.

Listar regras de filtragem de IP do bucket

Linha de comando

  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. Para listar as regras de filtragem de IP do bucket, execute o comando gcloud alpha storage buckets describe no ambiente de desenvolvimento:

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

    Em que:

    BUCKET_NAME é o nome do bucket. Por exemplo, my-bucket.

APIs REST

API JSON

  1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

  2. Use cURL para chamar a API JSON com uma solicitação de List bucket:

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

    Em que:

    PROJECT_ID é o ID ou o número do projeto que contém os buckets que você quer listar. Por exemplo, my-project.

    A resposta terá esta aparência:

    {
      "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"
            }
    },

A seguir

Faça um teste

Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho do Cloud Storage em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

Faça uma avaliação gratuita do Cloud Storage