---
layout: default
navsection: sdk
navmenu: Perl
title: "Examples"
...
{% comment %}
Copyright (C) The Arvados Authors. All rights reserved.

SPDX-License-Identifier: CC-BY-SA-3.0
{% endcomment %}

h2. Initialize SDK

Set up an API client user agent:

<notextile>
<pre><code class="userinput">
use Arvados;
my $arv = Arvados->new('apiVersion' => 'v1');
</code></pre>
</notextile>

The SDK retrieves the list of API methods from the server at run time. Therefore, the set of available methods is determined by the server version rather than the SDK version.

h2. create

Create an object:

<notextile>
<pre><code class="userinput">my $test_link = $arv->{'links'}->{'create'}->execute('link' => { 'link_class' => 'test', 'name' => 'test' });
</code></pre>
</notextile>

h2. delete

<notextile>
<pre><code class="userinput">my $some_user = $arv->{'collections'}->{'get'}->execute('uuid' => $collection_uuid);
</code></pre>
</notextile>

h2. get

Retrieve an object by ID:

<notextile>
<pre><code class="userinput">my $some_user = $arv->{'users'}->{'get'}->execute('uuid' => $current_user_uuid);
</code></pre>
</notextile>

Get the UUID of an object that was retrieved using the SDK:

<notextile>
<pre><code class="userinput">my $current_user_uuid = $current_user->{'uuid'}
</code></pre>
</notextile>

h2. list

Get a list of objects:

<notextile>
<pre><code class="userinput">my $repos = $arv->{'repositories'}->{'list'}->execute;
print ("UUID of first repo returned is ", $repos->{'items'}->[0], "\n");
</code></pre>
</notextile>

h2. update

Update an object:

<notextile>
<pre><code class="userinput">my $test_link = $arv->{'links'}->{'update'}->execute(
        'uuid' => $test_link->{'uuid'},
        'link' => { 'properties' => { 'foo' => 'bar' } });
</code></pre>
</notextile>

h2. Get current user

Get the User object for the current user:

<notextile>
<pre><code class="userinput">my $current_user = $arv->{'users'}->{'current'}->execute;
</code></pre>
</notextile>