HTTP_PUT 及 HTTP_PUT_BLOB

線上編輯

HTTP_PUT 變更開始或 HTTP_PUT_BLOB 變更結束純量函數會透過 HTTP PUT 要求從指定的 URL 擷取文字型資源。

URL: 傳回內建字串或圖形字串資料類型的表示式，指定所存取資源的 URL。; URL 中唯一支援的通訊協定是 http:// 和 https://。無法在 URL 中指定 https://userid:password@ 格式的 HTTP 基本鑑別。相反地，必須使用 basicAuth 選項來指定基本鑑別的使用者 ID 和密碼。
要求-訊息: 指定要在指定 URL 更新資料的表示式。; 若為 HTTP_PUT ，它必須是內建字串或圖形字串資料類型。; 若為 HTTP_PUT_BLOB ，它必須是內建二進位字串資料類型。
選項: 傳回內建字串或圖形字串資料類型的表示式。此字串必須格式化為 JSON 物件，其中包含要求的選項 (包括標頭)。如需選項清單，請參閱 HTTP 選項。; 如果未提供任何選項，則會使用預設選項。

HTTP_PUT 函數的結果為包含回應訊息的 CLOB (2G) CCSID 1208。變更開始 HTTP_PUT_BLOB 函數的結果為包含回應訊息的 BLOB (2G)。變更結束

附註

如需使用 HTTP 函數的相關資訊，請參閱 HTTP 函數概觀。

如果要從 HTTP 要求傳回標頭資訊，請使用 HTTP_PUT_VERBOSE 變更開始或 HTTP_PUT_BLOB_VERBOSE 變更結束表格函數: HTTP_PUT_VERBOSE 和 HTTP_PUT_BLOB_VERBOSE

範例

將 HTTP PUT 要求傳送至 https://www.example.com/users 傳送 'ABC' 並使用憑證儲存庫 /home/javaTrustStore/fromJava.KDB ，然後傳回結果。

VALUES QSYS2.HTTP_PUT('https://www.example.com/users',
                      'ABC',
                      '{"sslCertificateStoreFile":"/home/javaTrustStore/fromJava.KDB"}');