LogicalAssetUpdate()

Update an existing LogicalAsset for a known ContentID.

API URL:

[BaseURL]/Asset/Map/{MediaProfile}/{ALID}

Request Method:

PUT

Request Format

XML type:

• dece:LogicalAsset

Required information:

• LogicalAsset
  • @ALID
  • @ContentID
  • @MediaProfile
  • @AssentStreamAllowed
    • AssetFulfillmentGroup
      • DigitalAssetGroup

Response Format

Status Code:

• HTTP 200

Headers:

• Location: [BaseURL]/Asset/Map/{MediaProfile}/{ALID}

Errors

• AlidNotMatchingWiththeXMLAlid
  • ALID provided in the URI does not match the ALID provided in the XML body
  • HTTP Status Code: 403
• MediaProfileNotMatchingWiththeXMLAlid
  • MediaProfile provided in the URI does not match the MediaProfile provided in the XML body
  • HTTP Status Code: 403
• AssetLogicalIDNotValid
  • Provided ALID is not valid
  • HTTP Status Code: 400
• AssetProfileInvalid
  • Provided MediaProfile is not valid
  • HTTP Status Code: 400
• LogicalAssetAlreadyExist
  • The mapping already exists; The mapping was deleted and cannot be re-created
  • HTTP Status Code: 409
• CreateOrUpdateSeriesOrSeasonLogicalAssetForbidden
  • Cannot create a LogicalAsset for a Series or Season BasicAsset type
  • HTTP Status Code: 403

Example

Update a LogicalAsset

The following example updates an existing LogicalAsset MediaProfile from SD to HD

Sample Request:

PUT [BaseURL]/Asset/Map/urn:dece:type:mediaprofile:hd/urn:dece:alid:org:customer-zero:123456789 HTTP/1.1
Content-type: application/xml; charset=UTF-8
Host: api.uvvu.com

<?xml version="1.0" encoding="UTF-8"?>
<LogicalAsset xmlns="http://www.decellc.org/schema/2015/03/coordinator" xmlns:ns2="http://www.movielabs.com/schema/md/v2.3/md" xmlns:ns3="http://www.w3.org/2000/09/xmldsig#" xmlns:ns4="http://www.w3.org/2001/04/xmlenc#" ALID="urn:dece:alid:org:customer-zero:123456789" MediaProfile="urn:dece:type:mediaprofile:hd" ContentID="urn:dece:cid:org:customer-zero:123456789" AssentStreamAllowed="true">
  <AssetFulfillmentGroup>
    <DigitalAssetGroup>
    </DigitalAssetGroup>
  </AssetFulfillmentGroup>
</LogicalAsset>

Sample Response:

HTTP/1.1 200
Date: [Date]
Content-Type: text/plain
Location: [BaseURL]/Asset/Map/urn:dece:type:mediaprofile:hd/urn:dece:alid:org:customer-zero:123456789
X-transaction-info: [TransactionInfo]

Logical Asset Updated Successfully

See Also

• LogicalAssetCreate()
• LogicalAssetList()
• LogicalAssetGet()
• LogicalAssetDelete()