移動

• リクエスト
• レスポンス
• 例

Blockchain Platformインスタンスのスケール・アウト

post

/api/v1/blockchainPlatforms/instances/{id}/scaleout

Blockchain Platformインスタンスをスケール・アウトします。

リクエスト

サポートされるメディア・タイプ

• application/json

パス・パラメータ

• id(必須): string
  プラットフォーム・インスタンスの一意の識別子

本文()

JSONのリクエスト・ペイロード

ルート・スキーマ: ScaleOutPayload

型: object

スケール・アウト・ペイロード

ソースの表示

• newOrderer(必須): object ScaleOutOrdererDetails
  追加するオーダラ詳細
• newPeer(必須): object ScaleOutPeerDetails
  追加するピアの詳細
• newReplicas(必須): object ScaleOutReplicaNumberDetails
  追加する1つのノード(サービス)番号

{
    "type":"object",
    "description":"Scale out payload",
    "properties":{
        "newReplicas":{
            "$ref":"#/definitions/ScaleOutReplicaNumberDetails"
        },
        "newPeer":{
            "$ref":"#/definitions/ScaleOutPeerDetails"
        },
        "newOrderer":{
            "$ref":"#/definitions/ScaleOutOrdererDetails"
        }
    },
    "required":[
        "newReplicas",
        "newPeer",
        "newOrderer"
    ],
    "x-or":[
        "newReplicas",
        "newPeer",
        "newOrderer"
    ]
}

ネストしたスキーマ: ScaleOutOrdererDetails

型: object

追加するオーダラ詳細

ソースの表示

• logLevel: string
  許容値: [ "PANIC", "ERROR", "WARNING", "INFO", "NOTICE", "DEBUG" ]

  ピアのログ・レベル
• org: string
  組織名

{
    "type":"object",
    "description":"Orderer details to be added",
    "properties":{
        "org":{
            "type":"string",
            "description":"Organization name"
        },
        "logLevel":{
            "type":"string",
            "description":"Peer log level",
            "enum":[
                "PANIC",
                "ERROR",
                "WARNING",
                "INFO",
                "NOTICE",
                "DEBUG"
            ]
        }
    }
}

ネストしたスキーマ: ScaleOutPeerDetails

型: object

追加するピアの詳細

ソースの表示

• alias: string
  ピアの別名
• logLevel: string
  許容値: [ "PANIC", "ERROR", "WARNING", "INFO", "NOTICE", "DEBUG" ]

  ピアのログ・レベル
• org: string
  組織名
• role: string
  許容値: [ "Member", "Admin" ]

  ピアのロール

{
    "type":"object",
    "description":"Peer details to be added",
    "properties":{
        "org":{
            "type":"string",
            "description":"Organization name"
        },
        "role":{
            "type":"string",
            "description":"Peer role",
            "enum":[
                "Member",
                "Admin"
            ]
        },
        "logLevel":{
            "type":"string",
            "description":"Peer log level",
            "enum":[
                "PANIC",
                "ERROR",
                "WARNING",
                "INFO",
                "NOTICE",
                "DEBUG"
            ]
        },
        "alias":{
            "type":"string",
            "description":"Peer alias"
        }
    }
}

ネストしたスキーマ: ScaleOutReplicaNumberDetails

型: object

追加する1つのノード(サービス)番号

ソースの表示

• CA(必須): integer
  追加するCAレプリカ数
• proxy(必須): integer
  追加するRESTプロキシ・レプリカ数

{
    "type":"object",
    "description":"One node (service) number to be  added",
    "properties":{
        "proxy":{
            "type":"integer",
            "description":"REST proxy replicas number to add"
        },
        "CA":{
            "type":"integer",
            "description":"CA replicas number to add"
        }
    },
    "required":[
        "proxy",
        "CA"
    ],
    "x-or":[
        "proxy",
        "CA"
    ]
}

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

202レスポンス

受理

ヘッダー

• Location: string
  リクエストのステータスを問い合せるためのURLを含むロケーション・ヘッダー。

401レスポンス

未認可

404レスポンス

無効なパラメータ

409レスポンス

操作の競合

本文()

ルート・スキーマ: Error

型: object

エラー情報。

ソースの表示

• errors: array errors
  エラーのリスト
• message(必須): string
  判読可能なエラー文字列。
• status(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・ステータス。
• warnings: array warnings
  警告のリスト

{
    "description":"Error information.",
    "required":[
        "status",
        "message"
    ],
    "properties":{
        "status":{
            "description":"A short error status that defines the error, meant for programmatic parsing.",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string.",
            "type":"string"
        },
        "errors":{
            "type":"array",
            "description":"List of errors",
            "items":{
                "type":"string"
            }
        },
        "warnings":{
            "type":"array",
            "description":"List of warnings",
            "items":{
                "type":"string"
            }
        }
    }
}

ネストしたスキーマ: errors

型: array

エラーのリスト

ソースの表示

• 配列: string

{
    "type":"array",
    "description":"List of errors",
    "items":{
        "type":"string"
    }
}

ネストしたスキーマ: warnings

型: array

警告のリスト

ソースの表示

• 配列: string

{
    "type":"array",
    "description":"List of warnings",
    "items":{
        "type":"string"
    }
}

500レスポンス

サービス使用不可

先頭に戻る

例

このエンドポイントは、特定のBlockchain Platformインスタンスをスケール・アウトするために使用されます。

次のいずれかの方法を使用して、インスタンスをスケール・アウトできます。

• 新規VMの作成: クラスタに新しいVMを追加します(プラットフォーム・ホスト、チェーンコード・ホストまたはZookeeper/Kafkaホスト)。
• 新規レプリカの作成: 追加ノードを追加します(RESTプロキシまたはCA)。
• 新しいピアの作成:一度に1つのピアを追加します。

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行し、特定のBlockchain Platformインスタンスを問い合せてスケール・アウトする方法を示します。

curl -X POST \
  http://<hostname>:<port>/api/v1/blockchainPlatforms/instances/e1f7bcfe-cc7e-4d19-97fb-772b231fcf99/scaleout \
  -H 'Authorization: Basic b2JwdXNlcjpXZWxjb21lMQ==' \
  -H 'Content-Type: application/json'
    

リクエスト本文の例

JSON形式のリクエスト本文のコンテンツの例を次に示します。

{
 "newPeers": [
   {
     "org": "currentinstance",
     "role": "Member",
     "logLevel": "PANIC",
     "alias": "abcd",
     "vm": "myvm.oracle.com"
   }
 ]
}

レスポンス本文の例

次の例は、レスポンス本文の内容を示しています。

202 Accepted

先頭に戻る