LogoLogo
Click to Submit Feedback!
  • Welcome to ASM HERMES!
    • HERMES 10.6.8 Release Notes
      • 10.6.8.14379 AUG 24 MR Release Notes
      • 10.6.8.14627 SEPT 24 MR Release Notes
      • 10.6.8.14701 OCT 24 MR Release Notes
      • 10.6.8.14800 OCT 24 2 MR Release Notes
      • 10.6.8.14879 NOV 24 MR Release Notes
      • 10.6.8.14901 N0V 24 2 MR Release Notes
      • 10.6.8.15038 DEC 24 MR Release Notes
      • 10.6.8.15097 JAN 25 MR Release Notes
      • 10.6.8.15121 JAN 2 25 MR Release Notes
      • 10.6.8.15289 FEB 25 MR Release Notes
      • 10.6.8.15348 FEB 2 25 MR Release Notes
      • 10.6.8.15509 MAR 25 MR Release Notes
      • 10.6.8.15572 APRIL 25 MR Release Notes
    • HERMES 10.6.9 RC Release Notes
      • 10.6.9.14735 OCT 24 RC Release Notes
    • ASM Video Library
  • ITSM Solutions
    • Example Solutions - Best Practices for a Successful Outcome
      • Managing Changes to your ASM Application
      • Business Continuity Planning
      • Capacity Planning
      • Change Management
        • Planning Change Management
        • Build Your Workflow
      • Dynamic Ticket Routing
      • Environmental Impact Analysis (for TBL Accounting)
      • Knowledge Management
        • Planning Knowledge Management
      • Major Incident Management
        • Configure Major Incident Management
        • Allow Users to Subscribe to MI
      • Project Management
        • ASM Project Management How-To Videos
      • Service Validation and Testing
        • Example Configuration
      • User Survey Systems
        • Planning and Implementing Surveys
        • Survey Fields and Configuration
      • Workforce and Talent Management
        • Example Configuration
      • 2-Part Call Close Process
      • Incident Management
        • Planning Your Incident Management Implementation
        • Setup IPK Management
        • Build Screens to Support IPK
  • Use ASM
    • About the Alemba Service Manager Family
      • URLs and Access Parameters
        • System Access URLs
        • ASM Self Service Portal URLs
        • Pre-Populating Search Fields
    • Using the Self Service Portal
      • Logging on to Self Service Portal
        • Forgotten User ID and Password (Self Service Portal)
        • Password Expiry
      • Self Service Portal Home Page
      • Self Administration in Self Service Portal
        • Updating Your Contact Details
        • Changing Your Password
        • Delegating Work
      • Logging and Reviewing Tickets and Tasks/Approvals
        • Using the Logging Forms in Self Service Portal
        • Suggested Knowledge in the Self Service Portal
        • Reviewing Your Tickets in the Self Service Portal
          • Cloning Tickets in Portal
          • Chasing Ticket or Request
        • Off-Line Conversations with Support
        • Closing Your Tickets
        • Reopening Your Tickets
        • Cloning Your Tickets
      • Following Tickets
      • Self-Help/Self-Diagnosis in Portal: Scripts
      • Searching the Knowledge Bank in Self Service Portal
      • Chat
        • Alembot - Chatbot
      • Service Request Catalog
      • Your Surveys
    • Using Nano
      • Nano Feature List
      • NANO Video Tutorial - Quick Start
      • Nano Application
        • Viewing Your Workload in NANO
        • Viewing Bulletins
        • Nano Matching Panel
        • Using the Call, Request, and Task Details window
        • Working with Entities in Nano
          • Followers
        • Using Resource Manager in NANO
        • Viewing Your Outstanding Tasks
        • Keyboard Shortcuts
    • Using ASM Core
      • Getting Started
        • The ASM Core Window
          • The Information Panel
          • The View Option
          • The New Option
          • Configuring search results
        • Changing your Password
        • Generating an ASM statistics report
        • Printable Reports from within Core
        • Searching for Items
          • Using Wildcards in Search
          • Outstanding Item Searches
          • Saved searches
          • Viewing Search Results in Graphs
          • Creating Reporting Views from Search Results
        • Indicators - Icons
      • View Your Consolidated Workload
      • Viewing Daily Stats
      • Chat
      • Managing Followers
      • Managing Your Tickets - Calls and IPK
        • Working with Calls
          • About the Call Details Window
          • Cloning Option
          • Log New Request from Call
          • Watch Call
          • Change a Call from an Incident to a Problem, Known Error, Major Incident, or Service Request
          • About the Service Window
          • About the Call Information Panel
          • About the Matching Panel
          • Add Notes - Updating Your Tickets
            • Notes: Offline Conversations with the User
          • Managing and Using Call Activities
          • Assigning Work Based on Skills
        • Call Details Explorer Options
          • Call Activities Explorer Option
          • Linking Explorer Option
          • Forum Analysts Explorer Option
          • AI Ops Explorer Option
          • Viewing Event Transactions from a Call or Request
          • Email All Explorer Option
        • Overview of CTI in Alemba Service Manager
          • Storing Telephone Numbers for CTI
        • Logging a Call
        • Using Quick Solutions
        • Using Quick Forms
        • Deferring a Call
        • Reassigning/Forwarding a Call(s) Internally
        • Forwarding a Call Externally
        • Creating an Outage from a Call
        • Closing a Call
        • Global Updates
        • User Chased Tickets
        • Escalating Tickets
      • Sending Ad-Hoc Surveys
      • Requests and Tasks
        • Viewing your Request Workload
          • Viewing Outstanding Requests
          • Searching for Requests
        • Submit a New Request
        • Escalate a Request
        • Searching for Tasks
        • Suspending a Task
        • Completing a Task
        • Sending email from a task
        • Forwarding a Task Internally - Reassignment
        • Completing an Approval
        • Managing Change Calendars
        • Managing Resources
          • Preparing to Use Resource Manager
          • Using Resource Manager
          • Allocating Tasks in Resource Manager
      • Ordering Service Actions within ASM Core
      • Adding Attachments
      • Managing your CMDB
        • Managing CMDB Items
          • Cloning CMDB Items
          • Completing CMDB Item Details
          • CMDB Linking Diagram
          • Freezing CMDB Items
          • Linking CMDB Items
        • Managing Your Assets
          • Managing Inventory Items
          • Managing Software Products
          • Thresholds Explorer Option
          • Managing Transactions
            • Purchasing Items
            • Reserving Items
            • Allocating Items
            • Transferring Ownership of Items
            • Retiring Items
            • Changing Availability Status of Items
            • Adding an order from a search field
          • Specifying Usage Criteria
        • Managing your Service Portfolio
          • Managing Services
          • Managing Service Actions
            • Defining the Outcome of Selecting a Service Action
          • Managing Service Bundles
        • Managing Organizations
        • Managing Locations
        • Managing Cost Centers
        • Managing Jurisdictions
        • Managing Subscriber Groups
        • Managing Stakeholders
        • Options in the CMDB Items Explorer Pane
        • Allocating Change Windows to CMDB Items
        • Managing People
        • Managing Contracts
        • Managing Availability
          • Managing Outages
          • Impact Criteria
          • Displaying Outages
        • SLM - Managing Agreements
          • Defining Agreement Thresholds
          • Linking Service Items to an Agreement
          • Attaching Selection Criteria to Agreements
          • Agreement Measurements
      • Configuring AI Ops
        • Using the AI Ops Wizard
        • Managing AI Ops Rules
      • Knowledge Management
        • Managing Knowledge Entries
        • The Knowledge Bank Explorer
        • Viewing Knowledge Entries
        • Knowledge Administration
      • Configuring Reminders
      • Using IPK Workflow Rules
        • Part 1 - Building the Workflows
        • Part 2 - Defining Workflow Criteria Rules
          • Defining Call Fields for IPK Rules
        • Part 3 - Assigning Workflows to Rules
        • Configuring Call Auto Close Rules
        • Running Multiple Workflow Types on a Call
      • The Bulletin Board
        • Viewing Bulletins
        • Managing Bulletins
      • Using Timesheets
      • Scheduling Calls and Requests
      • Using Quick Forms
      • Using Call Scripts in Core
      • Instant Messaging/Internal Messages
      • Sending an Email
        • Finding Recipients
      • Delegation Setup
      • Purging Data
  • SetUp & Configure ASM
    • Licensing
      • Licensing model
      • ASM Person Licenses
    • Installation and Patching
      • Alemba Service Manager On-Premise Architecture
      • HERMES Installation Guide
        • HERMES Prerequisites
        • Upgrading/Installing ASM to HERMES Step by Step Guide
      • Installation PowerShell Parameters
        • Administration Using PowerShell Scripts
      • Installation Guide for Syncfusion Dashboards
        • Part 1-Syncfusion Dashboard Server Installation
        • Part 2-Syncfusion Server Check HTTPS Binding has been Configured
        • Part 3-Syncfusion Server User Management Server (UMS) Configuration
        • Part 4-Syncfusion Server Configure the Dashboard Server
        • Part 5-Syncfusion Server Patching the Scheduler Service
      • Upgrading from vFire 9.2 or Below
      • Installing and upgrading on Multiple Web Servers
      • Patching where downloading files is not possible
        • Installation Using Setup.exe
      • Configuring external network access to ASM
      • About the Polling Services
      • Uninstalling ASM Core
    • Setting Up your System
      • On-Premise: System Console Configuration Settings
      • Logging in as Administrator
      • ASM Nano
        • Enabling Nano
        • Request Phases
      • Setup IM (Internal Messaging)
      • Setup Email
        • Setting Up Incoming and Outgoing Email
          • Email Server Configuration
          • Methods of Authentication for Mail Servers
          • Incoming Email
            • Recognized Incoming Email Subject Headings
            • Incoming POP3, and IMAP Email Server Settings
            • Incoming Email via API
            • How the Logging Analyst is Determined on an Incoming Email
          • Outgoing SMTP Email Server Settings
          • Outgoing Email via Webhooks
          • Configure Azure MS Graph API
          • Configuring Exchange Web Services (EWS)
            • Prerequisites
              • Web Redirect URL Configuration
              • Creating an Azure Client Secret
            • EWS - Configure Outgoing Email
            • EWS - Configure Incoming Email
            • EWS - Authorize the Connection
            • EWS - Troubleshooting
        • Mail Message Access (MMA)
      • Setup Chat
    • Configuring your System
      • Accessibility Features
      • ASM Solutions
      • Call Template Administration
      • Configuration Post Go-Live
        • Preparing Production for Sys Admins and Developers
        • ASM Application Configuration Change Management
          • ASM Application Configuration Change Screens
          • ASM Application Change Workflow Template
      • Configuration Post Go-Live using SDLC
      • Configuring Escalations and Chase
      • Configuring the Data Purge Service
      • Configuring Screens
        • Creating New Screen Sets
        • Screens Available for Configuration using ASM Designer
        • Building Screens in ASM Designer
          • Configuring Fields
          • Creating a Custom Field
          • Deleting & Unlinking Fields
            • ASM System Fields for Call Screens
            • ASM System Fields for Request Screens
            • ASM System Fields for Task Screens
            • ASM System Fields for Approval Screens
            • ASM System Fields for CMDB Item Screens
          • Screen Widgets
            • Data-Grid Widgets
            • Self Service Portal System Widgets
          • Knowledge Article Screens
          • Configuring Message Templates
          • Importing/Exporting Screens
          • Troubleshooting Screens: The Screen's Dead Zone
        • Dynamic Screens
          • Deep Linking Field Data Across Screen Sets
          • Field Calculations
          • Using Rules
          • Adding Images and Progress Indicators to your screens
        • Deleting a Custom Screen
        • Configuring Button Labels
      • Conversation History Widget For Nano
      • Customizing Options for the Self Service Portal
        • Add Me: Set up "Add-Me" for Subscribing to or Following Issues
        • Styling the Self Service Portal
        • Enable Request Correction and Resubmission
      • System Administration Settings
        • Custom Global Profile Fields
        • System Settings Menu
          • Your Organization
          • Partitioning
            • Configuring Partitions
            • Partition Settings
          • System Settings
          • Security Profiles
          • Server Time Zone
            • Storing Time Zone Information
            • Time Zone Settings
          • Defining Working Hours
          • Defining public holidays
          • Reset References
          • System Source Titles
          • Browse Limits
          • Messaging
          • Message Types
            • Message Type Definitions
          • Pager Settings
          • Pager Types
          • Activity Log
          • Stored Procedures
          • System Titles
          • Quick Launch
          • Quick Notes
          • Auditing
            • Administration Audit Trail
          • User and Analyst Search Field Settings
          • Email Header and Footer
        • Security
          • Security Settings
          • Security Settings (Partitioned)
          • IPK Groups
          • Workflow Management Groups
          • Controlling log in
          • Email and Pager Options for IPK and Workflow Groups
        • Security Roles
          • General Access Security Role
            • Admin Tab
            • Timesheets Tab
          • IPK Management Security Roles
            • IPK Management Role: Options Tab
            • IPK Management Security Role: Groups Tab
            • IPK Management Security Role: IPK Streams Tab
            • IPK Management Security Role: IPK Statuses Tab
            • IPK Management Security Role: Forms Tab
            • IPK Management Security Role: Quick Launch Tab
            • IPK Management Security Role: Fwd Groups Tab
          • Workflow Management Security Roles
            • Workflow Management Security Role: Shared Tab
            • Workflow Management Security Role: Requests Tab
            • Workflow Management Security Role: Tasks Tab
            • Workflow Management Security Role: Processes Tab
            • Workflow Management Security Role: Groups Tab
            • Workflow Management Security Role: Request Screen Sets Tab
            • Workflow Management Security Role: Task Screen Sets Tab
            • Workflow Management Security Role: Appr. Screen Sets Tab
            • Workflow Management Security Role: User Approval Screen Sets Tab
            • Workflow Management Security Role: External Supplier Screen Sets Tab
            • Workflow Management Security Role: Closure Task Screen Sets Tab
            • Workflow Management Security Role: Forms Tab
            • Workflow Management Security Role: Template Tab
            • Workflow Management Security Role: Request Quick Launch Tab
            • Workflow Management Security Role: Task Quick Launch Tab
          • Configuration Management Security Roles
            • Configuration Management Security Role: CMDB Items Tab
            • Configuration Management Security Role: People Tab
            • Configuration Management Security Roles: Organizations Tab
            • Configuration Management Security Role: Locations Tab
            • Configuration Management Security Role: Contracts Tab
            • Configuration Management Security Role: Subscriber Groups Tab
            • Configuration Management Security Role: Cost Centers Tab
            • Configuration Management Security Role: Jurisdictions Tab
            • Configuration Management Security Role: Forms Tab
          • Service Level Management Security Roles
            • Service Level Management Security Role: Options Tab
            • Service Level Management Security Role: Forms Tab
          • Availability Management Security Roles
          • Knowledge Management Security Roles
            • Knowledge Management Security Role: Options Tab
            • Knowledge Management Security Role: Content Access Tab
            • Knowledge Management Security Role: Statuses Tab
          • Bulletin Board Security Roles
          • Dashboard Management Security Role
          • Integration Security Role
        • IPK and Workflow
          • Incident, Problem & Known Error (IPK) Management
            • Configuring IPK Settings
            • IPK Settings (Partitioned)
            • Action Type
            • Call Attributes
            • Call History Types
            • Call Impact
            • Call Physical Statuses
            • Call Priority
            • Call Screen Sets
            • Stakeholder Roles
            • Call States
            • Call Status Titles
            • Call Urgency
            • Closure Groups
            • Custom Call Profiles
            • User Survey
            • User Survey Screen Set
            • IPK classes
            • IPK Streams
            • IPK Statuses
            • Link Stream/Status to Call Screen Set
            • Link Type/Stream/Status to Call Screen Set
            • Link Screen Set to Reasons
            • Link Type to Reason
            • Limit Type by IPK Status
            • Link Type to Call Screen Set
            • Priority Matrix
            • Quick Forms
            • Quick Solutions
            • Reasons
            • Call Scripts: Scripting
            • Type Tiers
          • Workflow Management
            • Workflow Management Settings
            • Workflow Attributes
            • Approval Types
            • Request Action Types
            • Request Implementation Profiles
            • Request Implementation States
            • Request Link Types
            • Request Physical Statuses
            • Request Phases (Nano)
            • Request Priority
            • Request Risks
              • Request Risk Assessment
              • Request Impact
              • Request Complexity
              • Request Risk Assessment Matrix
            • Screen Sets for Requests, Tasks and Approvals
            • Request Stakeholder Roles
            • Request Completion Statuses
            • Request Types
            • Task Action Types
            • Task Phases
            • Task Physical Statuses
            • Task Priority
            • Task Status Titles
            • Task Types
            • Workflow Management History Types
            • Request History Filters
            • Workflow Processes
            • Workflow Export and Import - Workflow Porting
            • Linking Approval Screens to Partitions
        • Service Level Management
          • SLM Settings
          • Agreement Attributes
          • Agreement Selection Priority
          • CMDB Selection Priority
          • Agreement Stakeholder Roles
          • Agreement Statuses
          • Exclusion Reasons
          • Agreement Types
          • Event Activity Types
          • Agreement Matrices
          • Measurement Types
          • Payment Types
        • CMDB (Configuration Management Database)
          • CMDB Settings
          • CMDB Service Levels
          • CMDB Item Classes
          • CMDB Item Criticality
          • CMDB Item Physical Statuses
          • CMDB Item Types
          • CMDB Link Status
          • CMDB Link Types
          • Contract Support Type
          • Contract Types
          • Cost Center Category
          • Custom CMDB Profiles
          • Person Profile
          • External Contact Type
          • User VIP Statuses
          • Disposal Methods
          • Financial Statuses
          • Financial Category
          • Freeze Statuses
          • Link Manufacturer to Model Type
          • Manufacturers
          • Model Types
          • Organization Profiles
          • External Supplier Statuses
          • Purchase Method
          • Service Link Types
          • Service Portfolio Statuses
          • Service Cost Types
          • Service Periods
          • Asset Management - Asset Lifecycle Status
          • Asset Management - License Type
          • Asset Management - Transaction Status
          • Self Service Portal Display Categories
          • Stakeholder Roles
          • Auditing Configuration Items
        • Availability
          • Configuring Availability Management
          • Outage Types
          • Schedule Definition
        • Depreciation
          • Batch Run Parameters
          • Depreciation by CMDB Item Type
          • Depreciation Methods
          • Depreciation Schedules
        • Knowledge Bank
          • Knowledge Bank Settings
          • Knowledge Base Types
          • Knowledge Entry Types
          • Knowledge Profiles
          • Knowledge Ratings
          • Knowledge Statuses
          • Knowledge Document Import
        • Bulletin Board
          • Configuring the Bulletin Board
          • Bulletin Board Priorities
          • Bulletin Stakeholder Roles
        • Text Retrieval
          • Common Words
          • Keywords
          • Synonyms
        • Analytics
          • Analytics Settings
          • Classic Syncfusion Dashboard Server Configuration
        • Self Service Portal
          • Self Service Portal Settings
          • Self Service Portal Settings (Partitioned)
          • Self Service Portal Roles
            • Options Tab
            • CMDB Tab
            • Content Access Tab
            • Workflow Templates Tab
            • Call Templates Tab
            • IPK Status Tab
            • Dashboard Management Tab
          • Self Service Portal Systems
          • Self Service Portal My Options
          • Self Service Portal Tables
          • Service Order Status Titles
          • Question Mappings
          • Catalog Promoted Items
          • Suggested Knowledge in the Self Service Portal
          • Creating Custom Pages
          • Link Organization to Portal Key
        • Nano
        • Preview Features/Advanced Options
          • Settings
            • Multi Language
              • Languages
                • Portal Label Language Updates
                • Service Title Language Updates
            • Call Activities
            • Enable Active Directory Mappings to Sub Groups
            • CTI
              • Setting up the Alemba Service Manager CTI
            • SignalR Scale Out Options
            • External Chat tool Integrations
          • Portal Settings
          • Global Search
          • Chat Bot
      • Workflow Template Administration
        • Basic Process for Building a Workflow
          • Task List for Workflow (Request Template) Creation
            • Create a Service Action and Attach a Workflow to it
        • Managing Tasks - Adding Tasks to the Dependency Diagram
          • About Tasks - General
          • Task Types in the Task Palette
            • Defining Request Start Details
            • Creating a Standard Task
            • Create Request Task
            • Creating an Approval Task
            • Creating a User Approval Task
            • Conditional Branching Tasks
              • Defining a Dependency Rule
              • Defining Dependency Actions
            • Creating a Messaging Task
            • Creating a Delay Task
            • Creating a Manage CMDB Task
              • Recursive CMDB Task
              • Adding Transactions to a Manage CMDB task
              • Asset Management Transactions in a Manage CMDB Task
              • Mapping Fields to be Updated by a Transaction
            • Creating an Outbound Action Task
            • Creating an SLM Start Clock/Stop Clock Task
            • Creating an External Supplier Task
            • Creating a Run External Procedure Tasks
            • Creating a Change Window Task
            • Creating a Closure Task
            • Creating an Activation Task
        • Component Workflows
        • Setting Up Amendable Requests
        • Troubleshooting Workflow and Service Action Linking
        • Sharing Parent Request Items with Child Requests
    • Dashboards and Reporting
      • Dashboard Configuration and User Learning Guide
      • Descriptions of Default Reports and Dashboards (SDI Classifications)
        • 8.3 Number of Incidents and Service Requests
        • 8.4 Average Time to Respond
        • 8.6 Average time to resolve incidents or fulfill service requests
        • 8.7 First Contact Incident Resolution and Request Fulfilment Rate
        • 8.8 First Level Incident Resolution and Request Fulfillment Rate
        • 8.9 Reopned Incident Rate
        • 8.10 Backlog Management
        • 8.11 Percentage of hierarchic escalations
        • 8.21 Percentage of Functional Escalations copy
        • 8.23 Average incident resolution time by priority
        • 8.24 Average request fulfilment time by priority
        • 8.25 Average resolution time by incident category
        • 8.26 Average fulfilment time by service request type
        • 8.27 Comparison of service level targets to performance
        • 8.28 Service Desk Knowledge Usage
        • 8.29 Customer Facing Knowledge Usage
        • 8.30 Service Desk Knowledge Quality and effectiveness
        • 8.31 Customer facing knowledge quality and effectiveness
        • 8.33 Monitoring Incidents caused by changes measured against target
        • 8.34 Total cost of service delivery
        • 8.35 Average cost per incident by channel
        • 8.36 Average cost per service request by channel
        • 8.43 Problem records created through proactive problem management
        • 8.44 Incident reduction through problem management
      • Install SDI Reporting Pack
      • Dashboards and Reports (.sydx Files)
      • Connecting to Other Data Sources
      • Sample SQL Queries
      • Migrating your Syncfusion Dashboards to a New Server
    • FAQ
      • Limited Support/End of Life Capabilities
        • Configuration Portability
          • Overview & Best Practices
          • Porting Configuration Data
          • Viewing the Export and Import Logs
        • Server Console
          • Accessing the Server Console
          • Creating a New ASM System
          • Server Console system tasks
          • Customization nodes
          • SQL Server and Table Ownership
          • Updating Scripts
          • ASM Core Registry Keys
        • Concurrent Licensing
          • License Corrals
        • Alemba Classic API
          • Programming with the Classic API
            • WCF Client
          • Code Examples
          • Return Values
          • API Message Types
          • API Lookups
          • API Transactions
            • Availability Transactions
            • Call Transactions
            • CMDB Item Transactions
            • Contract Transactions
            • Cost Center Transactions
            • Jurisdiction Transactions
            • Location Transactions
            • Organization Transactions
            • Person Transactions
            • Subscriber Group Transactions
            • Knowledge Transactions
            • Bulletin Transactions
            • System Transactions
              • Session Transactions
              • Add Note Transactions
              • Attribute Transactions
              • Development Transactions
              • Message Transactions
              • Object Transactions
              • Stakeholder Transactions
            • Workflow Transactions
              • Workflow (Request) Transactions
              • Task Transactions
          • API Classes
          • API WSTester Application
      • Configuration or Customization
  • Integrate
    • Integration Overview
    • Managing Integration
      • Setting Up the Integration Platform
        • Defining Connectors
        • Defining Sources
        • Configuring an Integration Source
        • Resource Mapping
        • Defining Property Transforms
        • Defining Profile Maps
        • Defining Resolution Rules
        • Defining Link Type Mapping
      • Single Sign-On using SAML
        • Integrated Security vs. Single Sign On
        • Technical and Access Requirements
        • Configuring ASM for Single Sign-On
        • Importing Identity Provider Metadata
        • Service Provider Signing Certificate
        • Configuring the Service Provider
        • Exporting Service Provider Metadata
        • Importing Service Provider metadata into the Identity Provider
        • SSO Troubleshooting
        • SSL Binding
        • Creating a Self Signed Certificate
        • Extending the Single Sign-On Connector
      • Configuring Azure Active Directory discovery
      • Azure Multi-factor Authentication
      • Viewing Integration Activity
        • Viewing Integration Log
      • Connectors to ASM Core
        • Connector Matrix
        • Installing Connectors
        • CMDB Connectors
          • Altiris Network Discovery Connector
          • CA Cohesion Connector
          • Centennial Discovery/FrontRange Connector
          • EMC Smarts NCM Connector
            • Service Assurance Manager Connector
          • LANDESK Connector
          • Microsoft Azure Connector
          • Microsoft SCOM Connector
          • Microsoft SMS and SCCM Connector
          • Snow Connector
          • SolarWinds Connector
          • VMware Application Discovery Manager Connector
          • VMware vCenter Configuration Manager Connector
          • VMware vCloud Director Connector
          • vRealize Orchestrator Connector
        • LDAP Connectors to ASM Core
          • Microsoft Active Directory Server Connector
          • Novell eDirectory Server Connector
        • Generic Connectors to ASM Core
          • Email Event Connector
          • External Process Connector
          • Stored Procedure Connector
          • ASM to ASM Connector
          • Jira Connector
            • Developer Notes for the Jira ICNF
          • CSV File Connector
          • MS Azure DevOps Connector
          • Connector Suite for MS SQL Server Tables
          • Resource Databases Connector
            • Tutorial for Configuring the Database Resources Connector
        • Microsoft Alemba ITSM Connector
      • Build your Own Connector
        • Microsoft Entra ID (Azure Active Directory) - Connector Builder
        • Microsoft Intune - Connector Builder
      • Managing the Federated CMDB
        • Managing Scheduled Integration Scans
        • Auditing Configuration Items
      • Managing External Resources
      • Selecting Fields for Mapping
      • Managing Inbound and Outbound Actions
        • Configuring Inbound and Outbound Actions
          • Configuring Outbound Actions
            • Using Outbound Actions
          • Configuring Inbound Actions
        • Inbound or Outbound Action Source Parameters
      • Managing Events
        • Configuring Event Management
          • Event Management Source Parameters
          • Viewing Event Types
          • Managing Event Type Mappings
        • Using Events
      • Webhooks
        • Webhook Payloads
      • Canvas App Widgets
      • Microsoft Teams Chat Integration
      • Microsoft Project Integration
      • Connector Diagnostics
    • API's
      • Alemba RestFul API
        • Alemba API Architecture
        • Installing the Alemba API
        • Logging In to the Alemba API Explorer
        • Navigating the Alemba API Explorer
        • Alemba API Programmers’ Guide
        • Alemba API Programmers' Cookbook
          • Recipes
        • Alemba API Related Database Tables
        • Using API Reporting Views
        • Authentication
          • Configuring Authentication for the Alemba API
          • Configuring Windows Authentication for the Alemba API
          • Configuring Single Sign On using SAML for the Alemba API
      • Azure/ Web API/Logic Apps
      • ASM API Quick Reference Guide
        • Getting Started: The ClientId
        • Postman for Testing
        • Search for Existing Calls
        • Locking and Updating Calls
        • Creating New Calls
  • Earlier Versions of ASM
