Get Asset

GET

https://app.mk.io/api/v1/projects/:project_name/media/assets/:asset_name

GET

/api/v1/projects/:project_name/media/assets/:asset_name

curl https://app.mk.io/api/v1/projects/project_name/media/assets/asset_name \
     -H "Authorization: Bearer <token>"

{
  "properties": {
    "storageAccountName": "string",
    "alternateId": "string",
    "assetId": "string",
    "container": "ContainerName",
    "containerDeletionPolicy": "Delete",
    "created": "2024-01-15T09:30:00Z",
    "description": "string",
    "encryptionScope": "string",
    "lastModified": "2024-01-15T09:30:00Z",
    "storageEncryptionFormat": "None",
    "subPath": "path/to/asset"
  },
  "id": "string",
  "labels": {
    "label1": "value1",
    "label2": ""
  },
  "name": "name",
  "systemData": {
    "createdAt": "2024-01-15T09:30:00Z",
    "createdBy": "string",
    "createdByType": "User",
    "internalId": "string",
    "lastModifiedAt": "2024-01-15T09:30:00Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  },
  "type": "string"
}

Get an asset by name.

RBAC Capability Required: ams.asset.get

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

asset_namestringRequired

Response

A single Asset.

propertiesobject

The properties of the asset.

idstringOptionalRead-only

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

labelsmap from strings to stringsOptional

A dictionary of labels associated with the resource.

Maximum number of labels: 32.
Maximum length of a label or value: 256 characters.
Label: alphanumeric, hyphens and underscores.
Value: alphanumeric, hyphens, underscores and spaces.

namestringOptionalRead-onlyformat: "^[^\^\'<>%&:\\?/*+]+$"1-260 characters

The name of the resource

systemDataobjectOptional

Metadata pertaining to creation and last modification of the resource.

typestringOptionalRead-only

The type of the resource. E.g. "Microsoft.Media/mediaservices/assets"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error