REST API for Oracle Blockchain Platform Enterprise Edition

Set Orderer Service for an Organization

post

/console/admin/api/v2/organizations/{orgName}/setOrderingService

This endpoint sets the orderer service settings for a participant organization, including the MSP ID, certificates, and ordering service node addresses. This API is only available on the participant.

Request

Supported Media Types

application/json

Path Parameters

orgName(required): string

Organization name

Orderer setting information

Root Schema : ordererSettingInfo

Type: object

Show Source

certs: object certs
mspId: string
orderingServiceNodes: array orderingServiceNodes
signature: string

{
    "type":"object",
    "properties":{
        "mspId":{
            "type":"string"
        },
        "certs":{
            "type":"object",
            "properties":{
                "adminCert":{
                    "type":"string"
                },
                "CACert":{
                    "type":"string"
                },
                "tlsCACert":{
                    "type":"string"
                },
                "intermediateCerts":{
                    "type":"string"
                }
            }
        },
        "orderingServiceNodes":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "address":{
                        "type":"string"
                    },
                    "adminAddress":{
                        "type":"string"
                    }
                }
            }
        },
        "signature":{
            "type":"string"
        }
    }
}

Nested Schema : certs

Type: object

Show Source

adminCert: string
CACert: string
intermediateCerts: string
tlsCACert: string

{
    "type":"object",
    "properties":{
        "adminCert":{
            "type":"string"
        },
        "CACert":{
            "type":"string"
        },
        "tlsCACert":{
            "type":"string"
        },
        "intermediateCerts":{
            "type":"string"
        }
    }
}

Nested Schema : orderingServiceNodes

Type: array

Show Source

Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "address":{
                "type":"string"
            },
            "adminAddress":{
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

address: string
adminAddress: string

{
    "type":"object",
    "properties":{
        "address":{
            "type":"string"
        },
        "adminAddress":{
            "type":"string"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Set the orderer settings

Root Schema : schema

Type: object

Example:

{
    "status":"SUCCESS"
}

400 Response

Invalid arguments

Root Schema : 400errorModels

Type: object

Show Source

key: string
value: string

{
    "type":"object",
    "properties":{
        "key":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    },
    "example":{
        "respMesg":"invalid argument"
    }
}

Example:

{
    "respMesg":"invalid argument"
}

401 Response

Unauthorized

403 Response

Forbidden

500 Response

Internal server error

Root Schema : 500errorModels

Type: object

Show Source

key: string
value: string

{
    "type":"object",
    "properties":{
        "key":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    }
}

Default Response

Unexpected error

Root Schema : errorModel

Type: object

Show Source

code(required): integer(int32)
message(required): string

{
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"integer",
            "format":"int32"
        },
        "message":{
            "type":"string"
        }
    }
}