Merge pull request #515 from mulesoft/W-13223380-add-endpoint-page-gr

W-13223380 add-endpoint-page-gr

Author: glenn-rodgers-sf

modules/ROOT/assets/image-source-files/api-instance-summary.graffle

@@ -9,6 +9,7 @@
  ** xref:find-api-id-task.adoc[Obtain an API Instance ID]
  ** xref:export-api-latest-task.adoc[Export an API Instance]
  ** xref:access-developer-portal-task.adoc[Access the Developer Portal]
+ ** xref:edit-api-endpoint-task.adoc[Edit an API Instance Endpoint]
  ** xref:deprecate-api-latest-task.adoc[Deprecate an API Instance]
  ** xref:delete-api-task.adoc[Delete an API Instance]
  ** xref:manage-versions-instances-concept.adoc[Manage API Versions and Instances]

modules/ROOT/assets/images/api-instance-summary.png

@@ -4,24 +4,25 @@ include::_attributes.adoc[]
 endif::[]
 :keywords: api, instance, manager
 
-An API instance is the instantiation of an API definition. It is an object that is used to share data between gateways and the control plane. An API Instance can either be a proxy of an API that serves the upstream or a Mule application endpoint.
+An API instance is the instantiation of an API definition. It is an object that is used to share data between gateways and the control plane. An API instance can either be a proxy of an API that serves the upstream or a Mule application endpoint.
 
 You can create, import, and deprecate API instances using API Manager. You can use instances of an API in multiple environments. You can also have multiple instances of an API in the same environment.
 
 You can create one instance of an API version that serves as a proxy and create another to directly manage it as an endpoint. You can apply policies to the API based on how the API is configured--proxy or endpoint. For example, you can apply caching policies to the proxy, and throttling policies and security policies to the endpoint. Additionally, you can promote an API to another environment.
 
-To manage API Instances in API Manager:
+To manage API instances in API Manager:
 
 . xref:create-instance-task.adoc[Add an API Instance] - API instances are managed by API Manager after you add them and remain under management until you delete them. 
-. xref:configure-api-task.adoc[Configure an API Instance] - You can customize your API Instance to fit your specific situation with many optional settings. Not all options are available depending on the runtime as well as the API.
-. View an API Instance's settings for information about the instance or to export it.
+. xref:configure-api-task.adoc[Configure an API Instance] - You can customize your API instance to fit your specific situation with many optional settings. Not all options are available depending on the runtime as well as the API.
+. View an API instance's API Summary for information about the instance or to export it:
 ** xref:find-api-id-task.adoc[Obtain API Instance ID] - API Manager generates the apiId of new APIs managed by API Manager for use with Mule 4.
 ** xref:export-api-latest-task.adoc[Export an API Instance] - After creating an API instance, you can export it. This exports the API instance endpoint configuration and Exchange asset relationship. You can then import it into another environment in the same business group to create a new API instance.
 ** xref:access-developer-portal-task.adoc[Access the Developer Portal] - As an administrator, you can view the resources and methods of an API, and access other details, such as publish date and mocking service, from Anypoint Exchange (Exchange). You can view the API in an asset portal (private) or a public portal.
-. Modify an API Instance when you no longer need the instance or when you need to update it to the latest version.
+. Modify an API instance when you no longer need the instance or when you need to update it:
+** xref:edit-api-endpoint-task.adoc[Edit an API Instance Endpoint] - Edit the API instance's endpoint to update its base path, port, TLS context, and more.
 ** xref:deprecate-api-latest-task.adoc[Deprecate an API Instance] - While transitioning consumers of your API to an updated instance, you can prevent developers from signing up for access to your old API instance. 
 ** xref:delete-api-task.adoc[Delete an API Instance] - You can delete an API instance and its version if you no longer need to manage it from API Manager. 
 ** xref:manage-versions-instances-concept.adoc[Manage API Versions] - After you create an API in Anypoint Platform, you configure the version details for the API and then publish it to Anypoint Exchange (Exchange). The API version resides in Exchange, and not in API Manager. However, you then manage this API version from API Manager.