Powered by GitBook
On this page
  • Functionality
  • Use Case Scenario
  • Connector Description
  • Connector Install Process
  • Connection Parameters
  • URL
  • Login ID and Password
  • Federated CMDB Population
  • Resource Types
  • Link Types
  • User Import
  • Outbound Action Types
  • Instantiate vApp
  • Provision Organization
  • Set vApp Network
  • Customize Virtual Machines
  • Update VM Capacity
  • Make VM Names Unique
  • Insert Disk
  • Profile “Bus Sub Types”
  • Remove Disk
  • Deploy a vApp or Virtual Machine
  • Undeploy a vApp or Virtual Machine
  • Power On a vApp or Virtual Machine
  • Power Off a vApp or Virtual Machine
  • Reset a vApp or Virtual Machine
  • Suspend a vApp or Virtual Machine
  • Discard Suspended State
  • Shutdown a vApp or Virtual Machine
  • Reboot a vApp or Virtual Machine
  • Clone a vApp
  • Compose a Blank vApp
  • Merge vApp
  • Renew a vApp
  • Share a vApp
  • Delete a vApp
  • Create an Organization
  • Update an Organization
  • Delete an Organization
  • Create an Organization User
  • Update an Organization User
  • Delete an Organization User
  • Delete an Organization Network
  • Create an Organization vDC
  • Update an Organization vDC
  • Delete an Organization vDC
  • Change Ownership of a vApp
  • Update VM Network Connection
  • Create Organization Network - Bridged
  • Create Organization Network - Isolated
  • Create Organization Network - Routed
  • Rename VM
  • Create an Organization Network Firewall Rule
  • Delete an Organization Network Firewall Rule
  • Create an Organization Network NAT Rule
  • Delete an Organization Network NAT Rule
  • Security and Certificates
  • Installing a Security Certificate
  • Security Certificate Warnings
  • Example of VMware vCloud Director Certificate Installation

