feat: Update specgen configuration to Docker Engine API 29.4.1 and support /system/df

DOCKER_API_VERSION_MATRIX.md

@@ -2,13 +2,13 @@
 
 This project is currently generated against:
 
-- Docker release tag: `docker-v29.1.5`
+- Docker release tag: `docker-v29.4.1`
 
 ## API version matrix
 
 | Docker version | Maximum API version |
 | --- | --- |
-| 29.1 | 1.52 |
+| 29.4 | 1.54 |
 
 ## References
 

Directory.Build.props

@@ -1,7 +1,7 @@
 <Project>
   <PropertyGroup>
     <LangVersion>latest</LangVersion>
-    <DockerVersion>v29.1.5</DockerVersion>
+    <DockerVersion>v29.4.1</DockerVersion>
   </PropertyGroup>
   <!-- Strong-naming -->
   <PropertyGroup Label="Signing">

src/Docker.DotNet/Endpoints/ISystemOperations.cs

@@ -74,4 +74,9 @@ public interface ISystemOperations
     /// 500 - Server error.
     /// </remarks>
     Task MonitorEventsAsync(ContainerEventsParameters parameters, IProgress<Message> progress, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Get data usage information
+    /// </summary>
+    Task<SystemDataUsageInfoResponse> GetDataUsageInfoAsync(SytemDataUsageInfoParameters? parameters = null, CancellationToken cancellationToken = default);
 }

src/Docker.DotNet/Endpoints/SystemOperations.cs

@@ -72,4 +72,12 @@ public Task MonitorEventsAsync(ContainerEventsParameters parameters, IProgress<M
             progress,
             cancellationToken);
     }
+
+    public async Task<SystemDataUsageInfoResponse> GetDataUsageInfoAsync(SytemDataUsageInfoParameters? parameters = null, CancellationToken cancellationToken = default)
+    {
+        var queryParameters = parameters == null ? null : new QueryString<SytemDataUsageInfoParameters>(parameters);
+
+        return await _client.MakeRequestAsync<SystemDataUsageInfoResponse>(_client.NoErrorHandlers, HttpMethod.Get, "system/df", queryParameters, cancellationToken)
+            .ConfigureAwait(false);
+    }
 }

src/Docker.DotNet/Models/BuildDiskUsage.Generated.cs

@@ -0,0 +1,49 @@
+#nullable enable
+namespace Docker.DotNet.Models
+{
+    /// <summary>
+    /// DiskUsage represents system data usage for build cache resources.
+    /// 
+    /// swagger:model DiskUsage
+    /// </summary>
+    public class BuildDiskUsage // (build.DiskUsage)
+    {
+        /// <summary>
+        /// Count of active build cache records.
+        /// 
+        /// Example: 1
+        /// </summary>
+        [JsonPropertyName("ActiveCount")]
+        public long? ActiveCount { get; set; }
+
+        /// <summary>
+        /// List of build cache records.
+        /// </summary>
+        [JsonPropertyName("Items")]
+        public IList<CacheRecord>? Items { get; set; }
+
+        /// <summary>
+        /// Disk space that can be reclaimed by removing inactive build cache records.
+        /// 
+        /// Example: 12345678
+        /// </summary>
+        [JsonPropertyName("Reclaimable")]
+        public long? Reclaimable { get; set; }
+
+        /// <summary>
+        /// Count of all build cache records.
+        /// 
+        /// Example: 4
+        /// </summary>
+        [JsonPropertyName("TotalCount")]
+        public long? TotalCount { get; set; }
+
+        /// <summary>
+        /// Disk space in use by build cache records.
+        /// 
+        /// Example: 98765432
+        /// </summary>
+        [JsonPropertyName("TotalSize")]
+        public long? TotalSize { get; set; }
+    }
+}

src/Docker.DotNet/Models/BuildIdentity.Generated.cs

