.NET asset administration

While using Cloudinary, all your images, videos, and other raw files are uploaded to your Cloudinary account. You can use our Media Library web interface to browse through and manage your uploaded media assets and generated transformations. In addition, you can use methods from the Upload and Admin APIs, which offer methods for managing, organizing, and creating media assets.

  • Upload API methods can be used as needed.
  • Admin API methods are rate-limited.
    You can view the number of hourly Admin API requests allowed by your account plan in the Account page of your console settings.

Upload API

In addition to the upload method, this API includes methods for:

Admin API

A secure API with methods for managing and organizing your media assets, including:

Example

The following .NET command returns the details of an uploaded image according to its public ID (all details are deserialized into an instance of the GetResourceResult class):

Copy to clipboard
var account = new Account(
    "my_cloud_name",
    "my_api_key",
    "my_api_secret");

var cloudinary = new Cloudinary(account);
var getResult = cloudinary.GetResource("sample");

/*
* RESPONSE (GetResourceResult):
* {
*  "public_id":"sample",
*  "format":"jpg",
*  "version":1375283820,
*  "resource_type":"image",
*  "type":"upload",
*  "created_at":"2017-07-31T15:16:53Z",
*  "bytes":759100,
*  "width":1920,
*  "height":1200,
*  "url":"http://res.cloudinary.com/.../upload/v1375283820/sample.jpg",
*  "secure_url":"https://res.cloudinary.com/.../upload/v1375283820/sample.jpg",
*  "next_cursor":"fe2b0ab2d84c668edaa38d9a528884c8",
*  "derived":[
*  {
*    "transformation":"w_10/a_10/png",
*    "format":"png",
*    "bytes":432,
*    "id":"e76bf3dcb7bb81aa7f5a34a5a90ed2b3",
*    "url":"http://res.cloudinary.com/.../upload/w_10/a_10/v1375283820/sample.png",
*    "secure_url":"https://res.cloudinary.com/.../upload/w_10/a_10/v1375283820/sample.png"
*  },
*  {
*    "transformation":"w_100",
*    "format":"jpg",
*    "bytes":3434,
*    "id":"94a81bec64d7ac730febfe84595ff23d",
*    "url":"http://res.cloudinary.com/.../upload/w_100/v1375283820/sample.jpg",
*    "secure_url":"https://res.cloudinary.com/.../upload/w_100/v1375283820/sample.jpg"
*  }]
* }
*/

Asynchronous API methods

Each of the methods in the upload and admin APIs has an asynchronous version for .NET. To call the asynchronous version of a method, append Async to the method name.

For example:

  • the Upload method becomes UploadAsync
  • the Rename method becomes RenameAsync
  • the Destroy method becomes DestroyAsync

The following C# code uses the asynchronous method to upload an image:

Copy to clipboard
var uploadParams = new ImageUploadParams()
{
    File = new FileDescription(@"mypicture.jpg")
};

Task<ImageUploadResult> imageUploadTask = cloudinary.UploadAsync(uploadParams);

var uploadResult = await imageUploadTask;

Note
Asynchronous methods enable asynchronous programming on the client side, so that your main thread is not blocked by tasks that take a long time, and other tasks can run simultaneously (see the Microsoft .NET Programming Guide if you are unfamiliar with asynchronous programming).

Do not confuse asynchronous methods with the async parameter in the upload API, which allows requests to be handled asynchronously by Cloudinary on the server side.

For a full list of the API methods, see the Upload API Reference and Admin API Reference.

✔️ Feedback sent!

Rate this page: