lhc1748bu vmware cloud for aws and the art of software- or ... · vmc api hierarchy • vmc exposes...

LHC1748BU

#VMworld #LHC1748BU

VMware Cloud for AWS and the Art of Software-Defined Data Centers API CLI and PowerShell

VMworld 2017 Content: Not fo

r publication or distri

bution

• This presentation may contain product features that are currently under development.

• This overview of new technology represents no commitment from VMware to deliver these features in any generally available product.

• Features are subject to change, and must not be included in contracts, purchase orders, or sales agreements of any kind.

• Technical feasibility and market demand will affect final delivery.

• Pricing and packaging for any new technologies or features discussed or presented have not been determined.

Disclaimer

#LHC1748BU CONFIDENTIAL 2



bution

Agenda

• VMC Overview

• API Endpoints for VMC

– REST API - What's in there, how to access etc

– Demo of VMC REST API

• API Endpoints for the SDDC

• SDKs and CLIs

– Where are they and how to use

– Demo of using CLIs

• Demo – Awesome integration demo

CONFIDENTIAL 3



bution

VMC Overview

CONFIDENTIAL 4

AWS Global Infrastructure

VMware Cloud™ on AWSPowered by VMware Cloud Foundation

AWS Global InfrastructureCustomer Data Center

vSphere vSAN NSX

Operational

Management

Native AWS Services

Amazon

EC2

Amazon

S3

Amazon

RDS

AWS

Direct

Connect

AWS IAMAWS IoT

…

…

…

…

vRealize Suite, vSphere Integrated Containers, ISV Ecosystem

vCentervCenter

• ESXi on Dedicated Hardware

• Support for VMs and Containers

• vSAN on Flash and EBS Storage

• Replication and DR Orchestration

• NSX Spanning on-premises and Cloud

• Advanced Networking & Security Services




bution

VMC is Sold as a Service

▪ VMware manages hypervisor and management components

▪ AWS manages physical resources

▪ Customer manages VMs

▪ Customer decides how many VMs to run on vSphereVMworld 2017 Content: Not fo


bution

Restrictive Access Model

▪ No root ESXi access

▪ No VIB installations

▪ No VDS configuration access

▪ No direct management VM access

vSAN Cluster

Managed by

VMwareManaged by Customer

VC NSX … VM VM VMVM Customer

VMware

VM



bution

Automated Cluster Remediation

HOST FAILS, OR PROBLEM IDENTIFIED

NEW HOST ADDED TO CLUSTER.DATA FROM PROBLEM HOST REBUILT, AND/OR MIGRATED

PREVIOUS HOST EVACUATED FROM CLUSTER, FULLY REPLACED BY NEW HOST

1.

2.

3.

vSAN Cluster

vSAN Cluster

vSAN ClusterVMworld 2017 Content: Not fo


bution

Elastic Data Center Network Overview

Management Pool▪ vCenter Server, PSC, NSX Manager

▪ NSX Edge Gateway (MGW)

▪ NSX Logical Switch for management VMs

▪ Firewall and VPN for security

Compute Pools▪ NSX Edge Gateway (CGW)

▪ NSX Logical Switch for workload VMs

▪ Firewall and VPN for security

▪ NAT to connect VMs to the Internet

MGW CGW

Internet

vSAN Cluster

Managed by

VMwareManaged by Customer

VC NSX … VM VM VMVM VM



bution

How do we integrate/automateVMware Cloud on AWS?

CONFIDENTIAL9



bution

API Endpoints for VMC



bution

VMC API Hierarchy

• VMC Exposes three API surfaces that work together to provide end-to-end functionality

– Console, VMC, vCenter

• All APIs adhere to modern API standards

– RESTful

• HTTP Verbs - GET, POST, DELETE, PATCH

– JSON

• Dictionaries with Key – Value pairs

– OAuth

• Authentication tokens as part of the HTTP Header

• Documentation provided inline and online

CONFIDENTIAL 11

console.cloud.vmware.com

vmc.vmware.com

vcenter.{customer}.vmc.vmware.comVMworld 2017 Content: N

ot for publicatio

n or distribution

Key Cloud Console API Endpoints (Orgs & Users)

• console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize

– Authenticate to CSP and retrieve a “csp-auth-token”

• console.cloud.vmware.com/csp/gateway/am/api/orgs/{org id}/users?expand=1

– Display information about all users in an Org

• console.cloud.vmware.com/csp/gateway/am/api/orgs/{org id}/invitations

– Invite a user to an Org

• console.cloud.vmware.com/csp/gateway/am/api/users/{user id}

– Remove a user from an Org

CONFIDENTIAL 12


vmc.vmware.com

vcenter.{customer}.vmc.vmware.com



bution

vmc.vmware.com

vmc.vmware.com

vmc.vmware.com

vmc.vmware.com

VMC API Endpoint

13


VMware Cloud™ on AWSPowered by VMware Cloud Foundation


