gcloud alpha blockchain-node-engine nodes create Stay organized with collections Save and categorize content based on your preferences.
- 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 name
my-nodeinlocationus-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 the
projectattribute:- provide the argument
node_nameon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
NODE_NAME- ID of the node or fully qualified identifier for the node.
To set the
node_nameattribute:- provide the argument
node_nameon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--location=LOCATION- Location of the blockchain node resource.To set the
locationattribute:- provide the argument
node_nameon the command line with a fullyspecified name; - provide the argument
--locationon the command line; - set the property
web3/location.
- provide the argument
- provide the argument
- 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.
- 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_TYPEmust 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_TYPEmust 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 helpfor details. - API REFERENCE
- This command uses the
blockchainnodeengine/v1API. 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.