-. Explore advanced use cases for API Instances.
+. Explore advanced use cases for API instances:
 +
 xref:configure-multiple-credential-providers.adoc[Configure Multiple Client Providers] - You can use multiple client providers, such as OpenAM and PingFederate, to help you enforce security and regulations in your business organization. These client providers enable you to secure your operational data, including client credentials and access tokens.

modules/ROOT/nav.adoc

@@ -61,7 +61,7 @@ outbound.keystore.password_281324
 outbound.truststore.password_281324
 ----
 
-The `281324` suffix in this case is API Instance ID of your API Proxy.
+The `281324` suffix in this case is API instance ID of your API Proxy.
 
 If you inspect your API Proxy's XML, you can see these properties being used in your trustore/keystore configurations:
 
@@ -91,7 +91,7 @@ outbound.keystore.password_281324
 outbound.truststore.password_281324
 ----
 
-The `281324` suffix in this case is API Instance ID of your API Proxy.
+The `281324` suffix in this case is API instance ID of your API Proxy.
 
 If you inspect your API Proxy's XML, you can see these properties being used in your trustore/keystore configurations:
 
@@ -107,11 +107,8 @@ To deploy your API Proxy to a standalone server, provide secured properties for
 . Download the API Proxy.
 .. In API Manager, select the version of the API proxy you want to download.
 .. Click the *Actions* button in the top-right corner of your screen and select *Download Proxy*.
-. Take note of your API Instance ID under *API Instance*.
-+
-image::building-https-proxy-541ec.png["The Download Proxy form with the API Instance ID highlighted by a rectangle."]
-+
-. When running your standalone Mule instance, you need to provide the keystore and key passphrases as -D arguments, along with your API Proxy's API Instance ID. +
+. Take note of your API instance ID under *API Instance ID*.
+. When running your standalone Mule instance, you need to provide the keystore and key passphrases as -D arguments, along with your API Proxy's API instance ID. +
 For example, if your API instance ID is 15464957, you need to pass the arguments:
 +
 [source,sample,linenums]

modules/ROOT/pages/api-instance-landing-page.adoc

@@ -0,0 +1,16 @@
+= Editing an API Instance Endpoint
+ifndef::env-site,env-github[]
+include::_attributes.adoc[]
+endif::[]
+
+After you create an API instance in API Manager, you can edit the instance's endpoint configuration settings.
+
+For more information about the API endpoint configuration fields, see the relevant table for runtime from xref:configure-api-task.adoc[].
+
+To edit an API instance's endpoint:
+
+. Go to *Anypoint Platform* > *API Manager*.
+. In *API Administration*, click the name of the API instance whose endpoint you want to edit. 
+. Click *Settings*.
+. Edit the desired endpoint configuration fields.
+. Click *Save*.

modules/ROOT/pages/building-https-proxy.adoc

@@ -5,7 +5,12 @@ endif::[]
 :keywords: api, manager, raml
 :page-aliases: general:getting-started:api-lifecycle-overview.adoc
 
-Anypoint API Manager (API Manager) is a component of Anypoint Platform that enables you to manage, govern, and secure APIs. It leverages the runtime capabilities of Anypoint Flex Gateway, Anypoint Mule Gateway and Anypoint Service Mesh, all of which enforce policies, collect and track analytics data, manage proxies, provide encryption and authentication, and manage applications.
+Anypoint API Manager (API Manager) is a component of Anypoint Platform that enables you to manage, govern, and secure APIs. It provides an interface to configure the runtime capabilities of Anypoint Flex Gateway, Anypoint Mule Gateway, and Anypoint Service Mesh. With API Manager you can:
+
+* Enforce policies
+* Collect and track analytics data
+* Manage proxies and applications
+* Provide encryption and authentication
 
 API Manager is tightly integrated with the following tools:
 
@@ -18,13 +23,13 @@ Before using API Manager, familiarize yourself with the user interface and the t
 
 == What API Manager Looks Like
 