Was this helpful?

  1. Integrate
  2. Managing Integration
  3. Connectors to ASM Core
  4. CMDB Connectors

VMware vCloud Director Connector

This section of the documentation contains the technical specifications of the ASM Core - VMware vCloud Director connector, which allows you to perform Cloud Provisioning and IT Service Management.

Alemba is currently reviewing and updating the whole of the connector section, including all subsections. Expect this section to be updated by end of June, 2025.

This section of the documentation contains the technical specifications of the ASM Core - VMware vCloud Director connector, which allows you to perform Cloud Provisioning and IT Service Management functions against business services deployed on cloud based infrastructure managed by VMware vCloud Director.

The documentation describes the details of the VMware vCloud Director connector including:

  • The supported versions of VMware vCloud Director

  • The name of the .NET assembly file

  • The connection methodology

  • The resource and link types that can be discovered and the attributes of each resource and link type

  • The events that are generated and the attributes passed with those events.

  • The actions that can be called from ASM Core to be implemented into VMware vCloud Director.

For compatibility and version support details, refer to the ASM Connector Matrix.

You should familiarize yourself with the information in Installing Connectors before installing any connectors, and read the Integration topics for more information on how to configure them.

Functionality

The vCloud Director connector allows organizations to:

  • Drive actions on cloud based resources and applications as part of a Service Request or Change Management process, or Release Management process.

  • Discover cloud based resources into the ASM Core Federated CMDB, including:

    • Organizations

    • Catalogs

    • vApp Templates

    • vApps

