Lister les nœuds de blockchain

Cette page explique comment afficher une liste des nœuds Blockchain Node Engine à l'aide de la console ou d'un appel d'API.

Utiliser la console

La liste Nœuds affiche la liste des nœuds existants dans Blockchain Node Engine. Si aucun nœud n'a été créé, vous êtes invité à en créer un, comme décrit dans la section Créer un nœud de blockchain.

Dans la console Google Cloud, accédez à la page Blockchain Node Engine.

Accéder à Blockchain Node Engine

La page de la liste des nœuds s'affiche par défaut.

Interface utilisateur de la liste des nœuds Blockchain Node Engine

Voici ce que vous pouvez faire sur cette page:

Action Option
Afficher les informations sur le nœud:
  • Nom:nom que vous avez attribué au nœud dans Créer un nœud de blockchain. Par exemple, my-new-node.
  • État:état actuel du nœud. (par exemple, "Running"). Consultez la section État pour connaître tous les états possibles.
  • Chaîne (réseau) : blockchain et réseau que vous avez configurés dans Créer un nœud blockchain. Par exemple, Ethereum (Mainnet).
  • Type de nœud: type que vous avez configuré dans Créer un nœud de blockchain. (par exemple, "Full" (Complet)).
  • Emplacement:emplacement que vous avez configuré dans Créer un nœud blockchain. Par exemple, us-central1.
  • Point de terminaison JSON-RPC:nom d'hôte du point de terminaison JSON-RPC du nœud de blockchain, généré par Google Cloud.
  • Point de terminaison WebSocket:nom d'hôte du point de terminaison WebSocket du nœud de blockchain, généré par Google Cloud.
affiner la liste des nœuds affichés:
Agir sur les nœuds:

Filtre

Pour affiner la liste des nœuds affichés:

  1. Créez une requête de filtre:

    1. Cliquez dans la zone de filtre. Un menu de sélection des noms de colonnes s'affiche.
    2. Sélectionnez un nom de colonne. (par exemple, État). Un menu de sélection des états s'affiche.
    3. Sélectionnez un État. (par exemple, Running [En cours d'exécution]).
    4. Vous pouvez également ajouter un opérateur OU, puis sélectionner d'autres options pour modifier davantage votre requête. Par exemple, Status: RUNNING OR Location: us-central1.

  2. Vous pouvez également modifier la requête:

    • Cliquez sur le symbole X sur le chip de requête pour la supprimer.
    • Cliquez sur le X dans la zone Filtre pour effacer toutes les requêtes.

Modifier les colonnes

Pour afficher ou masquer des colonnes:

  1. Cliquez sur Options d'affichage des colonnes. Un menu de sélection des colonnes possibles s'affiche.
  2. Sélectionnez les éléments à afficher ou désélectionnez ceux à masquer.
  3. Cliquez sur OK.

Tri

Pour réorganiser la liste des API affichées, cliquez sur un en-tête de colonne.

La flèche indique la priorité de tri actuelle. Une flèche vers le bas indique l'ordre décroissant. Une flèche vers le haut indique l'ordre croissant.

Utiliser une API

Pour répertorier tous les nœuds de blockchain avec ListBlockchainNodes, envoyez la requête suivante:

curl \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
https://blockchainnodeengine.googleapis.com/v1/projects/PROJECT_ID/\
locations/LOCATION/blockchainNodes

Où :

  • PROJECT_ID est l'ID de votre Google Cloud projet. Exemple : my-project-id.
  • LOCATION correspond à l'emplacement que vous avez sélectionné dans Créer un nœud. Par exemple, us-central1.

Voici un exemple de réponse à la commande ci-dessus:

{
  "blockchainNodes": [
    {
      "name": "projects/my-project-id/locations/us-central1/blockchainNodes/my-new-node-2",
      "createTime": "2023-05-05T21:19:33.308756Z",
      "updateTime": "2023-05-05T21:58:44.513286Z",
      "labels": {
        "my-label-key": "my-label-value"
      },
      "blockchainType": "ETHEREUM",
      "connectionInfo": {
        "ipInfo": {
          "rpcIpv4Address": "203.0.113.1"
        },
        "endpointInfo": {
          "jsonRpcApiEndpoint": "json-rpc.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com",
          "websocketsApiEndpoint": "ws.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com"
        }
      },
      "ethereumDetails": {
        "network": "MAINNET",
        "nodeType": "FULL",
        "executionClient": "GETH",
        "consensusClient": "LIGHTHOUSE",
        "apiEnableAdmin": false,
        "apiEnableDebug": false,
        "additionalEndpoints": {
          "beaconApiEndpoint": "beacon.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com",
          "beaconPrometheusMetricsApiEndpoint": "bc-mc.4amkczs2vkh8hjtghcipu7y2t.blockchainnodeengine.com"
        }
      },
      "state": "RUNNING"
    },
    {
      "name": "projects/my-project-id/locations/us-central1/blockchainNodes/my-new-node",
      "createTime": "2023-05-05T21:03:14.002367Z",
      "updateTime": "2023-05-05T21:42:28.131570Z",
      "blockchainType": "ETHEREUM",
      "connectionInfo": {
        "ipInfo": {
          "rpcIpv4Address": "203.0.113.2"
        },
        "endpointInfo": {
          "jsonRpcApiEndpoint": "json-rpc.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com",
          "websocketsApiEndpoint": "ws.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com"
        }
      },
      "ethereumDetails": {
        "network": "MAINNET",
        "nodeType": "FULL",
        "executionClient": "GETH",
        "consensusClient": "LIGHTHOUSE",
        "apiEnableAdmin": true,
        "apiEnableDebug": true,
        "additionalEndpoints": {
          "beaconApiEndpoint": "beacon.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com",
          "beaconPrometheusMetricsApiEndpoint": "bc-mc.8t4jplvidg0v6nsjgqfwok6it.blockchainnodeengine.com"
        }
      },
      "state": "RUNNING"
    }
  ]
}