Merge pull request #110768 from anbene/api-docs

Updating CPP API Docs

Author: v-albemi

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-cancel-operations.md

@@ -5,11 +5,14 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: reference
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
-# Cancel operation 
+# Cancel operation
+
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the changes listed in [Cloud Partner Portal API Reference](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview) to ensure your code continues to work after the migration to Partner Center.
 
 This API cancels an operation currently in progress on the offer. Use the [Retrieve operations
 API](./cloud-partner-portal-api-retrieve-operations.md) to get an
@@ -18,13 +21,10 @@ operation, however in some complex scenarios a new operation may be
 required to cancel an existing one. In this case, the HTTP response body
 contains the operation's location that should be used to query status.
 
-You can provide a comma-separated list of email addresses with the
-request, and the API will notify these addresses about the progress of
-the operation.
-
   `POST https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/cancel?api-version=2017-10-31`
 
-URI parameters
+## URI parameters
+
 --------------
 
 |  **Name**    |      **Description**                                  |    **Data type**  |
@@ -34,8 +34,7 @@ URI parameters
 | api-version  |  Current version of API                               |    Date           |
 |  |  |  |
 
-
-Header
+## Header
 ------
 
 |  **Name**              |  **Value**         |
@@ -44,8 +43,7 @@ Header
 |  Authorization         |  Bearer YOUR TOKEN |
 |  |  |
 
-
-Body example
+## Body example
 ------------
 
 ### Request
@@ -65,20 +63,23 @@ Body example
 |  notification-emails     | Comma separated list of email Ids to be notified of the progress of the  publishing operation. |
 |  |  |
 
-
 ### Response
 
-  `Operation-Location: https://cloudpartner.azure.com/api/publishers/contoso/offers/contoso-virtualmachineoffer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8`
+#### Migrated offers
+
+`Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31`
 
+#### Non-migrated offers
+
+`Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31`
 
 ### Response Header
 
 |  **Name**             |    **Value**                       |
 |  ---------            |    ----------                      |
-| Operation-Location    | URL, which can be queried to determine the current status of the operation. |
+| Location    | The relative path to retrieve this operation's status. |
 |  |  |
 
-
 ### Response status codes
 
 | **Code**  |  **Description**                                                                       |

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-concurrency-control.md

@@ -5,12 +5,15 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
 # Concurrency Control
 
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the changes listed in [Cloud Partner Portal API Reference](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview) to ensure your code continues to work after the migration to Partner Center.
+
 Every call to the Cloud Partner Portal publishing APIs must explicitly
 specify which concurrency control strategy to use. Failure to provide
 the **If-Match** header will result in an HTTP 400 error response. We

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-considerations.md

@@ -5,16 +5,18 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
 # API Considerations
 
-
 API versioning
 --------------
 
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the changes listed in [Cloud Partner Portal API Reference](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview) to ensure your code continues to work after the migration to Partner Center.
+
 There may be multiple versions of the API that are available at the same
 time. Clients must indicate which version they wish to invoke use by
 providing the `api-version` parameter as part of the query string.

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-creating-offer.md

@@ -5,13 +5,16 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: reference
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
 Create or modify an offer
 =========================
 
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the changes listed in [Cloud Partner Portal API Reference](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview) to ensure your code continues to work after the migration to Partner Center.
+
 This call updates a specific offer within the publisher namespace or creates a new offer.
 
   `PUT https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>?api-version=2017-10-31`

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-go-live.md

@@ -5,20 +5,22 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: reference
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
-Go Live
-=======
+# Go Live
+
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the changes listed in [Cloud Partner Portal API Reference](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview) to ensure your code continues to work after the migration to Partner Center.
 
 This API starts the process for pushing an app to production. This operation is usually
 long-running. This call uses the notification email list
 from the [Publish](./cloud-partner-portal-api-publish-offer.md) API operation.
 
  `POST  https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/golive?api-version=2017-10-31` 
 
-URI parameters
+## URI parameters
 --------------
 
 |  **Name**      |   **Description**                                                           | **Data type** |
@@ -28,8 +30,7 @@ URI parameters
 | api-version    | Latest version of the API                                                   |  Date         |
 |  |  |  |
 
-
-Header
+## Header
 ------
 
 |  **Name**       |     **Value**       |
