Skip to content

CLI Ingredient Release Get Command

The vdc ingredient-release get command retrieves detailed information about specific ingredient releases, including metadata, dependencies, artifacts, and release history. This command is essential for validating releases, debugging workflows, and integrating release information into automation scripts.


Command Syntax

vdc ingredient-release get [options]

Required Parameters

You must specify either:

  • Project, feed, name, and version combination OR
  • Release ID

Options Reference

Option Shortcut Description Required Example
--project <project> -p The project name in VDC Yes* --project validation-team
--feed <feed> -f The feed name Yes* --feed main
--name <name> -n The ingredient name Yes* --name IFWI_NVL
--version <version> -v The release version Yes* --version 2024WW15.1
--id <id> -i The release identifier Yes* --id REL-123456
--format <json\|yaml> Output format No --format yaml
--verbose Enable detailed logging No --verbose
--token <token> Authentication token Yes --token $VDC_TOKEN

Usage Examples

Get Release by Project/Feed/Name/Version

# Basic release information
vdc ingredient-release get --project validation-team --feed main --name IFWI_NVL -version 2024WW15.1 --token $VDC_TOKEN

# With YAML output for readability
vdc ingredient-release get --project validation-team --feed main --name BIOS_DMR --version A0_drop4 --format yaml --token $VDC_TOKEN

# With verbose logging for debugging
vdc ingredient-release get --project myproject --feed experimental --name custom-firmware --version 1.0.0-beta --verbose --token $VDC_TOKEN

Get Release by ID

# Using release ID (when known)
vdc ingredient-release get --id REL-123456 --token $VDC_TOKEN

# With YAML output
vdc ingredient-release get --id REL-789012 --format yaml --token $VDC_TOKEN

Output Formats

JSON Output (Default)