@@ -0,0 +1,22 @@
+#nullable enable
+namespace Docker.DotNet.Models
+{
+    /// <summary>
+    /// BuildIdentity contains build reference information if image was created via build.
+    /// </summary>
+    public class BuildIdentity // (image.BuildIdentity)
+    {
+        /// <summary>
+        /// Ref is the identifier for the build request. This reference can be used to
+        /// look up the build details in BuildKit history API.
+        /// </summary>
+        [JsonPropertyName("Ref")]
+        public string? Ref { get; set; }
+
+        /// <summary>
+        /// CreatedAt is the time when the build ran.
+        /// </summary>
+        [JsonPropertyName("CreatedAt")]
+        public DateTime? CreatedAt { get; set; }
+    }
+}

src/Docker.DotNet/Models/CacheRecord.Generated.cs

@@ -0,0 +1,66 @@
+#nullable enable
+namespace Docker.DotNet.Models
+{
+    /// <summary>
+    /// CacheRecord contains information about a build cache record.
+    /// </summary>
+    public class CacheRecord // (build.CacheRecord)
+    {
+        /// <summary>
+        /// ID is the unique ID of the build cache record.
+        /// </summary>
+        [JsonPropertyName("ID")]
+        public string ID { get; set; } = default!;
+
+        /// <summary>
+        /// Parents is the list of parent build cache record IDs.
+        /// </summary>
+        [JsonPropertyName(" Parents")]
+        public IList<string>? Parents { get; set; }
+
+        /// <summary>
+        /// Type is the cache record type.
+        /// </summary>
+        [JsonPropertyName("Type")]
+        public string Type { get; set; } = default!;
+
+        /// <summary>
+        /// Description is a description of the build-step that produced the build cache.
+        /// </summary>
+        [JsonPropertyName("Description")]
+        public string Description { get; set; } = default!;
+
+        /// <summary>
+        /// InUse indicates if the build cache is in use.
+        /// </summary>
+        [JsonPropertyName("InUse")]
+        public bool InUse { get; set; } = default!;
+
+        /// <summary>
+        /// Shared indicates if the build cache is shared.
+        /// </summary>
+        [JsonPropertyName("Shared")]
+        public bool Shared { get; set; } = default!;
+
+        /// <summary>
+        /// Size is the amount of disk space used by the build cache (in bytes).
+        /// </summary>
+        [JsonPropertyName("Size")]
+        public long Size { get; set; } = default!;
+
+        /// <summary>
+        /// CreatedAt is the date and time at which the build cache was created.
+        /// </summary>
+        [JsonPropertyName("CreatedAt")]
+        public DateTime CreatedAt { get; set; } = default!;
+
+        /// <summary>
+        /// LastUsedAt is the date and time at which the build cache was last used.
+        /// </summary>
+        [JsonPropertyName("LastUsedAt")]
+        public DateTime? LastUsedAt { get; set; }
+
+        [JsonPropertyName("UsageCount")]
+        public long UsageCount { get; set; } = default!;
+    }
+}

src/Docker.DotNet/Models/ContainerDiskUsage.Generated.cs

@@ -0,0 +1,49 @@
+#nullable enable
+namespace Docker.DotNet.Models
+{
+    /// <summary>
+    /// DiskUsage represents system data usage information for container resources.
+    /// 
+    /// swagger:model DiskUsage
+    /// </summary>
+    public class ContainerDiskUsage // (container.DiskUsage)
+    {
+        /// <summary>
+        /// Count of active containers.
+        /// 
+        /// Example: 1
+        /// </summary>
+        [JsonPropertyName("ActiveCount")]
+        public long? ActiveCount { get; set; }
+
+        /// <summary>
+        /// List of container summaries.
+        /// </summary>
+        [JsonPropertyName("Items")]
+        public IList<ContainerListResponse>? Items { get; set; }
+
+        /// <summary>
+        /// Disk space that can be reclaimed by removing inactive containers.
+        /// 
+        /// Example: 12345678
+        /// </summary>
+        [JsonPropertyName("Reclaimable")]
+        public long? Reclaimable { get; set; }
+
+        /// <summary>
+        /// Count of all containers.
+        /// 
+        /// Example: 4
+        /// </summary>
+        [JsonPropertyName("TotalCount")]
+        public long? TotalCount { get; set; }
+
+        /// <summary>
+        /// Disk space in use by containers.
+        /// 
+        /// Example: 98765432
+        /// </summary>
+        [JsonPropertyName("TotalSize")]
+        public long? TotalSize { get; set; }
+    }
+}