@@ -38,23 +39,25 @@ Header
 | Authorization   | `Bearer YOUR_TOKEN` |
 |  |  |
 
-
-Body example
-------------
+## Body example
 
 ### Response
 
-`Operation-Location: https://cloudpartner.azure.com/api/publishers/contoso/offers/contoso-virtualmachineoffer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8`
+#### Migrated offers
 
+`Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31`
+
+#### Non-migrated offers
+
+`Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31`
 
 ### Response Header
 
 |  **Name**             |      **Value**                                                            |
 |  --------             |      ----------                                                           |
-| Operation-Location    |  URL to query to determine the current status of the operation            |
+| Location    |  The relative path to retrieve this operation's status            |
 |  |  |
 
-
 ### Response status codes
 
 | **Code** |  **Description**                                                                        |

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview.md

@@ -5,13 +5,15 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
 
-Cloud Partner Portal API Reference
-==================================
+# Cloud Partner Portal API Reference
+
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the [Changes to CPP APIs](#changes-to-cpp-apis-after-the-migration-to-partner-center) listed in this document to ensure your code continues to work after the migration to Partner Center.
 
 The Cloud Partner Portal REST APIs allow the programmatic retrieval and
 manipulation of workloads, offers, and publisher profiles. The APIs use
@@ -21,47 +23,48 @@ This reference provides the technical details for the Cloud Partner
 Portal REST APIs. The payload samples in this document are for reference
 only and are subject to change as new functionality is added.
 
-
-Prerequisites and considerations
--------------------------------
+## Prerequisites and considerations
 
 Before using the APIs, you should review:
 
 - The [Prerequisites](./cloud-partner-portal-api-prerequisites.md) article to
 learn how to add a service principal to your account, and get an
-Azure Active Directory (Azure AD) access token for authentication. 
-- The two [concurrency control](./cloud-partner-portal-api-concurrency-control.md).
-strategies available for calling these APIs.
-- Additional API [considerations](./cloud-partner-portal-api-considerations.md), such as 
-versioning and error handling.
+Azure Active Directory (Azure AD) access token for authentication.
+- The two [concurrency control](./cloud-partner-portal-api-concurrency-control.md) strategies available for calling these APIs.
+- Additional API [considerations](./cloud-partner-portal-api-considerations.md), such as versioning and error handling.
 
+## Changes to CPP APIs after the migration to Partner Center
 
-Common tasks
-------------
-This reference details APIs to perform the following common tasks.
+| **API** | **Change description** | **Impact** |
+| ------- | ---------------------- | ---------- |
+| POST Publish, GoLive, Cancel | For migrated offers, the response header will have a different format but will continue to work in the same way, denoting a relative path to retrieve the operation status. | When sending any of the corresponding POST requests for an offer, the Location header will have one of two format depending on the migration status of the offer:<ul><li>Non-migrated offers<br>`/api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31`</li><li>Migrated offers<br>`/api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31`</li> |
+| GET Operation | For offer types that previously supported 'notification-email' field in the response, this field will be deprecated and no longer returned for migrated offers. | For migrated offers, we'll no longer send notifications to the list of emails specified in the requests. Instead, the API service will align with the notification email process in Partner Center to send emails. Specifically, notifications will be sent to the email address set in the Seller contact info section of your Account settings in Partner Center, to notify you of operation progress.<br><br>Please review the email address set in the Seller contact info section of your [Account settings](https://partner.microsoft.com/dashboard/account/management) in Partner Center to ensure the correct email is provided for notifications.  |
 
+## Common tasks
+
+This reference details APIs to perform the following common tasks.
 
 ### Offers
 
--   [Retrieve all offers](./cloud-partner-portal-api-retrieve-offers.md)
--   [Retrieve a specific offer](./cloud-partner-portal-api-retrieve-specific-offer.md)
--   [Retrieve offer status](./cloud-partner-portal-api-retrieve-offer-status.md)
--   [Create an offer](./cloud-partner-portal-api-creating-offer.md)
--   [Publish an offer](./cloud-partner-portal-api-publish-offer.md)
+- [Retrieve all offers](./cloud-partner-portal-api-retrieve-offers.md)
+- [Retrieve a specific offer](./cloud-partner-portal-api-retrieve-specific-offer.md)
+- [Retrieve offer status](./cloud-partner-portal-api-retrieve-offer-status.md)
+- [Create an offer](./cloud-partner-portal-api-creating-offer.md)
+- [Publish an offer](./cloud-partner-portal-api-publish-offer.md)
 
 ### Operations
 
--   [Retrieve operations](./cloud-partner-portal-api-retrieve-operations.md)
--   [Cancel operations](./cloud-partner-portal-api-cancel-operations.md)
+- [Retrieve operations](./cloud-partner-portal-api-retrieve-operations.md)
+- [Cancel operations](./cloud-partner-portal-api-cancel-operations.md)
 
 ### Publish an app
 
--   [Go live](./cloud-partner-portal-api-go-live.md)
+- [Go live](./cloud-partner-portal-api-go-live.md)
 
 ### Other tasks
 
--   [Set pricing for virtual machine offers](./cloud-partner-portal-api-setting-price.md)
+- [Set pricing for virtual machine offers](./cloud-partner-portal-api-setting-price.md)
 
 ### Troubleshooting
 
--   [Troubleshooting authentication errors](./cloud-partner-portal-api-troubleshooting-authentication-errors.md)
+- [Troubleshooting authentication errors](./cloud-partner-portal-api-troubleshooting-authentication-errors.md)

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-prerequisites.md

@@ -5,14 +5,17 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: conceptual
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
 
 API Prerequisites
 ================
 
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the changes listed in [Cloud Partner Portal API Reference](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview) to ensure your code continues to work after the migration to Partner Center.
+
 There are two required programmatic assets that you need to use the Cloud Partner Portal APIs: a service principal and an Azure Active Directory (Azure AD) access token.
 
 
@@ -40,7 +43,7 @@ Use the following steps to add the service principal:
 
 -   A **Friendly Name** for the service principal, for example `spAccount`.
 -   The **Application ID**. To find this identifier, go to the [Azure
-    Portal](https://portal.azure.com), click **Azure Active Directory**,
+    portal](https://portal.azure.com), click **Azure Active Directory**,
     choose **App registrations**, and click on your app.
 -   The **Tenant ID**, also known as the **Directory ID**, for your
     Azure AD tenant. You can find this identifier in the Azure Active Directory

articles/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-publish-offer.md

@@ -5,19 +5,21 @@ author: dsindona
 ms.service: marketplace
 ms.subservice: partnercenter-marketplace-publisher
 ms.topic: reference
-ms.date: 09/13/2018
+ms.date: 04/08/2020
 ms.author: dsindona
 ---
 
 
-Publish an offer
-================
+# Publish an offer
+
+> [!NOTE]
+> The Cloud Partner Portal APIs are integrated with Partner Center and will continue to work after your offers are migrated to Partner Center. The integration introduces small changes. Review the changes listed in [Cloud Partner Portal API Reference](https://docs.microsoft.com/azure/marketplace/cloud-partner-portal-orig/cloud-partner-portal-api-overview) to ensure your code continues to work after the migration to Partner Center.
 
 Starts the publishing process for the specified offer. This call is a long running operation.
 
   `POST  https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/publish?api-version=2017-10-31`
 
-URI parameters
+## URI parameters
 --------------
 
 |  **Name**      |    **Description**                               |  **Data type** |
@@ -27,8 +29,7 @@ URI parameters
 |  api-version   | Latest version of the API                        |   Date         |
 |  |  |
 
-
-Header
+## Header
 ------
 
 |  **Name**        |    **Value**          |
@@ -38,7 +39,7 @@ Header
 |  |  |
 
 
-Body example
+## Body example
 ------------
 
 ### Request
@@ -62,14 +63,20 @@ Body example
 
 ### Response
 
-   `Operation-Location: /api/operations/contoso$56615b67-2185-49fe-80d2-c4ddf77bb2e8$2$preview?api-version=2017-10-31`
+#### Migrated offers
+
+`Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31`
+
+#### Non-migrated offers
+
+`Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31`
 
 
 ### Response Header
 
 |  **Name**             |    **Value**                                                                 |
 |  -------------------- | ---------------------------------------------------------------------------- |
-| Operation-Location    | URL that can be queried to determine the current status of the operation.    |
+| Location    | The relative path to retrieve this operation's status     |
 |  |  |