Microsoft Azure

Microsoft Azure Recommendations Service

Microsoft Azure Recommendations Service is a cloud-based tool that helps businesses enhance customer engagement and increase sales by providing personalized product recommendations. By analyzing customer behavior and preferences, the service generates targeted recommendations that are tailored to the individual user's needs and interests. This helps companies deliver more relevant and valuable content to their customers, ultimately leading to higher conversion rates and customer satisfaction.

GitHub OpenAPI

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/azure/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/recommendationsservice-openapi-original.yml

OpenAPI Specification

recommendationsservice-openapi-original.yml Raw ↑ 
swagger: '2.0'
info:
  title: Microsoft Azure RecommendationsService
  description: Dynamics 365 Recommendations Service resource provider
  version: 2022-03-01-preview
host: management.azure.com
schemes:
  - https
consumes:
  - application/json
produces:
  - application/json
security:
  - azure_auth:
      - user_impersonation
securityDefinitions:
  azure_auth:
    description: Azure Active Directory OAuth2 Flow.
    type: oauth2
    authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
    flow: implicit
    scopes:
      user_impersonation: Impersonate your user account.
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.RecommendationsService/checkNameAvailability:
    post:
      operationId: microsoftAzureAccountsChecknameavailability
      description: >-
        Checks that the RecommendationsService Account name is valid and is not
        already in use.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - description: Check name availability request details.
          name: body
          in: body
          required: true
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/CheckNameAvailabilityRequest
      responses:
        '200':
          description: Successful. The response describes the name availability.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/CheckNameAvailabilityResponse
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Check name availability of RecommendationsService Account - name available:
          $ref: ./examples/Accounts_CheckNameAvailabilityAvailable.json
        Check name availability of RecommendationsService Account - name unavailable:
          $ref: ./examples/Accounts_CheckNameAvailabilityUnavailable.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Recommendationsservice Checknameavailability
      tags:
        - Subscriptions
  /subscriptions/{subscriptionId}/providers/Microsoft.RecommendationsService/accounts:
    get:
      operationId: microsoftAzureAccountsListbysubscription
      description: Returns list of RecommendationsService Account resources.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Account resources list.
          schema:
            $ref: '#/definitions/AccountResourceList'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Get RecommendationsService Account resources by subscription:
          $ref: ./examples/Accounts_ListBySubscription.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Recommendationsservice Accounts
      tags:
        - Subscriptions
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts:
    get:
      operationId: microsoftAzureAccountsListbyresourcegroup
      description: Returns list of RecommendationsService Account resources.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
      responses:
        '200':
          description: Account resources list.
          schema:
            $ref: '#/definitions/AccountResourceList'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Get RecommendationsService Account resources by resource group:
          $ref: ./examples/Accounts_ListByResourceGroup.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}
  : get:
      operationId: microsoftAzureAccountsGet
      description: Returns RecommendationsService Account resource for a given name.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
      responses:
        '200':
          description: Account details.
          schema:
            $ref: '#/definitions/AccountResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Get RecommendationsService Account resource:
          $ref: ./examples/Accounts_Get.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname
      tags:
        - Subscriptions
    put:
      operationId: microsoftAzureAccountsCreateorupdate
      description: Creates or updates RecommendationsService Account resource.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - description: Account details.
          name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/AccountResource'
      responses:
        '200':
          description: Successful.
          schema:
            $ref: '#/definitions/AccountResource'
        '201':
          description: RecommendationsService Account resource is being created or updated.
          schema:
            $ref: '#/definitions/AccountResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Create or update RecommendationsService Account resource:
          $ref: ./examples/Accounts_CreateOrUpdate.json
        Create or update RecommendationsService Account resource with managed identity:
          $ref: ./examples/Accounts_CreateOrUpdateWithManagedIdentity.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname
      tags:
        - Subscriptions
    patch:
      operationId: microsoftAzureAccountsUpdate
      description: Updates RecommendationsService Account details.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - description: Account resource patch details.
          name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/AccountPatchResource'
      responses:
        '200':
          description: Successful.
          schema:
            $ref: '#/definitions/AccountResource'
        '202':
          description: RecommendationsService Account resource is being updated.
          schema:
            $ref: '#/definitions/AccountResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Update existing RecommendationsService Account resource:
          $ref: ./examples/Accounts_Update.json
        Update existing RecommendationsService Account resource with managed identity:
          $ref: ./examples/Accounts_UpdateWithManagedIdentity.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname
      tags:
        - Subscriptions
    delete:
      operationId: microsoftAzureAccountsDelete
      description: Deletes RecommendationsService Account resource.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
      responses:
        '200':
          description: RecommendationsService Account resource deleted successfully.
        '202':
          description: RecommendationsService Account resource is being deleted.
        '204':
          description: RecommendationsService Account resource does not exist.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Delete RecommendationsService Account resource:
          $ref: ./examples/Accounts_Delete.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/status
  : post:
      operationId: microsoftAzureAccountsGetstatus
      description: Returns RecommendationsService Account status.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
      responses:
        '200':
          description: The status of the account.
          schema:
            $ref: '#/definitions/AccountStatus'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Get RecommendationsService Account status - Modeling resource exists:
          $ref: ./examples/Accounts_GetStatus_ModelingExists.json
        Get account status - no Modeling resource exists:
          $ref: ./examples/Accounts_GetStatus_NoModelingExists.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Status
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/modeling
  : get:
      operationId: microsoftAzureModelingListbyaccountresource
      description: Returns list of Modeling resources for a given Account name.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
      responses:
        '200':
          description: Modeling resources list.
          schema:
            $ref: '#/definitions/ModelingResourceList'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Get Modeling resources by RecommendationsService Account resource:
          $ref: ./examples/Modeling_ListByAccountResource.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Modeling
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/modeling/{modelingName}
  : get:
      operationId: microsoftAzureModelingGet
      description: Returns Modeling resources for a given name.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ModelingNameParameter'
      responses:
        '200':
          description: Modeling resource details.
          schema:
            $ref: '#/definitions/ModelingResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Get Modeling resource:
          $ref: ./examples/Modeling_Get.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Modeling Modelingname
      tags:
        - Subscriptions
    put:
      operationId: microsoftAzureModelingCreateorupdate
      description: Creates or updates Modeling resource.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ModelingNameParameter'
        - description: Modeling resource details.
          name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/ModelingResource'
      responses:
        '200':
          description: Successful.
          schema:
            $ref: '#/definitions/ModelingResource'
        '201':
          description: Modeling resource is being created or updated.
          schema:
            $ref: '#/definitions/ModelingResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Create or update Modeling resource:
          $ref: ./examples/Modeling_CreateOrUpdate.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Modeling Modelingname
      tags:
        - Subscriptions
    patch:
      operationId: microsoftAzureModelingUpdate
      description: Updates Modeling resource details.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ModelingNameParameter'
        - description: Modeling resource patch details.
          name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/ModelingPatchResource'
      responses:
        '200':
          description: Successful.
          schema:
            $ref: '#/definitions/ModelingResource'
        '202':
          description: Modeling resource is being updated.
          schema:
            $ref: '#/definitions/ModelingResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Update Modeling resource:
          $ref: ./examples/Modeling_Update.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Modeling Modelingname
      tags:
        - Subscriptions
    delete:
      operationId: microsoftAzureModelingDelete
      description: Deletes Modeling resources of a given name.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ModelingNameParameter'
      responses:
        '200':
          description: Modeling resource deleted successfully.
        '202':
          description: Modeling resource is being deleted.
        '204':
          description: Modeling resource does not exist.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Delete Modeling resource:
          $ref: ./examples/Modeling_Delete.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Modeling Modelingname
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/serviceEndpoints
  : get:
      operationId: microsoftAzureServiceendpointsListbyaccountresource
      description: Returns list of ServiceEndpoint resources for a given Account name.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
      responses:
        '200':
          description: ServiceEndpoint resources list.
          schema:
            $ref: '#/definitions/ServiceEndpointResourceList'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Get ServiceEndpoint resources by RecommendationsService Account resource:
          $ref: ./examples/ServiceEndpoints_ListByAccountResource.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Serviceendpoints
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecommendationsService/accounts/{accountName}/serviceEndpoints/{serviceEndpointName}
  : get:
      operationId: microsoftAzureServiceendpointsGet
      description: Returns ServiceEndpoint resources for a given name.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ServiceEndpointNameParameter'
      responses:
        '200':
          description: ServiceEndpoint resource details.
          schema:
            $ref: '#/definitions/ServiceEndpointResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Get ServiceEndpoint resource:
          $ref: ./examples/ServiceEndpoints_Get.json
      summary: >-
        Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Serviceendpoints Serviceendpointname
      tags:
        - Subscriptions
    put:
      operationId: microsoftAzureServiceendpointsCreateorupdate
      description: Creates or updates ServiceEndpoint resource.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ServiceEndpointNameParameter'
        - description: ServiceEndpoint resource details.
          name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/ServiceEndpointResource'
      responses:
        '200':
          description: Successful.
          schema:
            $ref: '#/definitions/ServiceEndpointResource'
        '201':
          description: ServiceEndpoint resource is being created or updated.
          schema:
            $ref: '#/definitions/ServiceEndpointResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Create or update ServiceEndpoint resource:
          $ref: ./examples/ServiceEndpoints_CreateOrUpdate.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Serviceendpoints Serviceendpointname
      tags:
        - Subscriptions
    patch:
      operationId: microsoftAzureServiceendpointsUpdate
      description: Updates ServiceEndpoint resource details.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ServiceEndpointNameParameter'
        - description: ServiceEndpoint resource patch details.
          name: body
          in: body
          required: true
          schema:
            $ref: '#/definitions/ServiceEndpointPatchResource'
      responses:
        '200':
          description: Successful.
          schema:
            $ref: '#/definitions/ServiceEndpointResource'
        '202':
          description: ServiceEndpoint resource is being updated.
          schema:
            $ref: '#/definitions/ServiceEndpointResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Update ServiceEndpoint resource:
          $ref: ./examples/ServiceEndpoints_Update.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Serviceendpoints Serviceendpointname
      tags:
        - Subscriptions
    delete:
      operationId: microsoftAzureServiceendpointsDelete
      description: Deletes ServiceEndpoint resources of a given name.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter
        - $ref: '#/parameters/AccountNameParameter'
        - $ref: '#/parameters/ServiceEndpointNameParameter'
      responses:
        '200':
          description: ServiceEndpoint resource deleted successfully.
        '202':
          description: ServiceEndpoint Account resource is being created or updated.
        '204':
          description: ServiceEndpoint resource does not exist.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Delete ServiceEndpoint resource:
          $ref: ./examples/ServiceEndpoints_Delete.json
      x-ms-long-running-operation: true
      x-ms-long-running-operation-options:
        final-state-via: azure-async-operation
      summary: >-
        Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Recommendationsservice Accounts Accountname Serviceendpoints Serviceendpointname
      tags:
        - Subscriptions
  /providers/Microsoft.RecommendationsService/locations/{location}/operationStatuses/{operationId}:
    get:
      operationId: microsoftAzureOperationstatusesGet
      description: Returns the current status of an async operation.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/LocationParameter
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/OperationIdParameter
      responses:
        '200':
          description: Requested operation status
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/OperationStatusResult
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      x-ms-examples:
        Get operation status:
          $ref: ./examples/OperationStatuses_Get.json
      summary: >-
        Microsoft Azure Get Providers Microsoft Recommendationsservice Locations Location Operationstatuses Operationid
      tags:
        - Providers
  /providers/Microsoft.RecommendationsService/operations:
    get:
      operationId: microsoftAzureOperationsList
      description: Returns list of operations.
      parameters:
        - $ref: >-
            ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      responses:
        '200':
          description: Operation details.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definitions/OperationListResult
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: >-
              ../../../../../common-types/resource-management/v2/types.json#/definiti

# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/recommendationsservice-openapi-original.yml