swagger: '2.0'
info:
version: 2020-08-01-preview
title: Microsoft Azure AccessControlClient AccessConnector MultipleActivationKeys API
schemes:
- https
tags:
- name: MultipleActivationKeys
paths:
/subscriptions/{subscriptionId}/providers/Microsoft.WindowsESU/multipleActivationKeys:
get:
tags:
- MultipleActivationKeys
operationId: microsoftAzureMultipleactivationkeysList
x-ms-examples:
ListMultipleActivationKeys:
$ref: ./examples/ListMultipleActivationKeys.json
description: List all Multiple Activation Keys (MAK) created for a subscription.
parameters:
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter
responses:
'200':
description: OK
schema:
$ref: '#/definitions/MultipleActivationKeyList'
default:
description: Error response describing why the operation failed.
schema:
$ref: '#/definitions/ErrorResponse'
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Subscriptions Subscriptionid Providers Microsoft Windowsesu Multipleactivationkeys
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsESU/multipleActivationKeys:
get:
tags:
- MultipleActivationKeys
operationId: microsoftAzureMultipleactivationkeysListbyresourcegroup
x-ms-examples:
ListMultipleActivationKeys:
$ref: ./examples/ListMultipleActivationKeysByResourceGroup.json
description: List all Multiple Activation Keys (MAK) in a resource group.
parameters:
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter
responses:
'200':
description: OK
schema:
$ref: '#/definitions/MultipleActivationKeyList'
default:
description: Error response describing why the operation failed.
schema:
$ref: '#/definitions/ErrorResponse'
x-ms-pageable:
nextLinkName: nextLink
summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Windowsesu Multipleactivationkeys
? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.WindowsESU/multipleActivationKeys/{multipleActivationKeyName}
: get:
tags:
- MultipleActivationKeys
operationId: microsoftAzureMultipleactivationkeysGet
x-ms-examples:
GetMultipleActivationKey:
$ref: ./examples/GetMultipleActivationKey.json
description: Get a MAK key.
parameters:
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter
- $ref: '#/parameters/MultipleActivationKeyNameParameter'
responses:
'200':
description: OK
schema:
$ref: '#/definitions/MultipleActivationKey'
default:
description: Error response describing why the operation failed.
schema:
$ref: '#/definitions/ErrorResponse'
summary: Microsoft Azure Get Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Windowsesu Multipleactivationkeys Multipleactivationkeyname
put:
tags:
- MultipleActivationKeys
operationId: microsoftAzureMultipleactivationkeysCreate
x-ms-examples:
CreateMultipleActivationKey:
$ref: ./examples/CreateMultipleActivationKey.json
description: Create a MAK key.
parameters:
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter
- $ref: '#/parameters/MultipleActivationKeyNameParameter'
- name: multipleActivationKey
in: body
description: Details of the MAK key.
required: true
schema:
$ref: '#/definitions/MultipleActivationKey'
responses:
'200':
description: OK
schema:
$ref: '#/definitions/MultipleActivationKey'
'201':
description: Created
schema:
$ref: '#/definitions/MultipleActivationKey'
default:
description: Error response describing why the operation failed.
schema:
$ref: '#/definitions/ErrorResponse'
x-ms-long-running-operation: true
summary: Microsoft Azure Put Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Windowsesu Multipleactivationkeys Multipleactivationkeyname
patch:
tags:
- MultipleActivationKeys
operationId: microsoftAzureMultipleactivationkeysUpdate
x-ms-examples:
UpdateMultipleActivationKey:
$ref: ./examples/UpdateMultipleActivationKey.json
description: Update a MAK key.
parameters:
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter
- $ref: '#/parameters/MultipleActivationKeyNameParameter'
- name: multipleActivationKey
in: body
description: Details of the MAK key.
required: true
schema:
$ref: '#/definitions/MultipleActivationKeyUpdate'
responses:
'200':
description: OK
schema:
$ref: '#/definitions/MultipleActivationKey'
default:
description: Error response describing why the operation failed.
schema:
$ref: '#/definitions/ErrorResponse'
summary: Microsoft Azure Patch Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Windowsesu Multipleactivationkeys Multipleactivationkeyname
delete:
tags:
- MultipleActivationKeys
operationId: microsoftAzureMultipleactivationkeysDelete
x-ms-examples:
DeleteMultipleActivationKey:
$ref: ./examples/DeleteMultipleActivationKey.json
description: Delete a MAK key.
parameters:
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter
- $ref: ../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter
- $ref: '#/parameters/MultipleActivationKeyNameParameter'
responses:
'200':
description: OK
'204':
description: No Content
default:
description: Error response describing why the operation failed.
schema:
$ref: '#/definitions/ErrorResponse'
summary: Microsoft Azure Delete Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Windowsesu Multipleactivationkeys Multipleactivationkeyname
definitions:
ErrorDefinition:
description: Error definition.
properties:
code:
description: Service specific error code which serves as the substatus for the HTTP error code.
type: string
readOnly: true
message:
description: Description of the error.
type: string
readOnly: true
details:
description: Internal error details.
type: array
items:
$ref: '#/definitions/ErrorDefinition'
readOnly: true
ErrorResponse:
description: Error response.
properties:
error:
$ref: '#/definitions/ErrorDefinition'
description: The error details.
MultipleActivationKey:
description: MAK key details.
type: object
allOf:
- $ref: ../../../../../common-types/resource-management/v1/types.json#/definitions/TrackedResource
properties:
properties:
description: MAK key specific properties.
type: object
x-ms-client-flatten: true
properties:
multipleActivationKey:
description: MAK 5x5 key.
type: string
readOnly: true
expirationDate:
description: End of support of security updates activated by the MAK key.
format: date-time
type: string
readOnly: true
osType:
description: Type of OS for which the key is requested.
type: string
enum:
- Windows7
- WindowsServer2008
- WindowsServer2008R2
x-ms-enum:
name: OsType
modelAsString: true
x-ms-mutability:
- create
- read
supportType:
description: Type of support
type: string
enum:
- SupplementalServicing
- PremiumAssurance
default: SupplementalServicing
x-ms-enum:
name: SupportType
modelAsString: true
x-ms-mutability:
- create
- read
installedServerNumber:
description: Number of activations/servers using the MAK key.
type: integer
minimum: 1
maximum: 5000
x-ms-mutability:
- create
- read
agreementNumber:
description: Agreement number under which the key is requested.
type: string
x-ms-mutability:
- create
- read
isEligible:
description: true if user has eligible on-premises Windows physical or virtual machines, and that the requested key will only be used in their organization; false otherwise.
type: boolean
x-ms-mutability:
- create
- read
provisioningState:
type: string
enum:
- Succeeded
- Failed
- Canceled
- Accepted
- Provisioning
x-ms-enum:
name: ProvisioningState
modelAsString: true
readOnly: true
x-ms-azure-resource: true
MultipleActivationKeyList:
description: List of MAK keys.
type: object
properties:
value:
description: List of MAK keys.
type: array
items:
$ref: '#/definitions/MultipleActivationKey'
nextLink:
description: Link to the next page of resources.
type: string
readOnly: true
MultipleActivationKeyUpdate:
description: MAK key details.
type: object
properties:
tags:
description: Resource tags.
type: object
additionalProperties:
type: string
parameters:
MultipleActivationKeyNameParameter:
name: multipleActivationKeyName
in: path
required: true
type: string
description: The name of the MAK key.
x-ms-parameter-location: method
x-ms-parameterized-host:
hostTemplate: '{endpoint}'
useSchemePrefix: false
parameters:
- $ref: '#/parameters/Endpoint'