Microsoft Azure Endpoints API

openapi: 3.2.0
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Endpoints API
tags:
- name: Endpoints
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints
  : get:
      tags:
      - Endpoints
      description: Get DigitalTwinsInstance Endpoints.
      operationId: microsoftAzureDigitaltwinsendpointList
      x-ms-examples:
        Get a DigitalTwinsInstance endpoints:
          $ref: ./examples/DigitalTwinsEndpointsGet_example.json
      x-ms-pageable:
        nextLinkName: nextLink
      parameters:
      - $ref: '#/components/parameters/api-version'
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - $ref: '#/components/parameters/resourceName'
      responses:
        '200':
          description: The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DigitalTwinsEndpointResourceListResult'
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Digitaltwins Digitaltwinsinstances Resourcename Endpoints
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/endpoints/{endpointName}
  : get:
      tags:
      - Endpoints
      description: Get DigitalTwinsInstances Endpoint.
      operationId: microsoftAzureDigitaltwinsendpointGet
      x-ms-examples:
        Get a DigitalTwinsInstance endpoint:
          $ref: ./examples/DigitalTwinsEndpointGet_example.json
      parameters:
      - $ref: '#/components/parameters/api-version'
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - $ref: '#/components/parameters/resourceName'
      - $ref: '#/components/parameters/endpointName'
      responses:
        '200':
          description: The body contains all the non-security properties of the DigitalTwinsInstance. Security-related properties are set to null.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DigitalTwinsEndpointResource'
        default:
          description: Default error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Digitaltwins Digitaltwinsinstances Resourcename Endpoints Endpointname
    put:
      tags:
      - Endpoints
      description: Create or update DigitalTwinsInstance endpoint.
      operationId: microsoftAzureDigitaltwinsendpointCreateorupdate
      x-ms-long-running-operation: true
      x-ms-examples:
        Put a DigitalTwinsInstance resource:
          $ref: ./examples/DigitalTwinsEndpointPut_example.json
      parameters:
      - $ref: '#/components/parameters/api-version'
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - $ref: '#/components/parameters/resourceName'
      - $ref: '#/components/parameters/endpointName'
      responses:
        '200':
          description: This is returned as a response to the status polling request for the create or update operation. The body contains the resource representation that indicates a transitional provisioning state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DigitalTwinsEndpointResource'
        '201':
          description: Created - Put request accepted; the operation will complete asynchronously.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DigitalTwinsEndpointResource'
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Digitaltwins Digitaltwinsinstances Resourcename Endpoints Endpointname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DigitalTwinsEndpointResource'
        description: The DigitalTwinsInstance endpoint metadata and security metadata.
        required: true
    delete:
      tags:
      - Endpoints
      description: Delete a DigitalTwinsInstance endpoint.
      operationId: microsoftAzureDigitaltwinsendpointDelete
      x-ms-long-running-operation: true
      x-ms-examples:
        Delete a DigitalTwinsInstance endpoint:
          $ref: ./examples/DigitalTwinsEndpointDelete_example.json
      parameters:
      - $ref: '#/components/parameters/api-version'
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - $ref: '#/components/parameters/resourceName'
      - $ref: '#/components/parameters/endpointName'
      responses:
        '200':
          description: This is returned as a response to the status polling request for the delete operation. The body contains the resource representation that indicates a transitional provisioning state.
        '202':
          description: Accepted - Delete request accepted; the operation will complete asynchronously.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DigitalTwinsEndpointResource'
        '204':
          description: Once the long running delete operation completes successfully, a 204 No Content status code is returned when the status polling request finds the DigitalTwins service metadata in the service and the status of the delete operation is set to a completed state.
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Digitaltwins Digitaltwinsinstances Resourcename Endpoints Endpointname
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints
  : get:
      tags:
      - Endpoints
      description: Lists existing CDN endpoints.
      operationId: microsoftAzureEndpointsListbyprofile
      x-ms-examples:
        Endpoints_ListByProfile:
          $ref: ./examples/Endpoints_ListByProfile.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndpointListResult'
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}
  : get:
      tags:
      - Endpoints
      description: Gets an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.
      operationId: microsoftAzureEndpointsGet
      x-ms-examples:
        Endpoints_Get:
          $ref: ./examples/Endpoints_Get.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname
    put:
      tags:
      - Endpoints
      description: Creates a new CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.
      operationId: microsoftAzureEndpointsCreate
      x-ms-examples:
        Endpoints_Create:
          $ref: ./examples/Endpoints_Create.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        '201':
          description: Created. The request has been fulfilled and a new endpoint has been created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        '202':
          description: Accepted and the operation will complete asynchronously.
          headers:
            location:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-long-running-operation: true
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Endpoint'
        description: Endpoint properties
        required: true
    patch:
      tags:
      - Endpoints
      description: Updates an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile. Only tags can be updated after creating an endpoint. To update origins, use the Update Origin operation. To update origin groups, use the Update Origin group operation. To update custom domains, use the Update Custom Domain operation.
      operationId: microsoftAzureEndpointsUpdate
      x-ms-examples:
        Endpoints_Update:
          $ref: ./examples/Endpoints_Update.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        '202':
          description: Accepted and the operation will complete asynchronously
          headers:
            location:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        default:
          description: CDN error response describing why the operation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-long-running-operation: true
      summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EndpointUpdateParameters'
        description: Endpoint update properties
        required: true
    delete:
      tags:
      - Endpoints
      description: Deletes an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.
      operationId: microsoftAzureEndpointsDelete
      x-ms-examples:
        Endpoints_Delete:
          $ref: ./examples/Endpoints_Delete.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
        '202':
          description: Accepted and the operation will complete asynchronously.
          headers:
            location:
              schema:
                type: string
        '204':
          description: No Content. The request has been accepted but the endpoint was not found.
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-long-running-operation: true
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/start
  : post:
      tags:
      - Endpoints
      description: Starts an existing CDN endpoint that is on a stopped state.
      operationId: microsoftAzureEndpointsStart
      x-ms-examples:
        Endpoints_Start:
          $ref: ./examples/Endpoints_Start.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        '202':
          description: Accepted and the operation will complete asynchronously.
          headers:
            location:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname Start
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/stop
  : post:
      tags:
      - Endpoints
      description: Stops an existing running CDN endpoint.
      operationId: microsoftAzureEndpointsStop
      x-ms-examples:
        Endpoints_Stop:
          $ref: ./examples/Endpoints_Stop.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        '202':
          description: Accepted and the operation will complete asynchronously.
          headers:
            location:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Endpoint'
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname Stop
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/purge
  : post:
      tags:
      - Endpoints
      description: Removes a content from CDN.
      operationId: microsoftAzureEndpointsPurgecontent
      x-ms-examples:
        Endpoints_PurgeContent:
          $ref: ./examples/Endpoints_PurgeContent.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
        '202':
          description: Accepted and the operation will complete asynchronously.
          headers:
            location:
              schema:
                type: string
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname Purge
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PurgeParameters'
        description: The path to the content to be purged. Path can be a full URL, e.g. '/pictures/city.png' which removes a single file, or a directory with a wildcard, e.g. '/pictures/*' which removes all folders and files in the directory.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/load
  : post:
      tags:
      - Endpoints
      description: Pre-loads a content to CDN. Available for Verizon Profiles.
      operationId: microsoftAzureEndpointsLoadcontent
      x-ms-examples:
        Endpoints_LoadContent:
          $ref: ./examples/Endpoints_LoadContent.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
        '202':
          description: Accepted and the operation will complete asynchronously.
          headers:
            location:
              schema:
                type: string
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-long-running-operation: true
      summary: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname Load
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoadParameters'
        description: 'The path to the content to be loaded. Path should be a full URL, e.g. ‘/pictures/city.png'' which loads a single file '
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/validateCustomDomain
  : post:
      tags:
      - Endpoints
      description: Validates the custom domain mapping to ensure it maps to the correct CDN endpoint in DNS.
      operationId: microsoftAzureEndpointsValidatecustomdomain
      x-ms-examples:
        Endpoints_ValidateCustomDomain:
          $ref: ./examples/Endpoints_ValidateCustomDomain.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateCustomDomainOutput'
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      summary: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname Validatecustomdomain
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ValidateCustomDomainInput'
        description: Custom domain to be validated.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/checkResourceUsage
  : post:
      tags:
      - Endpoints
      description: Checks the quota and usage of geo filters and custom domains under the given endpoint.
      operationId: microsoftAzureEndpointsListresourceusage
      x-ms-examples:
        Endpoints_ListResourceUsage:
          $ref: ./examples/Endpoints_ListResourceUsage.json
      parameters:
      - $ref: '#/components/parameters/resourceGroupNameParameter'
      - name: profileName
        in: path
        description: Name of the CDN profile which is unique within the resource group.
        required: true
        schema:
          type: string
      - name: endpointName
        in: path
        description: Name of the endpoint under the profile which is unique globally.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/subscriptionIdParameter'
      - $ref: '#/components/parameters/apiVersionParameter'
      responses:
        '200':
          description: OK. The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceUsageListResult'
        default:
          description: CDN error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse_2'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Cdn Profiles Profilename Endpoints Endpointname Checkresourceusage
  /{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints:
    get:
      tags:
      - Endpoints
      description: List of endpoints to the target resource.
      operationId: microsoftAzureEndpointsList
      x-ms-examples:
        HybridConnectivityEndpointsGet:
          $ref: ./examples/EndpointsList.json
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: '#/components/parameters/ResourceUriParameter'
      responses:
        '200':
          description: List of endpoints.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndpointsList'
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      deprecated: false
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Get Resourceuri Providers Microsoft Hybridconnectivity Endpoints
  /{resourceUri}/providers/Microsoft.HybridConnectivity/endpoints/{endpointName}:
    get:
      tags:
      - Endpoints
      description: Gets the endpoint to the resource.
      operationId: microsoftAzureEndpointsGet
      x-ms-examples:
        HybridConnectivityEndpointsGetDefault:
          $ref: ./examples/EndpointsGetDefault.json
        HybridConnectivityEndpointsGetCustom:
          $ref: ./examples/EndpointsGetCustom.json
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: '#/components/parameters/ResourceUriParameter'
      - $ref: '#/components/parameters/EndpointNameParameter'
      responses:
        '200':
          description: Endpoint details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndpointResource'
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      deprecated: false
      summary: Microsoft Azure Get Resourceuri Providers Microsoft Hybridconnectivity Endpoints Endpointname
    put:
      tags:
      - Endpoints
      description: Create or update the endpoint to the target resource.
      operationId: microsoftAzureEndpointsCreateorupdate
      x-ms-examples:
        HybridConnectivityEndpointsPutDefault:
          $ref: ./examples/EndpointsPutDefault.json
        HybridConnectivityEndpointsPutCustom:
          $ref: ./examples/EndpointsPutCustom.json
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: '#/components/parameters/ResourceUriParameter'
      - $ref: '#/components/parameters/EndpointNameParameter'
      responses:
        '200':
          description: Endpoint details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndpointResource'
        default:
          description: Error response describing why the operation failed.
          content:
            application/json:
              schema:
                $ref: ../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse
      summary: Microsoft Azure Put Resourceuri Providers Microsoft Hybridconnectivity Endpoints Endpointname
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EndpointResource'
        description: Endpoint details
        required: true
    patch:
      tags:
      - Endpoints
      description: Update the endpoint to the target resource.
      operationId: microsoftAzureEndpointsUpdate
      x-ms-examples:
        HybridConnectivityEndpointsPatchDefault:
          $ref: ./examples/EndpointsPatchDefault.json
      parameters:
      - $ref: ../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter
      - $ref: '#/components/parameters/ResourceUriParameter'
      - $ref: '#/components/parameters/EndpointNameParameter'
      responses:
        '200':
          description: Endpoint resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndpointReso

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