swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector GuestUsages API
schemes:
- https
tags:
- name: GuestUsages
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureActiveDirectory/guestUsages/{resourceName}
  : put:
      operationId: microsoftAzureGuestusagesCreate
      tags:
      - GuestUsages
      x-ms-examples:
        GuestUsages_Create:
          $ref: ./examples/GuestUsagesCreate.json
      summary: Microsoft Azure Creates A Guest Usages Resource
      description: Creates a Guest Usages resource for the Microsoft.AzureActiveDirectory resource provider
      parameters:
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/ResourceNameParameter'
      - name: Resource
        in: body
        description: Guest Usages resource to be created
        schema:
          $ref: '#/definitions/GuestUsagesResource'
      responses:
        '200':
          description: The request was successful and the resource was created successfully
          schema:
            $ref: '#/definitions/GuestUsagesResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
    patch:
      operationId: microsoftAzureGuestusagesUpdate
      tags:
      - GuestUsages
      x-ms-examples:
        GuestUsages_Update:
          $ref: ./examples/GuestUsagesUpdate.json
      summary: Microsoft Azure Updates A Guest Usages Resource
      description: Updates a Guest Usages resource for the Microsoft.AzureActiveDirectory resource provider
      parameters:
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/ResourceNameParameter'
      - name: ResourcePatch
        in: body
        description: Guest Usages Resource to be updated
        schema:
          $ref: '#/definitions/GuestUsagesResourcePatch'
      responses:
        '200':
          description: Guest Usages Resource Successfully Updated
          schema:
            $ref: '#/definitions/GuestUsagesResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
    delete:
      operationId: microsoftAzureGuestusagesDelete
      tags:
      - GuestUsages
      x-ms-examples:
        GuestUsages_Delete:
          $ref: ./examples/GuestUsagesDelete.json
      summary: Microsoft Azure Deletes A Guest Usages Resource
      description: Deletes a Guest Usages resource for the Microsoft.AzureActiveDirectory resource provider
      parameters:
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/ResourceNameParameter'
      responses:
        '200':
          description: Guest Usages Resource Successfully Deleted.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
    get:
      operationId: microsoftAzureGuestusagesGet
      tags:
      - GuestUsages
      x-ms-examples:
        GuestUsages_Get:
          $ref: ./examples/GuestUsagesGet.json
      summary: Microsoft Azure Gets A Guest Usages Resource
      description: Gets a Guest Usages resource for the Microsoft.AzureActiveDirectory resource provider
      parameters:
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      - $ref: '#/parameters/ResourceNameParameter'
      responses:
        '200':
          description: Guest Usages resource successfully retrieved
          schema:
            $ref: '#/definitions/GuestUsagesResource'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
  /subscriptions/{subscriptionId}/providers/Microsoft.AzureActiveDirectory/guestUsages:
    get:
      operationId: microsoftAzureGuestusagesListbysubscription
      tags:
      - GuestUsages
      x-ms-examples:
        GuestUsagesSubscription_List:
          $ref: ./examples/GuestUsagesSubscriptionGet.json
      summary: Microsoft Azure Gets Guest Usages Resources Under A Subscription
      description: Gets Guest Usages resources under a subscription for the Microsoft.AzureActiveDirectory resource provider
      parameters:
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/SubscriptionIdParameter'
      responses:
        '200':
          description: List of Guest Usages resources under the subscription successfully retrieved.
          schema:
            $ref: '#/definitions/GuestUsagesResourceList'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
      x-ms-pageable:
        nextLinkName: null
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureActiveDirectory/guestUsages:
    get:
      operationId: microsoftAzureGuestusagesListbyresourcegroup
      tags:
      - GuestUsages
      x-ms-examples:
        GuestUsagesResourceGroup_List:
          $ref: ./examples/GuestUsagesResourceGroupGet.json
      summary: Microsoft Azure Gets Guest Usages Resources Under Resource Group
      description: Gets Guest Usages resources under a resource group for the Microsoft.AzureActiveDirectory resource provider
      parameters:
      - $ref: '#/parameters/ApiVersionParameter'
      - $ref: '#/parameters/SubscriptionIdParameter'
      - $ref: '#/parameters/ResourceGroupNameParameter'
      responses:
        '200':
          description: List of Guest Usages resources under the resourceGroup successfully retrieved.
          schema:
            $ref: '#/definitions/GuestUsagesResourceList'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/CloudError'
      x-ms-pageable:
        nextLinkName: null
definitions:
  GuestUsagesResourceList:
    description: The collection of guest usages resources
    properties:
      value:
        description: List of guest usages resources
        type: array
        readOnly: true
        items:
          $ref: '#/definitions/GuestUsagesResource'
  CloudError:
    x-ms-external: true
    properties:
      error:
        $ref: ../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse
    description: An error response for a resource management request.
  GuestUsagesResourceProperties:
    description: Guest Usages Resource Properties
    type: object
    properties:
      tenantId:
        type: string
        description: An identifier for the tenant for which the resource is being created
  GuestUsagesResourcePatch:
    description: Guest Usages Resource for Patch
    type: object
    properties:
      tags:
        type: object
        additionalProperties:
          type: string
        description: Key-value pairs of additional resource provisioning properties.
  GuestUsagesResource:
    description: Guest Usages Resource
    type: object
    properties:
      id:
        type: string
        readOnly: true
        description: An identifier that represents the Guest Usages resource.
      name:
        type: string
        readOnly: true
        description: The name of the Guest Usages resource.
      type:
        type: string
        readOnly: true
        description: The type of the Guest Usages resource.
      location:
        type: string
        description: Location of the Guest Usages resource.
        x-ms-mutability:
        - create
        - read
      tags:
        type: object
        additionalProperties:
          type: string
        description: Key-value pairs of additional resource provisioning properties.
      properties:
        $ref: '#/definitions/GuestUsagesResourceProperties'
        x-ms-client-flatten: true
        description: The Guest Usages Resource Properties
    x-ms-azure-resource: true
parameters:
  ApiVersionParameter:
    name: api-version
    in: query
    required: true
    type: string
    description: The API version to be used with the HTTP request.
  ResourceNameParameter:
    name: resourceName
    in: path
    required: true
    type: string
    description: The initial domain name of the AAD tenant.
    x-ms-parameter-location: method
  SubscriptionIdParameter:
    name: subscriptionId
    in: path
    required: true
    type: string
    description: The Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)
  ResourceGroupNameParameter:
    name: resourceGroupName
    in: path
    required: true
    type: string
    description: The name of the resource group.
    x-ms-parameter-location: method
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'