Lister les règles de filtrage par adresse IP du bucket

Cette page explique comment lister les règles de filtrage par adresse IP des buckets. L'opération de liste des règles de filtrage par adresse IP des buckets vous permet de vérifier si le filtrage par adresse 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 Obtenez les règles de filtrage par adresse IP du bucket.

Rôles requis

Pour obtenir les autorisations requises pour lister les règles de filtrage par adresse 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 par adresse 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 par adresse IP du bucket

gcloud

  1. Vérifiez que la version 526.0.0 (ou ultérieure) de la Google Cloud CLI est installée :

    gcloud version | head -n1

  2. Si vous avez installé une version antérieure de la gcloud CLI, mettez-la à jour :

    gcloud components update --version=526.0.0

  3. Pour lister les règles de filtrage par adresse IP du bucket, exécutez la commande gcloud storage buckets describe dans votre environnement de développement :

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

    Où :

    BUCKET_NAME est le nom du bucket. Par exemple, my-bucket.

API REST

API JSON

  1. Vous devez installer et initialiser la gcloud CLI afin 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.s3nsapis.fr/storage/v1/b?PROJECT_ID"

    Où :

    PROJECT_ID est l'ID ou le numéro du projet contenant les buckets dont vous voulez afficher la liste. Par 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"
        }
},

Étapes suivantes