移動

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

新規Blockchain Platformパッチの登録

post

/api/v1/blockchainPlatforms/patches

新規Blockchain Platformパッチを登録します。

リクエスト

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

• multipart/form-data

フォーム・パラメータ

• patchArchive: string
  パッチ詳細(metadata.jsonスクリプト/prePatch.shスクリプト/postPatch.sh)を含むtarアーカイブ・ファイル。コンポーネントごとの.tgz。

先頭に戻る

レスポンス

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

• application/json

200レスポンス

OK

本文()

ルート・スキーマ: PatchInfoSummary

型: object

ソースの表示

• applicable(オプション): boolean
  パッチが適用可能かどうか
• description(オプション): string
  パッチの説明または詳細
• displayName(オプション): string
  パッチの表示名
• fullVersion(オプション): string
  パッチの完全バージョン
• patchId(オプション): string
  パッチのID
• prevVersion(オプション): string
  前のバージョン
• release(オプション): string
  パッチ・リリース・バージョン
• rollbackable(オプション): boolean
  パッチをロールバックできるかどうか
• serviceVersion(オプション): string
  パッチ・サービス・バージョン
• status(オプション): string
  パッチ/ロールバック・ステータス

{
    "type":"object",
    "properties":{
        "patchId":{
            "type":"string",
            "description":"Patch ID"
        },
        "displayName":{
            "type":"string",
            "description":"Patch display name"
        },
        "description":{
            "type":"string",
            "description":"Patch description or details"
        },
        "serviceVersion":{
            "type":"string",
            "description":"Patch service version"
        },
        "release":{
            "type":"string",
            "description":"Patch release version"
        },
        "fullVersion":{
            "type":"string",
            "description":"Patch full version"
        },
        "prevVersion":{
            "type":"string",
            "description":"Previous version"
        },
        "rollbackable":{
            "type":"boolean",
            "description":"Is patch able to be rolled back"
        },
        "applicable":{
            "type":"boolean",
            "description":"Is patch able to be applied"
        },
        "status":{
            "type":"string",
            "description":"Patch/rollback status"
        }
    }
}

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"
    }
}

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レスポンス

内部サーバー・エラー

本文()

ルート・スキーマ: 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リソースに対するPOSTリクエストを発行し、新しいBlockchain Platformパッチを問い合せて登録する方法を示しています。

curl -X POST http://<hostname>:<port>/api/v1/blockchainPlatforms/patches 
-H 'Authorization: Basic amFzc2l0ZXN0OndlbGNvbWUx' 
-F patchArchive=@/home/oracle/obp-19-3-3.zip

レスポンス本文の例

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

{
  "patchId" : "obp-patch-19-3-3",
  "displayName" : "OBP Patch 19.3.3",
  "description" : "OBP Patch 19.3.3",
  "serviceVersion" : "19.3",
  "release" : "3",
  "fullVersion" : "19.3.3",
  "prevVersion" : null,
  "rollbackable" : null,
  "applicable" : null,
  "status" : null
}

先頭に戻る