Skip to main content

recipe_versions

Creates, updates, deletes, gets or lists a recipe_versions resource.

Overview​

Namerecipe_versions
TypeResource
Idnvidia.catalog.recipe_versions

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
idinteger (int64)Deprecated: Please use versionId instead. Unique ID of the version
version_idstringUnique version id. Please use this instead of 'id' (wire: versionId)
accuracy_reachednumber (float)Accuracy this recipe reached (wire: accuracyReached)
batch_sizeinteger (int64)Batch size this recipe was trained with (wire: batchSize)
created_by_userstringId of the user who created this recipe (wire: createdByUser)
created_datestringCreation date in ISO-8601 format (pattern: <code>\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d.\d+Z</code>) (wire: createdDate)
custom_metricsarray (wire: customMetrics)
descriptionstringDescription of the recipe version
gpu_modelstringGPU model and memory (wire: gpuModel)
is_signedbooleanIndicates if the version is signed (wire: isSigned)
malware_scan_datestringScan date in ISO-8601 format (pattern: <code>\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d.\d+Z</code>) (wire: malwareScanDate)
malware_scan_statusstringMalware scan status (NOT_SCANNED, IN_PROGRESS, CLEAN, SUSPICIOUS, FAILED, MALICIOUS) (wire: malwareScanStatus)
memory_footprintstringrecipe size/memory footprint for inference (wire: memoryFootprint)
number_of_epochsinteger (int64)Number of epochs this recipe trained (wire: numberOfEpochs)
other_contentsarray (wire: otherContents)
performancestringText describing performance of the recipe results
policyarray
quick_start_guidestringText with a guide to getting started (wire: quickStartGuide)
release_notesstringText describing this release (wire: releaseNotes)
release_typestringRelease type enum for the artifact version in the product lifecycle. (BETA, GA, EA, FEATURE, PRODUCTION, LTSB) (wire: releaseType)
setupstringText describing recipe setup
statusstringVersion status (UPLOAD_PENDING, UPLOAD_COMPLETE)
storage_versionstringThe storage version i.e. the format the file and their contents are persisted in in object store. Possible values include V1 - for legacy artifact versions with files, V2 - for new artifact versions with blob registry, `` - for artifact versions without any files. (wire: storageVersion)
total_file_countinteger (int64)Total file count (wire: totalFileCount)
total_size_in_bytesinteger (int64)Total size of the recipe in bytes (wire: totalSizeInBytes)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_by_teamselectorg_name, team_name, recipe_name, version_idGet recipe version in team as guest
getselectorg_name, recipe_name, version_idGet recipe version in org as guest
list_by_teamselectorg_name, team_name, recipe_namepage_size, page_number, sort_order, release_typeList recipe versions in team as guest
listselectorg_name, recipe_namepage_size, page_number, sort_order, release_typeList recipe versions in org as guest

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
org_namestring (UTF-8)Organization name
recipe_namestring (UTF-8)Recipe name
team_namestring (UTF-8)Team name
version_idstring (UTF-8)Version ID
page_numberstring (UTF-8)Page number - zero based index
page_sizestring (UTF-8)Page size
release_typestring (UTF-8)Release Type
sort_orderstring (UTF-8)Sort order

SELECT examples​

Get recipe version in team as guest

SELECT
id,
version_id,
accuracy_reached,
batch_size,
created_by_user,
created_date,
custom_metrics,
description,
gpu_model,
is_signed,
malware_scan_date,
malware_scan_status,
memory_footprint,
number_of_epochs,
other_contents,
performance,
policy,
quick_start_guide,
release_notes,
release_type,
setup,
status,
storage_version,
total_file_count,
total_size_in_bytes
FROM nvidia.catalog.recipe_versions
WHERE org_name = '{{ org_name }}' -- required
AND team_name = '{{ team_name }}' -- required
AND recipe_name = '{{ recipe_name }}' -- required
AND version_id = '{{ version_id }}' -- required
;