Azure Confidential Ledger
ConfidentialLedgerClient escribe y recupera entradas de libro de contabilidad en el servicio Confidential Ledger.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Equipo de Azure Confidential Ledger |
| Correo Electrónico | accledgerdevs@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft Corporation |
| Sitio web | https://www.microsoft.com/en-us/microsoft-365 |
| Directiva de privacidad | https://privacy.microsoft.com/ |
| Categorías | Productividad |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Escribe una entrada de libro de contabilidad. |
Opcionalmente, se puede especificar un identificador de colección. |
| Obtiene el estado de una entrada por identificador de transacción. |
Devuelve el estado actual de una transacción, que indica si se ha confirmado en el libro de contabilidad. |
| Obtiene la entrada del libro de contabilidad actual. |
Opcionalmente, se puede especificar un identificador de colección para indicar la colección desde la que se va a capturar el valor. Para devolver entradas de libro de contabilidad anteriores, las secciones pertinentes del libro de contabilidad deben leerse desde el disco y validarse. Para evitar el bloqueo dentro del enclave, la respuesta indicará si la entrada está lista y parte de la respuesta, o si la carga sigue en curso. |
| Obtiene la entrada del libro de contabilidad por identificador de transacción. |
Opcionalmente, se puede especificar un identificador de colección para indicar la colección desde la que se va a capturar el valor. Para devolver entradas de libro de contabilidad anteriores, las secciones pertinentes del libro de contabilidad deben leerse desde el disco y validarse. Para evitar el bloqueo dentro del enclave, la respuesta indicará si la entrada está lista y parte de la respuesta, o si la carga sigue en curso. |
| Obtiene las entradas del libro de contabilidad por colección y intervalo. |
Opcionalmente, se puede especificar un identificador de colección. Solo se devolverán las entradas de la colección especificada (o predeterminada). |
| Obtiene un recibo por identificador de transacción. |
Devuelve un recibo criptográfico que se puede usar para comprobar la integridad de una transacción. |
Escribe una entrada de libro de contabilidad.
Opcionalmente, se puede especificar un identificador de colección.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Versión de la API que se va a usar con la solicitud HTTP.
|
api-version | True | string |
Versión de la API que se va a usar con la solicitud HTTP. |
|
Identificador de la colección.
|
collectionId | string |
Identificador de la colección. |
|
|
contents
|
contents | True | string |
Contenido de la entrada del libro de contabilidad. |
|
collectionId
|
collectionId | string | ||
|
transactionId
|
transactionId | string |
Identificador de transacción |
|
|
Nombre del libro de contabilidad.
|
ledgerName | True | string |
Nombre del libro de contabilidad. |
Devoluciones
Devuelto como resultado de una escritura en Confidential Ledger, el identificador de transacción de la respuesta indica cuándo la escritura será duradera.
- Body
- LedgerWriteResult
Obtiene el estado de una entrada por identificador de transacción.
Devuelve el estado actual de una transacción, que indica si se ha confirmado en el libro de contabilidad.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Versión de la API que se va a usar con la solicitud HTTP.
|
api-version | True | string |
Versión de la API que se va a usar con la solicitud HTTP. |
|
Identifica una transacción de escritura.
|
transactionId | True | string |
Identifica una transacción de escritura. |
|
Nombre del libro de contabilidad.
|
ledgerName | True | string |
Nombre del libro de contabilidad. |
Devoluciones
Respuesta devuelta a una consulta para el estado de la transacción
- Body
- TransactionStatus
Obtiene la entrada del libro de contabilidad actual.
Opcionalmente, se puede especificar un identificador de colección para indicar la colección desde la que se va a capturar el valor. Para devolver entradas de libro de contabilidad anteriores, las secciones pertinentes del libro de contabilidad deben leerse desde el disco y validarse. Para evitar el bloqueo dentro del enclave, la respuesta indicará si la entrada está lista y parte de la respuesta, o si la carga sigue en curso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Versión de la API que se va a usar con la solicitud HTTP.
|
api-version | True | string |
Versión de la API que se va a usar con la solicitud HTTP. |
|
Identificador de la colección.
|
collectionId | string |
Identificador de la colección. |
|
|
Nombre del libro de contabilidad.
|
ledgerName | True | string |
Nombre del libro de contabilidad. |
Devoluciones
Entrada en el libro de contabilidad.
- Body
- LedgerEntry
Obtiene la entrada del libro de contabilidad por identificador de transacción.
Opcionalmente, se puede especificar un identificador de colección para indicar la colección desde la que se va a capturar el valor. Para devolver entradas de libro de contabilidad anteriores, las secciones pertinentes del libro de contabilidad deben leerse desde el disco y validarse. Para evitar el bloqueo dentro del enclave, la respuesta indicará si la entrada está lista y parte de la respuesta, o si la carga sigue en curso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Versión de la API que se va a usar con la solicitud HTTP.
|
api-version | True | string |
Versión de la API que se va a usar con la solicitud HTTP. |
|
Identificador de la colección.
|
collectionId | string |
Identificador de la colección. |
|
|
Identifica una transacción de escritura.
|
transactionId | True | string |
Identifica una transacción de escritura. |
|
Nombre del libro de contabilidad.
|
ledgerName | True | string |
Nombre del libro de contabilidad. |
Devoluciones
Resultado de la consulta de una entrada de libro de contabilidad desde un identificador de transacción anterior. La entrada del libro de contabilidad solo está disponible en la respuesta si el estado devuelto es Listo.
- Body
- LedgerQueryResult
Obtiene las entradas del libro de contabilidad por colección y intervalo.
Opcionalmente, se puede especificar un identificador de colección. Solo se devolverán las entradas de la colección especificada (o predeterminada).
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Versión de la API que se va a usar con la solicitud HTTP.
|
api-version | True | string |
Versión de la API que se va a usar con la solicitud HTTP. |
|
Identificador de la colección.
|
collectionId | string |
Identificador de la colección. |
|
|
Especifique el primer identificador de transacción en un intervalo.
|
fromTransactionId | string |
Especifique el primer identificador de transacción en un intervalo. |
|
|
Especifique el último identificador de transacción en un intervalo.
|
toTransactionId | string |
Especifique el último identificador de transacción en un intervalo. |
|
|
Nombre del libro de contabilidad.
|
ledgerName | True | string |
Nombre del libro de contabilidad. |
Devoluciones
Entradas de libro de contabilidad paginadas devueltas en respuesta a una consulta.
- Body
- PagedLedgerEntries
Obtiene un recibo por identificador de transacción.
Devuelve un recibo criptográfico que se puede usar para comprobar la integridad de una transacción.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Versión de la API que se va a usar con la solicitud HTTP.
|
api-version | True | string |
Versión de la API que se va a usar con la solicitud HTTP. |
|
Identifica una transacción de escritura.
|
transactionId | True | string |
Identifica una transacción de escritura. |
|
Nombre del libro de contabilidad.
|
ledgerName | True | string |
Nombre del libro de contabilidad. |
Devoluciones
Recibo que certifica la transacción en el identificador especificado.
- Body
- TransactionReceipt
Definiciones
LedgerEntries
Matriz de entradas del libro de contabilidad.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Productos
|
LedgerEntry |
Entrada en el libro de contabilidad. |
LedgerEntry
Entrada en el libro de contabilidad.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
contents
|
contents | string |
Contenido de la entrada del libro de contabilidad. |
|
collectionId
|
collectionId | string | |
|
transactionId
|
transactionId | string |
Identificador de transacción |
LedgerQueryResult
Resultado de la consulta de una entrada de libro de contabilidad desde un identificador de transacción anterior. La entrada del libro de contabilidad solo está disponible en la respuesta si el estado devuelto es Listo.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
state | LedgerQueryState |
Estado de una consulta de libro de contabilidad. |
|
entry
|
entry | LedgerEntry |
Entrada en el libro de contabilidad. |
LedgerQueryState
Estado de una consulta de libro de contabilidad.
Estado de una consulta de libro de contabilidad.
LedgerWriteResult
Devuelto como resultado de una escritura en Confidential Ledger, el identificador de transacción de la respuesta indica cuándo la escritura será duradera.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
PagedLedgerEntries
Entradas de libro de contabilidad paginadas devueltas en respuesta a una consulta.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
state | LedgerQueryState |
Estado de una consulta de libro de contabilidad. |
|
nextLink
|
nextLink | string |
Ruta de acceso desde la que se va a recuperar la siguiente página de resultados. |
|
Entradas
|
entries | LedgerEntries |
Matriz de entradas del libro de contabilidad. |
TransactionId
Identificador único para el estado del libro de contabilidad. Si se devuelve como parte de ledgerEntry, indica el estado desde el que se leyó la entrada.
Identificador único para el estado del libro de contabilidad. Si se devuelve como parte de ledgerEntry, indica el estado desde el que se leyó la entrada.
TransactionReceipt
Recibo que certifica la transacción en el identificador especificado.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
applicationClaims
|
applicationClaims | ApplicationClaims |
Lista de notificaciones de aplicación. |
|
recibo
|
receipt | ReceiptContents | |
|
estado
|
state | LedgerQueryState |
Estado de una consulta de libro de contabilidad. |
|
transactionId
|
transactionId | TransactionId |
Identificador único para el estado del libro de contabilidad. Si se devuelve como parte de ledgerEntry, indica el estado desde el que se leyó la entrada. |
TransactionState
TransactionStatus
Respuesta devuelta a una consulta para el estado de la transacción
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
state | TransactionState |
Representa el estado de la transacción. |
|
transactionId
|
transactionId | TransactionId |
Identificador único para el estado del libro de contabilidad. Si se devuelve como parte de ledgerEntry, indica el estado desde el que se leyó la entrada. |
ApplicationClaims
Lista de notificaciones de aplicación.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Productos
|
ApplicationClaim |
Una notificación de una aplicación de libro de contabilidad. |
ApplicationClaim
Una notificación de una aplicación de libro de contabilidad.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
digerir
|
digest | ClaimDigest |
Una notificación de aplicación en formato implícita. |
|
amable
|
kind | ApplicationClaimKind |
Representa el tipo de una notificación de aplicación. |
|
ledgerEntry
|
ledgerEntry | LedgerEntryClaim |
Una notificación de aplicación derivada de los datos de entrada del libro de contabilidad. |
ApplicationClaimKind
Representa el tipo de una notificación de aplicación.
Representa el tipo de una notificación de aplicación.
ApplicationClaimProtocol
Representa el protocolo que se va a usar para calcular el resumen de una notificación de los datos de notificación especificados.
Representa el protocolo que se va a usar para calcular el resumen de una notificación de los datos de notificación especificados.
ClaimDigest
Una notificación de aplicación en formato implícita.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
value
|
value | string |
Resumen de la notificación de aplicación, en formato hexadecimal. |
|
protocol
|
protocol | ApplicationClaimProtocol |
Representa el protocolo que se va a usar para calcular el resumen de una notificación de los datos de notificación especificados. |
LedgerEntryClaim
Una notificación de aplicación derivada de los datos de entrada del libro de contabilidad.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
collectionId
|
collectionId | string |
Identificador de una colección. |
|
contents
|
contents | string |
Contenido de una entrada de libro de contabilidad. |
|
secretKey
|
secretKey | string |
Clave secreta codificada en Base64. |
|
protocol
|
protocol | ApplicationClaimProtocol |
Representa el protocolo que se va a usar para calcular el resumen de una notificación de los datos de notificación especificados. |
ReceiptContents
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
cert
|
cert | string | |
|
hoja
|
leaf | string | |
|
leafComponents
|
leafComponents | ReceiptLeafComponents | |
|
nodeId
|
nodeId | string | |
|
prueba
|
proof | ReceiptElementArray | |
|
root
|
root | string | |
|
serviceEndorsements
|
serviceEndorsements | PemArray | |
|
firma
|
signature | string |
ReceiptElement
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
left
|
left | string | |
|
Derecha
|
right | string |
ReceiptElementArray
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Productos
|
ReceiptElement |
ReceiptLeafComponents
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
claimsDigest
|
claimsDigest | string | |
|
commitEvidence
|
commitEvidence | string | |
|
writeSetDigest
|
writeSetDigest | string |
Pem
PemArray
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Productos
|
Pem |