移動

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

Blockchain Platformインスタンスのリスト

get

/api/v1/blockchainPlatforms/instances

Blockchain Platformインスタンスのサマリーおよびリストを取得します。

リクエスト

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

• application/json

問合せパラメータ

• includeSummary: string
  インスタンス・サマリーを含める: trueまたはfalse

  許容値: [ true, false ]

先頭に戻る

レスポンス

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

• application/json

200レスポンス

Blockchain Platformインスタンスのサマリーおよびリストを取得します

本文()

ルート・スキーマ: schema

型: array

ソースの表示

• 配列: object BlockchainPlatformSummaryWrapper
  Blockchain Platformサマリー・リストのラッパー

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/BlockchainPlatformSummaryWrapper"
    }
}

ネストしたスキーマ: BlockchainPlatformSummaryWrapper

型: object

Blockchain Platformサマリー・リストのラッパー

ソースの表示

• instances(オプション): array instances
  Blockchain Platformインスタンスのリスト
• summary(オプション): object InstancesCountSummary
  Blockchain Platformのサマリー

{
    "description":"Blockchain Platform Summary List Wrapper",
    "type":"object",
    "properties":{
        "instances":{
            "description":"List of Blockchain Platform instances",
            "type":"array",
            "items":{
                "$ref":"#/definitions/BlockchainPlatformSummary"
            }
        },
        "summary":{
            "$ref":"#/definitions/InstancesCountSummary"
        }
    }
}

ネストしたスキーマ: instances

型: array

Blockchain Platformインスタンスのリスト

ソースの表示

• 配列: object BlockchainPlatformSummary
  Blockchain Platformのサマリー

{
    "description":"List of Blockchain Platform instances",
    "type":"array",
    "items":{
        "$ref":"#/definitions/BlockchainPlatformSummary"
    }
}

ネストしたスキーマ: InstancesCountSummary

型: object

Blockchain Platformのサマリー

ソースの表示

• developerCount(オプション): integer
  開発者インスタンスの合計数
• enterpriseCount(オプション): integer
  エンタープライズ・インスタンスの合計数
• founderCount(オプション): integer
  ファウンダ・インスタンスの合計数
• instancesCount(オプション): integer
  インスタンスの合計数
• participantCount(オプション): integer
  参加者インスタンスの合計数

{
    "description":"Blockchain Platform Summary",
    "type":"object",
    "properties":{
        "instancesCount":{
            "description":"Total number of instances",
            "type":"integer"
        },
        "founderCount":{
            "description":"Total number of founder instances",
            "type":"integer"
        },
        "participantCount":{
            "description":"Total number of participant instances",
            "type":"integer"
        },
        "enterpriseCount":{
            "description":"Total number of enterprise instances",
            "type":"integer"
        },
        "developerCount":{
            "description":"Total number of developer instances",
            "type":"integer"
        }
    }
}

ネストしたスキーマ: BlockchainPlatformSummary

型: object

Blockchain Platformのサマリー

ソースの表示

• configuration(オプション): string
  許容値: [ "Developer", "Enterprise" ]

  コンピュート構成のタイプ: DeveloperまたはEnterprise
• createdBy(オプション): string
  インスタンスを作成したユーザー
• createOperationId(オプション): string
  インスタンスを作成した作成操作の操作ID
• displayName(オプション): string
  インスタンスの表示名。名前を変更できます
• enableTLS(オプション): boolean
  デフォルトのロード・バランサでTLSを有効化するか無効化するかを決定します。
• id: string
  作成時に変更できない一意の識別子
• instanceFQDN(オプション): string
  外部ロード・バランサが使用されていることを示すインスタンスFQDN
• lifecycleState(オプション): string
  許容値: [ "Creating", "Active", "Updating", "Terminating", "Terminated", "Starting", "Stopping", "Stopped", "Patching", "RollBack", "ScalingOut", "ScalingIn", "Unknown", "Failed" ]

  インスタンスの現在の操作の状態
• platformRole(オプション): string
  許容値: [ "Founder", "Participant" ]

  プラットフォームのロール: FounderまたはParticipant
• startPort(オプション): integer
  外部ロード・バランサ開始ポート
• status(オプション): string
  許容値: [ "Healthy", "Unhealthy", "Down", "Unknown", "Stopped" ]

  インスタンスのステータス
• statusDisplayName(オプション): string
  許容値: [ "Up", "PartiallyUp", "Down", "Unknown", "Stopped" ]

  インスタンス・ステータス表示名
• timeCreated(オプション): string(date-time)
  インスタンスが作成された時間。RFC3339形式の日時文字列