vSphere vSAN NSX

vCenter

• ESXi on Dedicated Hardware

• Support for VMs and Containers

• vSAN on Flash and EBS Storage

• Replication and DR Orchestration

• NSX Spanning on-premises and Cloud

• Advanced Networking & Security Services


https://vmc.vmware.com/vmc/api• Currently in “Technical Preview” – Send us your feedback!

• API Endpoint available for VMC features such as:

• Create/Remove SDDC

• Add/Remove Host

• List Org Information

• List SDDC Information

• List VMC Tasks

• Available at:

https://vmc.vmware.com/vmc/api

• Accessible via access tokens

• Simple API model

• API Explorer available

• Command Line interface available



bution

https://vmc.vmware.com/vmc/api

VMC API Explorer

14

• API Explorer available at:

https://vmc.vmware.com/swagger/index.html

• Easily browse the API model

• Determine required fields

• Understand the request body

• Detailed parameter information

• List of response messages and examples

• Live “Try it out” feature

• Sample Curl statement after try it out



bution

https://vmc.vmware.com/swagger/index.html

Key VMC API Endpoints (SDDC)

• vmc.vmware.com/vmc/api/orgs/{org id}/sddcs

– Provision an SDDC or display information about all existing SDDCs in an Org

• vmc.vmware.com/vmc/api/orgs/{org id}/sddcs/{sddc id}

– Destroy an SDDC or display detailed information about an existing SDDC

• vmc.vmware.com/vmc/api/orgs/{org id}/sddcs/{sddc id}/esxs

– Provision or destroy a host from an SDDC or display information about all hosts in an SDDC

• vmc.vmware.com/vmc/api/orgs/{org id}/sddcs/{sddc id}/publicips

– Provision a Public IP address for an SDDC

• vmc.vmware.com/vmc/api/orgs/{org id}/sddcs/{sddc id}/dns

– Configure DNS settings for the SDDC

15


vmc.vmware.com




bution

vmc.vmware.com

vmc.vmware.com

vmc.vmware.com

vmc.vmware.com

vmc.vmware.com

VMC API Explorer Demo



bution

17



bution

Demo of CLI Access to VMC



bution

DCLI Demo



bution

API Endpoints for the SDDC



bution

ESXiESXi

vSphere API Interfaces (the big picture)

ESXi

vCenter

vCenter ManagementReporting and Features

SOAP API REST API

SOAP API

vSphere Management SDKs

Perl

.Net

Java

Web Services

Storage Management

ESX Agent Manager

SSO Client

vSphere Storage Policy

vSphere Automation SDK

VMC on AWS

VM Management

VCSA API

Content Library

Tags

REST

Perl

.Net

Java

Python

Ruby

Open Source SDK

pyvmomi (Python)

rbvmomi (Ruby)

govmomi (Go)

Web

Services

Automation / Operator Interfaces

PowerCLI

vCLI

vRealize Orchestrator

VM Management

VCSA API

Content Library

Tags

ESXi Management Reportingand

Features



bution

API Endpoints for the SDDC

• Same as always!

– Use the same tools as you do On-Premises

• Tips for getting started

– Don’t worry about vCenter Management

– Don’t worry about ESX Management

– Remember the deployment folders / resource pools / datastores

22


vmc.vmware.com




bution

3 ways we are focusing on the future

• Easy to use simplified API Model

• Modern API Interfaces (REST)

• CRUD based API Interfaces

• Easy to navigate, full coverage documentation

Simplification

1

• Easy to use API Explorer

• Choice of Development/scripting languages

• Choice of Automation tools

Choice of access

2

• Learn once use anywhere

• Access multiple products

• Transportation of skills

• Community driven samples and sharing

Consistency

3VMworld 2017 Content: N

ot for publicatio

n or distribution

API Explorer

24

• Available at

https://vchostname/apiexplorer

• Navigate REST based APIs for

• vCenter

• Appliance Management

• Tags

• Content Library

• API Query

• Easily understand the API model

• Determine required fields

• Easily understand the request body

• Detailed filter information

• List of response messages and examples

• Live “Try it out” feature

• Sample Curl statement after try it out



bution

https://vchostname/apiexplorer

SDKs and CLIs



bution

Open Sourced vSphere Automation SDKs

26

• Available at

https://vmware.github.io/vsphere-automation-sdk/

• VMware maintained

• Get up and running in less than 5 minutes!

• SDKs for managing vSphere and VMC in

• REST

• Java

• Python

• Perl

• .Net

• Ruby

• Full of samples

• Community contributions welcome



bution

https://vmware.github.io/vsphere-automation-sdk/

What about PowerCLI with VMware Cloud on AWS?

27



bution

How easy it is to build integration with VMware Cloud on AWS?



bution

Demo – Some fun integration

29



bution



bution

lhc1748bu vmware cloud for aws and the art of software- or ... · vmc api hierarchy • vmc exposes...

Documents