Contents

List of Examples

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

1 Introduction

• vDC Management Overview
  • Important Concepts
• How APIs and CLI Work
  • Synchronous Semantic
• Functionality Overview

2 Getting Started

• Prerequisites
• Installation
  • Cloud Infrastructure API
  • Cloud Infrastructure Client Java API
  • Cloud Infrastructure CLI
• Next Steps

3 Managing Resources

• Resources Overview
  • Status of Account Resources
• Managing Account Access
  • Creating an Access Key
  • Viewing Access Key Information
  • Deleting an Access Key
• Viewing vDC Capabilities
• Managing Virtual Networks
  • Creating a vNet
  • Deleting a vNet
  • Viewing vNets Information
• Managing vIP Addresses
  • Allocating a vIP Address
  • Deallocating a vIP Address
  • Viewing vIP Addresses
• Managing Server Templates
  • Uploading a Server Template from a vServer
  • Uploading a Server Template from a URL
  • Uploading a Server Template from an Assembly
  • Deleting a Server Template
  • Viewing Server Template Information
• Managing Storage
  • Creating a Volume
  • Deleting a Volume
  • Viewing Volume Information
  • Attaching a Volume to a vServer
  • Detaching a Volume from a vServer
  • Importing a Volume
  • Creating a Snapshot
  • Deleting a Snapshot
  • Viewing Snapshot Information
• Managing Distribution Groups
  • Creating a Distribution Group
  • Deleting a Distribution Group
  • Viewing Distribution Groups Information
• Managing vServers
  • Viewing vServer Types
  • Creating a vServer
  • Deleting a vServer
  • Viewing vServer Information
  • Stopping a vServer
  • Starting a vServer
  • Rebooting a vServer
  • Sending Messages to a vServer
  • Receiving Message from a vServer
• Managing Key Pairs
  • Creating a Key Pair
  • Importing a Key Pair
  • Deleting a Key Pair
  • Viewing Key Pair Information
• Managing Attributes of an Account Resource
  • Viewing Attributes of an Account Resource
  • Modifying Attributes of an Account Resource
• Managing Tags
  • Creating a Tag
  • Removing a Tag
  • Viewing Tag Information

4 Cloud Infrastructure API Reference

• Web Service Overview
• Cloud Infrastructure API Requests
  • Required Web Service HTTP Request Parameters
  • Signing a Web Service Request
  • Examples of Web Service Requests
• List of Actions
  • AllocateIpAddressesRequest
  • AttachVolumesToVserverRequest
  • CreateAccessKeyAsObjectRequest
  • CreateAccessKeyToFileRequest
  • CreateDistributionGroupRequest
  • CreateKeyPairAsObjectRequest
  • CreateKeyPairToFileRequest
  • CreateSnapshotRequest
  • CreateTagsRequest
  • CreateVnetRequest
  • CreateVolumeRequest
  • DeleteAccessKeyRequest
  • DeleteDistributionGroupRequest
  • DeleteKeyPairRequest
  • DeleteSnapshotRequest
  • DeleteTagsRequest
  • DeleteVnetRequest
  • DeleteVolumeRequest
  • DeregisterServerTemplateRequest
  • DescribeAccessKeysRequest
  • DescribeAccountsRequest
  • DescribeAttributesRequest
  • DescribeDistributionGroupsRequest
  • DescribeIpAddressesRequest
  • DescribeKeyPairsRequest
  • DescribeServerTemplatesRequest
  • DescribeSnapshotsRequest
  • DescribeTagsRequest
  • DescribeVdcCapabilitiesRequest
  • DescribeVnetsRequest
  • DescribeVolumesRequest
  • DescribeVserversRequest
  • DescribeVserverTypesRequest
  • DetachVolumesFromVserverRequest
  • ImportKeyPairRequest
  • ImportVolumeRequest
  • ModifyAttributesRequest
  • RebootVserversRequest
  • ReceiveMessageFromVserverRequest
  • RegisterAccessKeyRequest
  • RegisterKeyPairRequest
  • RegisterServerTemplateFromUrlRequest
  • RegisterServerTemplateFromVserverRequest
  • RegisterServerTemplatesFromAssemblyRequest
  • ReleaseIpAddressesRequest
  • RunVserverRequest
  • RunVserversRequest
  • SendMessagesToVserverRequest
  • StartVserversRequest
  • StopVserversRequest
  • TerminateVserversRequest
• Data Types
  • AccountIdType
  • DescribeAccessKeysResultItem
  • DescribeAccountsResultItem
  • DescribeDistributionGroupsResultItem
  • DescribeIpAddressesResultItem
  • DescribeKeyPairsResultItem
  • DescribeServerTemplatesResultItem
  • DescribeSnapshotsResultItem
  • DescribeTagsResultItem
  • DescribeVdcCapabilitiesResultItem
  • DescribeVnetsResultItem
  • DescribeVolumesResultItem
  • DescribeVserversResultItem
  • DescribeVserverTypesResultItem
  • DistributionGroupIdType
  • FilterItem
  • GenericString
  • Message
  • PositiveInteger
  • ResourceAttribute
  • ResourceIdType
  • SnapshotIdType
  • ServerTemplateIdType
  • TagType
  • URLType
  • VnetIdType
  • VolumeIdType
  • VserverIdType

5 Cloud Infrastructure CLI Reference

• Common Command Options
• List of Commands
  • akm-create-access-key
  • akm-delete-access-key
  • akm-describe-access-keys
  • akm-describe-accounts
  • iaas-allocate-ip-addresses
  • iaas-attach-volumes-to-vserver
  • iaas-create-distribution-group
  • iaas-create-key-pair
  • iaas-create-server-template-from-assembly
  • iaas-create-server-template-from-url
  • iaas-create-server-template-from-vserver
  • iaas-create-snapshot
  • iaas-create-tags
  • iaas-create-vnet
  • iaas-create-volume
  • iaas-delete-distribution-group
  • iaas-delete-key-pair
  • iaas-delete-server-template
  • iaas-delete-snapshot
  • iaas-delete-tags
  • iaas-delete-vnet
  • iaas-delete-volume
  • iaas-describe-attributes
  • iaas-describe-distribution-groups
  • iaas-describe-ip-addresses
  • iaas-describe-key-pairs
  • iaas-describe-server-templates
  • iaas-describe-snapshots
  • iaas-describe-tags
  • iaas-describe-vdc-capabilities
  • iaas-describe-vnets
  • iaas-describe-volumes
  • iaas-describe-vservers
  • iaas-describe-vserver-types
  • iaas-detach-volumes-from-vserver
  • iaas-import-key-pair
  • iaas-import-volume
  • iaas-modify-attributes
  • iaas-reboot-vservers
  • iaas-receive-message-from-vserver
  • iaas-release-ip-addresses
  • iaas-run-vserver
  • iaas-run-vservers
  • iaas-send-messages-to-vserver
  • iaas-start-vservers
  • iaas-stop-vservers
  • iaas-terminate-vservers

A A Web Service Client Example

• Description of Web Service API Requests
  • AKM Request
    • REQUEST_DATA
    • Example of a complete request
  • IAAS Request
    • REQUEST_IAAS_DATA
    • SIGNATURE_BLOCK
    • IAAS Data Used for Signature
• Sending a Web Service Request
  • Using the Web Browser
  • Using WGET
• Creating Public and Private Keys
  • Private Key
  • Public Key
• WebUtil Application Overview
  • How the WebUtil Application Works
• Web Service Request Examples