Microsoft Azure IotDpsResource API

swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector IotDpsResource API
schemes:
- https
tags:
- name: IotDpsResource
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}
  : get:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Get The Non Security Related Metadata Of The Provisioning Service
      description: Get the metadata of the provisioning service without SAS keys.
      operationId: microsoftAzureIotdpsresourceGet
      x-ms-examples:
        DPSGet:
          $ref: ./examples/DPSGet.json
      parameters:
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: Name of the provisioning service to retrieve.
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: Resource group name.
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: Provisioning service description with no keys is included in the response.
          schema:
            $ref: '#/definitions/ProvisioningServiceDescription'
        default:
          description: Default error response
          schema:
            $ref: '#/definitions/ErrorDetails'
      produces:
      - application/json
      consumes:
      - application/json
    put:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Create Or Update The Metadata Of The Provisioning Service
      description: Create or update the metadata of the provisioning service. The usual pattern to modify a property is to retrieve the provisioning service metadata and security metadata, and then combine them with the modified values in a new body to update the provisioning service.
      x-ms-long-running-operation: true
      operationId: microsoftAzureIotdpsresourceCreateorupdate
      x-ms-examples:
        DPSCreate:
          $ref: ./examples/DPSCreate.json
        DPSUpdate:
          $ref: ./examples/DPSUpdate.json
      parameters:
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: Resource group identifier.
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: Name of provisioning service to create or update.
      - name: iotDpsDescription
        in: body
        required: true
        description: Description of the provisioning service to create or update.
        schema:
          $ref: '#/definitions/ProvisioningServiceDescription'
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: The body contains all the non-security properties of the provisioning service. Security-related properties are set to null.
          schema:
            $ref: '#/definitions/ProvisioningServiceDescription'
        '201':
          description: This is a long running operation. The operation returns a 201 if the validation is complete. The response includes an Azure-AsyncOperation header that contains a status URL. Clients are expected to poll the status URL for the status of the operation. If successful, the operation returns HTTP status code of 201 (OK).
          schema:
            $ref: '#/definitions/ProvisioningServiceDescription'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
      produces:
      - application/json
      consumes:
      - application/json
    patch:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Update An Existing Provisioning Service S Tags
      description: Update an existing provisioning service's tags. to update other fields use the CreateOrUpdate method
      x-ms-long-running-operation: true
      operationId: microsoftAzureIotdpsresourceUpdate
      x-ms-examples:
        DPSPatch:
          $ref: ./examples/DPSPatch.json
      parameters:
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: Resource group identifier.
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: Name of provisioning service to create or update.
      - name: ProvisioningServiceTags
        in: body
        required: true
        description: Updated tag information to set into the provisioning service instance.
        schema:
          $ref: '#/definitions/TagsResource'
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: Provisioning Service was successfully updated
          schema:
            $ref: '#/definitions/ProvisioningServiceDescription'
      produces:
      - application/json
      consumes:
      - application/json
    delete:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Delete The Provisioning Service
      description: Deletes the Provisioning Service.
      x-ms-long-running-operation: true
      operationId: microsoftAzureIotdpsresourceDelete
      x-ms-examples:
        DPSDelete:
          $ref: ./examples/DPSDelete.json
      consumes: []
      produces:
      - application/json
      parameters:
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: Name of provisioning service to delete.
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: Resource group identifier.
      - $ref: '#/parameters/api-version'
      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: The provisioning service resource provider always returns a 202 Accepted status code with valid Location and Retry-After headers. The resource provider also sets the Azure-AsyncOperation header with a URL that points to the operation resource for this operation. Subsequent GET attempts on the resource after a DELETE operation return a resource representation that indicates a transitional provisioning state (such as Terminating). To retrieve the status of the operation, a client can either poll the URL returned in the Location header after the Retry-After interval, get the provisioning service status directly, or query the operation resource.
        '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 provisioning service metadata in the service and the status of the delete operation is set to a completed state.
        '404':
          description: After the long running delete operation completes successfully, a 404 Not Found is returned when the status polling request no longer finds the provisioning service metadata in the service.
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
  /subscriptions/{subscriptionId}/providers/Microsoft.Devices/provisioningServices:
    get:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Get All The Provisioning Services In A Subscription
      description: List all the provisioning services for a given subscription id.
      operationId: microsoftAzureIotdpsresourceListbysubscription
      x-ms-examples:
        DPSListBySubscription:
          $ref: ./examples/DPSListBySubscription.json
      parameters:
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the provisioning services in the subscription.
          schema:
            $ref: '#/definitions/ProvisioningServiceDescriptionListResult'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
      x-ms-pageable:
        nextLinkName: nextLink
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices:
    get:
      tags:
      - IotDpsResource
      operationId: microsoftAzureIotdpsresourceListbyresourcegroup
      description: Get a list of all provisioning services in the given resource group.
      x-ms-examples:
        DPSListByResourceGroup:
          $ref: ./examples/DPSListByResourceGroup.json
      consumes: []
      produces:
      - application/json
      parameters:
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: Resource group identifier.
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: List of provisioning services in the resource group.
          schema:
            $ref: '#/definitions/ProvisioningServiceDescriptionListResult'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Devices Provisioningservices
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/operationresults/{operationId}
  : get:
      tags:
      - IotDpsResource
      operationId: microsoftAzureIotdpsresourceGetoperationresult
      description: Gets the status of a long running operation, such as create, update or delete a provisioning service.
      x-ms-examples:
        DPSGetOperationResult:
          $ref: ./examples/DPSGetOperationResult.json
      consumes: []
      produces:
      - application/json
      parameters:
      - name: operationId
        in: path
        required: true
        type: string
        description: Operation id corresponding to long running operation. Use this to poll for the status.
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: Resource group identifier.
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: Name of provisioning service that the operation is running on.
      - name: asyncinfo
        in: query
        description: Async header used to poll on the status of the operation, obtained while creating the long running operation.
        required: true
        type: string
        default: 'true'
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: The status of the long running operation.
          schema:
            $ref: '#/definitions/AsyncOperationResult'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Devices Provisioningservices Provisioningservicename Operationresults Operationid
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/skus
  : get:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Get The List Of Valid Skus For A Provisioning Service
      description: Gets the list of valid SKUs and tiers for a provisioning service.
      operationId: microsoftAzureIotdpsresourceListvalidskus
      x-ms-examples:
        DPSGetValidSku:
          $ref: ./examples/DPSGetValidSku.json
      parameters:
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: Name of provisioning service.
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: Name of resource group.
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: This is a synchronous operation. The body contains a JSON-serialized array of the valid SKUs for this provisioning service.
          schema:
            $ref: '#/definitions/IotDpsSkuDefinitionListResult'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
      x-ms-pageable:
        nextLinkName: nextLink
  /subscriptions/{subscriptionId}/providers/Microsoft.Devices/checkProvisioningServiceNameAvailability:
    post:
      tags:
      - IotDpsResource
      operationId: microsoftAzureIotdpsresourceCheckprovisioningservicenameavailability
      x-ms-examples:
        DPSCheckName:
          $ref: ./examples/DPSCheckNameAvailability.json
      summary: Microsoft Azure Check If A Provisioning Service Name Is Available
      description: Check if a provisioning service name is available. This will validate if the name is syntactically valid and if the name is usable
      parameters:
      - $ref: '#/parameters/subscriptionId'
      - name: arguments
        in: body
        required: true
        description: Set the name parameter in the OperationInputs structure to the name of the provisioning service to check.
        schema:
          $ref: '#/definitions/OperationInputs'
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: This is a synchronous operation. The body contains a JSON-serialized response that specifies whether the provisioning service name is available. If the name is not available, the body contains the reason.
          schema:
            $ref: '#/definitions/NameAvailabilityInfo'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/listkeys
  : post:
      tags:
      - IotDpsResource
      operationId: microsoftAzureIotdpsresourceListkeys
      x-ms-examples:
        DPSListKeys:
          $ref: ./examples/DPSListKeys.json
      summary: Microsoft Azure Get The Security Metadata For A Provisioning Service
      description: List the primary and secondary keys for a provisioning service.
      parameters:
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: The provisioning service name to get the shared access keys for.
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        in: path
        required: true
        type: string
        description: resource group name
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: This is a synchronous operation. The body contains a JSON-serialized array of shared access policies, including keys, that you can use to access the provisioning service endpoints.
          schema:
            $ref: '#/definitions/SharedAccessSignatureAuthorizationRuleListResult'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
      x-ms-pageable:
        nextLinkName: nextLink
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}/keys/{keyName}/listkeys
  : post:
      tags:
      - IotDpsResource
      operationId: microsoftAzureIotdpsresourceListkeysforkeyname
      x-ms-examples:
        DPSGetKey:
          $ref: ./examples/DPSGetKey.json
      summary: Microsoft Azure Get A Shared Access Policy By Name From A Provisioning Service
      description: List primary and secondary keys for a specific key name
      parameters:
      - name: provisioningServiceName
        in: path
        required: true
        type: string
        description: Name of the provisioning service.
      - name: keyName
        in: path
        required: true
        type: string
        description: Logical key name to get key-values for.
      - $ref: '#/parameters/subscriptionId'
      - name: resourceGroupName
        description: The name of the resource group that contains the provisioning service.
        in: path
        required: true
        type: string
      - $ref: '#/parameters/api-version'
      responses:
        '200':
          description: This is a synchronous operation. The body contains a JSON-serialized shared access policy, including keys, that you can use to access one or more provisioning service endpoints.
          schema:
            $ref: '#/definitions/SharedAccessSignatureAuthorizationRule[AccessRightsDescription]'
        default:
          description: Default error response.
          schema:
            $ref: '#/definitions/ErrorDetails'
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{resourceName}/privateLinkResources
  : get:
      tags:
      - IotDpsResource
      summary: Microsoft Azure List Private Link Resources
      description: List private link resources for the given provisioning service
      operationId: microsoftAzureIotdpsresourceListprivatelinkresources
      x-ms-examples:
        PrivateLinkResources_List:
          $ref: ./examples/DPSListPrivateLinkResources.json
      parameters:
      - $ref: '#/parameters/api-version'
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - $ref: '#/parameters/resourceName'
      responses:
        '200':
          description: The body contains the list of private link resources
          schema:
            $ref: '#/definitions/PrivateLinkResources'
        default:
          description: DefaultErrorResponse
          schema:
            $ref: '#/definitions/ErrorDetails'
      deprecated: false
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{resourceName}/privateLinkResources/{groupId}
  : get:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Get The Specified Private Link Resource
      description: Get the specified private link resource for the given provisioning service
      operationId: microsoftAzureIotdpsresourceGetprivatelinkresources
      x-ms-examples:
        PrivateLinkResources_List:
          $ref: ./examples/DPSGetPrivateLinkResources.json
      parameters:
      - $ref: '#/parameters/api-version'
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - $ref: '#/parameters/resourceName'
      - $ref: '#/parameters/groupId'
      responses:
        '200':
          description: The body contains the specified of private link resource
          schema:
            $ref: '#/definitions/GroupIdInformation'
        default:
          description: DefaultErrorResponse
          schema:
            $ref: '#/definitions/ErrorDetails'
      deprecated: false
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{resourceName}/privateEndpointConnections
  : get:
      tags:
      - IotDpsResource
      summary: Microsoft Azure List Private Endpoint Connections
      description: List private endpoint connection properties
      operationId: microsoftAzureIotdpsresourceListprivateendpointconnections
      x-ms-examples:
        PrivateEndpointConnections_List:
          $ref: ./examples/DPSListPrivateEndpointConnections.json
      parameters:
      - $ref: '#/parameters/api-version'
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - $ref: '#/parameters/resourceName'
      responses:
        '200':
          description: The body contains the list of private endpoint connection properties
          schema:
            $ref: '#/definitions/PrivateEndpointConnectionsList'
        default:
          description: DefaultErrorResponse
          schema:
            $ref: '#/definitions/ErrorDetails'
      deprecated: false
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}
  : get:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Get Private Endpoint Connection
      description: Get private endpoint connection properties
      operationId: microsoftAzureIotdpsresourceGetprivateendpointconnection
      x-ms-examples:
        PrivateEndpointConnection_Get:
          $ref: ./examples/DPSGetPrivateEndpointConnection.json
      parameters:
      - $ref: '#/parameters/api-version'
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - $ref: '#/parameters/resourceName'
      - $ref: '#/parameters/privateEndpointConnectionName'
      responses:
        '200':
          description: The body contains the private endpoint connection properties
          schema:
            $ref: '#/definitions/PrivateEndpointConnection'
        default:
          description: DefaultErrorResponse
          schema:
            $ref: '#/definitions/ErrorDetails'
      deprecated: false
    put:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Create Or Update Private Endpoint Connection
      description: Create or update the status of a private endpoint connection with the specified name
      operationId: microsoftAzureIotdpsresourceCreateorupdateprivateendpointconnection
      x-ms-examples:
        PrivateEndpointConnection_CreateOrUpdate:
          $ref: ./examples/DPSCreateOrUpdatePrivateEndpointConnection.json
      x-ms-long-running-operation: true
      parameters:
      - $ref: '#/parameters/api-version'
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - $ref: '#/parameters/resourceName'
      - $ref: '#/parameters/privateEndpointConnectionName'
      - name: privateEndpointConnection
        in: body
        description: The private endpoint connection with updated properties
        required: true
        schema:
          $ref: '#/definitions/PrivateEndpointConnection'
      responses:
        '200':
          description: This is returned as a response to the status polling request for the update operation.
          schema:
            $ref: '#/definitions/PrivateEndpointConnection'
        '201':
          description: This is a long running operation. The operation returns a 201 if the validation is complete. The response includes an Azure-AsyncOperation header that contains a status URL. Clients are expected to poll the status URL for the status of the operation. If successful, the operation returns HTTP status code of 201 (OK).
          schema:
            $ref: '#/definitions/PrivateEndpointConnection'
        default:
          description: DefaultErrorResponse
          schema:
            $ref: '#/definitions/ErrorDetails'
      deprecated: false
    delete:
      tags:
      - IotDpsResource
      summary: Microsoft Azure Delete Private Endpoint Connection
      description: Delete private endpoint connection with the specified name
      operationId: microsoftAzureIotdpsresourceDeleteprivateendpointconnection
      x-ms-examples:
        PrivateEndpointConnection_Delete:
          $ref: ./examples/DPSDeletePrivateEndpointConnection.json
      x-ms-long-running-operation: true
      parameters:
      - $ref: '#/parameters/api-version'
      - $ref: '#/parameters/subscriptionId'
      - $ref: '#/parameters/resourceGroupName'
      - $ref: '#/parameters/resourceName'
      - $ref: '#/parameters/privateEndpointConnectionName'
      responses:
        '200':
          description: This is returned as a response to the status polling request for the delete operation.
          schema:
            $ref: '#/definitions/PrivateEndpointConnection'
        '202':
          description: This is a long running operation. The operation returns a 202 if the validation is complete. The response includes an Azure-AsyncOperation header that contains a status URL. Clients are expected to poll the status URL for the status of the operation.
          schema:
            $ref: '#/definitions/PrivateEndpointConnection'
          headers:
            Azure-AsyncOperation:
              type: string
              description: Operation Status Location URI
            Location:
              type: string
              description: Operation Status Location URI
            Retry-After:
              description: Retry After
              type: string
        '204':
          description: PrivateEndpoint does not exist.
        default:
          description: DefaultErrorResponse
          schema:
            $ref: '#/definitions/ErrorDetails'
      deprecated: false
