Lister les règles de filtrage des adresses IP des buckets

Cette page explique comment lister les règles de filtrage des adresses IP des buckets. L'opération List bucket IP filtering rules vous permet de vérifier si le filtrage des adresses IP est activé ou désactivé sur un bucket. Si vous devez afficher des informations sur les sources réseau spécifiques autorisées, utilisez l'opération Obtenir les règles de filtrage des adresses IP du bucket.

Rôles requis

Pour obtenir les autorisations requises pour lister les règles de filtrage des adresses IP du bucket, demandez à votre administrateur de vous accorder le rôle "Administrateur de l'espace de stockage" (roles/storage.admin) sur le bucket. Ce rôle contient l'autorisation storage.buckets.list requise pour lister les règles de filtrage des adresses IP des buckets.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés. Vous pouvez également obtenir cette autorisation avec d'autres rôles prédéfinis. Pour connaître les rôles et les autorisations associées, consultez la page Rôles IAM pour Cloud Storage.

Pour savoir comment attribuer des rôles aux projets, consultez la page Gérer l'accès aux projets.

Lister les règles de filtrage des adresses IP des buckets

Ligne de commande

  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. Pour lister les règles de filtrage des adresses IP du bucket, exécutez la commande gcloud alpha storage buckets describe dans votre environnement de développement:

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

    Où :

    BUCKET_NAME est le nom du bucket. Exemple :my-bucket

API REST

API JSON

  1. Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API JSON avec une requête de bucket List:

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

    Où :

    PROJECT_ID correspond à l'ID ou au numéro du projet contenant les buckets que vous souhaitez lister. Exemple :my-project

    La réponse est semblable à ceci :

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

Étape suivante

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud Storage en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Profiter d'un essai gratuit de Cloud Storage