ConfidentialLedgerClient.CreateLedgerEntryAsync メソッド

定義

名前空間:

Azure.Security.ConfidentialLedger

アセンブリ:

Azure.Security.ConfidentialLedger.dll

パッケージ:

Azure.Security.ConfidentialLedger v1.2.0

[プロトコルメソッド]台帳エントリを書き込みます。

• この プロトコル メソッド を使用すると、高度なシナリオで応答の要求と処理を明示的に作成できます。

public virtual System.Threading.Tasks.Task<Azure.Response> CreateLedgerEntryAsync (Azure.Core.RequestContent content, string collectionId = default, Azure.RequestContext context = default);

abstract member CreateLedgerEntryAsync : Azure.Core.RequestContent * string * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
override this.CreateLedgerEntryAsync : Azure.Core.RequestContent * string * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function CreateLedgerEntryAsync (content As RequestContent, Optional collectionId As String = Nothing, Optional context As RequestContext = Nothing) As Task(Of Response)

パラメーター

content

RequestContent

要求の本文として送信するコンテンツ。

collectionId

String

コレクション ID。

context

RequestContext

要求コンテキスト。これは、クライアント パイプラインの既定の動作を呼び出しごとにオーバーライドできます。

戻り値

Task<Response>

サービスから返された応答。

例外

ArgumentNullException

content が null です。

RequestFailedException

サービスから成功以外の状態コードが返されました。

例

このサンプルでは、必要なパラメーターと要求コンテンツを使用して CreateLedgerEntryAsync を呼び出す方法と、結果を解析する方法を示します。

var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ConfidentialLedgerClient(endpoint, credential);

var data = new {
    contents = "<contents>",
};

Response response = await client.CreateLedgerEntryAsync(RequestContent.Create(data));

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("collectionId").ToString());

このサンプルでは、すべてのパラメーターと要求コンテンツを使用して CreateLedgerEntryAsync を呼び出す方法と、結果を解析する方法を示します。

var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ConfidentialLedgerClient(endpoint, credential);

var data = new {
    contents = "<contents>",
};

Response response = await client.CreateLedgerEntryAsync(RequestContent.Create(data), "<collectionId>");

JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("collectionId").ToString());

注釈

必要に応じて、コレクション ID を指定できます。

要求と応答のペイロードの JSON スキーマを次に示します。

要求本文:

の LedgerEntryスキーマ:

{
  contents: string, # Required. Contents of the ledger entry.
  collectionId: string, # Optional.
  transactionId: string, # Optional. A unique identifier for the state of the ledger. If returned as part of a LedgerEntry, it indicates the state from which the entry was read.
}

応答本文:

の LedgerWriteResultスキーマ:

{
  collectionId: string, # Required.
}