Create Dynamic Memory for Vendor ID

Create a new Dynamic Memory file for specified Vendor.

Method Type URI
PUT v90/ws/vendor/{vendorId}/dynamicMemory.ws

URI Parameters

Parameter Description Type
vendorId Identifier of the Vendor in the database. Integer

Sample Request

See Sample XML for Dynamic Memory Web Services. The XML element names are self-explanatory. However, some of the important element are as follows:

NOTE   The XML must comply with the schema provided for Dynamic Memory. (See XSD for Dynamic Memory)

XML Elements Description Type
memoryName (Required) Specify the dynamic memory file name. String
fileId (Required) Specify the file ID. Integer
size

(Optional) Specify the file size in bytes.

>Maximum file size for Sentinel HL key version 4.x keys: 25944 bytes

>Maximum file size for Sentinel HL key version 6.x keys: 65535 bytes per file out of a total memory of 390304 bytes. You can create nearly six dynamic memory files using the maximum file size for each.

>Maximum file size for Sentinel SL keys: 65535 bytes

Integer
action

(Required). Used for dynamic memory file management.
Valid values:

>Set: The new data segment is added to the dynamic memory file. Existing information remains unchanged.

>Overwrite: The new data segment will overwrite the existing information in the file.

>Cancel: The dynamic memory file attached to the specified license is permanently deleted.

 

 

 

String
memorySegment

(Optional) Specify data for the Dynamic Memory.

>offset—(Required) The hexadecimal starting point of the memory segment. Supported range in bytes:

•Sentinel HL key version 4.x keys: 0 to 25943

•Sentinel HL key version 6.x keys: 0 to 65534

•Sentinel SL keys: 0 to 65534

NOTE   The combined value of offset and size must not exceed:

>Sentinel HL key version 4.x keys: 25944 bytes

>Sentinel HL key version 6.x keys: 65535 bytes

>Sentinel SL keys: 65535 bytes

>size—(Required) Size of the segment in bytes. Supported range:

•Sentinel HL key version 4.x keys: 1 to 25944

•Sentinel HL key version 6.x keys: 1 to 65535

•Sentinel SL keys:1 to 65535

>color—Hexadecimal color code.

>name—(Required) The name of the memory segment.

>description—Description for the memory segment.

>saot—Whether the memory data can be defined during Entitlement generation. Valid values: TRUE/FALSE

>content—Specify as a BASE 16 (hexadecimal) encoded string.

Example of memory segment in a Product XML:

<memorySegment>
            <offset>0x0000</offset>
            <size>10</size>
            <color>#9f22bf</color>
            <name>first memory segment</name>
            <description> description for memory segment</description>
            <saot>true</saot>
            <content>memory content</content>
        </memorySegment>
 
memoryType

Specify memory type as:

>1 (Read/Write): Data that can be updated at run-time.

>2 (Read Only): Data to be read at run-time.

>3 (Write Once): Data that can be updated only once at run-time and then is treated as Read Only.

  

Sample Response

Success

HTTP Status Code: 201

Header-Location: {dynamicmemoryId}

Failure

HTTP Status Code: 404

Response Body: The Vendor ID was not found.