Registry Data References - Get Blob Reference SAS
Get blob reference SAS Uri.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}/datareferences/{name}/versions/{version}?api-version=2023-10-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
name
|
path | True |
string |
Data reference name. Regex pattern: |
registry
|
path | True |
string |
Name of Azure Machine Learning registry. This is case-insensitive Regex pattern: |
resource
|
path | True |
string |
The name of the resource group. The name is case insensitive. |
subscription
|
path | True |
string |
The ID of the target subscription. |
version
|
path | True |
string |
Version identifier. |
api-version
|
query | True |
string |
The API version to use for this operation. |
Request Body
Name | Type | Description |
---|---|---|
assetId |
string |
Id of the asset to be accessed |
blobUri |
string |
Blob uri of the asset to be accessed |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Success |
|
Other Status Codes |
Error |
Examples
GetBlobReferenceSAS Data Reference.
Sample request
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/registries/registryName/datareferences/string/versions/string?api-version=2023-10-01
{
"assetId": "string",
"blobUri": "https://www.contoso.com/example"
}
Sample response
{
"blobReferenceForConsumption": {
"blobUri": "https://www.contoso.com/example",
"storageAccountArmId": "string",
"credential": {
"credentialType": "NoCredentials"
}
}
}
Definitions
Name | Description |
---|---|
Anonymous |
Access credential with no credentials |
Data |
Enum to determine the DataReference credentials type. |
Docker |
Credential for docker with username and password |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Get |
|
Get |
BlobReferenceSASRequest for getBlobReferenceSAS API |
Get |
BlobReferenceSASResponse for getBlobReferenceSAS API |
Managed |
Credential for user managed identity |
SASCredential |
Access with full SAS uri |
AnonymousAccessCredential
Access credential with no credentials
Name | Type | Description |
---|---|---|
credentialType |
string:
No |
[Required] Credential type used to authentication with storage. |
DataReferenceCredentialType
Enum to determine the DataReference credentials type.
Name | Type | Description |
---|---|---|
DockerCredentials |
string |
|
ManagedIdentity |
string |
|
NoCredentials |
string |
|
SAS |
string |
DockerCredential
Credential for docker with username and password
Name | Type | Description |
---|---|---|
credentialType |
string:
Docker |
[Required] Credential type used to authentication with storage. |
password |
string |
DockerCredential user password |
userName |
string |
DockerCredential user name |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
GetBlobReferenceForConsumptionDto
Name | Type | Description |
---|---|---|
blobUri |
string |
Blob uri, example: https://blob.windows.core.net/Container/Path |
credential | DataReferenceCredential: |
Credential info to access storage account |
storageAccountArmId |
string |
The ARM id of the storage account |
GetBlobReferenceSASRequestDto
BlobReferenceSASRequest for getBlobReferenceSAS API
Name | Type | Description |
---|---|---|
assetId |
string |
Id of the asset to be accessed |
blobUri |
string |
Blob uri of the asset to be accessed |
GetBlobReferenceSASResponseDto
BlobReferenceSASResponse for getBlobReferenceSAS API
Name | Type | Description |
---|---|---|
blobReferenceForConsumption |
Blob reference for consumption details |
ManagedIdentityCredential
Credential for user managed identity
Name | Type | Description |
---|---|---|
credentialType |
string:
Managed |
[Required] Credential type used to authentication with storage. |
managedIdentityType |
string |
ManagedIdentityCredential identity type |
userManagedIdentityClientId |
string |
ClientId for the UAMI. For ManagedIdentityType = SystemManaged, this field is null. |
userManagedIdentityPrincipalId |
string |
PrincipalId for the UAMI. For ManagedIdentityType = SystemManaged, this field is null. |
userManagedIdentityResourceId |
string |
Full arm scope for the Id. For ManagedIdentityType = SystemManaged, this field is null. |
userManagedIdentityTenantId |
string |
TenantId for the UAMI. For ManagedIdentityType = SystemManaged, this field is null. |
SASCredential
Access with full SAS uri
Name | Type | Description |
---|---|---|
credentialType |
string:
SAS |
[Required] Credential type used to authentication with storage. |
sasUri |
string |
Full SAS Uri, including the storage, container/blob path and SAS token |