Skip to main content

beta_models

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

Overview​

Namebeta_models
TypeResource
Idazure.ai_projects.beta_models

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
blobReferenceobjectCredential info to access the storage account. Required.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_credentialsselectname, version, endpointGet model asset credentials. Retrieves temporary credentials for accessing the storage backing the specified model version.
getselectname, version, endpointGet a model version. Retrieves the specified model version, returning 404 if it does not exist.
list_versionsselectname, endpointList versions. List all versions of the given ModelVersion.
listselectendpointList latest versions. List the latest version of each ModelVersion.
updateupdatename, version, endpointUpdate a model version. Update an existing ModelVersion with the given version id.
deletedeletename, version, endpointDelete a model version. Delete the specific version of the ModelVersion. The service returns 200 OK if the ModelVersion was deleted successfully or if the ModelVersion does not exist.
pending_create_versionexecname, version, endpoint, blobUriCreate a model version async. Creates a model version asynchronously with blob content validation. Returns 202 Accepted with a location header for polling the operation status.
pending_uploadexecname, version, endpoint, pendingUploadTypeStart a pending upload. Initiates a new pending upload or retrieves an existing one for the specified model version.

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
endpointstringThe service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client endpoint parameter. (default: )
namestringName of the model. Required.
versionstringVersion of the model. Required.

SELECT examples​

Get model asset credentials. Retrieves temporary credentials for accessing the storage backing the specified model version.

SELECT
blobReference
FROM azure.ai_projects.beta_models
WHERE name = '{{ name }}' -- required
AND version = '{{ version }}' -- required
AND endpoint = '{{ endpoint }}' -- required
;

UPDATE examples​

Update a model version. Update an existing ModelVersion with the given version id.

UPDATE azure.ai_projects.beta_models
SET 
description = '{{ description }}',
tags = '{{ tags }}'
WHERE 
name = '{{ name }}' --required
AND version = '{{ version }}' --required
AND endpoint = '{{ endpoint }}' --required
RETURNING
id,
name,
artifactProfile,
baseModel,
blobUri,
description,
loraConfig,
source,
tags,
version,
warnings,
weightType;

DELETE examples​

Delete a model version. Delete the specific version of the ModelVersion. The service returns 200 OK if the ModelVersion was deleted successfully or if the ModelVersion does not exist.

DELETE FROM azure.ai_projects.beta_models
WHERE name = '{{ name }}' --required
AND version = '{{ version }}' --required
AND endpoint = '{{ endpoint }}' --required
;

Lifecycle Methods​

Create a model version async. Creates a model version asynchronously with blob content validation. Returns 202 Accepted with a location header for polling the operation status.

EXEC azure.ai_projects.beta_models.pending_create_version 
@name='{{ name }}' --required, 
@version='{{ version }}' --required, 
@endpoint='{{ endpoint }}' --required 
@@json=
'{
"blobUri": "{{ blobUri }}", 
"weightType": "{{ weightType }}", 
"baseModel": "{{ baseModel }}", 
"source": "{{ source }}", 
"loraConfig": "{{ loraConfig }}", 
"description": "{{ description }}", 
"tags": "{{ tags }}"
}'
;