Get Blockchain Platform Instance Details
get
/api/v1/blockchainPlatforms/instances/{id}
Retrieves the details of a particular Blockchain Platform instance.
Request
Supported Media Types
- application/json
Path Parameters
-
id(required): string
Unique platform instance identifier
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : BlockchainPlatformDetails
Type:
object
Blockchain Platform Details
Show Source
-
components:
array components
All services information
-
configuration:
string
Allowed Values:
[ "Developer", "Enterprise" ]
Type of compute configuration: Developer or Enterprise -
createActivityId:
string
The operation ID of the create operation that created the instance
-
createdBy:
string
The user who created the instance
-
displayName:
string
Instance display name; can be renamed
-
domainName:
string
Instance domain name
-
id:
string
Unique identifier that is immutable on creation
-
lifecycleState:
string
Allowed Values:
[ "Creating", "Active", "Updating", "Terminating", "Terminated", "Starting", "Stopping", "Stopped", "Patching", "RollBack", "ScalingOut", "ScalingIn", "Unknown", "Failed" ]
The current operation state of the instance -
platformRole:
string
Allowed Values:
[ "Founder", "Participant" ]
Role of platform: Founder or Participant -
serviceEndpoint:
string
Service endpoint URL, valid post-provisioning
-
stateMessage:
string
An message describing the current state in more detail. For example, can be used to provide actionable information for a resource in failed state.
-
status:
string
Allowed Values:
[ "Healthy", "Unhealthy", "Down", "Unknown", "Stopped" ]
Instance status -
statusDisplayName:
string
Allowed Values:
[ "Up", "PartiallyUp", "Down", "Unknown", "Stopped" ]
Instance status display name -
timeCreated:
string(date-time)
The time the the instance was created. A timestamp string.
-
timeUpdated:
string(date-time)
The time the instance was updated. A timestamp string.
-
version:
string
Instance version
Nested Schema : BlockchainPlatformComponent
Type:
Show Source
object
-
name:
string
Node (service) name
-
replicas:
integer
Node (service) replicas number
-
status:
string
Allowed Values:
[ "Pending", "Provisioned", "Failed", "Terminated" ]
Status of each service -
type:
string
Allowed Values:
[ "ca", "console", "peer", "orderer", "hami", "prometheus", "authserver", "restproxy" ]
Node (service) type
401 Response
Not authorized
404 Response
Invalid parameters
500 Response
Service unavailable
Examples
This endpoint is used to get the details of a particular Blockchain Platform instance.
The following example shows how to query and get the details of a particular Blockchain Platform instance by submitting a GET request on the REST resource using cURL.
curl -X GET \ http://<hostname>:<port>/api/v1/blockchainPlatforms/instances/93d26463-e4b9-4773-b1c1-9cda2c311b44 \ -H 'Authorization: Basic b2JwdXNlcjpXZWxjb21lMQ==' \ -H 'Content-Type: application/json'
Example of the Response Body
The following example shows the contents of the response body in JSON format:
{ "id": "93d26463-e4b9-4773-b1c1-9cda2c311b44", "displayName": "myNATinstf1", "timeCreated": 1566971517441, "timeUpdated": 1566979960292, "createdBy": "obpuser", "createOperationId": "IDR0yB4PWpqjaqTe__iq2c03PIe2H-QCypb3DGyCjCXJE=", "platformRole": "Founder", "configuration": "Developer", "status": "Healthy", "lifecycleState": "Active", "version": "19.3.3", "instanceFQDN": "", "enableTLS": true, "startPort": 0, "stateMessage": "", "logging": "/u01/obp-logs", "serviceEndpoint": "https://myvm.oracle.com:10000", "cluster": { "manager": [ { "vm": "myvm.oracle.com", "vmStatus": "Up", "role": "Admin" } ], "crc": null, "zk": null }, "components": [ { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-nodemanager", "type": "nodemanager", "status": "Healthy", "replicas": 3, "host": [ "myvm.oracle.com", "myvm.oracle.com", "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-zookeeper1", "type": "zookeeper", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-zookeeper2", "type": "zookeeper", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-zookeeper3", "type": "zookeeper", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-kafka1", "type": "kafka", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-kafka2", "type": "kafka", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-kafka3", "type": "kafka", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-authserver", "type": "authserver", "status": "Healthy", "replicas": 3, "host": [ "myvm.oracle.com", "myvm.oracle.com", "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-ca", "type": "ca", "status": "Healthy", "replicas": 2, "host": [ "myvm.oracle.com", "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-orderer0", "type": "orderer", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-orderer1", "type": "orderer", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-peer0", "type": "peer", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-peer1", "type": "peer", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-console0", "type": "console", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-console1", "type": "console", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-restproxy", "type": "restproxy", "status": "Healthy", "replicas": 2, "host": [ "myvm.oracle.com", "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-prometheus", "type": "prometheus", "status": "Healthy", "replicas": 1, "host": [ "myvm.oracle.com" ] }, { "name": "93d26463-e4b9-4773-b1c1-9cda2c311b44-lbr", "type": "lbr", "status": "Healthy", "replicas": 3, "host": [ "myvm.oracle.com", "myvm.oracle.com", "myvm.oracle.com" ] } ], "ledgerPlacement": [ { "93d26463-e4b9-4773-b1c1-9cda2c311b44-orderer0": "/u01/93d26463-e4b9-4773-b1c1-9cda2c311b44/orderer/93d26463-e4b9-4773-b1c1-9cda2c311b44-orderer0", "93d26463-e4b9-4773-b1c1-9cda2c311b44-orderer1": "/u01/93d26463-e4b9-4773-b1c1-9cda2c311b44/orderer/93d26463-e4b9-4773-b1c1-9cda2c311b44-orderer1", "93d26463-e4b9-4773-b1c1-9cda2c311b44-peer0": "/u01/93d26463-e4b9-4773-b1c1-9cda2c311b44/peer/93d26463-e4b9-4773-b1c1-9cda2c311b44-peer0", "93d26463-e4b9-4773-b1c1-9cda2c311b44-peer1": "/u01/93d26463-e4b9-4773-b1c1-9cda2c311b44/peer/93d26463-e4b9-4773-b1c1-9cda2c311b44-peer1", "host": "myvm.oracle.com", "sharedDirectory": "/u01/93d26463-e4b9-4773-b1c1-9cda2c311b44" } ], "statusDisplayName": "Up" }