Razão Confidencial do Azure
O ConfidentialLedgerClient grava e recupera entradas do razão no serviço Razão Confidencial.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Equipe do Razão Confidencial do Azure |
| accledgerdevs@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft Corporation |
| Site | https://www.microsoft.com/en-us/microsoft-365 |
| Política de privacidade | https://privacy.microsoft.com/ |
| Categorias | Produtividade |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Grava uma entrada do razão |
Opcionalmente, uma ID de coleção pode ser especificada. |
| Obtém a entrada do razão atual |
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas de razão mais antigas, as seções relevantes do 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 do razão por ID da transação |
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas de razão mais antigas, as seções relevantes do 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 do razão por coleção e intervalo |
Opcionalmente, uma ID de coleção pode ser especificada. 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 razão. |
| Obtém um recibo por ID da transação |
Retorna um recibo criptográfico que pode ser usado para verificar a integridade de uma transação. |
Grava uma entrada do razão
Opcionalmente, uma ID de coleção pode ser especificada.
Parâmetros
| Nome | Chave | Obrigató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. |
|
A ID da coleção.
|
collectionId | string |
A ID da coleção. |
|
|
contents
|
contents | True | string |
Conteúdo da entrada do razão. |
|
collectionId
|
collectionId | string | ||
|
ID da transação
|
transactionId | string |
ID da transação |
|
|
O nome do razão.
|
ledgerName | True | string |
O nome do razão. |
Retornos
Retornada como resultado de uma gravação no Razão Confidencial, a ID da transação na resposta indica quando a gravação se tornará durável.
- Corpo
- LedgerWriteResult
Obtém a entrada do razão atual
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas de razão mais antigas, as seções relevantes do 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
| Nome | Chave | Obrigató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. |
|
A ID da coleção.
|
collectionId | string |
A ID da coleção. |
|
|
O nome do razão.
|
ledgerName | True | string |
O nome do razão. |
Retornos
Uma entrada no razão.
- Corpo
- LedgerEntry
Obtém a entrada do razão por ID da transação
Opcionalmente, uma ID de coleção pode ser especificada para indicar a coleção da qual buscar o valor. Para retornar entradas de razão mais antigas, as seções relevantes do 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
| Nome | Chave | Obrigató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. |
|
A ID da coleção.
|
collectionId | string |
A ID da coleção. |
|
|
Identifica uma transação de gravação.
|
transactionId | True | string |
Identifica uma transação de gravação. |
|
O nome do razão.
|
ledgerName | True | string |
O nome do razão. |
Retornos
O resultado da consulta de uma entrada do razão de uma ID de transação mais antiga. A entrada do razão estará disponível na resposta somente se o estado retornado estiver pronto.
- Corpo
- LedgerQueryResult
Obtém entradas do razão por coleção e intervalo
Opcionalmente, uma ID de coleção pode ser especificada. Somente as entradas na coleção especificada (ou padrão) serão retornadas.
Parâmetros
| Nome | Chave | Obrigató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. |
|
A ID da coleção.
|
collectionId | string |
A ID da coleção. |
|
|
Especifique a primeira ID da transação em um intervalo.
|
fromTransactionId | string |
Especifique a primeira ID da transação em um intervalo. |
|
|
Especifique a última ID da transação em um intervalo.
|
toTransactionId | string |
Especifique a última ID da transação em um intervalo. |
|
|
O nome do razão.
|
ledgerName | True | string |
O nome do razão. |
Retornos
Entradas de razão paginadas retornadas em resposta a uma consulta.
- Corpo
- 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 razão.
Parâmetros
| Nome | Chave | Obrigató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 razão.
|
ledgerName | True | string |
O nome do razão. |
Retornos
Resposta retornada a uma consulta para o status da transação
- Corpo
- TransactionStatus
Obtém um recibo por ID da transação
Retorna um recibo criptográfico que pode ser usado para verificar a integridade de uma transação.
Parâmetros
| Nome | Chave | Obrigató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 razão.
|
ledgerName | True | string |
O nome do razão. |
Retornos
Um recibo que certifica a transação na ID especificada.
- Corpo
- TransactionReceipt
Definições
LedgerEntries
Matriz de entradas do razão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
LedgerEntry |
Uma entrada no razão. |
LedgerEntry
Uma entrada no razão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
contents
|
contents | string |
Conteúdo da entrada do razão. |
|
collectionId
|
collectionId | string | |
|
ID da transação
|
transactionId | string |
ID da transação |
LedgerQueryResult
O resultado da consulta de uma entrada do razão de uma ID de transação mais antiga. A entrada do razão estará disponível na resposta somente se o estado retornado estiver pronto.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
state | LedgerQueryState |
Estado de uma consulta do razão. |
|
entrada
|
entry | LedgerEntry |
Uma entrada no razão. |
LedgerQueryState
LedgerWriteResult
Retornada como resultado de uma gravação no Razão Confidencial, a ID da transação na resposta indica quando a gravação se tornará durável.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
PagedLedgerEntries
Entradas de razão paginadas retornadas em resposta a uma consulta.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
state | LedgerQueryState |
Estado de uma consulta do razão. |
|
nextLink
|
nextLink | string |
Caminho do qual recuperar a próxima página de resultados. |
|
Entradas
|
entries | LedgerEntries |
Matriz de entradas do razão. |
TransactionId
Um identificador exclusivo para o estado do razão. Se retornado como parte de um LedgerEntry, ele indica o estado do qual a entrada foi lida.
Um identificador exclusivo para o estado do razão. Se retornado como parte de um LedgerEntry, ele indica o estado do qual a entrada foi lida.
TransactionReceipt
Um recibo que certifica a transação na ID especificada.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
applicationClaims
|
applicationClaims | ApplicationClaims |
Lista de declarações de aplicativo. |
|
recibo
|
receipt | ReceiptContents | |
|
estado
|
state | LedgerQueryState |
Estado de uma consulta do razão. |
|
ID da transação
|
transactionId | TransactionId |
Um identificador exclusivo para o estado do razão. Se retornado como parte de um LedgerEntry, ele indica o estado do qual a entrada foi lida. |
TransactionState
TransactionStatus
Resposta retornada a uma consulta para o status da transação
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
state | TransactionState |
Representa o estado da transação. |
|
ID da transação
|
transactionId | TransactionId |
Um identificador exclusivo para o estado do razão. Se retornado como parte de um LedgerEntry, ele indica o estado do qual a entrada foi lida. |
ApplicationClaims
Lista de declarações de aplicativo.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
ApplicationClaim |
Uma declaração de um aplicativo razão. |
ApplicationClaim
Uma declaração de um aplicativo razão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
hash
|
digest | ClaimDigest |
Uma declaração de aplicativo em forma digerida. |
|
variante
|
kind | ApplicationClaimKind |
Representa o tipo de declaração de aplicativo. |
|
ledgerEntry
|
ledgerEntry | LedgerEntryClaim |
Uma declaração de aplicativo derivada dos dados de entrada do razão. |
ApplicationClaimKind
Representa o tipo de declaração de aplicativo.
Representa o tipo de declaração de aplicativo.
ApplicationClaimProtocol
Representa o protocolo a ser usado para calcular o resumo de uma declaração dos dados de declaração fornecidos.
Representa o protocolo a ser usado para calcular o resumo de uma declaração dos dados de declaração fornecidos.
ClaimDigest
Uma declaração de aplicativo em forma digerida.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | string |
O resumo da declaração do aplicativo, em forma hexadecimal. |
|
protocolo
|
protocol | ApplicationClaimProtocol |
Representa o protocolo a ser usado para calcular o resumo de uma declaração dos dados de declaração fornecidos. |
LedgerEntryClaim
Uma declaração de aplicativo derivada dos dados de entrada do razão.
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
Identificador de uma coleção. |
|
contents
|
contents | string |
Conteúdo de uma entrada do razão. |
|
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 dos dados de declaração fornecidos. |
ReceiptContents
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
cert
|
cert | string | |
|
folha
|
leaf | string | |
|
leafComponents
|
leafComponents | ReceiptLeafComponents | |
|
id do nó
|
nodeId | string | |
|
prova
|
proof | ReceiptElementArray | |
|
raiz
|
root | string | |
|
serviceEndorsements
|
serviceEndorsements | PemArray | |
|
assinatura
|
signature | string |
ReceiptElement
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
esquerda
|
left | string | |
|
Certo
|
right | string |
ReceiptElementArray
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
ReceiptElement |
ReceiptLeafComponents
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
claimsDigest
|
claimsDigest | string | |
|
commitEvidence
|
commitEvidence | string | |
|
writeSetDigest
|
writeSetDigest | string |
Pem
PemArray
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Itens
|
Pem |