-To access API Manager, log in to Anypoint Platform and select *API Manager* from the main menu:
+To access API Manager, log in to Anypoint Platform and select *API Manager*:
 
 image::api-manager-ui-overview.png["API Manager page navigation shown with callouts.",97%,97%]
 
 [calloutlist]
 . The environment selector. Anypoint Platform enables you to create and manage separate deployment environments for APIs and applications. API Manager displays all environments except design environments. For details, see xref:switch-environment-task.adoc[Switching Environments].
-. Navigation menu:
+. Sidebar:
 * *API Groups*
 +
 An _API group_ is an API asset that enables organizations to publish a group of API instances as a single unit. For details, see xref:api-groups-landing-page.adoc[API Groups].
@@ -39,7 +44,7 @@ _Applications_ are external services that consume APIs. For details about applic
 _Custom policies_ are policies that anyone can develop and apply to their APIs, with the intention of extending existing functionality or defining new functionality. For details, see xref:policies::policies-custom-overview.adoc[Custom Policies].
 * *DataGraph Administration*
 +
-Anypoint DataGraph enables you to unify all the data within your application network in a unified schema. For details, see xref:datagraph::index.adoc[Anypoint DataGraph Overview].
+Anypoint DataGraph enables you to unify all the data within your application network in a unified schema. For details, see xref:datagraph::index.adoc[Anypoint DataGraph Overview]. *DataGraph Administration* is only visible after you configure a Datagraph unified schema.
 * *Analytics*
 +
 API analytics provide insight into how your APIs are being used and how they are performing. For details, see xref:viewing-api-analytics.adoc[Reviewing Analytics Usage].
@@ -163,9 +168,9 @@ For details, see xref:api-groups-landing-page.adoc[API Groups].
 
 An API instance describes a configuration of an API that is deployed on one of the following runtimes: Flex Gateway, Mule Gateway, or Service Mesh. API instances are managed by API Manager after they are created using add, promote, or import options. API instances remain under management until they are deleted.
 
-The API Manager dashboard shows key information about a deployed API instance:
+The API Summary shows key information about a deployed API instance:
 
-image::dashboard-legend.png[]
+image::api-instance-summary.png[API Summary page]
 
 For details, see xref:api-instance-landing-page.adoc[API Instance].
 

modules/ROOT/pages/edit-api-endpoint-task.adoc

@@ -18,13 +18,11 @@ To manually approve or reject requests, you must have:
 
 To approve or reject requests to access your API:
 
-. In API Manager, click *API Administration*.
-. Click the name of the API instance to which you are requesting access. 
-. From the configuration page for the API instance, click *Contracts* from the left menu. 
+. Go to *Anypoint Platform* > *API Manager*. 
+. In *API Administration*, click the name of the API instance to which you are requesting access. 
+. Click *Contracts*. 
 +
-The request appears:
-+
-image::approve-requests-api-manager.png[Approving Requests,120%,110%]
+The request appears.
 . Click either *Approve* or *Reject* to approve or reject the access request, respectively.
 
 

modules/ROOT/pages/latest-overview-concept.adoc

@@ -9,15 +9,13 @@ Deleting a contract deletes the approved contract from Anypoint Exchange. Revoki
 
 To delete a contract with an application:
 
-. In API Manager, click *API Administration*.
-. Click the name of the API instance for which you want to revoke access.
+. Go to *Anypoint Platform* > *API Manager*. 
+. In *API Administration*, click the name of the API instance for which you want to revoke access.
 . Click the `<api version>:<api instance or label>` link, for example, `v1:16046365`. 
-. From the configuration page for the API instance, click *Contracts* from the left menu.
+. Click *Contracts*.
 . For the application for which you want to revoke access, click *Revoke*.
 +
-The *Restore* and *Delete* options appear:
-+
-image:revoke-access-to-api.png[Delete API Request]
+The *Restore* and *Delete* options appear.
 . To delete the contract, click *Delete*.
 //image:trash.png[trash icon].