src/Docker.DotNet/Models/DiscreteGenericResource.Generated.cs

@@ -2,7 +2,7 @@
 namespace Docker.DotNet.Models
 {
     /// <summary>
-    /// DiscreteGenericResource represents a &quot;user defined&quot; resource which is defined
+    /// DiscreteGenericResource represents a &quot;user-defined&quot; resource which is defined
     /// as an integer
     /// &quot;Kind&quot; is used to describe the Kind of a resource (e.g: &quot;GPU&quot;, &quot;FPGA&quot;, &quot;SSD&quot;, ...)
     /// Value is used to count the resource (SSD=5, HDD=3, ...)

src/Docker.DotNet/Models/DockerModelsJsonSerializerContext.Generated.cs

@@ -9,9 +9,12 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(BindOptions))]
     [JsonSerializable(typeof(BlkioStatEntry))]
     [JsonSerializable(typeof(BlkioStats))]
+    [JsonSerializable(typeof(BuildDiskUsage))]
+    [JsonSerializable(typeof(BuildIdentity))]
     [JsonSerializable(typeof(CAConfig))]
     [JsonSerializable(typeof(CPUStats))]
     [JsonSerializable(typeof(CPUUsage))]
+    [JsonSerializable(typeof(CacheRecord))]
     [JsonSerializable(typeof(CapacityRange))]
     [JsonSerializable(typeof(ClusterInfo))]
     [JsonSerializable(typeof(ClusterOptions))]
@@ -26,6 +29,7 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(ConfigReferenceRuntimeTarget))]
     [JsonSerializable(typeof(ConsoleSize))]
     [JsonSerializable(typeof(ContainerConfig))]
+    [JsonSerializable(typeof(ContainerDiskUsage))]
     [JsonSerializable(typeof(ContainerExecCreateParameters))]
     [JsonSerializable(typeof(ContainerExecCreateResponse))]
     [JsonSerializable(typeof(ContainerExecInspectResponse))]
@@ -81,10 +85,12 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(IPAMConfig))]
     [JsonSerializable(typeof(IPAMOptions))]
     [JsonSerializable(typeof(IPAMStatus))]
+    [JsonSerializable(typeof(Identity))]
     [JsonSerializable(typeof(ImageBuildParameters))]
     [JsonSerializable(typeof(ImageBuildResult))]
     [JsonSerializable(typeof(ImageConfig))]
     [JsonSerializable(typeof(ImageDeleteResponse))]
+    [JsonSerializable(typeof(ImageDiskUsage))]
     [JsonSerializable(typeof(ImageHistoryResponse))]
     [JsonSerializable(typeof(ImageInspectResponse))]
     [JsonSerializable(typeof(ImageOptions))]
@@ -113,6 +119,7 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(Metadata))]
     [JsonSerializable(typeof(Mount))]
     [JsonSerializable(typeof(MountPoint))]
+    [JsonSerializable(typeof(NRIInfo))]
     [JsonSerializable(typeof(NamedGenericResource))]
     [JsonSerializable(typeof(Network))]
     [JsonSerializable(typeof(NetworkAddressPool))]
@@ -169,6 +176,7 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(PortSummary))]
     [JsonSerializable(typeof(Privileges))]
     [JsonSerializable(typeof(PublishStatus))]
+    [JsonSerializable(typeof(PullIdentity))]
     [JsonSerializable(typeof(RaftConfig))]
     [JsonSerializable(typeof(ReplicatedJob))]
     [JsonSerializable(typeof(ReplicatedService))]
