You can call this operation to query the basic information about a blockchain in Ant Blockchain.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
AntChainId String Yes pYogqb9v

The ID of the blockchain whose basic information is to be queried.

Action String No DescribeAntChainInformation

The operation that you want to perform. Set the value to DescribeAntChainInformation.

RegionId String No cn-hangzhou

The ID of the region where Ant Blockchain is used.

Response parameters

Parameter Type Example Description
RequestId String 91246411-C7E9-4EFD-9074-3939AEDFC1BB

The ID of the request.

Result

The result of the operation.

AbnormalNodes Integer 0

The number of abnormal nodes on the blockchain.

AntChainId String pYogqb9v

The ID of the blockchain whose basic information was queried.

BlockHeight Integer 365236

The block height of the blockchain.

CreateTime Long 1562847396000

The time when the blockchain was created.

NodeInfos

The information about the nodes on the blockchain.

BlockHeight Long 365216

The block height of the node.

NodeName String 121.199.195.8 18130

The address of the node.

Status Boolean true

The status of the node.

Version String 0.10

The version of the node.

NodeNumber Integer 4

The number of nodes on the blockchain.

Normal Boolean true

The running status of the blockchain.

TransactionSum Integer 42

The total number of transactions that were executed on the blockchain.

Version String 0.10.2.4.7

The version of the blockchain.

Examples

Sample requests


http(s)://[Endpoint]/? Action=DescribeAntChainInformation
&<Common request parameters>

Sample success responses

JSON format

{
	"successResponse":true,
	"requestId":"91246411-C7E9-4EFD-9074-3939AEDFC1BB",
	"data":{
		"Result":{
			"NodeNumber":4,
			"AbnormalNodes":0,
			"BlockHeight":365236,
			"IsRole":false,
			"Normal":true,
			"TransactionSum":42,
			"CreateTime":1562847396000,
			"AntChainId":"pYogqb9v",
			"Version":"0.10.2.4.7",
			"NodeInfos":[
				{
					"Status":true,
					"BlockHeight":365216,
					"Version":"0.10",
					"NodeName":"121.199.195.8 18130"
				},
				{
					"Status":true,
					"BlockHeight":365216,
					"Version":"0.10",
					"NodeName":"121.199.195.8 18132"
				},
				{
					"Status":true,
					"BlockHeight":365216,
					"Version":"0.10",
					"NodeName":"121.199.195.8 18133"
				},
				{
					"Status":true,
					"BlockHeight":365216,
					"Version":"0.10",
					"NodeName":"121.199.195.8 18131"
				}
			]
		},
		"RequestId":"91246411-C7E9-4EFD-9074-3939AEDFC1BB"
	},
	"code":"200"
}

Error codes

For a list of error codes, visit the API Error Center.