Azure 機密總帳
ConfidentialLedgerClient 會針對 Confidential Ledger 服務寫入和擷取分類帳項目。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | Azure 機密總帳小組 |
| accledgerdevs@microsoft.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft公司 |
| 網站 | https://www.microsoft.com/en-us/microsoft-365 |
| 隱私策略 | https://privacy.microsoft.com/ |
| 類別 | 生產力 |
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 依交易識別碼取得分類帳項目 |
您可以選擇性地指定集合識別碼,以指出要從中擷取值的集合。 若要傳回較舊的分類帳項目,必須從磁碟讀取分類帳的相關區段並進行驗證。 為了防止在記憶體保護區內阻塞,回應會指出項目是否已準備就緒且是回應的一部分,或載入是否仍在進行中。 |
| 依交易識別碼取得專案的狀態 |
傳回交易的目前狀態,指出它是否已提交到帳本中。 |
| 依交易識別碼取得收據 |
傳回可用於驗證交易完整性的加密收據。 |
| 取得目前的分類帳項目 |
您可以選擇性地指定集合識別碼,以指出要從中擷取值的集合。 若要傳回較舊的分類帳項目,必須從磁碟讀取分類帳的相關區段並進行驗證。 為了防止在記憶體保護區內阻塞,回應會指出項目是否已準備就緒且是回應的一部分,或載入是否仍在進行中。 |
| 寫入分類帳項目 |
您可以選擇性地指定集合識別碼。 |
| 按集合和範圍獲取分類帳條目 |
您可以選擇性地指定集合識別碼。 只會傳回指定 (或預設) 集合中的項目。 |
依交易識別碼取得分類帳項目
您可以選擇性地指定集合識別碼,以指出要從中擷取值的集合。 若要傳回較舊的分類帳項目,必須從磁碟讀取分類帳的相關區段並進行驗證。 為了防止在記憶體保護區內阻塞,回應會指出項目是否已準備就緒且是回應的一部分,或載入是否仍在進行中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
要與 HTTP 要求搭配使用的 API 版本。
|
api-version | True | string |
要與 HTTP 要求搭配使用的 API 版本。 |
|
集合識別碼。
|
collectionId | string |
集合識別碼。 |
|
|
識別寫入交易。
|
transactionId | True | string |
識別寫入交易。 |
|
分類帳的名稱。
|
ledgerName | True | string |
分類帳的名稱。 |
傳回
從較舊的交易識別碼查詢分類帳項目的結果。只有在傳回的狀態為「就緒」時,才可在回應中使用分類帳項目。
依交易識別碼取得專案的狀態
傳回交易的目前狀態,指出它是否已提交到帳本中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
要與 HTTP 要求搭配使用的 API 版本。
|
api-version | True | string |
要與 HTTP 要求搭配使用的 API 版本。 |
|
識別寫入交易。
|
transactionId | True | string |
識別寫入交易。 |
|
分類帳的名稱。
|
ledgerName | True | string |
分類帳的名稱。 |
傳回
傳回交易狀態查詢的回應
依交易識別碼取得收據
傳回可用於驗證交易完整性的加密收據。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
要與 HTTP 要求搭配使用的 API 版本。
|
api-version | True | string |
要與 HTTP 要求搭配使用的 API 版本。 |
|
識別寫入交易。
|
transactionId | True | string |
識別寫入交易。 |
|
分類帳的名稱。
|
ledgerName | True | string |
分類帳的名稱。 |
傳回
證明指定 ID 交易的收據。
取得目前的分類帳項目
您可以選擇性地指定集合識別碼,以指出要從中擷取值的集合。 若要傳回較舊的分類帳項目,必須從磁碟讀取分類帳的相關區段並進行驗證。 為了防止在記憶體保護區內阻塞,回應會指出項目是否已準備就緒且是回應的一部分,或載入是否仍在進行中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
要與 HTTP 要求搭配使用的 API 版本。
|
api-version | True | string |
要與 HTTP 要求搭配使用的 API 版本。 |
|
集合識別碼。
|
collectionId | string |
集合識別碼。 |
|
|
分類帳的名稱。
|
ledgerName | True | string |
分類帳的名稱。 |
傳回
分類帳中的項目。
- 身體
- LedgerEntry
寫入分類帳項目
您可以選擇性地指定集合識別碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
要與 HTTP 要求搭配使用的 API 版本。
|
api-version | True | string |
要與 HTTP 要求搭配使用的 API 版本。 |
|
集合識別碼。
|
collectionId | string |
集合識別碼。 |
|
|
內容
|
contents | True | string |
分類帳項目的內容。 |
|
collectionId
|
collectionId | string | ||
|
交易 ID
|
transactionId | string |
交易識別碼 |
|
|
分類帳的名稱。
|
ledgerName | True | string |
分類帳的名稱。 |
傳回
回應中的交易識別碼會傳回,因為寫入機密分類帳會傳回,指出寫入何時會持續。
按集合和範圍獲取分類帳條目
您可以選擇性地指定集合識別碼。 只會傳回指定 (或預設) 集合中的項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
要與 HTTP 要求搭配使用的 API 版本。
|
api-version | True | string |
要與 HTTP 要求搭配使用的 API 版本。 |
|
集合識別碼。
|
collectionId | string |
集合識別碼。 |
|
|
指定範圍內的第一個交易識別碼。
|
fromTransactionId | string |
指定範圍內的第一個交易識別碼。 |
|
|
指定範圍內的最後一個交易 ID。
|
toTransactionId | string |
指定範圍內的最後一個交易 ID。 |
|
|
分類帳的名稱。
|
ledgerName | True | string |
分類帳的名稱。 |
傳回
回傳的分頁分類帳項目以回應查詢。
定義
分類帳項目
分類帳項目陣列。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
LedgerEntry |
分類帳中的項目。 |
分類帳項目
分類帳中的項目。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
內容
|
contents | string |
分類帳項目的內容。 |
|
collectionId
|
collectionId | string | |
|
交易 ID
|
transactionId | string |
交易識別碼 |
LedgerQuery結果
從較舊的交易識別碼查詢分類帳項目的結果。只有在傳回的狀態為「就緒」時,才可在回應中使用分類帳項目。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
state | LedgerQueryState |
分類帳查詢的狀態。 |
|
輸入
|
entry | LedgerEntry |
分類帳中的項目。 |
LedgerQueryState
LedgerWrite結果
回應中的交易識別碼會傳回,因為寫入機密分類帳會傳回,指出寫入何時會持續。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
PagedLedger項目
回傳的分頁分類帳項目以回應查詢。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
state | LedgerQueryState |
分類帳查詢的狀態。 |
|
nextLink
|
nextLink | string |
從中擷取下一頁結果的路徑。 |
|
條目
|
entries | LedgerEntries |
分類帳項目陣列。 |
TransactionId
分類帳狀態的唯一識別碼。 如果傳回為 LedgerEntry 的一部分,則會指出從中讀取專案的狀態。
分類帳狀態的唯一識別碼。 如果傳回為 LedgerEntry 的一部分,則會指出從中讀取專案的狀態。
交易收據
證明指定 ID 交易的收據。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
應用程式索賠
|
applicationClaims | ApplicationClaims |
申請索賠清單。 |
|
收條
|
receipt | ReceiptContents | |
|
狀態
|
state | LedgerQueryState |
分類帳查詢的狀態。 |
|
交易 ID
|
transactionId | TransactionId |
分類帳狀態的唯一識別碼。 如果傳回為 LedgerEntry 的一部分,則會指出從中讀取專案的狀態。 |
交易狀態
交易狀態
傳回交易狀態查詢的回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
state | TransactionState |
代表交易的狀態。 |
|
交易 ID
|
transactionId | TransactionId |
分類帳狀態的唯一識別碼。 如果傳回為 LedgerEntry 的一部分,則會指出從中讀取專案的狀態。 |
申請索賠
申請索賠清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
ApplicationClaim |
分類帳應用程式的宣告。 |
申請索賠
分類帳應用程式的宣告。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
摘要
|
digest | ClaimDigest |
摘要形式的申請權利要求。 |
|
類型
|
kind | ApplicationClaimKind |
代表應用程式宣告的類型。 |
|
ledgerEntry
|
ledgerEntry | LedgerEntryClaim |
衍生自總帳專案資料的應用程式宣告。 |
申請索賠種類
應用程式宣告通訊協定
索賠文摘
摘要形式的申請權利要求。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | string |
申請權利要求的摘要,十六進位形式。 |
|
通訊協定
|
protocol | ApplicationClaimProtocol |
代表要用來從指定索賠資料計算索賠摘要的通訊協定。 |
LedgerEntryClaim
衍生自總帳專案資料的應用程式宣告。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
集合的識別碼。 |
|
內容
|
contents | string |
分類帳項目的內容。 |
|
secretKey 金鑰
|
secretKey | string |
Base64 編碼的秘密金鑰。 |
|
通訊協定
|
protocol | ApplicationClaimProtocol |
代表要用來從指定索賠資料計算索賠摘要的通訊協定。 |
收據內容
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
cert
|
cert | string | |
|
葉
|
leaf | string | |
|
leafComponents
|
leafComponents | ReceiptLeafComponents | |
|
nodeId
|
nodeId | string | |
|
證
|
proof | ReceiptElementArray | |
|
根
|
root | string | |
|
服務背書
|
serviceEndorsements | PemArray | |
|
特徵標記
|
signature | string |
收據元素
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
left
|
left | string | |
|
右
|
right | string |
ReceiptElement陣列
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
ReceiptElement |
ReceiptLeaf元件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
索賠摘要
|
claimsDigest | string | |
|
commit證據
|
commitEvidence | string | |
|
寫入設定摘要
|
writeSetDigest | string |
佩姆
Pem陣列
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
Pem |