Azure Confidential Ledger
O ConfidentialLedgerClient grava e recupera entradas do razão no serviço Confidential Ledger.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Equipa de Contabilidade Confidencial do Azure |
| accledgerdevs@microsoft.com |
| Metadados do conector | |
|---|---|
| Editora | Corporação Microsoft |
| Sítio Web | https://www.microsoft.com/en-us/microsoft-365 |
| Política de privacidade | https://privacy.microsoft.com/ |
| Categorias | Produtividade |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Grava uma entrada contábil |
Opcionalmente, pode ser especificada uma ID de coleção. |
| Obtém a entrada contábil atual |
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas mais antigas do livro-razão, as seções relevantes do livro razão devem ser lidas do disco e validadas. Para evitar o bloqueio dentro do enclave, a resposta indicará se a entrada está pronta e parte da resposta, ou se o carregamento ainda está em andamento. |
| Obtém a entrada contábil por ID de transação |
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas mais antigas do livro-razão, as seções relevantes do livro razão devem ser lidas do disco e validadas. Para evitar o bloqueio dentro do enclave, a resposta indicará se a entrada está pronta e parte da resposta, ou se o carregamento ainda está em andamento. |
| Obtém entradas contábeis por coleção e intervalo |
Opcionalmente, pode ser especificada uma ID de coleção. Somente as entradas na coleção especificada (ou padrão) serão retornadas. |
| Obtém o status de uma entrada por ID de transação |
Retorna o status atual de uma transação, indicando se ela foi confirmada no livro-razão. |
| Obtém um recibo por ID de transação |
Retorna um recibo criptográfico que pode ser usado para verificar a integridade de uma transação. |
Grava uma entrada contábil
Opcionalmente, pode ser especificada uma ID de coleção.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
A versão da API a ser usada com a solicitação HTTP.
|
api-version | True | string |
A versão da API a ser usada com a solicitação HTTP. |
|
O ID da coleção.
|
collectionId | string |
O ID da coleção. |
|
|
contents
|
contents | True | string |
Conteúdo da entrada contábil. |
|
collectionId
|
collectionId | string | ||
|
transactionId
|
transactionId | string |
ID da Transação |
|
|
O nome do livro-razão.
|
ledgerName | True | string |
O nome do livro-razão. |
Devoluções
Retornado como resultado de uma gravação no Razão Confidencial, o ID da transação na resposta indica quando a gravação se tornará durável.
- Body
- LedgerWriteResult
Obtém a entrada contábil atual
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas mais antigas do livro-razão, as seções relevantes do livro razão devem ser lidas do disco e validadas. Para evitar o bloqueio dentro do enclave, a resposta indicará se a entrada está pronta e parte da resposta, ou se o carregamento ainda está em andamento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
A versão da API a ser usada com a solicitação HTTP.
|
api-version | True | string |
A versão da API a ser usada com a solicitação HTTP. |
|
O ID da coleção.
|
collectionId | string |
O ID da coleção. |
|
|
O nome do livro-razão.
|
ledgerName | True | string |
O nome do livro-razão. |
Devoluções
Uma entrada no livro-razão.
- Body
- LedgerEntry
Obtém a entrada contábil por ID de transação
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas mais antigas do livro-razão, as seções relevantes do livro razão devem ser lidas do disco e validadas. Para evitar o bloqueio dentro do enclave, a resposta indicará se a entrada está pronta e parte da resposta, ou se o carregamento ainda está em andamento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
A versão da API a ser usada com a solicitação HTTP.
|
api-version | True | string |
A versão da API a ser usada com a solicitação HTTP. |
|
O ID da coleção.
|
collectionId | string |
O ID da coleção. |
|
|
Identifica uma transação de gravação.
|
transactionId | True | string |
Identifica uma transação de gravação. |
|
O nome do livro-razão.
|
ledgerName | True | string |
O nome do livro-razão. |
Devoluções
O resultado da consulta de uma entrada contábil de uma ID de transação mais antiga. A entrada contábil estará disponível na resposta somente se o estado retornado for Pronto.
- Body
- LedgerQueryResult
Obtém entradas contábeis por coleção e intervalo
Opcionalmente, pode ser especificada uma ID de coleção. Somente as entradas na coleção especificada (ou padrão) serão retornadas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
A versão da API a ser usada com a solicitação HTTP.
|
api-version | True | string |
A versão da API a ser usada com a solicitação HTTP. |
|
O ID da coleção.
|
collectionId | string |
O ID da coleção. |
|
|
Especifique o ID da primeira transação em um intervalo.
|
fromTransactionId | string |
Especifique o ID da primeira transação em um intervalo. |
|
|
Especifique o último ID de transação em um intervalo.
|
toTransactionId | string |
Especifique o último ID de transação em um intervalo. |
|
|
O nome do livro-razão.
|
ledgerName | True | string |
O nome do livro-razão. |
Devoluções
Entradas paginadas do razão retornadas em resposta a uma consulta.
- Body
- PagedLedgerEntries
Obtém o status de uma entrada por ID de transação
Retorna o status atual de uma transação, indicando se ela foi confirmada no livro-razão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
A versão da API a ser usada com a solicitação HTTP.
|
api-version | True | string |
A versão da API a ser usada com a solicitação HTTP. |
|
Identifica uma transação de gravação.
|
transactionId | True | string |
Identifica uma transação de gravação. |
|
O nome do livro-razão.
|
ledgerName | True | string |
O nome do livro-razão. |
Devoluções
Resposta retornada a uma consulta para o status da transação
- Body
- TransactionStatus
Obtém um recibo por ID de transação
Retorna um recibo criptográfico que pode ser usado para verificar a integridade de uma transação.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
A versão da API a ser usada com a solicitação HTTP.
|
api-version | True | string |
A versão da API a ser usada com a solicitação HTTP. |
|
Identifica uma transação de gravação.
|
transactionId | True | string |
Identifica uma transação de gravação. |
|
O nome do livro-razão.
|
ledgerName | True | string |
O nome do livro-razão. |
Devoluções
Um recibo certificando a transação no id especificado.
- Body
- TransactionReceipt
Definições
LedgerEntries
Matriz de entradas contábeis.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
LedgerEntry |
Uma entrada no livro-razão. |
LedgerEntry
Uma entrada no livro-razão.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
contents
|
contents | string |
Conteúdo da entrada contábil. |
|
collectionId
|
collectionId | string | |
|
transactionId
|
transactionId | string |
ID da Transação |
LedgerQueryResult
O resultado da consulta de uma entrada contábil de uma ID de transação mais antiga. A entrada contábil estará disponível na resposta somente se o estado retornado for Pronto.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
state
|
state | LedgerQueryState |
Estado de uma consulta contábil. |
|
introdução
|
entry | LedgerEntry |
Uma entrada no livro-razão. |
LedgerQueryState
LedgerWriteResult
Retornado como resultado de uma gravação no Razão Confidencial, o ID da transação na resposta indica quando a gravação se tornará durável.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
PagedLedgerEntries
Entradas paginadas do razão retornadas em resposta a uma consulta.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
state
|
state | LedgerQueryState |
Estado de uma consulta contábil. |
|
Próximo Link
|
nextLink | string |
Caminho a partir do qual recuperar a próxima página de resultados. |
|
entradas
|
entries | LedgerEntries |
Matriz de entradas contábeis. |
TransactionId
Um identificador exclusivo para o estado do livro-razão. Se retornado como parte de um LedgerEntry, ele indica o estado a partir do qual a entrada foi lida.
Um identificador exclusivo para o estado do livro-razão. Se retornado como parte de um LedgerEntry, ele indica o estado a partir do qual a entrada foi lida.
TransaçãoRecibo
Um recibo certificando a transação no id especificado.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
applicationClaims
|
applicationClaims | ApplicationClaims |
Lista de reivindicações de aplicação. |
|
recibo
|
receipt | ReceiptContents | |
|
state
|
state | LedgerQueryState |
Estado de uma consulta contábil. |
|
transactionId
|
transactionId | TransactionId |
Um identificador exclusivo para o estado do livro-razão. Se retornado como parte de um LedgerEntry, ele indica o estado a partir do qual a entrada foi lida. |
Estado da Transação
Status da transação
Resposta retornada a uma consulta para o status da transação
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
state
|
state | TransactionState |
Representa o estado da transação. |
|
transactionId
|
transactionId | TransactionId |
Um identificador exclusivo para o estado do livro-razão. Se retornado como parte de um LedgerEntry, ele indica o estado a partir do qual a entrada foi lida. |
ApplicationClaims
Lista de reivindicações de aplicação.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
ApplicationClaim |
Uma reivindicação de um aplicativo contábil. |
ApplicationClaim
Uma reivindicação de um aplicativo contábil.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
resumo
|
digest | ClaimDigest |
Uma reivindicação de pedido na forma digerida. |
|
tipo
|
kind | ApplicationClaimKind |
Representa o tipo de reivindicação de um aplicativo. |
|
ledgerEntry
|
ledgerEntry | LedgerEntryClaim |
Uma declaração de aplicativo derivada de dados de entrada do livro-razão. |
ApplicationClaimKind
Representa o tipo de reivindicação de um aplicativo.
Representa o tipo de reivindicação de um aplicativo.
ApplicationClaimProtocol
Representa o protocolo a ser usado para calcular o resumo de uma declaração a partir dos dados de declaração fornecidos.
Representa o protocolo a ser usado para calcular o resumo de uma declaração a partir dos dados de declaração fornecidos.
ClaimDigest
Uma reivindicação de pedido na forma digerida.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
valor
|
value | string |
O resumo da reivindicação do pedido, em forma hexadecimal. |
|
protocolo
|
protocol | ApplicationClaimProtocol |
Representa o protocolo a ser usado para calcular o resumo de uma declaração a partir dos dados de declaração fornecidos. |
LedgerEntryClaim
Uma declaração de aplicativo derivada de dados de entrada do livro-razão.
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
Identificador de uma coleção. |
|
contents
|
contents | string |
Conteúdo de uma entrada contábil. |
|
chave secreta
|
secretKey | string |
Chave secreta codificada em Base64. |
|
protocolo
|
protocol | ApplicationClaimProtocol |
Representa o protocolo a ser usado para calcular o resumo de uma declaração a partir dos dados de declaração fornecidos. |
ReciboConteúdo
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
cert
|
cert | string | |
|
folha
|
leaf | string | |
|
folhasComponentes
|
leafComponents | ReceiptLeafComponents | |
|
nodeId
|
nodeId | string | |
|
prova
|
proof | ReceiptElementArray | |
|
raiz
|
root | string | |
|
serviçoEndossos
|
serviceEndorsements | PemArray | |
|
assinatura
|
signature | string |
ReceiptElement
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
esquerda
|
left | string | |
|
Certo
|
right | string |
ReceiptElementArray
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
ReceiptElement |
Componentes ReceiptLeaf
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
reivindicaçõesDigest
|
claimsDigest | string | |
|
commitEvidence
|
commitEvidence | string | |
|
writeSetDigest
|
writeSetDigest | string |
Pem
PemArray
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
Pem |