swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector Settings API
schemes:
- https
tags:
- name: Settings
paths:
  /{scope}/providers/Microsoft.CostManagement/settings:
    get:
      tags:
      - Settings
      operationId: microsoftAzureSettingsList
      description: List all cost management settings in the requested scope.
      externalDocs:
        url: https://docs.microsoft.com/rest/api/cost-management/
      x-ms-examples:
        SettingsList:
          $ref: ./examples/settingsList.json
      parameters:
      - $ref: '#/parameters/scopeSettingParameter'
      - $ref: common-types.json#/parameters/apiVersionParameter
      responses:
        '200':
          description: OK. The request has succeeded.
          schema:
            $ref: '#/definitions/SettingsListResult'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: common-types.json#/definitions/ErrorResponse
      summary: Microsoft Azure Get Scope Providers Microsoft Costmanagement Settings
  /{scope}/providers/Microsoft.CostManagement/settings/{type}:
    put:
      tags:
      - Settings
      operationId: microsoftAzureSettingsCreateorupdatebyscope
      description: Create or update a setting within the given scope.
      x-ms-examples:
        CreateOrUpdateSettingByScope:
          $ref: ./examples/settings-createOrUpdate.json
      parameters:
      - $ref: '#/parameters/scopeSettingParameter'
      - $ref: '#/parameters/settingTypeParameter'
      - $ref: common-types.json#/parameters/apiVersionParameter
      - name: setting
        description: Setting to be created or updated.
        in: body
        required: true
        schema:
          $ref: '#/definitions/Setting'
      responses:
        '200':
          description: Setting Updated.
          schema:
            $ref: '#/definitions/Setting'
        '201':
          description: Setting Created.
          schema:
            $ref: '#/definitions/Setting'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: common-types.json#/definitions/ErrorResponse
      summary: Microsoft Azure Put Scope Providers Microsoft Costmanagement Settings Type
    get:
      tags:
      - Settings
      operationId: microsoftAzureSettingsGetbyscope
      description: Get the setting from the given scope by name.
      externalDocs:
        url: https://docs.microsoft.com/rest/api/cost-management/
      x-ms-examples:
        SettingByScope:
          $ref: ./examples/setting-get.json
      parameters:
      - $ref: '#/parameters/scopeSettingParameter'
      - $ref: '#/parameters/settingTypeParameter'
      - $ref: common-types.json#/parameters/apiVersionParameter
      responses:
        '200':
          description: The request has succeeded.
          schema:
            $ref: '#/definitions/Setting'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: common-types.json#/definitions/ErrorResponse
      summary: Microsoft Azure Get Scope Providers Microsoft Costmanagement Settings Type
    delete:
      tags:
      - Settings
      operationId: microsoftAzureSettingsDeletebyscope
      description: Delete a setting within the given scope.
      externalDocs:
        url: https://docs.microsoft.com/rest/api/cost-management/
      x-ms-examples:
        SettingDeleteByScope:
          $ref: ./examples/setting-delete.json
      parameters:
      - $ref: '#/parameters/scopeSettingParameter'
      - $ref: '#/parameters/settingTypeParameter'
      - $ref: common-types.json#/parameters/apiVersionParameter
      responses:
        '200':
          description: Setting deleted successfully.
        '204':
          description: Setting is already deleted or not found.
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: common-types.json#/definitions/ErrorResponse
      summary: Microsoft Azure Delete Scope Providers Microsoft Costmanagement Settings Type
definitions:
  Setting:
    description: Setting definition.
    discriminator: kind
    type: object
    allOf:
    - $ref: common-types.json#/definitions/ProxyResource
    properties:
      kind:
        type: string
        description: Specifies the kind of settings.
        enum:
        - taginheritance
        x-ms-enum:
          name: SettingsKind
          modelAsString: true
    required:
    - kind
  SettingsListResult:
    description: Setting list result. It contains a list of settings.
    type: object
    properties:
      value:
        description: The list of settings.
        type: array
        readOnly: true
        items:
          $ref: '#/definitions/Setting'
parameters:
  scopeSettingParameter:
    name: scope
    in: path
    required: true
    type: string
    description: The scope associated with this setting. This includes 'subscriptions/{subscriptionId}' for subscription scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for billing profile scope.
    x-ms-parameter-location: method
  settingTypeParameter:
    name: type
    in: path
    description: Setting type.
    required: true
    type: string
    x-ms-parameter-location: method
    enum:
    - taginheritance
    x-ms-enum:
      name: SettingType
      modelAsString: true
      values:
      - value: taginheritance
        description: This setting applies resource group and subscription tags to usage data of child resources. Inherited tags will  be seen within 24 hours for the current month's usage data.
        name: TagInheritance
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'