definitions:
  ErrorMessage:
    description: Error response containing message and code.
    type: object
    properties:
      code:
        description: standard error code
        type: string
      message:
        description: standard error description
        type: string
      details:
        description: detailed summary of error
        type: string
  AsyncOperationResult:
    type: object
    description: Result of a long running operation.
    properties:
      status:
        description: current status of a long running operation.
        type: string
      error:
        description: Error message containing code, description and details
        $ref: '#/definitions/ErrorMessage'
  PrivateEndpoint:
    description: The private endpoint property of a private endpoint connection
    type: object
    properties:
      id:
        readOnly: true
        type: string
        description: The resource identifier.
  ErrorDetails:
    description: Error details.
    type: object
    properties:
      code:
        description: The error code.
        format: int32
        type: integer
        readOnly: true
      httpStatusCode:
        description: The HTTP status code.
        type: string
        readOnly: true
      message:
        description: The error message.
        type: string
        readOnly: true
      details:
        description: The error details.
        type: string
        readOnly: true
  IotDpsSkuDefinitionListResult:
    type: object
    description: List of available SKUs.
    properties:
      value:
        description: The list of SKUs
        type: array
        items:
          $ref: '#/definitions/IotDpsSkuDefinition'
      nextLink:
        description: The next link.
        type: string
        readOnly: true
  SharedAccessSignatureAuthorizationRuleListResult:
    type: object
    description: List of shared access keys.
    properties:
      value:
        description: The list of shared access policies.
        type: array
        items:
          $ref: '#/definitions/SharedAccessSignatureAuthorizationRule[AccessRightsDescription]'
      nextLink:
        description: The next link.
        type: string
        readOnly: true
  PrivateLinkServiceConnectionState:
    description: The current state of a private endpoint connection
    type: object
    properties:
      status:
        description: The status of a private endpoint connection
        enum:
        - Pending
        - Approved
        - Rejected
        - Disconnected
        type: string
        x-ms-enum:
          name: PrivateLinkServiceConnectionStatus
          modelAsString: true
      description:
        type: string
        description: The description for the current state of a private endpoint connection
      actionsRequired:
        type: string
        description: Actions required for a private endpoint connection
    required:
    - status
    - description
  ProvisioningServiceDescription:
    description: The description of the provisioning service.
    type: object
    properties:
      etag:
        description: The Etag field is *not* required. If it is provided in the response body, it must also be provided as a header per the normal ETag convention.
        type: string
      properties:
        description: Service specific properties for a provisioning service
        $ref: '#/definitions/IotDpsPropertiesDescription'
      sku:
        description: Sku info for a provisioning Service.
        $ref: '#/definitions/IotDpsSkuInfo'
      systemData:
        $ref: ../../../../../common-types/resource-management/v2/types.json#/definitions/systemData
        readOnly: true
      identity:
        description: The managed identities for a provisioning service.
        $ref: ../../../../../common-types/resource-management/v5/managedidentity.json#/definitions/ManagedServiceIdentity
    allOf:
    - $ref: '#/definitions/Resource'
    required:
    - sku
    - properties
  ProvisioningServiceDescriptionListResult:
    type: object
    description: List of provisioning service descriptions.
    properties:
      value:
        description: List of provisioning service descriptions.
        type: array
        items:
          $ref: '#/definitions/ProvisioningServiceDescription'
      nextLink:
        description: the next link
        type: string
        readOnly: true
  TagsResource:
    properties:
      tags:
        additionalProperties:
          type: string
        description: Resource tags
    description: A container holding only the Tags for a resource, allowing the user to update the tags on a Provisioning Service instance.
  PrivateEndpointConnectionProperties:
    description: The properties of a private endpoint connection
    type: object
    properties:
      privateEndpoint:
        description: The private endpoint property of a private endpoint connection
        $ref: '#/definitions/PrivateEndpoint'
      privateLinkServiceConnectionState:
        description: The current state of a private endpoint connection
        $ref: '#/definitions/PrivateLinkServiceConnectionState'
    required:
    - privateLinkServiceConnectionState
  SharedAccessSignatureAuthorizationRule[AccessRightsDescription]:
    type: object
    description: Description of the shared access key.
    properties:
      keyName:
        type: string
        description: Name of the key.
      primaryKey:
        type: string
        description: Primary SAS key value.
      secondaryKey:
        type: string
        description: Secondary SAS key value.
      rights:
        description: Rights that this key has.
        enum:
        - ServiceConfig
        - EnrollmentRead
        - EnrollmentWrite
        - DeviceConnect
        - RegistrationStatusRead
        - RegistrationStatusWrite
        type: string
        x-ms-enum:
          name: AccessRightsDescription
          modelAsString: true
    required:
    - keyName
    - rights
  Resource:
    description: The common properties of an Azure resource.
    properties:
      id:
        readOnly: true
        type: string
        description: The resource identifier.
      name:
        readOnly: true
        type: string
        description: The resource name.
        pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$
      type:
        readOnly: true
        type: string
        description: The resource type.
      location:
        type: string
        description: The resource location.
      resourcegroup:
        type: string
        description: The resource group of the resource.
      subscriptionid:
        type: string
        description: The subscription id of the resource.
      tags:
        type: object
        additionalProperties:
          type: string
        description: The resource tags.
    x-ms-azure-resource: true
    required:
    - location
  IotDpsPropertiesDescription:
    description: the service specific properties of a provisioning service, including keys, linked iot hubs, current state, and system generated properties such as hostname and idScope
    type: object
    properties:
      state:
        description: Current state of the provisioning service.
        enum:
        - Activating
        - Active
        - Deleting
  

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