swagger: '2.0'
info:
  version: 2020-08-01-preview
  title: Microsoft Azure AccessControlClient AccessConnector CreateApiKey API
schemes:
- https
tags:
- name: CreateApiKey
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/keys/{apiKeyAlias}/create:
    post:
      tags:
      - CreateApiKey
      summary: 'Microsoft Azure Generates An Api Key, Granting Access To The Full Range Of Marketplace Catalog Apis Please Note That This Api Is Currently In A Preview State And Requires Sign Up To The Discovery Api Key Early Access Preview Feature Using A Valid Azure Subscription For More Information On This Process Please See The Documentation For Marketplace Catalog Apis [here] Https: Learn Microsoft Com En Us Rest Api Marketplacecatalog Dataplane Products Get?view Rest Marketplacecatalog Dataplane 2023 05 01 Preview&tabs Http'
      operationId: microsoftAzureCreateapikeyPost
      x-ms-examples:
        Create_Key:
          $ref: ./examples/CreateKey.json
      parameters:
      - type: string
        name: apiKeyAlias
        in: path
        required: true
        description: Alias for new API Key. This alias must be unique and contain only alphanumeric characters separated by dashes.
      - type: string
        name: x-ms-client-tenant-id
        x-originalName: tenantId
        description: The tenant associated with the subscription.
        in: header
        required: true
        x-nullable: true
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          x-nullable: false
          description: Returns the newly created API key.
          schema:
            $ref: '#/definitions/ApiKey'
        default:
          description: Microsoft.Marketplace error response describing why the operation failed.
          schema:
            $ref: ../../../../../common-types/resource-management/v5/types.json#/definitions/ErrorResponse
      description: Needs a more full description created.
definitions:
  ApiKey:
    type: object
    description: ApiKey object containing both the key and its alias.
    properties:
      keyAlias:
        description: The API key alias.
        type: string
      key:
        description: The API key to be used when calling relevant Discovery endpoints.
        type: string
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/parameters/Endpoint'