{
  "Packages": [
    {
      "FileName": "hierarchy_example.zip",
      "FileCount": 4,
      "FileSize": 95,
      "FileNumber": 0,
      "ArtifactoryLink": "https://artifactory-vdc.devtools.intel.com/artifactory/vdcstorage-repo/test/Navit-project/Default/IFWI_PTL/1.03/hierarchy_example.zip"
    }
  ],
  "Badges": [],
  "Description": "",
  "FeedName": "Default",
  "IngredientFamily": "Firmware",
  "IngredientType": "IFWI",
  "ModifiedDependenciesCount": 3,
  "ModifiedWorkItemTotals": {
    "Total": 0,
    "TotalBugs": 0,
    "TotalEnhancments": 0,
    "TotalWorkarounds": 0,
    "TotalOthers": 0
  },
  "Name": "IFWI_PTL",
  "ProjectName": "Navit-project",
  "ReleaseBaseline": {
    "Name": "IFWI_PTL",
    "Version": "1.0.2",
    "ProjectName": "Navit-project",
    "FeedName": "Default",
    "Schema": "Ifwi",
    "IngredientType": "IFWI"
  },
  "SchemaType": "Ifwi",
  "Silicon": "PTL",
  "Sku": null,
  "Segment": null,
  "Step": null,
  "Milestones": [],
  "ValidationDiscipline": "PIV",
  "Version": "1.03",
  "WorkItemTotals": {
    "Total": 0,
    "TotalBugs": 0,
    "TotalEnhancments": 0,
    "TotalWorkarounds": 0,
    "TotalOthers": 0
  },
  "ReleaseDate": {
    "Date": "2025-08-09T15:35:42.621Z",
    "IntelDate": "2025WW32.6"
  },
  "ReadableId": 2936,
  "Dependencies": [
    {
      "DependencyType": "Changed",
      "FeedName": "Default",
      "ReadableId": 1416,
      "IngredientType": "BIOS",
      "SchemaType": "Bios",
      "IsChanged": true,
      "ModifiedWorkItemTotals": {
        "Total": 0,
        "TotalBugs": 0,
        "TotalEnhancments": 0,
        "TotalWorkarounds": 0,
        "TotalOthers": 0
      },
      "Name": "MT-TEST",
      "ProjectName": "Sandbox1",
      "PreviousRelease": {
        "Name": "MT-TEST",
        "Version": "5.0.1",
        "ProjectName": "Sandbox1",
        "FeedName": "Default",
        "Schema": "Bios",
        "IngredientType": "BIOS"
      },
      "Version": "7.0.1",
      "WorkItemTotals": {
        "Total": 0,
        "TotalBugs": 0,
        "TotalEnhancments": 0,
        "TotalWorkarounds": 0,
        "TotalOthers": 0
      },
      "ReleaseDate": {
        "Date": "2025-07-29T08:34:11.1098421Z",
        "IntelDate": "2025WW31.2"
      },
      "HasPackages": true,
      "HasDependencies": true,
      "CustomMetadata": null
    },
    {
      "DependencyType": "Added",
      "FeedName": "Default",
      "ReadableId": 1178,
      "IngredientType": "ISH",
      "SchemaType": "Basic",
      "IsChanged": true,
      "ModifiedWorkItemTotals": {
        "Total": 0,
        "TotalBugs": 0,
        "TotalEnhancments": 0,
        "TotalWorkarounds": 0,
        "TotalOthers": 0
      },
      "Name": "PTL_ISH_Release_Prod_ISH_0",
      "ProjectName": "PTL-IFWIs",
      "PreviousRelease": null,
      "Version": "2025.23.7.594",
      "WorkItemTotals": {
        "Total": 0,
        "TotalBugs": 0,
        "TotalEnhancments": 0,
        "TotalWorkarounds": 0,
        "TotalOthers": 0
      },
      "ReleaseDate": {
        "Date": "2025-06-08T06:28:23.7146777Z",
        "IntelDate": "2025WW23.0"
      },
      "HasPackages": true,
      "HasDependencies": false,
      "CustomMetadata": null
    },
    {
      "DependencyType": "Removed",
      "FeedName": "Default",
      "ReadableId": 1330,
      "IngredientType": "UCODE",
      "SchemaType": "StarCode",
      "IsChanged": true,
      "ModifiedWorkItemTotals": {
        "Total": 0,
        "TotalBugs": 0,
        "TotalEnhancments": 0,
        "TotalWorkarounds": 0,
        "TotalOthers": 0
      },
      "Name": "Ucode_PTL_B0_Eng",
      "ProjectName": "PTL-UnifiedPatch",
      "PreviousRelease": null,
      "Version": null,
      "WorkItemTotals": {
        "Total": 0,
        "TotalBugs": 0,
        "TotalEnhancments": 0,
        "TotalWorkarounds": 0,
        "TotalOthers": 0
      },
      "ReleaseDate": {
        "Date": "2025-06-08T11:47:49.8455604Z",
        "IntelDate": "2025WW23.0"
      },
      "HasPackages": false,
      "HasDependencies": false,
      "CustomMetadata": null
    }
  ],
  "HasMultiLevelDependencies": true,
  "Changes": [],
  "CreatedBy": {
    "Email": "navit.klein@intel.com",
    "DisplayName": "Klein, Navit"
  },
  "CreatedAt": "2025-08-09T15:36:41.6610298Z",
  "UpdatedBy": {
    "Email": "navit.klein@intel.com",
    "DisplayName": "Klein, Navit"
  },
  "UpdatedAt": "2025-08-09T15:36:41.6610304Z",
  "IsOfficial": true,
  "CustomMetadata": null
}

YAML Output (Human-Readable)

Packages:
- FileName: hierarchy_example.zip
  FileCount: 4
  FileSize: 95
  FileNumber: 0
  ArtifactoryLink: https://artifactory-vdc.devtools.intel.com/artifactory/vdcstorage-repo/test/Navit-project/Default/IFWI_PTL/1.03/hierarchy_example.zip
Badges: []
Description: ''
FeedName: Default
IngredientFamily: Firmware
IngredientType: IFWI
ModifiedDependenciesCount: 3
ModifiedWorkItemTotals:
  Total: 0
  TotalBugs: 0
  TotalEnhancments: 0
  TotalWorkarounds: 0
  TotalOthers: 0
Name: IFWI_PTL
ProjectName: Navit-project
ReleaseBaseline:
  Name: IFWI_PTL
  Version: 1.0.2
  ProjectName: Navit-project
  FeedName: Default
  Schema: Ifwi
  IngredientType: IFWI
