1. docker
  2. Commit a5d9619093108cecd7f3d0209e7a94c55129fcd7
Browse code

api/docs: remove BuildCache.Parent field for API v1.42 and up

The BuildCache.Parent field was removed in API v1.42 in [moby@e0db820].
While we had to keep the Go struct field around to backfil the field for
older API versions, it's no longer part of API v1.42 and up (using the
"omitempty" is just an implementation detail).

This patch corrects the swagger files to match this.

[moby@e0db820]: https://github.com/moby/moby/commit/e0db8207f3b84d030a71f41db70fc7fbf0535b9f

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

Sebastiaan van Stijn authored on 2025/10/14 18:18:53
Showing 12 changed files
api/docs/v1.42.yaml
History View file @ a5d9619
... ... 
@@ -2619,14 +2619,6 @@ definitions:
2619 2619 
         description: |
2620 2620 
           Unique ID of the build cache record.
2621 2621 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2622 
-      Parent:
2623 
-        description: |
2624 
-          ID of the parent build cache record.
2625 
-
2626 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2627 
-        type: "string"
2628 
-        x-nullable: true
2629 
-        example: ""
2630 2622 
       Parents:
2631 2623 
         description: |
2632 2624 
           List of parent build cache record IDs.
api/docs/v1.43.yaml
History View file @ a5d9619
... ... 
@@ -2650,14 +2650,6 @@ definitions:
2650 2650 
         description: |
2651 2651 
           Unique ID of the build cache record.
2652 2652 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2653 
-      Parent:
2654 
-        description: |
2655 
-          ID of the parent build cache record.
2656 
-
2657 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2658 
-        type: "string"
2659 
-        x-nullable: true
2660 
-        example: ""
2661 2653 
       Parents:
2662 2654 
         description: |
2663 2655 
           List of parent build cache record IDs.
api/docs/v1.44.yaml
History View file @ a5d9619
... ... 
@@ -2661,14 +2661,6 @@ definitions:
2661 2661 
         description: |
2662 2662 
           Unique ID of the build cache record.
2663 2663 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2664 
-      Parent:
2665 
-        description: |
2666 
-          ID of the parent build cache record.
2667 
-
2668 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2669 
-        type: "string"
2670 
-        x-nullable: true
2671 
-        example: ""
2672 2664 
       Parents:
2673 2665 
         description: |
2674 2666 
           List of parent build cache record IDs.
api/docs/v1.45.yaml
History View file @ a5d9619
... ... 
@@ -2647,14 +2647,6 @@ definitions:
2647 2647 
         description: |
2648 2648 
           Unique ID of the build cache record.
2649 2649 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2650 
-      Parent:
2651 
-        description: |
2652 
-          ID of the parent build cache record.
2653 
-
2654 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2655 
-        type: "string"
2656 
-        x-nullable: true
2657 
-        example: ""
2658 2650 
       Parents:
2659 2651 
         description: |
2660 2652 
           List of parent build cache record IDs.
api/docs/v1.46.yaml
History View file @ a5d9619
... ... 
@@ -2693,14 +2693,6 @@ definitions:
2693 2693 
         description: |
2694 2694 
           Unique ID of the build cache record.
2695 2695 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2696 
-      Parent:
2697 
-        description: |
2698 
-          ID of the parent build cache record.
2699 
-
2700 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2701 
-        type: "string"
2702 
-        x-nullable: true
2703 
-        example: ""
2704 2696 
       Parents:
2705 2697 
         description: |
2706 2698 
           List of parent build cache record IDs.
api/docs/v1.47.yaml
History View file @ a5d9619
... ... 
@@ -2711,14 +2711,6 @@ definitions:
2711 2711 
         description: |
2712 2712 
           Unique ID of the build cache record.
2713 2713 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2714 
-      Parent:
2715 
-        description: |
2716 
-          ID of the parent build cache record.
2717 
-
2718 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2719 
-        type: "string"
2720 
-        x-nullable: true
2721 
-        example: ""
2722 2714 
       Parents:
2723 2715 
         description: |
2724 2716 
           List of parent build cache record IDs.
api/docs/v1.48.yaml
History View file @ a5d9619
... ... 
@@ -2812,14 +2812,6 @@ definitions:
2812 2812 
         description: |
2813 2813 
           Unique ID of the build cache record.
2814 2814 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2815 
-      Parent:
2816 
-        description: |
2817 
-          ID of the parent build cache record.
2818 
-
2819 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2820 
-        type: "string"
2821 
-        x-nullable: true
2822 
-        example: ""
2823 2815 
       Parents:
2824 2816 
         description: |
2825 2817 
           List of parent build cache record IDs.
api/docs/v1.49.yaml
History View file @ a5d9619
... ... 
@@ -2812,14 +2812,6 @@ definitions:
2812 2812 
         description: |
2813 2813 
           Unique ID of the build cache record.
2814 2814 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2815 
-      Parent:
2816 
-        description: |
2817 
-          ID of the parent build cache record.
2818 
-
2819 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2820 
-        type: "string"
2821 
-        x-nullable: true
2822 
-        example: ""
2823 2815 
       Parents:
2824 2816 
         description: |
2825 2817 
           List of parent build cache record IDs.
api/docs/v1.50.yaml
History View file @ a5d9619
... ... 
@@ -2639,14 +2639,6 @@ definitions:
2639 2639 
         description: |
2640 2640 
           Unique ID of the build cache record.
2641 2641 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2642 
-      Parent:
2643 
-        description: |
2644 
-          ID of the parent build cache record.
2645 
-
2646 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2647 
-        type: "string"
2648 
-        x-nullable: true
2649 
-        example: ""
2650 2642 
       Parents:
2651 2643 
         description: |
2652 2644 
           List of parent build cache record IDs.
api/docs/v1.51.yaml
History View file @ a5d9619
... ... 
@@ -2653,14 +2653,6 @@ definitions:
2653 2653 
         description: |
2654 2654 
           Unique ID of the build cache record.
2655 2655 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2656 
-      Parent:
2657 
-        description: |
2658 
-          ID of the parent build cache record.
2659 
-
2660 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2661 
-        type: "string"
2662 
-        x-nullable: true
2663 
-        example: ""
2664 2656 
       Parents:
2665 2657 
         description: |
2666 2658 
           List of parent build cache record IDs.
api/docs/v1.52.yaml
History View file @ a5d9619
... ... 
@@ -2730,14 +2730,6 @@ definitions:
2730 2730 
         description: |
2731 2731 
           Unique ID of the build cache record.
2732 2732 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2733 
-      Parent:
2734 
-        description: |
2735 
-          ID of the parent build cache record.
2736 
-
2737 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2738 
-        type: "string"
2739 
-        x-nullable: true
2740 
-        example: ""
2741 2733 
       Parents:
2742 2734 
         description: |
2743 2735 
           List of parent build cache record IDs.
api/swagger.yaml
History View file @ a5d9619
... ... 
@@ -2730,14 +2730,6 @@ definitions:
2730 2730 
         description: |
2731 2731 
           Unique ID of the build cache record.
2732 2732 
         example: "ndlpt0hhvkqcdfkputsk4cq9c"
2733 
-      Parent:
2734 
-        description: |
2735 
-          ID of the parent build cache record.
2736 
-
2737 
-          > **Deprecated**: This field is deprecated, and omitted if empty.
2738 
-        type: "string"
2739 
-        x-nullable: true
2740 
-        example: ""
2741 2733 
       Parents:
2742 2734 
         description: |
2743 2735 
           List of parent build cache record IDs.