Use Case Scenario

The connector can be used to support following use cases:

  • Cloud Provisioning

  • Incident Classification

  • Asset Management.

  • Change/Release Management

  • Request Fulfilment

Possible use cases and recommendations are provided further in this document.

Connector Description

The table below provides a description of the VCloud Director Connector.

Information fields
Description

Connector

VMware vCloud Director <-> ASM Core

ASM database version

SQL (See Prerequisites document for details)

Third-party application

VMware vCloud Director

VMware vCloud Director supported DB

Any DB format as detailed in VMware vCloud Director Prerequisites

Assembly

Infra.Connector.vCloud.dll

Connector class

vCloudConnector

Configuration file

Infra.Connector.vCloud.icnf

Connection methodology

Web Services

The table below provides compatibility for ASM and VCD Versions

VSM/ASM Versions Supported

VMware vCloud Director Versions Supported

10

1.5 / 1.5.1 / 5.1

10

1.5 / 1.5.1 / 5.1 / 5.5

The connector uses vCloud 1.5 API when liaising with VMware vCloud Director 5.1 / 5.5 systems. As a consequence, version 5.1 / 5.5 vCloud specific resources and functionalities are not exposed to ASM Systems.

Connector Install Process

The connector install process is part of the main application installation process.

Connection Parameters

When creating a new VMware vCloud Director source from the Source option of the Integration Platform, some specific parameters have to be entered. The screenshot below illustrates an example of connection details to a VMware vCloud Director source.

Only one set of credentials is required; from a vCD system administrator.

URL

This represents the path to the vCloud Director application, not the API as such. The path provided should make use of https tag.

This patch must not contain any references to virtual directories. An example of proper path is

https://vcd2rhl5vcd.model.infra.com.au/

In comparison,

https://vcd2rhl5vcd.model.infra.com.au/Cloud/

and

https://vcd2rhl5vcd.model.infra.com.au/api/ 

are two examples of erroneous paths.

Login ID and Password

For vCD system admin, the Login ID needs to be of the following format:

<user-id>@system

Federated CMDB Population

Federated CMDB population is performed by setting up scans using the Integration Platform functionality of ASM Core. These scans allow for VMware vCloud Director resources and links to be reflected in the ASM Core CMDB. This section provides details on the resource types and attributes, as well as on the link types and their attributes.

Resource Types

This section lists the resource types and their attributes that the connector is able to discover and eventually import on VMware vCloud Director systems.

Network Pool

Field ID
Display
Data Type

name

Name

string

href

API URL

string

Description

Description

text

This resource is a mandatory input when using the new outbound action: Create Organization Network – Routed.

Provider vDC

A provider vDC resource is a collection of all the resources available in a vCloud. A Provider vDC is created by the vCloud service provider using tools that are specific to the host platform. In this release, a Provider vDC is created by a vSphere administrator using vSphere tools. The attributes of this resource type are listed in the table below:

Field ID
Display
Data Type

name

Name

string

href

API URL

string

description

Description

string

status

Status

profile

CpuAllocation

CPU Allocation (MHz)

long

CpuCapacity

CPU Capacity (MHz)

long

CpuFree

CPU Free (MHz)

long

MemoryAllocation

Memory Allocation (MB)

long

MemoryCapacity

Memory Capacity (MB)

long

MemoryFree

Memory Free (MB)

long

RootComputeCapacityIsElastic

Elastic CPU/Memory

Bool

RootComputeCapacityIsHA

Highly Available CPU/Memory

Bool

StorageAllocation

Storage Allocation (MB)

long

StorageCapacity

Storage Capacity (MB)

long

StorageFree

Storage Free (MB)

long

VCpuRatingMHz

Virtual CPU Rating (MHz)

int

isEnabled

Enabled

bool

Provider Network

This element is created by the server and is read-only at the client. The attributes of this resource type are listed in the table below:

Field ID
Display
Data Type

name

Name

string

href

API URL

string

ProviderInfo

Provider Info

string

Description

Description

text

NetworkPoolName

Network Pool Name

string

NetworkPoolHref

Network Pool Href

string

IpScopeIsInherited

IP Scope Is Inherited

bool

IpScopeGateway

IP Scope Gateway

string

IpScopeNetmask

IP Scope Netmask

string

IpScopeDns1

IP Scope DNS 1

string

IpScopeDns2

IP Scope DNS 2

string

IpScopeDnsSuffix

IP Scope DNS Suffix

string

IpScopeIpRanges

IP Scope IP Ranges

string

FenceMode

Fence Mode

profile

DHCPServiceEnabled

DHCP Service Enabled

bool

DHCPDefaultLeaseTime

DHCP Default Lease Time

int

DHCPMaxLeaseTime

DHCP Max Lease Time

int

DHCPIpRange

DHCP IP Range

string

FireWallIsEnabled

Firewall Enabled

bool

FireWallRuleIsEnabled

Firewall Rule Enabled

bool

FireWallRuleDescription

Firewall Rule Description

bool

FireWallRulePolicy

Firewall Rule Policy

string

FireWallRuleProtocolTCP

Firewall Rule Protocol TCP

bool

FireWallRuleProtocolUDP

Firewall Rule Protocol UDP

bool

FireWallRuleProtocolPort

Firewall Rule Port

int

NatIsEnabled

NAT Enabled

bool

NatType

NAT Type

string

NatPolicy

NAT Policy

string

NetworkOrgName

Network Organization Name

string

NetworkOrgAPIAdminUrl

Network Organization API Admin URL

string

Organization

A vCloud contains one or more organizations. A vCloud organization is a unit of administration for a collection of users, groups, and computing resources. Clients authenticate at the organization level, using credentials established by an organization administrator when the user was created or imported from a directory service such as LDAP.

The attributes of this resource type are listed in the table below:

Field ID
Display
DataType

name

Name

string

href

API URL

string

description

Description

text

fullName

Full Name

string

consoleURL

Console URL

string

orgUsers

Users

entityReference

DefaultDeploymentLeaseSeconds

Default Deployment Lease (Sec)

int

DefaultStorageLeaseSeconds

Default Storage Lease (Sec)

int

vDC

A vCloud virtual datacenter (vDC) is an allocation mechanism for computing resources such as networks, storage, CPU, and memory. In a vDC, these resources are fully virtualized, and can be allocated based on demand, service level requirements, or a combination of the two. Resource consumption in a vDC is monitored by a chargeback mechanism.

There are two kinds of vDC:

  • Provider vDCs contain all the resources available from the vCloud service provider. Provider vDCs are created and managed by vCloud system administrators.

  • Organization (Org) vDCs provide an environment where virtual systems can be stored, deployed, and operated. They also provide storage for virtual media.

The vCloud system administrator allocates resources to an organization vDC, and an organization administrator specifies how that allocation is distributed to the vDCs in an organization.

The attributes of this resource type are listed in the table below:

Field ID
Display
Data Type

Organization

Organization

entityReference

name

Name

string

href

API URL

string

description

Description

text

status

Status

profile

nicQuota

NIC Quota

int

networkQuota

Network Quota

int

vmQuota

VM Quota

int

cpuAllocated

CPU Allocated (MHz)

long

cpuLimit

CPU Limit (MHz)

long

cpuUsed

CPU Used (MHz)

long

memAllocated

Memory Allocated (MB)

long

memLimit

Memory Limit (MB)

long

memUsed

