Udostępnij za pośrednictwem


Licenses - Create Or Update

Operacja tworzenia lub aktualizowania licencji.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
licenseName
path True

string

Nazwa licencji.

Wzorzec wyrażenia regularnego: [a-zA-Z0-9-_\.]+

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja geograficzna, w której znajduje się zasób

properties.licenseDetails

LicenseDetails

Opisuje właściwości licencji.

properties.licenseType

LicenseType

Typ zasobu licencji.

properties.tenantId

string

Opisuje identyfikator dzierżawy.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

License

Zaktualizowany zasób

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Create or Update a License

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

License

Opisuje licencję na maszynie hybrydowej.

LicenseCoreType

Opisuje typ rdzenia licencji (rdzenie wirtualne lub rdzenie wirtualne).

LicenseDetails

Opisuje właściwości licencji.

LicenseEdition

Opisuje wydanie licencji. Wartości to Standard lub Datacenter.

LicenseState

Opisuje stan licencji.

LicenseTarget

Opisuje serwer docelowy licencji.

LicenseType

Typ zasobu licencji.

ProgramYear

Opisuje rok programowy licencji zbiorczej.

ProvisioningState

Stan aprowizacji, który pojawia się tylko w odpowiedzi.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

VolumeLicenseDetails

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

License

Opisuje licencję na maszynie hybrydowej.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.licenseDetails

LicenseDetails

Opisuje właściwości licencji.

properties.licenseType

LicenseType

Typ zasobu licencji.

properties.provisioningState

ProvisioningState

Stan aprowizacji, który pojawia się tylko w odpowiedzi.

properties.tenantId

string

Opisuje identyfikator dzierżawy.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

LicenseCoreType

Opisuje typ rdzenia licencji (rdzenie wirtualne lub rdzenie wirtualne).

Nazwa Typ Opis
pCore

string

vCore

string

LicenseDetails

Opisuje właściwości licencji.

Nazwa Typ Opis
assignedLicenses

integer

Opisuje liczbę przypisanych licencji.

edition

LicenseEdition

Opisuje wydanie licencji. Wartości to Standard lub Datacenter.

immutableId

string

Opisuje niezmienny identyfikator.

processors

integer

Opisuje liczbę procesorów.

state

LicenseState

Opisuje stan licencji.

target

LicenseTarget

Opisuje serwer docelowy licencji.

type

LicenseCoreType

Opisuje typ rdzenia licencji (rdzenie wirtualne lub rdzenie wirtualne).

volumeLicenseDetails

VolumeLicenseDetails[]

Lista szczegółów licencji zbiorczej.

LicenseEdition

Opisuje wydanie licencji. Wartości to Standard lub Datacenter.

Nazwa Typ Opis
Datacenter

string

Standard

string

LicenseState

Opisuje stan licencji.

Nazwa Typ Opis
Activated

string

Deactivated

string

LicenseTarget

Opisuje serwer docelowy licencji.

Nazwa Typ Opis
Windows Server 2012

string

Windows Server 2012 R2

string

LicenseType

Typ zasobu licencji.

Nazwa Typ Opis
ESU

string

ProgramYear

Opisuje rok programowy licencji zbiorczej.

Nazwa Typ Opis
Year 1

string

Year 2

string

Year 3

string

ProvisioningState

Stan aprowizacji, który pojawia się tylko w odpowiedzi.

Nazwa Typ Opis
Accepted

string

Canceled

string

Creating

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

VolumeLicenseDetails

Nazwa Typ Opis
invoiceId

string

Identyfikator faktury dla licencji zbiorczej.

programYear

ProgramYear

Opisuje rok programowy licencji zbiorczej.