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¶
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 identifierVersion
: Release version stringProjectName
/FeedName
/IngredientName
: Location in VDC hierarchyIngredientType
: Type of ingredient (e.g.,IFWI
,BIOS
)
Release Information¶
Description
: User-provided release descriptionReleaseDate
: When the release was createdPublishedAt
: When the release was submitted to VDCPublishedBy
: User who submitted the release
Dependencies & Relationships¶
BaseLine
: Reference release used as foundationDependencies
: List of ingredient releases this release depends onUsedBy
: List of releases that depend on this release
Artifacts & Metadata¶
Milestones
: Associated silicon milestonesPackages
: Files included with the releaseCheckSum
: File integrity verification
Related Commands¶
- Submit release - Upload new ingredient releases
- Bulk submit - Handle multiple releases efficiently
Need Other Operations?¶
- Ingredient commands- Discover and manage ingredients
- Main CLI overview - Complete CLI capabilities
Want Advanced Usage?¶
- Getting started - Essential commands and workflows
Related Documentation¶
- Understanding Releases - Core release concepts
- Release submission - Web-based submission process