Page tree
Contents

Description:

Changes a value associated with an existing handle. Only the owner of the handle is able to modify a value and only types of DESC and URL are able to be modified. To obtain available indexes a call to the getHandle service will return all available values and their indexes.

Service Type:

POST

Parameters:

handle (Mandatory)

The handle that is to have one of its values modified.

value (Mandatory)

The new value.

index (Mandatory)

The index of the value to modify. 

Example Request:

URL

https://identifiers.ardc.edu.au/pids/modifyValueByIndex?handle=10378.2/1234&type=DESC&value=Changed Value&index=2

POST Body

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<request name="mint">
    <properties>
        <property name="appId" value="exampleAppID"/>
        <property name="sharedSecret" value="exampleSharedSecret"/>
        <property name="identifier" value="ExampleUser"/>
        <property name="authDomain" value="ExampleAuthDomain"/>
    </properties>
</request>

Example response:

<response type="success">
    <identifier handle="10378.2/12">
        <property index="1" type="URL" value="http://ardc.edu.au" />
        <property index="2" type="DESC" value="Changed Value" />
    </identifier>
    <timestamp>2009-05-15T02:23:01Z</timestamp>
    <message type="user">Successfully modified handle value</message>
</response>

This page has no comments.