SchemaType: Ifwi
Silicon: PTL
Sku:
Segment:
Step:
Milestones: []
ValidationDiscipline: PIV
Version: 1.03
WorkItemTotals:
  Total: 0
  TotalBugs: 0
  TotalEnhancments: 0
  TotalWorkarounds: 0
  TotalOthers: 0
ReleaseDate:
  Date: 2025-08-09T15:35:42.6210000Z
  IntelDate: 2025WW32.6
ReadableId: 2936
Dependencies:
- DependencyType: Changed
  FeedName: Default
  ReadableId: 1416
  IngredientType: BIOS
  SchemaType: Bios
  IsChanged: true
  ModifiedWorkItemTotals:
    Total: 0
    TotalBugs: 0
    TotalEnhancments: 0
    TotalWorkarounds: 0
    TotalOthers: 0
  Name: MT-TEST
  ProjectName: Sandbox1
  PreviousRelease:
    Name: MT-TEST
    Version: 5.0.1
    ProjectName: Sandbox1
    FeedName: Default
    Schema: Bios
    IngredientType: BIOS
  Version: 7.0.1
  WorkItemTotals:
    Total: 0
    TotalBugs: 0
    TotalEnhancments: 0
    TotalWorkarounds: 0
    TotalOthers: 0
  ReleaseDate:
    Date: 2025-07-29T08:34:11.1098421Z
    IntelDate: 2025WW31.2
  HasPackages: true
  HasDependencies: true
  CustomMetadata:
- DependencyType: Added
  FeedName: Default
  ReadableId: 1178
  IngredientType: ISH
  SchemaType: Basic
  IsChanged: true
  ModifiedWorkItemTotals:
    Total: 0
    TotalBugs: 0
    TotalEnhancments: 0
    TotalWorkarounds: 0
    TotalOthers: 0
  Name: PTL_ISH_Release_Prod_ISH_0
  ProjectName: PTL-IFWIs
  PreviousRelease:
  Version: 2025.23.7.594
  WorkItemTotals:
    Total: 0
    TotalBugs: 0
    TotalEnhancments: 0
    TotalWorkarounds: 0
    TotalOthers: 0
  ReleaseDate:
    Date: 2025-06-08T06:28:23.7146777Z
    IntelDate: 2025WW23.0
  HasPackages: true
  HasDependencies: false
  CustomMetadata:
- DependencyType: Removed
  FeedName: Default
  ReadableId: 1330
  IngredientType: UCODE
  SchemaType: StarCode
  IsChanged: true
  ModifiedWorkItemTotals:
    Total: 0
    TotalBugs: 0
    TotalEnhancments: 0
    TotalWorkarounds: 0
    TotalOthers: 0
  Name: Ucode_PTL_B0_Eng
  ProjectName: PTL-UnifiedPatch
  PreviousRelease:
  Version:
  WorkItemTotals:
    Total: 0
    TotalBugs: 0
    TotalEnhancments: 0
    TotalWorkarounds: 0
    TotalOthers: 0
  ReleaseDate:
    Date: 2025-06-08T11:47:49.8455604Z
    IntelDate: 2025WW23.0
  HasPackages: false
  HasDependencies: false
  CustomMetadata:
HasMultiLevelDependencies: true
Changes: []
CreatedBy:
  Email: navit.klein@intel.com
  DisplayName: Klein, Navit
CreatedAt: 2025-08-09T15:36:41.6610298Z
UpdatedBy:
  Email: navit.klein@intel.com
  DisplayName: Klein, Navit
UpdatedAt: 2025-08-09T15:36:41.6610304Z
IsOfficial: true
CustomMetadata:

Understanding Output Fields

Core Identity

  • Id: Unique system-generated release identifier
  • Version: Release version string
  • ProjectName/FeedName/IngredientName: Location in VDC hierarchy
  • IngredientType: Type of ingredient (e.g., IFWI, BIOS)

Release Information

  • Description: User-provided release description
  • ReleaseDate: When the release was created
  • PublishedAt: When the release was submitted to VDC
  • PublishedBy: User who submitted the release

Dependencies & Relationships

  • BaseLine: Reference release used as foundation
  • Dependencies: List of ingredient releases this release depends on
  • UsedBy: List of releases that depend on this release

Artifacts & Metadata

  • Milestones: Associated silicon milestones
  • Packages: Files included with the release
  • CheckSum: File integrity verification

Need Other Operations?

Want Advanced Usage?