OPCFoundation.NetStandard.Opc.Ua.AMB.Client 2.0.2

Prefix Reserved
dotnet add package OPCFoundation.NetStandard.Opc.Ua.AMB.Client --version 2.0.2
                    
NuGet\Install-Package OPCFoundation.NetStandard.Opc.Ua.AMB.Client -Version 2.0.2
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.AMB.Client" Version="2.0.2" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="OPCFoundation.NetStandard.Opc.Ua.AMB.Client" Version="2.0.2" />
                    
Directory.Packages.props
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.AMB.Client" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add OPCFoundation.NetStandard.Opc.Ua.AMB.Client --version 2.0.2
                    
#r "nuget: OPCFoundation.NetStandard.Opc.Ua.AMB.Client, 2.0.2"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package OPCFoundation.NetStandard.Opc.Ua.AMB.Client@2.0.2
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=OPCFoundation.NetStandard.Opc.Ua.AMB.Client&version=2.0.2
                    
Install as a Cake Addin
#tool nuget:?package=OPCFoundation.NetStandard.Opc.Ua.AMB.Client&version=2.0.2
                    
Install as a Cake Tool

Opc.Ua.AMB.Client

Client-side access to OPC 10000-110 — Asset Management Basics (AMB).

AmbClient amb = session.AssetManagement(telemetry);

foreach (NodeId asset in await amb.DiscoverAssetsAsync(ct))
{
    AssetSnapshot snapshot = await amb.ReadAssetAsync(asset, ct);
    Console.WriteLine($"{snapshot.Identification.ProductInstanceUri}: {snapshot.DeviceHealth}");
}

Discovery

FindAssetsAsync calls FindAlias on the alias categories Assets, AssetsByProductInstanceUri and AssetsByAssetId; EnumerateAssetsAsync browses the alias objects instead. DiscoverAssetsAsync returns every asset of the server once. ReadNodeVersionAsync and ObserveAssetSetChangesAsync follow changes of the categories.

Reading

Call OPC 10000-110
ReadIdentificationAsync, WriteAssetIdAsync §7, on the asset or in 2:Identification
ReadDeviceHealthAsync, ReadHealthAlarmsAsync §9
ReadMaintenanceActivitiesAsync §12
ReadDocumentationLinksAsync, AddDocumentationLinkAsync, RemoveDocumentationLinkAsync §10.5
ReadEntriesAsync §10.6, §10.7
ReadContextAsync, ReadLocationsOfAssetAsync, BrowseLocationsAsync §11, §13
EnumerateSubAssetsAsync, ReadRelationsAsync §14
ReadAssetAsync all of the above for one asset

Pass AmbClientOptions to the client constructor to opt into bounded traversal and strict response validation. Read records then retain original source nodes, quality and timestamps in their Values evidence. A present Good-null structure is not an absent optional path; scalar type mismatches are still rejected.

Events

ObserveHealthAlarmsAsync and ObserveMaintenanceAsync subscribe to the condition events and return AssetAlarmRecord and MaintenanceActivityRecord values, including the potential root causes, the maintenance state and the comment of an acknowledgement. A maintenance activity is told apart by its condition class (MaintenanceConditionClassType or a subtype), and the two filters select disjoint events. The fields of the AMB interfaces are selected with BaseEventType as the type definition, since a server checks select clauses against the type hierarchy of an event, which interfaces are not part of. Tolerant read calls ask for a condition refresh when there is no 2:DeviceHealthAlarms folder; strict reads require the folder and do not start an implicit refresh. Event observation still falls back to known maintenance classes if subtype browsing fails or reaches a traversal limit, without caching an incomplete class set. AcknowledgeAsync acknowledges a condition.

History

ReadHealthHistoryAsync reads raw DeviceHealth with original quality and timestamps. ReadHealthEventsAsync and ReadPastMaintenanceAsync read immutable condition events filtered by asset and maintenance class, including subtypes. They use HistoryClient for paging, continuation release and cancellation; pass HistoryClientOptions for read-duration and page limits. Event records preserve original field values in HistoryFields, whose select-clause identities are returned by GetHistoryEventFields(). GetHistoryCapabilitiesAsync reports history-read attributes. Unsupported or denied history is an error, not an empty successful result.

Hosting

services.AddOpcUa().AddClient(...).AddAssetManagementClient();

registers an AmbClientFactory and a Func<CancellationToken, Task<AmbClient>>.

Use AddAssetManagementClient(new AmbClientOptions { MaximumBrowseReferences = 1024, MaximumBrowsePages = 128 }) to apply strict limits to both factories. An AmbClientOptions singleton registered separately is also honored. Without options, both retain tolerant behavior. Direct construction supports new AmbClientFactory(openSession, telemetry, options) as well.

For the server side use Opc.Ua.AMB.Server; the model and the shared contracts live in Opc.Ua.AMB.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Framework net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on OPCFoundation.NetStandard.Opc.Ua.AMB.Client:

Package Downloads
OPCFoundation.NetStandard.Opc.Ua.Mcp.AMB

Embeddable MCP tools for OPC UA Asset Management Basics: asset discovery, identification, health, maintenance, documentation, and explicit asset controls.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.2 117 11/11/2026
2.0.1 119 10/12/2026
2.0.0 106 10/7/2026