[object Object] Icon

Encoding
Learn how to create, start, manage and modify Encodings

[object Object] Icon

Player
Learn how to create, start, manage and modify Players

[object Object] Icon

Analytics
Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Mon Jan 21 2019

How to setup an Akamai NetStorage Output

OverviewLink Icon

The NetStorage service of Akamai provides many ways to interact with it. The best way from our perspective is to use its HTTP API interface. In this tutorial you will learn how it works and what it needs to obtain proper credentials to create an Akamai NetStorage output in our service.

The biggest advantage is the recilience of HTTP requests and the amount of parallel connections you can leverage compared to FTP transfers, where it is capped to 25 connections for one akamai upload account. The NetStorage HTTP CMS API however doesn't has such limits and is therefore well suited to handle many parallel chunked transfers in a fast and reliable manner.

So lets look into it how you can obtain your credentials for it so you can configure an Akamai NetStorage as an Output for your encodings in our service.

Create/Edit your Akamai Upload AccountLink Icon

Upload accounts can be created in the Backend portal of your Akamai account and are dedicated "user" credentials used to control what and how someone can access your NetStorage and its content. What we are looking into here is how to enable the HTTP Access Method, respectively where you can find the information you need to create an Akamai NetStorage Output in our service.

  1. Login to your Akamai Account at https://control.akamai.com
  2. In the menu click on CONFIGURE => NetStorage => Configuration
  3. In the side bar on the left, click on the Upload Accounts icon

Create a new Upload Account

If you have no upload account available yet, you will have to create one first, please follow this guide in the Akamai documentation.

image

Edit an existing Upload Account

If you already have an upload account that can access the directories you want to transfer your encodings to, you can simply edit this one and grant it permissions to HTTP Access as well. In your Upload account overview you also see the access methods that are already enabled for your existing upload accounts. If the one you want to use already states HTTP, this account can be used already to create an Akamai NetStorage Output in your Bitmovin account.

image

Get your HTTP API credentialsLink Icon

Your Akamai NetStorage HTTP API credentials consist of the HTTP API Key and Username of your upload account.

  • Username - The username is shown in your Upload account overview in the column Upload Account
  • HTTP API Key - This key is used to authenticate against the Akamai NetStorage HTTP API and is shown only when you edit an Upload account
    1. Find your upload account in your overview, click on the three dots on the right side of the row and select Edit.
    2. Find the "Access Method" area. If no key is listed yet, create a new one with a click on Add or Rotate HTTP API Key (1). Then copy the Key (2).

image

Find your NetStorage HTTP API URLLink Icon

This URL is shown in the details view of your Storage Group in the Akamai Backend: Select the "Storage Group" section on the left side (blue cloud symbol), then select the storage group you are using in the list by clicking on it. You will be presented with a view like in the image below. The URL stated next NetStorage HTTP API, is the one you would have to use the host URL when creating an Akamai NetStorage Output in our service.

image

Create an Bitmovin Akamai NetStorage OutputLink Icon

To create a Bitmovin "Akamai NetStorage" Output configuration, that can be used by our encoding service, you need to know the HTTP API Key and Username of your upload account, as well as its Host URL.

Use the Dashboard UI

  1. Select the Encoding menu on the left and go to Outputs.
  2. Click on Create in the upper right corner of the Outputs overview
  3. Select Akamai as Output type and
  4. Enter all required fields (please see the image below)
  5. Click on Create

image

Use an Bitmovin API SDK

Each of our Open API SDK's implements the Bitmovin API, and make it easy to start its integration in your project or use-case. Use them to create reusable output resources to be used for your encodings:

Bitmovin API SDK for Java - Output example
1AkamaiNetStorageOutput output = new AkamaiNetStorageOutput();
2output.setHost(AKAMAI_NETSTORAGE_HTTP_API_HOST); // e.g. xxxxx-nsu.akamaihd.net
3output.setUsername(AKAMAI_NETSTORAGE_USERNAME);
4output.setPassword(AKAMAI_NETSTORAGE_PASSWORD);
5output = bitmovinApi.output.akamaiNetStorage.create(output);

See all available examples for each of our Bitmovin API SDK's in our GH Example Repository.

Give us feedback