gcloud alpha blockchain-node-engine nodes create

NAME
gcloud alpha blockchain-node-engine nodes create - create a Blockchain Node Engine node
SYNOPSIS
gcloud alpha blockchain-node-engine nodes create(NODE_NAME :--location=LOCATION)[--async][--blockchain-type=BLOCKCHAIN_TYPE; default="ETHEREUM"][--consensus-client=CONSENSUS_CLIENT; default="LIGHTHOUSE"][--execution-client=EXECUTION_CLIENT; default="GETH"][--network=NETWORK; default="MAINNET"][--node-type=NODE_TYPE; default="FULL"][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Create a new Blockchain Node Engine node with the givenname and configurations.

If run asynchronously with--async, exits after printing oneoperation name that can be used to poll the status of the creation via:

gcloudoperationsdescribe
EXAMPLES
To create a Blockchain Node Engine node with the namemy-node inlocationus-central, run:
gcloudalphablockchain-node-enginenodescreatemy-node--location=us-central1
POSITIONAL ARGUMENTS
Node resource - Arguments and flags that specify the Blockchain Node Engine nodeyou want to create. The arguments in this group can be used to specify theattributes of this resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.

To set theproject attribute:

  • provide the argumentnode_name on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

NODE_NAME
ID of the node or fully qualified identifier for the node.

To set thenode_name attribute:

  • provide the argumentnode_name on the command line.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--location=LOCATION
Location of the blockchain node resource.To set thelocation attribute:
  • provide the argumentnode_name on the command line with a fullyspecified name;
  • provide the argument--location on the command line;
  • set the propertyweb3/location.
FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--blockchain-type=BLOCKCHAIN_TYPE; default="ETHEREUM"
Blockchain type the node will connect run on.BLOCKCHAIN_TYPE must be (only one value is supported):
ethereum
Ethereum blockchain.
--consensus-client=CONSENSUS_CLIENT; default="LIGHTHOUSE"
Consensus client for Ethereum nodes.CONSENSUS_CLIENTmust be (only one value is supported):
lighthouse
Lighthouse execution client.
--execution-client=EXECUTION_CLIENT; default="GETH"
Execution client for Ethereum nodes.EXECUTION_CLIENTmust be (only one value is supported):
geth
Geth execution client.
--network=NETWORK; default="MAINNET"
Blockchain network the node will connect to.NETWORKmust be one of:
goerli
Goerli & Prater Ethereum test network.
holesky
Holesky Ethereum test network.
mainnet
Primary Ethereum network, often referred to as mainnet.
sepolia
Sepolia Ethereum test network.
--node-type=NODE_TYPE; default="FULL"
Node type - defines whether the node retains only recent data or an archivalhistory.NODE_TYPE must be (only one value issupported):
full
Node retains full history required for consensus validation, however does notretain archival data beyond that.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

API REFERENCE
This command uses theblockchainnodeengine/v1 API. The fulldocumentation for this API can be found at:https://cloud.google.com/blockchain-node-engine
NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-22 UTC.