Microsoft Azure Entities API

swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Entities API
  description: 'A list of entities that belong to the Management Groups.

    '
schemes:
- https
tags:
- name: Entities
  description: 'A list of entities that belong to the Management Groups.

    '
paths:
  /providers/Microsoft.Management/getEntities:
    post:
      tags:
      - Entities
      operationId: microsoftAzureEntitiesList
      description: List all entities (Management Groups, Subscriptions, etc.) for the authenticated user.<br>
      parameters:
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/SkipTokenParameter'
      - $ref: '#/parameters/GroupNameParameter'
      - $ref: '#/parameters/CacheControlHeader'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/EntityListResult'
        default:
          description: Error
          schema:
            $ref: '#/definitions/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        GetEntities:
          $ref: ./examples/GetEntities.json
      summary: Microsoft Azure Post Providers Microsoft Management Getentities
  /entities/health/jobs/{jobId}:
    get:
      produces:
      - application/json
      - text/json
      description: Get details of the healthcare prediction job specified by the jobId.
      operationId: microsoftAzureHealthstatus
      summary: Microsoft Azure Get Healthcare Analysis Job Status And Results
      parameters:
      - $ref: '#/parameters/JobId'
      - default: 20
        description: (Optional) Set the maximum number of results per task. When both $top and $skip are specified, $skip is applied first.
        in: query
        maximum: 50
        minimum: 1
        name: $top
        type: integer
      - default: 0
        description: (Optional) Set the number of elements to offset in the response. When both $top and $skip are specified, $skip is applied first.
        in: query
        minimum: 0
        name: $skip
        type: integer
      - $ref: '#/parameters/ShowStats'
      responses:
        '200':
          description: OK
          schema:
            $ref: '#/definitions/HealthcareJobState'
        '404':
          description: Job ID not found.
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
        '500':
          description: Internal error response
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
      x-ms-examples:
        Successful Health request:
          $ref: .//examples//SuccessfulHealthStatusRequest.json
      deprecated: false
      tags:
      - Entities
    delete:
      produces:
      - application/json
      - text/json
      description: Cancel healthcare prediction job.
      operationId: microsoftAzureCancelhealthjob
      summary: Microsoft Azure Cancel Healthcare Prediction Job
      parameters:
      - $ref: '#/parameters/JobId'
      responses:
        '202':
          description: Cancel Job request has been received.
          headers:
            Operation-Location:
              type: string
        '404':
          description: Job ID not found.
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
        '500':
          description: Internal error response
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
      x-ms-examples:
        Successful Health request:
          $ref: .//examples//SuccessfulHealthDeleteRequest.json
      deprecated: false
      x-ms-long-running-operation: true
      tags:
      - Entities
  /entities/health/jobs:
    post:
      summary: Microsoft Azure Submit Healthcare Analysis Job
      description: Start a healthcare analysis job to recognize healthcare related entities (drugs, conditions, symptoms, etc) and their relations.
      operationId: microsoftAzureHealth
      consumes:
      - application/json
      - text/json
      produces:
      - application/json
      - text/json
      parameters:
      - $ref: '#/parameters/ModelVersion'
      - $ref: '#/parameters/StringIndexType'
      - $ref: '#/parameters/MultiLanguageInput'
      responses:
        '202':
          description: Accepted - call results in a link where the status of the submitted job can be checked via the GET operation.
          headers:
            Operation-Location:
              type: string
        '400':
          description: Bad Request.
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
        '500':
          description: Internal error response
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
      x-ms-examples:
        Successful Health request:
          $ref: .//examples//SuccessfulHealthRequest.json
      deprecated: false
      x-ms-long-running-operation: true
      tags:
      - Entities
  /entities/recognition/general:
    post:
      summary: Microsoft Azure Named Entity Recognition
      description: The API returns a list of general named entities in a given document. For the list of supported entity types, check Supported Entity Types in Text Analytics API. See the Supported languages in Text Analytics API for the list of enabled languages.
      operationId: microsoftAzureEntitiesrecognitiongeneral
      consumes:
      - application/json
      - text/json
      produces:
      - application/json
      - text/json
      parameters:
      - $ref: '#/parameters/ModelVersion'
      - $ref: '#/parameters/ShowStats'
      - $ref: '#/parameters/StringIndexType'
      - $ref: '#/parameters/MultiLanguageInput'
      responses:
        '200':
          description: A successful call results in a list of recognized entities returned for each valid document.
          schema:
            $ref: '#/definitions/EntitiesResult'
        '400':
          description: Bad Request.
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
        '500':
          description: Internal error response
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
      x-ms-examples:
        Successful Entities request:
          $ref: .//examples//SuccessfulEntitiesRequest.json
      deprecated: false
      tags:
      - Entities
  /entities/recognition/pii:
    post:
      summary: Microsoft Azure Entities Containing Personal Information
      description: The API returns a list of entities with personal information (\"SSN\", \"Bank Account\" etc) in the document. For the list of supported entity types, check Supported Entity Types in Text Analytics API. See the Supported languages in Text Analytics API for the list of enabled languages.<br>
      operationId: microsoftAzureEntitiesrecognitionpii
      consumes:
      - application/json
      - text/json
      produces:
      - application/json
      - text/json
      parameters:
      - $ref: '#/parameters/ModelVersion'
      - $ref: '#/parameters/ShowStats'
      - name: domain
        in: query
        description: '(Optional) if specified, will set the PII domain to include only a subset of the entity categories. Possible values include: ''PHI'', ''none''.'
        type: string
      - $ref: '#/parameters/StringIndexType'
      - $ref: '#/parameters/PiiCategories'
      - $ref: '#/parameters/MultiLanguageInput'
      responses:
        '200':
          description: A successful call results in a list of entities containing personal information returned for each valid document
          schema:
            $ref: '#/definitions/PiiResult'
        '400':
          description: Bad Request.
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
        '500':
          description: Internal error response
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
      x-ms-examples:
        Successful Entity PII request:
          $ref: .//examples//SuccessfulEntityPIIRequest.json
      deprecated: false
      tags:
      - Entities
  /entities/linking:
    post:
      summary: Microsoft Azure Linked Entities From A Well Known Knowledge Base
      description: The API returns a list of recognized entities with links to a well known knowledge base. See the Supported languages in Text Analytics API for the list of enabled languages.
      operationId: microsoftAzureEntitieslinking
      consumes:
      - application/json
      - text/json
      produces:
      - application/json
      - text/json
      parameters:
      - $ref: '#/parameters/ModelVersion'
      - $ref: '#/parameters/ShowStats'
      - $ref: '#/parameters/StringIndexType'
      - $ref: '#/parameters/MultiLanguageInput'
      responses:
        '200':
          description: A successful call results in a list of recognized entities with links to a well known knowledge base returned for each valid document
          schema:
            $ref: '#/definitions/EntityLinkingResult'
        '400':
          description: Bad Request.
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
        '500':
          description: Internal error response
          schema:
            $ref: '#/definitions/ErrorResponse_2'
          x-ms-error-response: true
      x-ms-examples:
        Successful Entity Linking request:
          $ref: .//examples//SuccessfulEntityLinkingRequest.json
      deprecated: false
      tags:
      - Entities
definitions:
  DocumentLinkedEntities:
    type: object
    required:
    - id
    - entities
    - warnings
    properties:
      id:
        type: string
        description: Unique, non-empty document identifier.
      entities:
        type: array
        description: Recognized well known entities in the document.
        items:
          $ref: '#/definitions/LinkedEntity'
      warnings:
        type: array
        description: Warnings encountered while processing document.
        items:
          $ref: '#/definitions/TextAnalyticsWarning'
      statistics:
        description: if showStats=true was specified in the request this field will contain information about the document payload.
        $ref: '#/definitions/DocumentStatistics'
  JobMetadata:
    properties:
      createdDateTime:
        format: date-time
        type: string
      expirationDateTime:
        format: date-time
        type: string
      jobId:
        format: uuid
        type: string
      lastUpdateDateTime:
        format: date-time
        type: string
      status:
        enum:
        - notStarted
        - running
        - succeeded
        - failed
        - cancelled
        - cancelling
        - partiallyCompleted
        type: string
        x-ms-enum:
          modelAsString: false
          name: State
    required:
    - jobId
    - lastUpdateDateTime
    - createdDateTime
    - status
    type: object
  MultiLanguageBatchInput:
    type: object
    required:
    - documents
    properties:
      documents:
        type: array
        description: The set of documents to process as part of this batch.
        items:
          $ref: '#/definitions/MultiLanguageInput'
    description: Contains a set of input documents to be analyzed by the service.
  PiiDocumentEntities:
    type: object
    required:
    - id
    - redactedText
    - entities
    - warnings
    properties:
      id:
        type: string
        description: Unique, non-empty document identifier.
      redactedText:
        type: string
        description: Returns redacted text.
      entities:
        type: array
        description: Recognized entities in the document.
        items:
          $ref: '#/definitions/Entity'
      warnings:
        type: array
        description: Warnings encountered while processing document.
        items:
          $ref: '#/definitions/TextAnalyticsWarning'
      statistics:
        description: if showStats=true was specified in the request this field will contain information about the document payload.
        $ref: '#/definitions/DocumentStatistics'
  HealthcareJobState:
    allOf:
    - $ref: '#/definitions/JobMetadata'
    - properties:
        results:
          $ref: '#/definitions/HealthcareResult'
        errors:
          items:
            $ref: '#/definitions/TextAnalyticsError'
          type: array
      type: object
    - $ref: '#/definitions/Pagination'
  RequestStatistics:
    type: object
    required:
    - documentsCount
    - validDocumentsCount
    - erroneousDocumentsCount
    - transactionsCount
    properties:
      documentsCount:
        type: integer
        format: int32
        description: Number of documents submitted in the request.
      validDocumentsCount:
        type: integer
        format: int32
        description: Number of valid documents. This excludes empty, over-size limit or non-supported languages documents.
      erroneousDocumentsCount:
        type: integer
        format: int32
        description: Number of invalid documents. This includes empty, over-size limit or non-supported languages documents.
      transactionsCount:
        type: integer
        format: int64
        description: Number of transactions for the request.
    description: if showStats=true was specified in the request this field will contain information about the request payload.
  HealthcareEntity:
    type: object
    allOf:
    - $ref: '#/definitions/Entity'
    - properties:
        assertion:
          type: object
          $ref: '#/definitions/HealthcareAssertion'
        name:
          description: 'Preferred name for the entity. Example: ''histologically'' would have a ''name'' of ''histologic''.'
          type: string
        links:
          description: Entity references in known data sources.
          type: array
          items:
            $ref: '#/definitions/HealthcareEntityLink'
  HealthcareRelationEntity:
    type: object
    required:
    - ref
    - role
    properties:
      ref:
        description: Reference link object, using a JSON pointer RFC 6901 (URI Fragment Identifier Representation), pointing to the entity .
        type: string
      role:
        description: 'Role of entity in the relationship. For example: ''CD20-positive diffuse large B-cell lymphoma'' has the following entities with their roles in parenthesis:  CD20 (GeneOrProtein), Positive (Expression), diffuse large B-cell lymphoma (Diagnosis).'
        type: string
  ErrorDetails:
    description: The details of the error.
    properties:
      code:
        description: One of a server-defined set of error codes.
        type: string
      message:
        description: A human-readable representation of the error.
        type: string
      details:
        description: A human-readable representation of the error's details.
        type: string
  DocumentError:
    type: object
    required:
    - id
    - error
    properties:
      id:
        type: string
        description: Document Id.
      error:
        type: object
        description: Document Error.
        $ref: '#/definitions/TextAnalyticsError'
  DocumentStatistics:
    type: object
    required:
    - charactersCount
    - transactionsCount
    properties:
      charactersCount:
        type: integer
        format: int32
        description: Number of text elements recognized in the document.
      transactionsCount:
        type: integer
        format: int32
        description: Number of transactions for the document.
    description: if showStats=true was specified in the request this field will contain information about the document payload.
  Match:
    type: object
    required:
    - confidenceScore
    - text
    - offset
    - length
    properties:
      confidenceScore:
        type: number
        format: double
        description: If a well known item is recognized, a decimal number denoting the confidence level between 0 and 1 will be returned.
      text:
        type: string
        description: Entity text as appears in the request.
      offset:
        type: integer
        format: int32
        description: Start position for the entity match text.
      length:
        type: integer
        format: int32
        description: Length for the entity match text.
  EntityLinkingResult:
    type: object
    required:
    - documents
    - errors
    - modelVersion
    properties:
      documents:
        type: array
        description: Response by document
        items:
          $ref: '#/definitions/DocumentLinkedEntities'
      errors:
        type: array
        description: Errors by document id.
        items:
          $ref: '#/definitions/DocumentError'
      statistics:
        $ref: '#/definitions/RequestStatistics'
      modelVersion:
        type: string
        description: This field indicates which model is used for scoring.
  Permissions:
    type: string
    enum:
    - noaccess
    - view
    - edit
    - delete
    description: The users specific permissions to this item.
  ErrorResponse_2:
    type: object
    required:
    - error
    properties:
      error:
        type: object
        description: Document Error.
        $ref: '#/definitions/TextAnalyticsError'
  EntitiesResult:
    type: object
    required:
    - documents
    - errors
    - modelVersion
    properties:
      documents:
        type: array
        description: Response by document
        items:
          $ref: '#/definitions/DocumentEntities'
      errors:
        type: array
        description: Errors by document id.
        items:
          $ref: '#/definitions/DocumentError'
      statistics:
        $ref: '#/definitions/RequestStatistics'
      modelVersion:
        type: string
        description: This field indicates which model is used for scoring.
  TextAnalyticsWarning:
    type: object
    required:
    - code
    - message
    properties:
      code:
        type: string
        enum:
        - LongWordsInDocument
        - DocumentTruncated
        x-ms-enum:
          name: WarningCodeValue
          modelAsString: true
        description: Error code.
      message:
        type: string
        description: Warning message.
      targetRef:
        type: string
        description: A JSON pointer reference indicating the target object.
  LinkedEntity:
    type: object
    required:
    - name
    - matches
    - language
    - url
    - dataSource
    properties:
      name:
        type: string
        description: Entity Linking formal name.
      matches:
        type: array
        description: List of instances this entity appears in the text.
        items:
          $ref: '#/definitions/Match'
      language:
        type: string
        description: Language used in the data source.
      id:
        type: string
        description: Unique identifier of the recognized entity from the data source.
      url:
        type: string
        description: URL for the entity's page from the data source.
      dataSource:
        type: string
        description: Data source used to extract entity linking, such as Wiki/Bing etc.
      bingId:
        type: string
        description: Bing Entity Search API unique identifier of the recognized entity.
  TextAnalyticsError:
    type: object
    required:
    - code
    - message
    properties:
      code:
        type: string
        enum:
        - InvalidRequest
        - InvalidArgument
        - InternalServerError
        - ServiceUnavailable
        - NotFound
        x-ms-enum:
          name: ErrorCodeValue
          modelAsString: false
        description: Error code.
      message:
        type: string
        description: Error message.
      target:
        type: string
        description: Error target.
      innererror:
        $ref: '#/definitions/InnerError'
        description: Inner error contains more specific information.
      details:
        type: array
        description: Details about specific errors that led to this reported error.
        items:
          $ref: '#/definitions/TextAnalyticsError'
  EntityParentGroupInfo:
    description: (Optional) The ID of the parent management group.
    properties:
      id:
        type: string
        description: The fully qualified ID for the parent management group.  For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
  HealthcareResult:
    type: object
    required:
    - documents
    - errors
    - modelVersion
    properties:
      documents:
        type: array
        description: Response by document
        items:
          $ref: '#/definitions/DocumentHealthcareEntities'
      errors:
        type: array
        description: Errors by document id.
        items:
          $ref: '#/definitions/DocumentError'
      statistics:
        $ref: '#/definitions/RequestStatistics'
      modelVersion:
        type: string
        description: This field indicates which model is used for scoring.
  PiiResult:
    type: object
    required:
    - documents
    - errors
    - modelVersion
    properties:
      documents:
        type: array
        description: Response by document
        items:
          $ref: '#/definitions/PiiDocumentEntities'
      errors:
        type: array
        description: Errors by document id.
        items:
          $ref: '#/definitions/DocumentError'
      statistics:
        $ref: '#/definitions/RequestStatistics'
      modelVersion:
        type: string
        description: This field indicates which model is used for scoring.
  EntityInfo:
    description: The entity.
    properties:
      id:
        type: string
        description: The fully qualified ID for the entity.  For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
        readOnly: true
      type:
        type: string
        description: The type of the resource. For example, /providers/Microsoft.Management/managementGroups
        readOnly: true
      name:
        type: string
        description: The name of the entity. For example, 00000000-0000-0000-0000-000000000000
        readOnly: true
      properties:
        title: Properties
        x-ms-client-flatten: true
        $ref: '#/definitions/EntityInfoProperties'
  MultiLanguageInput:
    type: object
    required:
    - id
    - text
    properties:
      id:
        type: string
        description: A unique, non-empty document identifier.
      text:
        type: string
        description: The input text to process.
      language:
        type: string
        description: (Optional) This is the 2 letter ISO 639-1 representation of a language. For example, use "en" for English; "es" for Spanish etc. If not set, use "en" for English as default.
    description: Contains an input document to be analyzed by the service.
  EntityListResult:
    description: Describes the result of the request to view entities.
    properties:
      value:
        description: The list of entities.
        type: array
        items:
          $ref: '#/definitions/EntityInfo'
      nextLink:
        description: The URL to use for getting the next set of results.
        type: string
        readOnly: true
  DocumentHealthcareEntities:
    type: object
    required:
    - id
    - entities
    - relations
    - warnings
    properties:
      id:
        type: string
        description: Unique, non-empty document identifier.
      entities:
        description: Healthcare entities.
        type: array
        items:
          $ref: '#/definitions/HealthcareEntity'
      relations:
        type: array
        description: Healthcare entity relations.
        items:
          $ref: '#/definitions/HealthcareRelation'
      warnings:
        type: array
        description: Warnings encountered while processing document.
        items:
          $ref: '#/definitions/TextAnalyticsWarning'
      statistics:
        description: if showStats=true was specified in the request this field will contain information about the document payload.
        $ref: '#/definitions/DocumentStatistics'
  EntityInfoProperties:
    description: The generic properties of an entity.
    type: object
    properties:
      tenantId:
        type: string
        description: The AAD Tenant ID associated with the entity. For example, 00000000-0000-0000-0000-000000000000
      displayName:
        type: string
        description: The friendly name of the management group.
      parent:
        title: Parent
        $ref: '#/definitions/EntityParentGroupInfo'
      permissions:
        title: Permissions
        x-nullable: true
        $ref: '#/definitions/Permissions'
  HealthcareRelation:
    type: object
    description: Every relation is an entity graph of a certain relationType, where all entities are connected and have specific roles within the relation context.
    required:
    - relationType
    - entities
    properties:
      relationType:
        description: 'Type of relation. Examples include: `DosageOfMedication` or ''FrequencyOfMedication'', etc.'
        type: string
        enum:
        - Abbreviation
        - DirectionOfBodyStructure
        - DirectionOfCondition
        - DirectionOfExamination
        - DirectionOfTreatment
        - DosageOfMedication
        - FormOfMedication
        - FrequencyOfMedication
        - FrequencyOfTreatment
        - QualifierOfCondition
        - RelationOfExamination
        - RouteOfMedication
        - TimeOfCondition
        - TimeOfEvent
        - TimeOfExamination
        - TimeOfMedication
        - TimeOfTreatment
        - UnitOfCondition
        - UnitOfExamination
        - ValueOfCondition
        - ValueOfExamination
        x-ms-enum:
          name: relationType
          modelAsString: true
      entities:
        description: The entities in the relation.
        type: array
        items:
          $ref: '#/definitions/HealthcareRelationEntity'
  Pagination:
    properties:
      '@nextLink':
        type: string
    type: object
  DocumentEntities:
    type: object
    required:
    - id
    - entities
    - warnings
    properties:
      id:
        type: string
        description: Unique, non-empty document identifier.
      entities:
        type: array
        description: Recognized entities in the document.
        items:
          $ref: '#/definitions/Entity'
      warnings:
        type: array
        description: Warnings encountered while processing document.
        items:
          $ref: '#/definitions/TextAnalyticsWarning'
      statistics:
        description: if showStats=true was specified in the request this field will contain information about the document payload.
        $ref: '#/definitions/DocumentStatistics'
  ErrorResponse:
    description: The error object.
    properties:
      error:
        title: Error
        $ref: '#/definitions/ErrorDetails'
  HealthcareEntityLink:
    type: object
    required:
    - dataSource
    - id
    properties:
      dataSource:
        description: 'Entity Catalog. Examples include: UMLS, CHV, MSH, etc.'
        type: string
      id:
        description: Entity id in the given source catalog.
        type: string
  InnerError:
    type: object
    required:
    - code
    - message
    properties:
      code:
        type: string
        enum:
        - InvalidParameterValue
        - InvalidRequestBodyFormat
        - EmptyRequest
        - MissingInputRecords
        - InvalidDocument
        - ModelVersionIncorrect
        - InvalidDocumentBatch
        - UnsupportedLanguageCode
        - InvalidCountryHint
        x-ms-enum:
          name: InnerErrorCodeValue
          modelAsString: true
        description: Error code.
      message:
        type: string
        description: Error message.
      details:
        type: object
        additionalProperties:
          type: string
        description: Error details.
      target:
        type: string
        description: Error target.
      innererror:
        $ref: '#/definitions/InnerError'
        description: Inner error contains more specific information.
  Entity:
    type: object
    required:
    - text
    - category
    - offset
    - length
    - confidenceScore
    properties:
      text:
        type: string
        description: Entity text as appears in the request.
      category:
        type: string
        description: Entity type.
      subcategory:
        type: string
        description: (Optional) Entity sub type.
      offset:
        type: integer
        format: int32
        description: Start position for the entity text. Use of different 'stringIndexType' values can affect the offset returned.
      length:
        type: integer
        format: int32
        description: Length for the entity text. Use of different 'stringIndexType' values can affect the length returned.
      confidenceScore:
        type: number
        format: double
        description: Confidence score between 0 and 1 of the extracted entity.
  HealthcareAssertion:
    type: object
    properties:
      conditionality:
        description: Describes any conditionality on the entity.
        type: string
        enum:
        - hypothetical
        - conditional
        x-ms-enum:
          name: Conditionality
          modelAsString: false
      certainty:
        description: Describes the entities certainty and polarity.
        type: string
        enum:
        - positive
        - positivePossible
        - neutralPossible
        - negativePossible
        - negative
        x-ms-enum:
          name: Certainty
          modelAsString: false
      association:
        description: Describes if the entity is the subject of the text or if it describes someone else.
        type: string
        enum:
        - subject
        - other
        x-ms-enum:
          name: Association
          modelAsString: false
parameters:
  SkipTokenParameter:
    name: $skiptoken
    in: query
    required: false
    type: string
    description: "Page continuation token is only used if a previous operation returned a partial result. \nIf a previous response contains a nextLink element, the value of the nextLink element will include a token parameter that specifies a starting point to use for subsequent calls.\n"
    x-ms-parameter-location: client
  ApiVersionParameter:
    name: api-version
    in: query
    required: true
    type: string
    description: Version of the API to be used with the client request. The current version is 2018-01-01-preview.
  PiiCategories:
    description: (Optional) describes the PII categories to return
    in: query
    collectionFormat: csv
    items:
      type: string
      x-ms-enum:
        name: PiiCategory
        modelAsString: true
      enum:
      - ABARoutingNumber
      - ARNationalIdentityNumber
      - AUBankAccountNumber
      - AUDriversLicenseNumber
      - AUMedicalAccountNumber
      - AUPassportNumber
      - AUTaxFileNumber
      - AUBusinessNumber
      - AUCompanyNumber
      - ATIdentityCard
      - ATTaxIdentificationNumber
      - ATValueAddedTaxNumber
      - AzureDocumentDBAuthKey
      - AzureIAASDatabaseConnectionAndSQLString
      - AzureIoTConnectionString
      - AzurePublishSettingPassword
      - AzureRedisCacheString
      - AzureSAS
      - AzureServiceBusString
      - AzureStorageAccountKey
      - AzureStorageAccountGeneric
      - BENationalNumber
      - BENationalNumberV2
      - BEValueAddedTaxNumber
      - BRCPFNumber
      - BRLegalEntityNumber
      - BRNationalIDRG
      - BGUniformCivilNumber
      - CABankAccountNumber
      - CADriversLicenseNumber
      - CAHealthServiceNumber
      - CAPassportNumber
      - CAPersonalHealthIdentification
      - CASocialInsuranceNumber
      - CLIdentityCardNumber
      - CNResidentIdentityCardNumber
      - CreditCardNumber
      - HRIdentityCardNumber
      - HRNationalIDNumber
      - HRPersonalIdentificationNumber
      - HRPersonalIdentificationOIBNumberV2
      - CYIdentityCard
      - CYTaxIdentificationNumber
      - CZPersonalIdentityNumber
      - CZPersonalIdentityV2
      - DKPersonalIdentificationNumber
      - DKPersonalIdentificationV2
      - DrugEnforcementAgencyNumber
      - EEPersonalIdentificationCode
      - EUDebitCardNumber
      - EUDriversLicenseNumber
      - EUGPSCoordinates
      - EUNationalIdentificationNumber
      - EUPassportNumber
      - EUSocialSecurityNumber
      - EUTaxIdentificationNumber
      - 

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