Azure Confidential Ledger
ConfidentialLedgerClient는 Confidential Ledger 서비스에 대한 원장 항목을 작성하고 검색합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Azure Confidential Ledger 팀 |
| 전자 메일 | accledgerdevs@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft Corporation |
| 웹 사이트 | https://www.microsoft.com/en-us/microsoft-365 |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/ |
| 카테고리 | 생산력 |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 원장 항목을 씁니다. |
컬렉션 ID를 선택적으로 지정할 수 있습니다. |
| 컬렉션 및 범위별로 원장 항목을 가져옵니다. |
컬렉션 ID를 선택적으로 지정할 수 있습니다. 지정된(또는 기본값) 컬렉션의 항목만 반환됩니다. |
| 트랜잭션 ID로 영수증을 가져옵니다. |
트랜잭션의 무결성을 확인하는 데 사용할 수 있는 암호화 영수증을 반환합니다. |
| 트랜잭션 ID로 원장 항목을 가져옵니다. |
필요에 따라 값을 가져올 컬렉션을 나타내기 위해 컬렉션 ID를 지정할 수 있습니다. 이전 원장 항목을 반환하려면 원장의 관련 섹션을 디스크에서 읽고 유효성을 검사해야 합니다. enclave 내에서 차단을 방지하기 위해 응답은 항목이 준비되었는지, 응답의 일부인지 또는 로드가 여전히 진행 중인지를 나타냅니다. |
| 트랜잭션 ID별로 항목의 상태를 가져옵니다. |
트랜잭션이 원장에 커밋되었는지 여부를 나타내는 트랜잭션의 현재 상태를 반환합니다. |
| 현재 원장 항목을 가져옵니다. |
필요에 따라 값을 가져올 컬렉션을 나타내기 위해 컬렉션 ID를 지정할 수 있습니다. 이전 원장 항목을 반환하려면 원장의 관련 섹션을 디스크에서 읽고 유효성을 검사해야 합니다. enclave 내에서 차단을 방지하기 위해 응답은 항목이 준비되었는지, 응답의 일부인지 또는 로드가 여전히 진행 중인지를 나타냅니다. |
원장 항목을 씁니다.
컬렉션 ID를 선택적으로 지정할 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
HTTP 요청과 함께 사용할 API 버전입니다.
|
api-version | True | string |
HTTP 요청과 함께 사용할 API 버전입니다. |
|
컬렉션 ID입니다.
|
collectionId | string |
컬렉션 ID입니다. |
|
|
contents
|
contents | True | string |
원장 항목의 내용입니다. |
|
collectionId
|
collectionId | string | ||
|
거래 ID
|
transactionId | string |
트랜잭션 ID |
|
|
원장의 이름입니다.
|
ledgerName | True | string |
원장의 이름입니다. |
반환
Confidential Ledger에 대한 쓰기의 결과로 반환되는 응답의 트랜잭션 ID는 쓰기가 지속성이 되는 시기를 나타냅니다.
컬렉션 및 범위별로 원장 항목을 가져옵니다.
컬렉션 ID를 선택적으로 지정할 수 있습니다. 지정된(또는 기본값) 컬렉션의 항목만 반환됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
HTTP 요청과 함께 사용할 API 버전입니다.
|
api-version | True | string |
HTTP 요청과 함께 사용할 API 버전입니다. |
|
컬렉션 ID입니다.
|
collectionId | string |
컬렉션 ID입니다. |
|
|
범위에서 첫 번째 트랜잭션 ID를 지정합니다.
|
fromTransactionId | string |
범위에서 첫 번째 트랜잭션 ID를 지정합니다. |
|
|
범위에서 마지막 트랜잭션 ID를 지정합니다.
|
toTransactionId | string |
범위에서 마지막 트랜잭션 ID를 지정합니다. |
|
|
원장의 이름입니다.
|
ledgerName | True | string |
원장의 이름입니다. |
반환
쿼리에 대한 응답으로 반환된 페이지를 매긴 원장 항목입니다.
트랜잭션 ID로 영수증을 가져옵니다.
트랜잭션의 무결성을 확인하는 데 사용할 수 있는 암호화 영수증을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
HTTP 요청과 함께 사용할 API 버전입니다.
|
api-version | True | string |
HTTP 요청과 함께 사용할 API 버전입니다. |
|
쓰기 트랜잭션을 식별합니다.
|
transactionId | True | string |
쓰기 트랜잭션을 식별합니다. |
|
원장의 이름입니다.
|
ledgerName | True | string |
원장의 이름입니다. |
반환
지정된 ID로 트랜잭션을 인증하는 영수증입니다.
트랜잭션 ID로 원장 항목을 가져옵니다.
필요에 따라 값을 가져올 컬렉션을 나타내기 위해 컬렉션 ID를 지정할 수 있습니다. 이전 원장 항목을 반환하려면 원장의 관련 섹션을 디스크에서 읽고 유효성을 검사해야 합니다. enclave 내에서 차단을 방지하기 위해 응답은 항목이 준비되었는지, 응답의 일부인지 또는 로드가 여전히 진행 중인지를 나타냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
HTTP 요청과 함께 사용할 API 버전입니다.
|
api-version | True | string |
HTTP 요청과 함께 사용할 API 버전입니다. |
|
컬렉션 ID입니다.
|
collectionId | string |
컬렉션 ID입니다. |
|
|
쓰기 트랜잭션을 식별합니다.
|
transactionId | True | string |
쓰기 트랜잭션을 식별합니다. |
|
원장의 이름입니다.
|
ledgerName | True | string |
원장의 이름입니다. |
반환
이전 트랜잭션 ID에서 원장 항목을 쿼리한 결과입니다. 원장 항목은 반환된 상태가 Ready인 경우에만 응답에서 사용할 수 있습니다.
트랜잭션 ID별로 항목의 상태를 가져옵니다.
트랜잭션이 원장에 커밋되었는지 여부를 나타내는 트랜잭션의 현재 상태를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
HTTP 요청과 함께 사용할 API 버전입니다.
|
api-version | True | string |
HTTP 요청과 함께 사용할 API 버전입니다. |
|
쓰기 트랜잭션을 식별합니다.
|
transactionId | True | string |
쓰기 트랜잭션을 식별합니다. |
|
원장의 이름입니다.
|
ledgerName | True | string |
원장의 이름입니다. |
반환
트랜잭션 상태에 대한 쿼리에 반환된 응답
현재 원장 항목을 가져옵니다.
필요에 따라 값을 가져올 컬렉션을 나타내기 위해 컬렉션 ID를 지정할 수 있습니다. 이전 원장 항목을 반환하려면 원장의 관련 섹션을 디스크에서 읽고 유효성을 검사해야 합니다. enclave 내에서 차단을 방지하기 위해 응답은 항목이 준비되었는지, 응답의 일부인지 또는 로드가 여전히 진행 중인지를 나타냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
HTTP 요청과 함께 사용할 API 버전입니다.
|
api-version | True | string |
HTTP 요청과 함께 사용할 API 버전입니다. |
|
컬렉션 ID입니다.
|
collectionId | string |
컬렉션 ID입니다. |
|
|
원장의 이름입니다.
|
ledgerName | True | string |
원장의 이름입니다. |
반환
원장의 항목입니다.
정의
LedgerEntries
원장 항목의 배열입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
LedgerEntry |
원장의 항목입니다. |
LedgerEntry
원장의 항목입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
contents
|
contents | string |
원장 항목의 내용입니다. |
|
collectionId
|
collectionId | string | |
|
거래 ID
|
transactionId | string |
트랜잭션 ID |
LedgerQueryResult
이전 트랜잭션 ID에서 원장 항목을 쿼리한 결과입니다. 원장 항목은 반환된 상태가 Ready인 경우에만 응답에서 사용할 수 있습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
주
|
state | LedgerQueryState |
원장 쿼리의 상태입니다. |
|
entry
|
entry | LedgerEntry |
원장의 항목입니다. |
LedgerQueryState
LedgerWriteResult
Confidential Ledger에 대한 쓰기의 결과로 반환되는 응답의 트랜잭션 ID는 쓰기가 지속성이 되는 시기를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
PagedLedgerEntries
쿼리에 대한 응답으로 반환된 페이지를 매긴 원장 항목입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
주
|
state | LedgerQueryState |
원장 쿼리의 상태입니다. |
|
넥스트링크
|
nextLink | string |
결과의 다음 페이지를 검색할 경로입니다. |
|
항목
|
entries | LedgerEntries |
원장 항목의 배열입니다. |
TransactionId
원장 상태에 대한 고유 식별자입니다. LedgerEntry의 일부로 반환되는 경우 항목을 읽은 상태를 나타냅니다.
원장 상태에 대한 고유 식별자입니다. LedgerEntry의 일부로 반환되는 경우 항목을 읽은 상태를 나타냅니다.
TransactionReceipt
지정된 ID로 트랜잭션을 인증하는 영수증입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
applicationClaims
|
applicationClaims | ApplicationClaims |
애플리케이션 클레임 목록입니다. |
|
영수증
|
receipt | ReceiptContents | |
|
주
|
state | LedgerQueryState |
원장 쿼리의 상태입니다. |
|
거래 ID
|
transactionId | TransactionId |
원장 상태에 대한 고유 식별자입니다. LedgerEntry의 일부로 반환되는 경우 항목을 읽은 상태를 나타냅니다. |
TransactionState
TransactionStatus
트랜잭션 상태에 대한 쿼리에 반환된 응답
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
주
|
state | TransactionState |
트랜잭션의 상태를 나타냅니다. |
|
거래 ID
|
transactionId | TransactionId |
원장 상태에 대한 고유 식별자입니다. LedgerEntry의 일부로 반환되는 경우 항목을 읽은 상태를 나타냅니다. |
ApplicationClaims
애플리케이션 클레임 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
ApplicationClaim |
원장 애플리케이션의 클레임입니다. |
ApplicationClaim
원장 애플리케이션의 클레임입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
소화하다
|
digest | ClaimDigest |
다이제스트된 형식의 애플리케이션 클레임입니다. |
|
친절한
|
kind | ApplicationClaimKind |
애플리케이션 클레임의 종류를 나타냅니다. |
|
ledgerEntry
|
ledgerEntry | LedgerEntryClaim |
원장 항목 데이터에서 파생된 애플리케이션 클레임입니다. |
ApplicationClaimKind
ApplicationClaimProtocol
지정된 클레임 데이터에서 클레임 다이제스트를 계산하는 데 사용할 프로토콜을 나타냅니다.
지정된 클레임 데이터에서 클레임 다이제스트를 계산하는 데 사용할 프로토콜을 나타냅니다.
ClaimDigest
다이제스트된 형식의 애플리케이션 클레임입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | string |
16진수 형식의 애플리케이션 클레임 다이제스트입니다. |
|
protocol
|
protocol | ApplicationClaimProtocol |
지정된 클레임 데이터에서 클레임 다이제스트를 계산하는 데 사용할 프로토콜을 나타냅니다. |
LedgerEntryClaim
원장 항목 데이터에서 파생된 애플리케이션 클레임입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
컬렉션의 식별자입니다. |
|
contents
|
contents | string |
원장 항목의 내용입니다. |
|
시크릿키
|
secretKey | string |
Base64로 인코딩된 비밀 키입니다. |
|
protocol
|
protocol | ApplicationClaimProtocol |
지정된 클레임 데이터에서 클레임 다이제스트를 계산하는 데 사용할 프로토콜을 나타냅니다. |
ReceiptContents
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
cert
|
cert | string | |
|
잎
|
leaf | string | |
|
leafComponents
|
leafComponents | ReceiptLeafComponents | |
|
노드 ID
|
nodeId | string | |
|
증거
|
proof | ReceiptElementArray | |
|
root
|
root | string | |
|
serviceEndorsements
|
serviceEndorsements | PemArray | |
|
서명
|
signature | string |
ReceiptElement
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
왼쪽
|
left | string | |
|
오른쪽
|
right | string |
ReceiptElementArray
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
ReceiptElement |
ReceiptLeafComponents
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
claimsDigest
|
claimsDigest | string | |
|
commitEvidence
|
commitEvidence | string | |
|
writeSetDigest
|
writeSetDigest | string |
Pem
PemArray
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이템
|
Pem |