Jump to

• Request
• Response

Add an OSN to the System Channel

post

/console/admin/api/v2/channels/syschannel/addOSN

Add an ordering service node (OSN) to the system channel.

Request

Supported Media Types

• application/json

Body ()

New orderer (identified by orderer ID) to be joined

Root Schema : exportOSNInfo

Type: object

Show Source

• mspId(optional): string
• orderingServiceNodes(optional): array orderingServiceNodes
• signature(optional): string

{
    "type":"object",
    "properties":{
        "mspId":{
            "type":"string"
        },
        "orderingServiceNodes":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "ordererId":{
                        "type":"string"
                    },
                    "displayName":{
                        "type":"string"
                    },
                    "address":{
                        "type":"string"
                    },
                    "raftAddress":{
                        "type":"string"
                    },
                    "adminAddress":{
                        "type":"string"
                    },
                    "server_tls_cert":{
                        "type":"string"
                    },
                    "client_tls_cert":{
                        "type":"string"
                    }
                }
            }
        },
        "signature":{
            "type":"string"
        }
    }
}

Nested Schema : orderingServiceNodes

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "ordererId":{
                "type":"string"
            },
            "displayName":{
                "type":"string"
            },
            "address":{
                "type":"string"
            },
            "raftAddress":{
                "type":"string"
            },
            "adminAddress":{
                "type":"string"
            },
            "server_tls_cert":{
                "type":"string"
            },
            "client_tls_cert":{
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• address(optional): string
• adminAddress(optional): string
• client_tls_cert(optional): string
• displayName(optional): string
• ordererId(optional): string
• raftAddress(optional): string
• server_tls_cert(optional): string

{
    "type":"object",
    "properties":{
        "ordererId":{
            "type":"string"
        },
        "displayName":{
            "type":"string"
        },
        "address":{
            "type":"string"
        },
        "raftAddress":{
            "type":"string"
        },
        "adminAddress":{
            "type":"string"
        },
        "server_tls_cert":{
            "type":"string"
        },
        "client_tls_cert":{
            "type":"string"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success

Body ()

Root Schema : 200successModels

Type: object

Show Source

• key(optional): string
• value(optional): string

{
    "type":"object",
    "properties":{
        "key":{
            "type":"string"
        },
        "value":{
            "type":"string"
        }
    },
    "example":{
        "status":"success"
    }
}

Example:

{
    "status":"success"
}

400 Response

Invalid arguments

Body ()

Root Schema : 400errorModels

Type: object

Show Source

• key(optional): string
• value(optional): 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

Body ()

Root Schema : 500errorModels

Type: object

Show Source

• key(optional): string
• value(optional): string

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

Default Response

Unexpected error

Body ()

Root Schema : errorModel

Type: object

Show Source

• code: integer(int32)
• message: string

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

Back to Top