Memory Used (MB)

long

storageAllocated

Storage Allocated (MB)

long

storageLimit

Storage Limit (MB)

long

storageUsed

Storage Used (MB)

long

isEnabled

Is Enabled

bool

vDCOrgName

vDC Organization Name

string

vDCOrgAPIAdminUrl

vDC Organization API Admin URL

string

Network

An organization can be provisioned with one or more networks, each of which represents an allocation of the networking capacity of a provider vDC. These networks (known as organization networks) can be configured to provide services such as DHCP, NAT, and firewalling.

The attributes of this resource type are listed in the table below:

Field ID
Display
DataType

name

Name

string

href

URL

string

Description

Description

string

NetworkPoolName

Network Pool Name

string

NetworkPoolHref

Network Pool Href

string

IpScopeIsInherited

IP Scope Is Inherited

bool

IpScopeGateway

IP Scope Gateway

string

IpScopeNetmask

IP Scope Netmask

string

IpScopeDns1

IP Scope DNS 1

string

IpScopeDns2

IP Scope DNS 2

string

IpScopeDnsSuffix

IP Scope DNS Suffix

string

IpScopeIpRanges

IP Scope IP Ranges

string

FenceMode

Fence Mode

profile

DHCPServiceEnabled

DHCP Service Enabled

bool

DHCPDefaultLeaseTime

DHCP Default Lease Time

int

DHCPMaxLeaseTime

DHCP Max Lease Time

int

DHCPIpRange

DHCP IP Range

string

FireWallIsEnabled

Firewall Enabled

bool

FireWallRuleIsEnabled

Firewall Rule Enabled

bool

FireWallRuleDescription

Firewall Rule Description

bool

FireWallRulePolicy

Firewall Rule Policy

string

FireWallRuleProtocolTCP

Firewall Rule Protocol TCP

bool

FireWallRuleProtocolUDP

Firewall Rule Protocol UDP

bool

FireWallRuleProtocolPort

Firewall Rule Port

int

NatIsEnabled

NAT Enabled

bool

NatType

NAT Type

string

NatPolicy

NAT Policy

string

Catalog

Catalogs contain references to an organization’s virtual systems and media images. A catalog can be unpublished and visible only to its creator, or published and visible to other members of an organization. A vCloud system administrator specifies which organizations can publish catalogs, and an organization administrator controls the publication of catalogs and access to published catalogs within the organization.

The attributes of this resource type are listed in the table below:

Field ID
Display
DataType

Organization

Organization

entityReference

name

Name

string

href

API URL

string

Description

Description

string

IsPublished

Is Published

boolean

IsSharedToEveryone

Is Shared to Everyone

boolean

EveryoneAccessLevel

Everyone Access Level

profile

Owner

Owner

string

CatalogOrgName

Catalog Organization Name

string

CatalogOrgAPIAdminUrl

Catalog Organization API Admin URL

string

Catalog Item

A CatalogItem element can reference any entity that can be contained by a Catalog. Every vApp template or media image that has been added to the catalog is represented as a CatalogItem element.

The attributes of this resource type are listed in the table below:

Field ID
Display
DataType

name

Name

string

href

API URL

string

Description

Description

string

Entity

Entity

Entity reference

EntityURL

Entity URL

String

Type

Type

Profile

Catalog

Catalog

Entity reference

CatalogItemOrgName

Catalog Item Organization Name

string

CatalogItemOrgAPIAdminUrl

Catalog Item Organization API Admin URL

string

vApp Template

The attributes of this resource type are listed in the table below:

Field ID
Display
DataType

name

Name

string

href

API URL

string

status

Status

profile

Type

Type

profile

Description

Description

string

ovfDescriptorUploaded

ovf Descriptor Uploaded

bool

NetworkSection

Network Section

string

EulaSection

Eula Section

string

DeploymentLeaseInSeconds

Deployment Lease (Seconds)

int

StorageLeaseInSeconds

Storage Lease (Seconds)

int

DeploymentLeaseExpiration

Deployment Lease Expiration

datetime

StorageLeaseExpiration

Storage Lease Expiration

datetime

numVMs

No of VMs

int

canInstantiate

Can Instantiate

bool

vAppTemplateOrgName

vApp Template Organization Name

string

vAppTemplateOrgAPIAdminUrl

vApp Template Organization API Admin URL

string

vApp

The attributes of this resource type are listed in the table below:

Field ID
Display
DataType

name

Name

string

href

URL

string

vappowner

vApp Owner

string

status

Status

profile

Type

Type

profile

Description

Description

string

ovfDescriptorUploaded

ovf Descriptor Uploaded

bool

NetworkSection

Network Section

string

EulaSection

Eula Section

string

DeploymentLeaseInSeconds

Deployment Lease (Seconds)

int

StorageLeaseInSeconds

Storage Lease (Seconds)

int

DeploymentLeaseExpiration

Deployment Lease Expiration

datetime

StorageLeaseExpiration

Storage Lease Expiration

datetime

numVMs

No of VMs

int

vAppOrgName

vApp Organization Name

string

vAppOrgAPIAdminUrl

vApp Organization API Admin URL

string

vAppOwner

vApp Owner

string

Media

The attributes of this resource type are listed in the table below:

Field ID
Display
DataType

name

Name

string

href

URL

string

status

Status

profile

Type

Type

profile

Description

Description

string

imageType

Image Type

profile

Size

Size (bytes)

int

MediaOrgName

Media Organization Name

string

MediaOrgAPIAdminUrl

Media Organization API Admin URL

string

VM

A VM represents an individual virtual system, a member of a vApp’s Children container.

The attributes of this resource type are listed in the table below:

Key
Display
Data Type

name

Name

string

href

API URL

string

status

Status

profile

Description

Description

string

ovfDescriptorUploaded

ovf Descriptor Uploaded

bool

adminPasswordEnabled

Has Local Admin Password

bool

adminPassword

Local Admin Password

string

computerName

Computer Name

string

internalIpAddress

Internal IP Addresses

string

externalIpAddress

External IP Addresses

string

operatingSystem

Operating System

string

numberOfCpus

Number of CPUs

int

totalDiskCapacity

Total Disk Capacity (MB)

float

memory

Memory (MB)

long

VMOrgName

VM Organization Name

string

VMOrgAPIAdminUrl

VM Organization API Admin URL

string

vCD User

A User represents an individual user in the vCD system.

Field ID
Display
Data Type

name

Name

String

href

API URL

String

adminurl

API Admin URL

String

uniqueid

Unique ID

String

FullName

Full Name

String

EmailAddress

Email Address

String

Telephone

Telephone

String

IsEnabled

Is Enabled

Bool

IsLocked

Is Locked

Bool

IM

IM

String

NameInSource

Name In Source

String

Object GUID

Object GUID

String

IsAlertEnabled

Is Alert Enabled

Bool

IsExternal

Is External

Bool

IsDefaultCached

Is Default Cached

Bool

IsGroupRole

Is Group Role

Bool

StoredVMQuota

Stored VM Quota

Int

DeployedVMQuota

Deployed VM Quota

Int

RoleName

RoleName

String

Password

Password

String

UserOrgName

User Organization Name

String

UserOrgAPIAdminUrl

User Organization API Admin URL

String

UserOrgDescription

User Organization Description

String

UserOrgFullName

User Organization Full Name

String

UserOrgDefaultDeploymentLeaseSeconds

User Organization Default Deployment Lease (Sec)

Int

UserOrgDefaultStorageLeaseSeconds

