You are viewing the Apigee Management API reference documentation. For the main product docs, and to search all docs, go to https://docs.apigee.com. For cross-site search, click Search all in the search results.

Update a Virtual Host

Resource Summary

Security

Content Type

application/json, text/xml

Category

Virtual Host,

updateVHost

PUT

Update a Virtual Host

Updates a virtual host.

You must specify the complete description of the virtual host in the request body, not just the elements that you want to change. You can get the current virtual host properties by using the Get Virtual Host API.


About updating a virtual host



The requirements for updating a virtual host depend on whether you are using Edge for the Cloud or Edge for the Private Cloud. If you are using Edge for the Private Cloud, then it also depends on which version of Edge for the Private Cloud you are using.


For example, a subset of request body properties are valid only for specific Edge for Private Cloud versions, as follows:

  • ciphers and protocols properties are valid on Edge for Private Cloud version 4.15.07 and earlier
  • properties array is valid on Edge for Private Cloud version 4.17.01 and later
  • baseUrl property is valid on Edge for Private Cloud version 4.17.05 and later
  • retryOptions and listenOptions properties are valid on Edge for Private Cloud version 4.18.01 and later
Note: As of Edge for Private Cloud version 4.16.01, you must create a host alias when you create a virtual host. Also, the combination of host alias name and port number for the virtual host must be unique for all virtual hosts in the Edge installation.

For a general introduction to virtual hosts, see About virtual hosts. For information about your specific version of Edge, see:

See Virtual host property reference for complete information on setting all virtual host values.

Resource URL

https://api.enterprise.apigee.com/v1 /organizations/{org_name}/environments/{env_name}/virtualhosts/{virtualhost_name}

Header Parameters

Name Values Description
Content-Type
(required)

Specify Content Type as either application/json or text/xml

Request Body

The request body to update a virtual host depends on whether you are using Edge for the Cloud or Edge for the Private Cloud. If you are using Edge for the Private Cloud, then it also depends on which version of Edge for the Private Cloud you are using. For a complete list of all options for the request body, see Virtual host property reference.

org_name Mention the organization name true

env_name Mention the environment name true

virtualhost_name Mention the virtual host name true

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Working...

Help or comments?

  • If something's not working: Ask the Apigee Community or see Apigee Support.
  • If something's wrong with the docs: Click the "Send Feedback" button.
    (Incorrect? Unclear? Broken link? Typo?)