Partager via


Licenses - Create Or Update

Opération de création ou de mise à jour d’une licence.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/licenses/{licenseName}?api-version=2024-05-20-preview

Paramètres URI

Nom Dans Obligatoire Type Description
licenseName
path True

string

Nom de la licence.

Modèle d’expression régulière: [a-zA-Z0-9-_\.]+

resourceGroupName
path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string

ID de l’abonnement cible.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource

properties.licenseDetails

LicenseDetails

Décrit les propriétés d’une licence.

properties.licenseType

LicenseType

Type de la ressource de licence.

properties.tenantId

string

Décrit l’ID de locataire.

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

License

Ressource mise à jour

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Create or Update a License

Exemple de requête

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/licenses/{licenseName}?api-version=2024-05-20-preview

{
  "location": "eastus2euap",
  "properties": {
    "licenseType": "ESU",
    "licenseDetails": {
      "state": "Activated",
      "target": "Windows Server 2012",
      "edition": "Datacenter",
      "type": "pCore",
      "processors": 6
    }
  }
}

Exemple de réponse

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/Licenses/{licenseName}",
  "name": "{licenseName}",
  "type": "Microsoft.HybridCompute/licenses",
  "location": "eastus2euap",
  "tags": null,
  "properties": {
    "tenantId": "{tenandId}",
    "licenseType": "ESU",
    "licenseDetails": {
      "state": "Activated",
      "target": "Windows Server 2012",
      "edition": "Datacenter",
      "type": "pCore",
      "processors": 6,
      "assignedLicenses": 2,
      "immutableId": "<generated Guid>"
    }
  }
}

Définitions

Nom Description
createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

License

Décrit une licence dans une machine hybride.

LicenseCoreType

Décrit le type de base de licence (pCore ou vCore).

LicenseDetails

Décrit les propriétés d’une licence.

LicenseEdition

Décrit l’édition de la licence. Les valeurs sont Standard ou Datacenter.

LicenseState

Décrit l’état de la licence.

LicenseTarget

Décrit le serveur cible de licences.

LicenseType

Type de la ressource de licence.

ProgramYear

Décrit l’année du programme pour laquelle la licence en volume est destinée.

ProvisioningState

État d’approvisionnement, qui apparaît uniquement dans la réponse.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

VolumeLicenseDetails

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

License

Décrit une licence dans une machine hybride.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

location

string

Emplacement géographique où réside la ressource

name

string

nom de la ressource.

properties.licenseDetails

LicenseDetails

Décrit les propriétés d’une licence.

properties.licenseType

LicenseType

Type de la ressource de licence.

properties.provisioningState

ProvisioningState

État d’approvisionnement, qui apparaît uniquement dans la réponse.

properties.tenantId

string

Décrit l’ID de locataire.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

LicenseCoreType

Décrit le type de base de licence (pCore ou vCore).

Nom Type Description
pCore

string

vCore

string

LicenseDetails

Décrit les propriétés d’une licence.

Nom Type Description
assignedLicenses

integer

Décrit le nombre de licences affectées.

edition

LicenseEdition

Décrit l’édition de la licence. Les valeurs sont Standard ou Datacenter.

immutableId

string

Décrit l’ID immuable.

processors

integer

Décrit le nombre de processeurs.

state

LicenseState

Décrit l’état de la licence.

target

LicenseTarget

Décrit le serveur cible de licences.

type

LicenseCoreType

Décrit le type de base de licence (pCore ou vCore).

volumeLicenseDetails

VolumeLicenseDetails[]

Liste des détails de la licence en volume.

LicenseEdition

Décrit l’édition de la licence. Les valeurs sont Standard ou Datacenter.

Nom Type Description
Datacenter

string

Standard

string

LicenseState

Décrit l’état de la licence.

Nom Type Description
Activated

string

Deactivated

string

LicenseTarget

Décrit le serveur cible de licences.

Nom Type Description
Windows Server 2012

string

Windows Server 2012 R2

string

LicenseType

Type de la ressource de licence.

Nom Type Description
ESU

string

ProgramYear

Décrit l’année du programme pour laquelle la licence en volume est destinée.

Nom Type Description
Year 1

string

Year 2

string

Year 3

string

ProvisioningState

État d’approvisionnement, qui apparaît uniquement dans la réponse.

Nom Type Description
Accepted

string

Canceled

string

Creating

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la dernière ressource.

lastModifiedByType

createdByType

Type d’identité qui a modifié la dernière ressource.

VolumeLicenseDetails

Nom Type Description
invoiceId

string

ID de facture pour la licence en volume.

programYear

ProgramYear

Décrit l’année du programme pour laquelle la licence en volume est destinée.