Initial addition of the top level README.
Partially implements blueprint initial-docs Change-Id: I205ec57744249de14cfd963c6ed436354b32019e
This commit is contained in:
@@ -8,6 +8,7 @@ EndProject
|
|||||||
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{863F820F-2B49-44FF-A825-A858BFBBD69E}"
|
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{863F820F-2B49-44FF-A825-A858BFBBD69E}"
|
||||||
ProjectSection(SolutionItems) = preProject
|
ProjectSection(SolutionItems) = preProject
|
||||||
AssemblyVersionInfo.cs = AssemblyVersionInfo.cs
|
AssemblyVersionInfo.cs = AssemblyVersionInfo.cs
|
||||||
|
..\README.rst = ..\README.rst
|
||||||
EndProjectSection
|
EndProjectSection
|
||||||
EndProject
|
EndProject
|
||||||
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "OpenStack", "OpenStack\OpenStack.csproj", "{5660F8AA-14D5-4B3B-ADA0-F79A286EF483}"
|
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "OpenStack", "OpenStack\OpenStack.csproj", "{5660F8AA-14D5-4B3B-ADA0-F79A286EF483}"
|
||||||
|
|||||||
39
README.rst
Normal file
39
README.rst
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
OpenStack SDK for .NET
|
||||||
|
======================
|
||||||
|
|
||||||
|
The OpenStack SDK for .NET is an SDK, written for the Microsoft .NET platform, providing developers with what they need to write software against `OpenStack <http://openstack.org/>`_, the open source cloud platform.
|
||||||
|
|
||||||
|
Quick Start Example
|
||||||
|
-------------------
|
||||||
|
The following code will connect to Openstack, and print out all of the containers in the default storage account::
|
||||||
|
|
||||||
|
using System;
|
||||||
|
using System.Linq;
|
||||||
|
using System.Security;
|
||||||
|
using System.Threading;
|
||||||
|
using Openstack;
|
||||||
|
using Openstack.Identity;
|
||||||
|
using Openstack.Storage;
|
||||||
|
|
||||||
|
var authUri = new Uri("https://region.identity.host.com:12345/v2.0/tokens");
|
||||||
|
var userName = "user name";
|
||||||
|
var password = "password";
|
||||||
|
var tenantId = "XXXXXXXXXXXXXX-Project";
|
||||||
|
|
||||||
|
var credential = new OpenstackCredential(authUri, userName, password, tenantId);
|
||||||
|
var client = new OpenstackClient(credential, CancellationToken.None);
|
||||||
|
|
||||||
|
await client.Connect();
|
||||||
|
|
||||||
|
var storageServiceClient = client.CreateServiceClient<IStorageServiceClient>();
|
||||||
|
var storageAccount = await storageServiceClient.GetStorageAccount();
|
||||||
|
foreach(var container in storageAccount.Containers)
|
||||||
|
{
|
||||||
|
Console.WriteLine(container.Name);
|
||||||
|
}
|
||||||
|
|
||||||
|
For more examples see the *OpenStack/Examples* directory.
|
||||||
|
|
||||||
|
Development
|
||||||
|
-----------
|
||||||
|
The `homepage for the development effort <https://wiki.openstack.org/wiki/OpenStack-SDK-DotNet>`_ is on the OpenStack Wiki. The .NET SDK is developed through the same processes as the OpenStack services. `Features requests <https://blueprints.launchpad.net/openstack-sdk-dotnet>`_ and `bugs <https://bugss.launchpad.net/openstack-sdk-dotnet>`_ are filed through launchpad.
|
||||||
Reference in New Issue
Block a user