• timeUpdated(オプション): string(date-time)
  インスタンスが更新された時間。RFC3339形式の日時文字列
• version(オプション): string
  インスタンスのバージョン

{
    "description":"Blockchain Platform Summary",
    "type":"object",
    "required":[
        "id"
    ],
    "properties":{
        "id":{
            "description":"Unique identifier that is immutable on creation",
            "type":"string"
        },
        "displayName":{
            "description":"Instance display name, can be renamed",
            "type":"string"
        },
        "timeCreated":{
            "description":"The time the the instance was created. An RFC3339 formatted datetime string",
            "type":"string",
            "format":"date-time"
        },
        "timeUpdated":{
            "description":"The time the instance was updated. An RFC3339 formatted datetime string",
            "type":"string",
            "format":"date-time"
        },
        "createdBy":{
            "description":"The user who created the instance",
            "type":"string"
        },
        "createOperationId":{
            "description":"The operation id of the create operation that created the instance",
            "type":"string"
        },
        "platformRole":{
            "description":"Role of platform: Founder or Participant",
            "type":"string",
            "enum":[
                "Founder",
                "Participant"
            ]
        },
        "configuration":{
            "description":"Type of compute configuration: Developer or Enterprise",
            "type":"string",
            "enum":[
                "Developer",
                "Enterprise"
            ]
        },
        "status":{
            "type":"string",
            "description":"Instance status",
            "enum":[
                "Healthy",
                "Unhealthy",
                "Down",
                "Unknown",
                "Stopped"
            ]
        },
        "statusDisplayName":{
            "type":"string",
            "description":"instance status display name",
            "enum":[
                "Up",
                "PartiallyUp",
                "Down",
                "Unknown",
                "Stopped"
            ]
        },
        "lifecycleState":{
            "description":"The current operation state of the instance",
            "enum":[
                "Creating",
                "Active",
                "Updating",
                "Terminating",
                "Terminated",
                "Starting",
                "Stopping",
                "Stopped",
                "Patching",
                "RollBack",
                "ScalingOut",
                "ScalingIn",
                "Unknown",
                "Failed"
            ],
            "type":"string"
        },
        "version":{
            "description":"Instance version",
            "type":"string"
        },
        "enableTLS":{
            "type":"boolean",
            "description":"Determines whether to enable or disable TLS with the default load balancer."
        },
        "startPort":{
            "description":"External load balancer start port",
            "type":"integer"
        },
        "instanceFQDN":{
            "description":"Instance FQDN indicating external load balancer is used",
            "type":"string"
        }
    }
}

400レスポンス

不正なリクエスト

本文()

ルート・スキーマ: 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"
    }
}

401レスポンス

未認可

本文()

ルート・スキーマ: 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"
    }
}

404レスポンス

見つかりません

本文()

ルート・スキーマ: 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"
    }
}

429レスポンス

リクエストが多すぎます

本文()

ルート・スキーマ: 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レスポンス

内部サーバー・エラー

本文()

ルート・スキーマ: 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"
    }
}

デフォルト・レスポンス

不明なエラー

本文()

ルート・スキーマ: 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"
    }
}

先頭に戻る

例

このエンドポイントは、Blockchain Platformインスタンスのリストおよびサマリーを取得するために使用されます。

次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行し、Blockchain Platformインスタンスのサマリーおよびリストを問い合せて取得する方法を示します。

curl -X GET \
  http://<hostname>:<port>/api/v1/blockchainPlatforms/instances/93d26463-e4b9-4773-b1c1-9cda2c311b55 \
  -H 'Authorization: Basic b2JwdXNlcjpXZWxjb21lMQ==' \
  -H 'Content-Type: application/json'
  

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。

{
    "instances": [
        {
            "id": "93d26463-e4b9-4773-b1c1-9cda2c311b55",
            "displayName": "myNATinstf1",
            "timeCreated": 1566971517441,
            "timeUpdated": 1566972304422,
            "createdBy": "obpuser",
            "createOperationId": "IDR0yB4PWpqjaqTe__iq2c03PIe2H-QCypb3DGyCjCWJE=",
            "platformRole": "Founder",
            "configuration": "Developer",
            "status": "Healthy",
            "lifecycleState": "Active",
            "version": "19.3.2",
            "instanceFQDN": "",
            "enableTLS": true,
            "startPort": 0,
            "stateMessage": "",
            "statusDisplayName": "Up"
        }
    ],
    "summary": {
        "instancesCount": 1,
        "founderCount": 1,
        "participantCount": 0,
        "enterpriseCount": 0,
        "developerCount": 1
    }
}

先頭に戻る