Freigeben über


Licenses - Create Or Update

Der Vorgang zum Erstellen oder Aktualisieren einer Lizenz.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
licenseName
path True

string

Der Name der Lizenz.

RegEx-Muster: [a-zA-Z0-9-_\.]+

resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Der geografische Standort, an dem sich die Ressource befindet

properties.licenseDetails

LicenseDetails

Beschreibt die Eigenschaften einer Lizenz.

properties.licenseType

LicenseType

Der Typ der Lizenzressource.

properties.tenantId

string

Beschreibt die Mandanten-ID.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

License

Aktualisierte Ressource

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Create or Update a License

Beispielanforderung

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
    }
  }
}

Beispiel für eine Antwort

{
  "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>"
    }
  }
}

Definitionen

Name Beschreibung
createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

License

Beschreibt eine Lizenz auf einem Hybridcomputer.

LicenseCoreType

Beschreibt den Lizenzkerntyp (pCore oder vCore).

LicenseDetails

Beschreibt die Eigenschaften einer Lizenz.

LicenseEdition

Beschreibt die Edition der Lizenz. Die Werte sind entweder Standard oder Datacenter.

LicenseState

Beschreibt den Status der Lizenz.

LicenseTarget

Beschreibt den Lizenzzielserver.

LicenseType

Der Typ der Lizenzressource.

ProgramYear

Beschreibt das Programmjahr, für das die Volumenlizenz gilt.

ProvisioningState

Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

VolumeLicenseDetails

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

License

Beschreibt eine Lizenz auf einem Hybridcomputer.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.licenseDetails

LicenseDetails

Beschreibt die Eigenschaften einer Lizenz.

properties.licenseType

LicenseType

Der Typ der Lizenzressource.

properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.

properties.tenantId

string

Beschreibt die Mandanten-ID.

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

LicenseCoreType

Beschreibt den Lizenzkerntyp (pCore oder vCore).

Name Typ Beschreibung
pCore

string

vCore

string

LicenseDetails

Beschreibt die Eigenschaften einer Lizenz.

Name Typ Beschreibung
assignedLicenses

integer

Beschreibt die Anzahl der zugewiesenen Lizenzen.

edition

LicenseEdition

Beschreibt die Edition der Lizenz. Die Werte sind entweder Standard oder Datacenter.

immutableId

string

Beschreibt die unveränderliche ID.

processors

integer

Beschreibt die Anzahl der Prozessoren.

state

LicenseState

Beschreibt den Status der Lizenz.

target

LicenseTarget

Beschreibt den Lizenzzielserver.

type

LicenseCoreType

Beschreibt den Lizenzkerntyp (pCore oder vCore).

volumeLicenseDetails

VolumeLicenseDetails[]

Eine Liste der Volumenlizenzdetails.

LicenseEdition

Beschreibt die Edition der Lizenz. Die Werte sind entweder Standard oder Datacenter.

Name Typ Beschreibung
Datacenter

string

Standard

string

LicenseState

Beschreibt den Status der Lizenz.

Name Typ Beschreibung
Activated

string

Deactivated

string

LicenseTarget

Beschreibt den Lizenzzielserver.

Name Typ Beschreibung
Windows Server 2012

string

Windows Server 2012 R2

string

LicenseType

Der Typ der Lizenzressource.

Name Typ Beschreibung
ESU

string

ProgramYear

Beschreibt das Programmjahr, für das die Volumenlizenz gilt.

Name Typ Beschreibung
Year 1

string

Year 2

string

Year 3

string

ProvisioningState

Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.

Name Typ Beschreibung
Accepted

string

Canceled

string

Creating

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

VolumeLicenseDetails

Name Typ Beschreibung
invoiceId

string

Die Rechnungs-ID für die Volumenlizenz.

programYear

ProgramYear

Beschreibt das Programmjahr, für das die Volumenlizenz gilt.