@@ -196,6 +204,9 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(ServiceStatus))]
     [JsonSerializable(typeof(ServiceUpdateParameters))]
     [JsonSerializable(typeof(ServiceUpdateResponse))]
+    [JsonSerializable(typeof(SignatureIdentity))]
+    [JsonSerializable(typeof(SignatureTimestamp))]
+    [JsonSerializable(typeof(SignerIdentity))]
     [JsonSerializable(typeof(Spec))]
     [JsonSerializable(typeof(SpreadOver))]
     [JsonSerializable(typeof(State))]
@@ -227,6 +238,7 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(SwarmUpdateConfig))]
     [JsonSerializable(typeof(SwarmUpdateConfigParameters))]
     [JsonSerializable(typeof(SwarmUpdateParameters))]
+    [JsonSerializable(typeof(SystemDataUsageInfoResponse))]
     [JsonSerializable(typeof(SystemInfoResponse))]
     [JsonSerializable(typeof(TLSInfo))]
     [JsonSerializable(typeof(TaskDefaults))]
@@ -246,8 +258,10 @@ namespace Docker.DotNet.Models
     [JsonSerializable(typeof(UsageData))]
     [JsonSerializable(typeof(Version))]
     [JsonSerializable(typeof(VersionResponse))]
+    [JsonSerializable(typeof(Volume))]
     [JsonSerializable(typeof(VolumeAccessMode))]
     [JsonSerializable(typeof(VolumeAttachment))]
+    [JsonSerializable(typeof(VolumeDiskUsage))]
     [JsonSerializable(typeof(VolumeInfo))]
     [JsonSerializable(typeof(VolumeOptions))]
     [JsonSerializable(typeof(VolumeResponse))]

src/Docker.DotNet/Models/EndpointIPAMConfig.Generated.cs

@@ -7,10 +7,10 @@ namespace Docker.DotNet.Models
     public class EndpointIPAMConfig // (network.EndpointIPAMConfig)
     {
         [JsonPropertyName("IPv4Address")]
-        public string? IPv4Address { get; set; }
+        public string IPv4Address { get; set; } = default!;
 
         [JsonPropertyName("IPv6Address")]
-        public string? IPv6Address { get; set; }
+        public string IPv6Address { get; set; } = default!;
 
         [JsonPropertyName("LinkLocalIPs")]
         public IList<string>? LinkLocalIPs { get; set; }

src/Docker.DotNet/Models/EndpointVirtualIP.Generated.cs

@@ -15,6 +15,6 @@ public class EndpointVirtualIP // (swarm.EndpointVirtualIP)
         /// compatibility, but only the IP address is used.
         /// </summary>
         [JsonPropertyName("Addr")]
-        public string? Addr { get; set; }
+        public string Addr { get; set; } = default!;
     }
 }

src/Docker.DotNet/Models/GenericResource.Generated.cs

@@ -2,7 +2,7 @@
 namespace Docker.DotNet.Models
 {
     /// <summary>
-    /// GenericResource represents a &quot;user defined&quot; resource which can
+    /// GenericResource represents a &quot;user-defined&quot; resource which can
     /// be either an integer (e.g: SSD=3) or a string (e.g: SSD=sda1)
     /// </summary>
     public class GenericResource // (swarm.GenericResource)

src/Docker.DotNet/Models/IPAMConfig.Generated.cs

@@ -7,13 +7,13 @@ namespace Docker.DotNet.Models
     public class IPAMConfig // (network.IPAMConfig)
     {
         [JsonPropertyName("Subnet")]
-        public string? Subnet { get; set; }
+        public string Subnet { get; set; } = default!;
 
         [JsonPropertyName("IPRange")]
-        public string? IPRange { get; set; }
+        public string IPRange { get; set; } = default!;
 
         [JsonPropertyName("Gateway")]
-        public string? Gateway { get; set; }
+        public string Gateway { get; set; } = default!;
 
         [JsonPropertyName("AuxiliaryAddresses")]
         public IDictionary<string, string>? AuxAddress { get; set; }