User Organization Default Storage Lease (Sec

Int

Link Types

The connector allow for the exposure and import of several link types into the ASM Core CMDB. These link types are summarized in the table below.

Name
Resource Type A
Resource Type B
Description

Provider vDC Networks

Provider vDC

Provider Network

Link that shows relationship between provider vDC with provider Networks.

Catalog Contents

Catalog

Catalog Items

Link that shows relationship between a Catalog with its Contents.

vDC Available Networks

vDC

Network

Link that shows relationship between a vDC with its available networks.

vDC Resources

vDC

vDC Resource

Link that shows relationship between a vDC with its Resources.

VMs in vApp

vAppTemplates and vApps

vDC Resource:VM

Link that shows relationship between a VM with its parent, the vApp.

App Networks

vAppTemplates, vApps and VMs

Network

Link that shows relationship between a vApp with its network.

Network Association

Network

Network

Link that shows relationship between a network with its parent, the provider network.

Organization vDCs

Organization

vDC

Link to show the vDCs that belong to an organization.

Organization Catalogs

Organization

Catalog

Link to show the catalogs that belongs to an organization.

Organization Networks

Organization

Network

Link that shows the relationship of a network allocated to an organization by the system administrator.

Organization Users

Organization

User

User Import

The vCD connector allows for the discovery and importation of User from VMware vCloud Director into ASM Core as person records.

An organization can contain an arbitrary number of person records and groups. Person records can be created by the organization administrator or imported from a directory service such as LDAP. (Groups must be imported from the directory service.) Permissions within an organization are controlled through the assignment of security roles and groups to person records that can also be flagged as Users or Analysts.

Imports of users into ASM Core can take place in 2 main environments:

  1. VMware vCloud Director is the authoritative source of users for VMware Service

  2. A LDAP repository (such as MS Active Directory) is the authoritative source of users

In the second case, special care should be applied to Users import as it can lead to the creation of multiple person records for a unique directory server user. To avoid this happening, it is recommended to implement the following:

  1. When setting up LDAP mapping, use a custom string from the Person template (for instance “Custom String 1”) to map the LDAP “Object GUID” attribute.

  2. When setting up the VMware vCloud Director mapping, apply the following:

  3. Field mapping

  4. ASM Core Person “Custom String 1” field mapped to vCD “Object GUID” attribute

5. Matching Criteria rule

{Person: Custom String 1} like {Resource:Object GUID}

Outbound Action Types

The VCD connector proposes several action types. It does not handle any inbound action type.

For more details about Outbound/Inbound action functionality, refer to the documentation on ASM Core Integration Platform.

Instantiate vApp

A vApp template is like a recipe for creating a vApp. This recipe, contained in the vAppTemplate entity, specifies a set of files, such as virtual disks, that the vApp requires, and a set of abstract resources, such as CPU, memory, and network connections, that must be allocated to the vApp by the vDC in which it is deployed.

Instantiation creates these vDC-specific bindings based on parameters supplied by the client. (These bindings are advisory; they do not guarantee that the resource will be available when the vApp is deployed.) Instantiation is a prerequisite to deployment. In most cases, a client instantiates a vApp template and then immediately deploys it.

You cannot instantiate a vApp template until all of its required files are available in a vDC. A vAppTemplate that meets this requirement is said to be resolved, and has a status attribute whose value is 1.

When configuring the Instantiate vApp Outbound Action, it is recommended to set up both the Deploy and the Power On attributes to False.

Action ID

instantiateVAppTemplate

Action Display Name

Instantiate a vApp Template

Type of Transaction

Asynchronous

Input Parameters

Key
Display
Data Type

name

vApp Name *

string

Description

vApp Description

string

vDC

vDC *

entityReference

vAppTemplate

vApp Template *

entityReference

deploy

Deploy

bool

network

Network

entityReference

powerOn

Power On

bool

DeploymentLeaseExpiration

Deployment Lease Expiration

dateTime

StorageLeaseExpiration

Storage Lease Expiration

dateTime

* indicates mandatory field

Output Parameters

Key
Display
Data Type

vAppName

vApp Name

string

vAppURL

vApp API URL

string

vAppConsoleURL

vApp Console URL

string

Action Error Message

Action Error Message

string

Action Error StackTrace

Action Error StackTrace

string

Action Error Minor Error Code

Action Error Minor Error Code

string

Action Error Major Error Code

Action Error Major Error Code

string

HttpCode

HTTP Status Code

string

HttpMessage

HTTP Message

string

HttpUri

HTTP URI

string

HttpFaultResponse

HTTP Fault Response

string

Provision Organization

This is a composite action that orchestrates the individual actions used to provision a new organization, in the following order:

  • Create Organization

  • Create User

  • Create Organization Network

  • Create Organization vDC

Action ID

provisionOrg

Action Display Name

Create Organization

Type of transaction

Synchronous; concludes on creation

Input Parameters

Settings
Key
Display
Data Type

Organization

organizationName

Organization Name*

string

organizationDescription

Organization Description

text

organizationFullname

Organization Full Name*

string

DeployedVMQuota

Deployed VM Quota

int

StoredVMQuota

Stored VM Quota

int

OrganizationLdapOu

Organization LDAP OU

string

Lease

DefaultDeploymentLease

Default Deployment Lease

int

DefaultStorageLease

Default Storage Lease

int

Notification

UseDefaultNotificationSettings

Use Default Notification Settings*

bool

NotificationSenderAddress

Notification Sender Address

string

NotificationSubjectPrefix

Notification Subject Prefix

string

User

AdministrationUsers

Administration Users *

string

AdministrationRole

Administration Role *

profile

OrganizationUsers

Organization Users

string

OrganizationRole

Organization Role

profile

Network

NetworkName

Network Name *

string

NetworkDescription

Network Description

text

ParentNetwork

Parent Network *

entityReference

VdcName

vDC Name *

string

VdcDescription

vDC Description

text

VdcAllocationModel

Allocation Model *

profile

VdcStorageAllocated

Storage Allocated (MB)

int

VdcStorageLimit

Storage Limit (MB)

int

VdcCpuAllocated

CPU Allocated (MHz)

int

VdcCpuLimit

CPU Limit (MHz)

int

VdcMemoryAllocated

Memory Allocated (MB)

int

VdcMemoryLimit

Memory Limit (MB)

int

VdcNicQuota

NIC Quota

int

VdcNetworkQuota

Network Quota

int

VdcVmQuota

VM Quota

int

VdcPercentResourceGuaranteedMemory

% Resource Guaranteed (Mem.)

float

VdcPercentResourceGuaranteedCpu

% Resource Guaranteed (CPU)

float

VdcIsThinProvision

Is Thin Provision

bool

VdcProviderVdc

Provider vDC Reference *

entityReference

VdcVCpuRatingMHz

Virtual CPU Frequency (MHz)

long

* indicates mandatory field

Output Parameters

Key
Display
Data Type

orgURL

Organization API URL

string

orgConsoleURL

Organization Console URL

string

networkURL

Organization Network API URL

string

vdcURL

Organization vDC API URL

string

Action Error Message

Action Error Message

string

Action Error StackTrace

Action Error StackTrace

string

Action Error Minor Error Code

Action Error Minor Error Code

string

Action Error Major Error Code

Action Error Major Error Code

string

HttpCode

HTTP Status Code

string

HttpMessage

HTTP Message

string

HttpUri

HTTP URI

string

HttpFaultResponse

HTTP Fault Response

string

Login IDs are provided as a concatenated list of login IDs, delimited by semi-colons. It assumed the dedicated portal UI will take responsibility for concatenating these values.

Set vApp Network

Binds an org network to a vApp network with the specified name.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

Network

reference to an Org Network

Network Admin API URL

String

Network API URL

String

vApp Network Name

String

Output Parameters

Error Code

int

Error Message

String

If “vApp Network Name” is empty, the org network is bound to all the vApp networks in the vApp.

Customize Virtual Machines

A VM must be powered off while this action is performed in order for it to succeed. The Customization script is ran only when the VM is restarted.

This configures a VM to have a specific guest customization as specified by the parameters. If not configured, the action will switch on guest customization for the virtual machine. Guest customization is dependent on VMware Tools being already installed on the VM.

If a vApp is identified by the parameters, the customization is applied to all VMs within.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Guest Customization Script

Text

Computer Name

String

Local Admin Password

String

Output Parameters

Error Code

int

Error Message

String

Update VM Capacity

A VM must be powered off while this action is performed in order for it to succeed.

This updates the memory and CPU of a VM to values specified by the parameters.

If a vApp is identified by the parameters, the update is applied to all VMs within.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

reference to a VM

Number of CPUs

int

inMemory (MB)

int

Output Parameters

Error Code

int

Error Message

String

Make VM Names Unique

A VM must be powered off while this action is performed in order for it to succeed.

This generates a pseudo-random name a virtual machine within a vApp, optionally seeded by a provided prefix. The update is performed to both the internal vSphere name for the virtual machine and its computer name.

If not configured, the action will switch on guest customization for the virtual machine. Guest customization is dependent on VMware Tools being already installed on the VM.

If no prefix is specified, the initial internal VM name is used instead.

The generated name is necessarily restricted in length to 15 characters.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Prefix

String

Output Parameters

Error Code

int

Error Message

String

Insert Disk

A VM must be powered off while this action is performed in order for it to succeed.

This inserts a new disk into a VM.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Bus Sub Type

Profile "Bus Sub Types"

Capacity (MB)

int

Output Parameters

Error Code

in

Error Message

String

Profile “Bus Sub Types”

To support this action a new profile and a new matrix will be defined and published covering the supported bus types.

Value
Display
Underlying Super Type (Mapped in Matrix)
Super Type Value

ide

IDE

IDE

5

buslogic

BusLogic Parallel (SCSI)

SCSI

6

lsilogic

LSI Logic Parallel (SCSI)

SCSI

6

lsilogicsas

LSI Logic SAS (SCSI)

SCSI

6

virtualscsi

Paravirtual (SCSI)

SCSI

6

Remove Disk

This removes a disk with the specified index from a VM. If no index is specified, it will remove the disk with the highest index.

Input Parameters

vApp

reference to a vApp

vApp API URL

string

VM

Reference to a VM

Disk Index

int

Output Parameters

Error Code

int

Error Message

String

Deploy a vApp or Virtual Machine

Deploying a vApp automatically deploys all of the virtual machines it contains.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Power On

Bool

Deployment Lease (Seconds)

int

Output Parameters

Error Code

int

Error Message

String

Undeploy a vApp or Virtual Machine

Undeploying a vApp powers off or suspends any running vApp Children, then frees the resources reserved for the vApp and sets the vApp’s status attribute to a value of 1 to indicate that it is not deployed.

Undeploying a virtual machine powers off or suspends the virtual machine, then frees the resources reserved for it and sets the its status attribute to a value of 1 to indicate that it is not deployed.

This operation has no effect on the containing vApp.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Save State

Bool

Output Parameters

Error Code

int

Error Message

String

Power On a vApp or Virtual Machine

A powerOn request to a vApp URL powers on all of the virtual machines in the vApp, as specified in the vApp’s ovf:StartupSection element.

A powerOn request to a virtual machine URL powers on the specified virtual machine.

Input Parameters

vApp

reference to a vApp

vApp API URL

string

VM

reference to a VM

Output Parameters

Error Code

int

Error Message

string

Power Off a vApp or Virtual Machine

A powerOff request to a vApp URL powers off all of the virtual machines in the vApp, as specified in its ovf:StartupSection element.

A powerOff request to a virtual machine URL powers off the specified virtual machine.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Output Parameters

Error Code

int

Error Message

String

Reset a vApp or Virtual Machine

A reset request to a vApp URL resets all of the virtual machines in the vApp, as specified in its ovf:StartupSection element.

A reset request to a virtual machine URL resets the specified virtual machine.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Output Parameters

Error Code

int

Error Message

String

Suspend a vApp or Virtual Machine

A suspend request to a vApp URL suspends all of the virtual machines in the vApp, as specified in its ovf:StartupSection element.

A suspend request to a virtual machine URL suspends the specified virtual machine.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Output Parameters

Error Code

int

Error Message

String

Discard Suspended State

A discardSuspendedState request to a vApp URL discards the suspended state of all of the virtual machines in the vApp, as specified in its ovf:StartupSection element.

A discardSuspendedState request to a virtual machine URL discards the suspended state of the specified virtual machine.

You cannot resume a suspended vApp after its suspended state has been discarded.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Output Parameters

Error Code

int

Error Message

String

Shutdown a vApp or Virtual Machine

A shutdown request to a vApp URL shuts down all of the virtual machines in the vApp, as specified in its ovf:StartupSection element.

A shutdown request to a virtual machine URL shuts down the specified virtual machine. This request needs VM Tools to be installed on the VM to succeed.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Output Parameters

Error Code

int

Error Message

String

Reboot a vApp or Virtual Machine

A reboot request to a vApp URL reboots all of the virtual machines in the vApp, as specified in its ovf:StartupSection element.

A reboot request to a virtual machine URL reboots the specified virtual machine. This request needs VM Tools to be installed on the VM to succeed.

Input Parameters

vApp

reference to a vApp

vApp API URL

String

VM

Reference to a VM

Output Parameters

Error Code

int

Error Message

String

Clone a vApp

This operation must be performed with organization credentials.

The cloneVApp operation is similar to the instantiateVAppTemplate operation, except that it specifies a vApp to clone, rather than a vAppTemplate to instantiate.

Input Parameters

Name *

string

Description

text

vApp*

Reference to vApp

vDC*

Reference to vDC

Network

Reference to Network

Deploy

bool

Power-up

bool

Deployment Lease Expiry Date

date time

Storage Lease Expiry Date

date time

Output Parameters

Clone vApp Name

string

Clone vApp API URL

string

Clone vApp

reference to vApp

vApp Console URL

string

Error Code

int

Error Message

string

* indicates mandatory field

Compose a Blank vApp

Creates a Blank vApp on a particular VDC.

Input Parameters

vApp Name*

string

vDC*

Reference to vDC

Deployment Lease Expiry Date

date time

Storage Lease Expiry Date

date time

Output Parameters

vApp Name

string

vApp API URL

string

vApp

Reference to vApp

vApp Console URL

string

Error Code

int

Error Message

string

* indicates mandatory field

Merge vApp

Merges one or more source vApps into a target vApp. The Target vApp Name parameter is optional, if it is provided the resultant merged vApp will be renamed to this Target vApp Name. If Delete Source is True and Source is a VM, the VM will be deleted from its parent vApp.

Input Parameters

Source vApp

reference to vApp (Multiple Value)

Source vApp API URL

String (Multiple Value)

Target vApp Name

string

Target vApp

reference to vApp

Target vApp API URL

string

Delete Source

bool

Output Parameters

Merged vApp Name

string

Merged vApp

reference to vApp

Merged vApp API URL

string

Error Code

int

Error Message

string

Renew a vApp

Renews the deployment and/or storage lease of a vApp.

Input Parameters

vApp

resource reference

vApp API URL

string

Deployment Lease Expiry Date

date time

Storage Lease Expiry Date

date time

Output Parameters

N/A

N/A

Share a vApp

Share a vApp to everyone in the Org or to a few people specified in the input parameters.

If sharing to everyone the “Share to Users” parameter(s) are not needed. Otherwise they must be provided.

A vApp can only be shared to person records assigned an Organization where the vApp resides.

Input Parameters

vApp

resource reference

vApp API URL

string

Share to Everyone

bool

Share to Users

reference (Multiple Value)

Access Level *

profile

Output Parameters

Error Code

int

Error Message

string

* indicates mandatory field

Delete a vApp

This physically deletes a vApp.

Input Parameters

vApp

resource reference

vApp API URL

string

Output Parameters

Error Code

int

Error Message

string

Create an Organization

This creates an Organization in vCloud Director.

Input Parameters

Organization Name *

string

Organization Full Name *

string

Use Default Notification Settings *

bool

Organization Description

text

Deployed VM Quota

int

Stored VM Quota

int

Deployment Lease Seconds

int

Storage Lease Seconds

int

Is Default Org Email *

bool

From Email Address

string

Default Subject Prefix

string

Output Parameters

Error Code

int

Error Message

string

Organization Name

string

Organization API Admin URL

string

Organization API URL

string

* indicates mandatory field

Update an Organization

Input Parameters

Organization Description

text

Deployed VM Quota

int

Stored VM Quota

int

Deployment Lease Seconds

int

Storage Lease Seconds

int

Is Default Org Email *

bool

From Email Address

string

Default Subject Prefix

string

Organization Full Name

string

Organization API Admin URL

string

Organization

entityReference

Output Parameters

Error Code

Int

Error Message

String

* indicates mandatory field

In addition to the fields that are marked with an asterisk, it is mandatory to provide either Organization API Admin URL or Organization.

Delete an Organization

Input Parameters

Organization API Admin URL

string

Organization

entityReference

Output Parameters

Error Code

int

Error Message

string

Create an Organization User

Input Parameters

Organization Admin API URL*

string

Full Name

string

Email Address

string

Telephone

string

Is Enabled

bool

IM

string

Is Alert Enabled

bool

Stored Vm Quota

int

Deployed Vm Quota

int

Organization User *

string

Organization Role *

profile

Password *

string

Output Parameters

Error Code

int

Error Message

string

User Name

string

User API Admin URL

string

* indicates mandatory field

Update an Organization User

Input Parameters

Full Name

string

Email Address

string

Telephone

string

Is Enabled

bool

IM

string

Is Alert Enabled

bool

Stored Vm Quota

int

Deployed Vm Quota

int

Organization Role

profile

Is External

bool

User Admin API URL

string

User

entityReference

Output Parameters

Error Code

int

Error Message

string

In addition to the fields that are marked with an asterisk in the previous section, it is mandatory to provide either User API Admin URL or User.

Delete an Organization User

Input Parameters

User Admin API URL

string

User

entityReference

Output Parameters

Error Code

int

Error Message

string

Delete an Organization Network

Input Parameters

Network Admin API URL

string

Network

entityReference

Output Parameters

Error Code

int

Error Message

string

Create an Organization vDC

Input Parameters

Organization Admin API URL

string

Network Admin API URL

string

vDC Name *

string

Allocation Model *

profile

Provider vDC Reference *

entityReference

vDC Description

text

Storage Allocated (MB)

int

Storage Limit (MB)

int

CPU Allocated (MHz)

int

CPU Limit (MHz)

int

Memory Allocated (MB)

int

Memory Limit (MB)

int

NIC Quota

int

Network Quota

int

VM Quota

int

% Resource Guaranteed

(Memory)

float

% Resource Guaranteed

(CPU)

float

Is Thin Provision

bool

Virtual CPU Frequency (MHz)

long

Output Parameters

Error Code

int

Error Message

string

vDC Name

string

vDC API Admin URL

string

vDC API URL

string

* indicates mandatory field

Update an Organization vDC

In addition to the fields that are marked with an asterisk, it is mandatory to provide either vDC Admin API URL or vDC.

​

Input Parameters

Organization Admin API URL

string

​

Network Admin API URL

string

​

vDC Name *

string

​

Allocation Model *

profile

​

Provider vDC Reference *

entityReference

​

vDC Description

text

​

Storage Allocated (MB)

int

​

Storage Limit (MB)

int

​

CPU Allocated (MHz)

int

​

CPU Limit (MHz)

int

​

Memory Allocated (MB)

int

​

Memory Limit (MB)

int

​

NIC Quota

int

​

Network Quota

int

​

VM Quota

int

​

% Resource Guaranteed(Memory)

float

​

% Resource Guaranteed(CPU)

float

​

Is Thin Provision

bool

​

Virtual CPU Frequency (MHz)

long

Output Parameters

Error Code

int

​

Error Message

string

* indicates mandatory field

In addition to the fields that are marked with an asterisk, it is mandatory to provide either vDC Admin API URL or vDC.

Delete an Organization vDC

An Organization must be Disabled before it can be deleted.

Input Parameters

vDC Admin API URL

string

vDC

entityReference

Output Parameters

Error Code

int

Error Message

string

Change Ownership of a vApp

You can change the owner of a VApp, but not that of a VAppTemplate or Media object.

VApp, VAppTemplate, Catalog, and Media objects are initially owned by the user who created them. Ownership is expressed in an Owner element contained by the object representation. This element includes a User element that references the owner.

Before you start

To change the owner of a vApp, you must be the vApp owner, an organization administrator, or the system administrator.

To view change the owner of a catalog, you must be an organization administrator or the system administrator.

Input Parameters

User Admin API URL

string

User

entityReference

vApp API URL

string

vApp

entityReference

Output Parameters

Error Code

int

Error Message

string

Update VM Network Connection

Input Parameters

vApp API URL

string

vApp

entityReference

VM

entityReference

Network Admin API URL

string

Network

entityReference

Network Connection Index *

int

IP Address

string

IP Address Allocation Mode

profile

Output Parameters

Error Code

int

Error Message

string

The Network Connection Index attribute represents the NIC number of the VM targeted by this outbound action.

* indicates mandatory field.

In addition, it is mandatory to provide vApp API URL or vApp or VM.

Create Organization Network - Bridged

This is accessible by multiple organizations. Virtual machines belonging to different organizations can connect to and see traffic on this network. This network provides direct layer 2 connectivity to machines outside of the organization. Machines outside of this organization can connect to machines within the organization directly.

Input Parameters

Parent Network *

reference to an External Network

Network Description

string

Network Name *

string

Organization Admin API URL *

String

Output Parameters

Network API Admin URL

String

Network Name

String

Action Error Major Code

String

Action Error Message

String

Action Error Minor Error Code

String

Action Error Stack Trace

String

HTTP Fault Response

String

HTTP Message

String

HTTP Status Code

String

HTTP URI

String

* indicates mandatory field

Create Organization Network - Isolated

This is accessible only by this organization. Only virtual machines within this organization can connect to and see traffic on this network.

This network provides an organization with an isolated, private network that multiple vApps can connect to. This network provides no connectivity to machines outside this organization. Machines outside of this organization have no connectivity to machines within the organization.

Input Parameters

Start Address *

String

End Address *

String

NetMask *

String

Gateway *

String

Network Name *

String

Network Pool *

Reference to a Network Pool

Network Description

String

Organization Admin API URL *

String

Output Parameters

Network API Admin URL

String

Network Name

String

Action Error Major Code

String

Action Error Message

String

Action Error Minor Error Code

String

Action Error Stack Trace

String

HTTP Fault Response

String

HTTP Message

String

HTTP Status Code

String

HTTP URI

string

* indicates mandatory field

Create Organization Network - Routed

Accessible only by the organization specified. Only virtual machines within this organization can connect to this network.

This network also provides controlled access to an external network. System administrators and organization administrators can configure network address translation (NAT) and firewall settings to make specific virtual machines accessible from the external network.

Input Parameters

Start Address *

String

End Address *

String

NetMask *

String

Gateway *

String

Network Name *

String

Network Pool *

Ref to a Network Pool

Network Description

String

Organization Admin API URL *

String

DHCP Is Enabled

Boolean

DHCP Start Address

String

DHCP End Address

String

DHCP Default Lease Time

Int

DHCP Max Lease Time

Int

Firewall Is Enabled

Boolean

Firewall Default Action

Allow / Block

Output Parameters

Network API Admin URL

String

Network Name

String

Action Error Major Code

String

Action Error Message

String

Action Error Minor Error Code

String

Action Error Stack Trace

String

HTTP Fault Response

String

HTTP Message

String

HTTP Status Code

String

HTTP URI

String

* indicates mandatory field

Rename VM

This action allows renaming existing VM.

If a VM ref is provided as input, the referenced VM will be renamed according to the value passed in VM Name field.

If a vApp ref or vApp API URL value is provided as input, up to 5 VMs belonging to the referenced vApp will be renamed based to the value passed in VM Name field by adding “_x” as a suffix; for instance <VM_name>, <VM_name>_1, <VM_name>_2, <VM_name>_3 and <VM_name>_4.

If Update Computer Name is enabled, the VM Name will be used to rename the name of the Computer related to the VM. Default value is disabled for this option.

Input Parameters

VM Name *

String

vApp

Ref to a vApp

vApp API URL

String

VM

Ref to a VM

Update Computer Name

Boolean

Output Parameters

VM Name

String

VM Name-2

String

VM Name-3

String

VM Name-4

String

VM Name-5

String

Action Error Major Code

String

Action Error Message

String

Action Error Minor Error Code

String

Action Error Stack Trace

String

HTTP Fault Response

String

HTTP Message

String

HTTP Status Code

String

HTTP URI

String

* indicates mandatory field

Create an Organization Network Firewall Rule

This outbound action allows creating a firewall rule for a specific organization network in vCloud Director.

Mandatory fields are:

  • Network Admin API Url or the Network Entity reference

  • A name for the Firewall rule.

  • A source IP address and a destination IP address.

The system allows for 2 rules to have to same names but it does not allow for the creation of 2 rules using the same IP + Port source and destination, direction, and protocol.

Optional fields allow:

  • Enabled: activate or deactivate the rule.

  • Policy: Drop, Allow

  • Protocols: specifying between Any, TCP, UDP, TCP & UDP, ICMP.

  • Direction: specifying between Incoming, Outgoing

  • Ports: Any port (*), FTP (21), SSH (22), HTTP (80)

Display name
Field Type
Default Value

Input Parameters

Network Admin API URL

string

Network

entityReference

Firewall Rule Name *

string

Enabled

bool

False

Policy

profile

Drop

Protocols

profile

TCP

Direction

profile

Incoming

Destination Port

profile

Any Port (*)

Source Port

profile

Any Port (*)

Destination IP *

string

Source IP *

string

Output Parameters

Action Error Major Code

String

Action Error Message

string

Action Error Minor Error

Code

string

Action Error Stack Trace

string

HTTP Fault Response

string

HTTP Message

string

HTTP Status Code

string

HTTP URI

string

* indicates mandatory field

Delete an Organization Network Firewall Rule

This action deletes an existing firewall rule for a specific Organization Network.

Mandatory fields are:

  • Network Admin API Url or Network Entity reference

  • A name for the Firewall rule

If there are no existing rules in the specified network that possess the name provided as input parameter, no rule will be deleted.

A message is generated in the HTTP Fault Response stating: “Warning: no Firewall rule deleted. The value specified did not correspond to any existing Firewall rule in the source system.”.

This is not considered as a failure of the Outbound Action workflow task, meaning the workflow will continue following the Succeeded branch.

Input Parameters

Network Admin API URL

string

Network

entityReference

Firewall Rule Name *

string

Output Parameters

Action Error Major Code

String

Action Error Message

String

Action Error Minor Error Code

String

Action Error Stack Trace

String

HTTP Fault Response

String

HTTP Message

String

HTTP Status Code

String

HTTP URI

String

* indicates mandatory field

Create an Organization Network NAT Rule

This outbound action allows creating a NAT Routing rule for a specific organization network.

Mandatory fields are:

  • Network Admin API Url or Network Entity reference

  • An External IP address and an Internal IP address

Optional fields:

  • Protocols: allows specifying between TCP, UDP, TCP & UDP.

  • Type: allows specifying between Port Forwarding and IP Translation

  • Ports: Any port (*), FTP (21), SSH (22), HTTP (80)

Display name
Field Type
Default Value

Input Parameters

Network Admin API URL

string

Network

entityReference

NAT Rule Type

profile

Port Forwarding

Protocols

profile

TCP

External Port

profile

Any Port (*)

Internal Port

profile

Any Port (*)

External IP *

string

Internal IP *

string

Output Parameters

Action Error Major Code

String

Action Error Message

String

Action Error Minor Error Code

String

Action Error Stack Trace

String

HTTP Fault Response

String

HTTP Message

String

HTTP Status Code

String

HTTP URI

string

* indicates mandatory field

Delete an Organization Network NAT Rule

This action is used to delete one or several rules at the same time inside a unique Organization network.

Mandatory fields are:

  • Network Admin API Url or Network Entity reference

  • NAT Rule Type

  • At least one the other parameters

If Delete All IP Translation Rules and/or Delete All Port Forwarding Rules attributes are set to True, all the existing rules of the associated type will be deleted in the specified Organization Network.

When using Internal and/or External IP values or Internal and/or External IP values, the Outbound action will delete all the rules that matches all the parameters provided. At least one of the 4 values needs to be specified for the rule to run.

For example, if the only value specified is an External IP, then all the rules that possess this External IP address will be deleted. But if an External Port is also specified, then all then rules that possess the External IP address as well as the Port number will be deleted.

Any combination of the 4 parameters can be used.

If there are no existing rules that match the input parameters of the Outbound action, no rule will be deleted.

A message is generated in the HTTP Fault Response stating: “Warning: no NAT rule deleted. The values specified did not correspond to any existing NAT rule in the source system.”

This is not considered as a failure of the Outbound Action workflow task, meaning the workflow will continue using the Succeeded branch.

Input Parameters

Delete All IP Translation Rules

bool

Delete All Port Forwarding Rules

bool

Network Admin API URL

string

Network

entityReference

External IP

string

Internal IP

string

External Port

profile

Internal Port

profile

NAT Rule Type

profile

Output Parameters

Action Error Major Code

String

Action Error Message

String

Action Error Minor Error Code

String

Action Error Stack Trace

String

HTTP Fault Response

String

HTTP Message

String

HTTP Status Code

String

HTTP URI

String

Security and Certificates

Installing a Security Certificate

The vCD connector requires a security certificate to be installed on the ASM Core server to connect to VMware vCloud Director.

The certificate has to be installed in the Trusted Root Certification Authorities > Local Computer folder.

The recommended way to install the certificate is, from the ASM Core server, to point a web browser to the vCD server. A warning will be displayed that certificate is not trusted. From there, either the User’s Web browser allows for a straight install of the certificate, or system administrators will have to export the certificate to a file and then import this newly created file as a trusted certificate.

Security Certificate Warnings

During installation, the Configuration Wizard may attempt to test whether it can establish a connection over SSL with the specified connection parameters.

If a connection fails, a dialog will be displayed detailing the reasons why the connection could not be trusted and suggest actions that could be taken to resolve those issues. In addition, the dialog provides options to inspect and install the certificates issued by the server.

It is strongly advised that you consult with the relevant system administrators before directly installing a certificate with this dialog to avoid the server trusting compromised connections. It always best practice for the certificate of a remote server to be manually provided by that server’s administrator rather than downloaded from the server.

Example of VMware vCloud Director Certificate Installation

  1. In the Internet browser, type in the URL of the vCD instance

  2. When asked, select to proceed to vCD despite the certificate not being installed.

  3. Once on the vCD log in page, click on the Certificate Error box on the right of the Address bar.

  4. Click on View Certificate at the bottom of the window. Then click on “Install Certificate…”.

  5. Select “Place all certificates in the following store” optionand click on the Next button.

  6. Tick the option Show Physical stores and select the Local Computer folder under Trusted Root Certification Authorities folder.

  7. Click OK and complete the installation process.

  8. Restart the Internet browser and type in the vCD instance URL. Check that no certificate alert appears.

PreviousVMware vCenter Configuration Manager ConnectorNextvRealize Orchestrator Connector

Last updated 1 month ago

Was this helpful?