Microsoft Azure Access Policies API

openapi: 3.2.0
info:
  title: Microsoft Azure TimeSeriesInsightsClient Access Policies API
  description: Time Series Insights client
  version: 2021-06-30-preview
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Access Policies
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/accessPolicies/{accessPolicyName}
  : put:
      tags:
      - Access Policies
      operationId: microsoftAzureAccesspoliciesCreateorupdate
      x-ms-examples:
        AccessPoliciesCreate:
          $ref: ./examples/AccessPoliciesCreate.json
      description: Create or update an access policy in the specified environment.
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/EnvironmentNameParameter'
      - name: accessPolicyName
        in: path
        required: true
        description: Name of the access policy.
        schema:
          type: string
          maxLength: 90
          minLength: 1
          pattern: ^[-\w\._\(\)]+$
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: The existing access policy definition was successfully updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyResource'
        '201':
          description: The access policy was successfully created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyResource'
        default:
          description: 'HTTP 400 (Bad Request): The given access policy request body is invalid; See the error code and message in the response for details.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups…
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccessPolicyCreateOrUpdateParameters'
        description: Parameters for creating an access policy.
        required: true
    get:
      tags:
      - Access Policies
      operationId: microsoftAzureAccesspoliciesGet
      x-ms-examples:
        AccessPoliciesGet:
          $ref: ./examples/AccessPoliciesGet.json
      description: Gets the access policy with the specified name in the specified environment.
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/EnvironmentNameParameter'
      - $ref: '#/components/parameters/AccessPolicyNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: The access policy definition was successfully retrieved and is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyResource'
        default:
          description: 'HTTP 404 (Not Found): The subscription, resource group, environment, or access policy could not be found.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups…
    patch:
      tags:
      - Access Policies
      operationId: microsoftAzureAccesspoliciesUpdate
      x-ms-examples:
        AccessPoliciesUpdate:
          $ref: ./examples/AccessPoliciesPatchRoles.json
      description: Updates the access policy with the specified name in the specified subscription, resource group, and environment.
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/EnvironmentNameParameter'
      - $ref: '#/components/parameters/AccessPolicyNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: The access policy definition was successfully updated and is in the response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyResource'
        default:
          description: 'HTTP 404 (Not Found): The subscription, resource group, environment, or access policy could not be found.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups…
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccessPolicyUpdateParameters'
        description: Request object that contains the updated information for the access policy.
        required: true
    delete:
      tags:
      - Access Policies
      operationId: microsoftAzureAccesspoliciesDelete
      x-ms-examples:
        AccessPoliciesDelete:
          $ref: ./examples/AccessPoliciesDelete.json
      description: Deletes the access policy with the specified name in the specified subscription, resource group, and environment
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/EnvironmentNameParameter'
      - $ref: '#/components/parameters/AccessPolicyNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: The access policy was successfully deleted.
        '204':
          description: The access policy was successfully deleted.
        default:
          description: 'HTTP 404 (Not Found): The subscription, resource group, environment, or access policy could not be found.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups…
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TimeSeriesInsights/environments/{environmentName}/accessPolicies
  : get:
      tags:
      - Access Policies
      operationId: microsoftAzureAccesspoliciesListbyenvironment
      x-ms-examples:
        AccessPoliciesByEnvironment:
          $ref: ./examples/AccessPoliciesListByEnvironment.json
      description: Lists all the available access policies associated with the environment.
      parameters:
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - $ref: '#/components/parameters/EnvironmentNameParameter'
      - $ref: '#/components/parameters/ApiVersionParameter'
      responses:
        '200':
          description: access policies returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessPolicyListResponse'
        default:
          description: 'HTTP 404 (Not Found): The subscription, resource group, or environment could not be found.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups…
components:
  schemas:
    CloudError:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/CloudErrorBody'
          description: Describes a particular API error with an error code and a message.
      description: Contains information about an API error.
      x-ms-external: true
    AccessPolicyResource:
      properties:
        properties:
          x-ms-client-flatten: true
          $ref: '#/components/schemas/AccessPolicyResourceProperties'
      allOf:
      - $ref: '#/components/schemas/Resource'
      description: An access policy is used to grant users and applications access to the environment. Roles are assigned to service principals in Azure Active Directory. These roles define the actions the principal can perform through the Time Series Insights data plane APIs.
    AccessPolicyMutableProperties:
      description: An object that represents a set of mutable access policy resource properties.
      type: object
      properties:
        description:
          type: string
          description: An description of the access policy.
        roles:
          type: array
          items:
            type: string
            description: A role defining the data plane operations that a principal can perform on a Time Series Insights client.
            enum:
            - Reader
            - Contributor
            x-ms-enum:
              name: AccessPolicyRole
              modelAsString: true
          description: The list of roles the principal is assigned on the environment.
    AccessPolicyUpdateParameters:
      properties:
        properties:
          x-ms-client-flatten: true
          $ref: '#/components/schemas/AccessPolicyMutableProperties'
    AccessPolicyResourceProperties:
      properties:
        principalObjectId:
          type: string
          description: The objectId of the principal in Azure Active Directory.
          x-ms-mutability:
          - create
          - read
        description:
          type: string
          description: An description of the access policy.
        roles:
          type: array
          items:
            type: string
            description: A role defining the data plane operations that a principal can perform on a Time Series Insights client.
            enum:
            - Reader
            - Contributor
            x-ms-enum:
              name: AccessPolicyRole
              modelAsString: true
          description: The list of roles the principal is assigned on the environment.
    CloudErrorBody:
      type: object
      description: Describes a particular API error with an error code and a message.
      properties:
        code:
          type: string
          description: An error code that describes the error condition more precisely than an HTTP status code. Can be used to programmatically handle specific error cases.
        message:
          type: string
          description: A message that describes the error in detail and provides debugging information.
        target:
          type: string
          description: The target of the particular error (for example, the name of the property in error).
        details:
          type: array
          items:
            $ref: '#/components/schemas/CloudErrorBody'
            description: Describes a particular API error with an error code and a message.
          x-ms-identifiers: []
          description: Contains nested errors that are related to this error.
      x-ms-external: true
    AccessPolicyListResponse:
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/AccessPolicyResource'
          description: Result of the List access policies operation.
      description: The response of the List access policies operation.
    Resource:
      properties:
        id:
          readOnly: true
          type: string
          description: Resource Id
        name:
          readOnly: true
          type: string
          description: Resource name
        type:
          readOnly: true
          type: string
          description: Resource type
      description: Time Series Insights resource
      x-ms-azure-resource: true
    AccessPolicyCreateOrUpdateParameters:
      properties:
        properties:
          x-ms-client-flatten: true
          $ref: '#/components/schemas/AccessPolicyResourceProperties'
      required:
      - properties
  parameters:
    EnvironmentNameParameter:
      name: environmentName
      in: path
      required: true
      description: The name of the Time Series Insights environment associated with the specified resource group.
      x-ms-parameter-location: method
      schema:
        type: string
    ResourceGroupNameParameter:
      name: resourceGroupName
      in: path
      required: true
      x-ms-parameter-location: method
      description: Name of an Azure Resource group.
      schema:
        type: string
    AccessPolicyNameParameter:
      name: accessPolicyName
      in: path
      required: true
      description: The name of the Time Series Insights access policy associated with the specified environment.
      x-ms-parameter-location: method
      schema:
        type: string
    ApiVersionParameter:
      name: api-version
      in: query
      required: true
      description: Version of the API to be used with the client request.
      schema:
        type: string
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      description: Azure Subscription ID.
      required: true
      schema:
        type: string
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow