Compartir a través de


Licenses - Create Or Update

Operación para crear o actualizar una licencia.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
licenseName
path True

string

Nombre de la licencia.

Patrón de Regex: [a-zA-Z0-9-_\.]+

resourceGroupName
path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string

Identificador de la suscripción de destino.

api-version
query True

string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación geográfica donde reside el recurso

properties.licenseDetails

LicenseDetails

Describe las propiedades de una licencia.

properties.licenseType

LicenseType

Tipo del recurso de licencia.

properties.tenantId

string

Describe el identificador de inquilino.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

License

Recurso actualizado

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Create or Update a License

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

License

Describe una licencia en una máquina híbrida.

LicenseCoreType

Describe el tipo de núcleo de licencia (núcleo virtual o núcleo virtual).

LicenseDetails

Describe las propiedades de una licencia.

LicenseEdition

Describe la edición de la licencia. Los valores son Standard o Datacenter.

LicenseState

Describe el estado de la licencia.

LicenseTarget

Describe el servidor de destino de licencia.

LicenseType

Tipo del recurso de licencia.

ProgramYear

Describe el año del programa para el que está la licencia por volumen.

ProvisioningState

Estado de aprovisionamiento, que solo aparece en la respuesta.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

VolumeLicenseDetails

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

License

Describe una licencia en una máquina híbrida.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso.

properties.licenseDetails

LicenseDetails

Describe las propiedades de una licencia.

properties.licenseType

LicenseType

Tipo del recurso de licencia.

properties.provisioningState

ProvisioningState

Estado de aprovisionamiento, que solo aparece en la respuesta.

properties.tenantId

string

Describe el identificador de inquilino.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

LicenseCoreType

Describe el tipo de núcleo de licencia (núcleo virtual o núcleo virtual).

Nombre Tipo Description
pCore

string

vCore

string

LicenseDetails

Describe las propiedades de una licencia.

Nombre Tipo Description
assignedLicenses

integer

Describe el número de licencias asignadas.

edition

LicenseEdition

Describe la edición de la licencia. Los valores son Standard o Datacenter.

immutableId

string

Describe el identificador inmutable.

processors

integer

Describe el número de procesadores.

state

LicenseState

Describe el estado de la licencia.

target

LicenseTarget

Describe el servidor de destino de licencia.

type

LicenseCoreType

Describe el tipo de núcleo de licencia (núcleo virtual o núcleo virtual).

volumeLicenseDetails

VolumeLicenseDetails[]

Lista de detalles de la licencia por volumen.

LicenseEdition

Describe la edición de la licencia. Los valores son Standard o Datacenter.

Nombre Tipo Description
Datacenter

string

Standard

string

LicenseState

Describe el estado de la licencia.

Nombre Tipo Description
Activated

string

Deactivated

string

LicenseTarget

Describe el servidor de destino de licencia.

Nombre Tipo Description
Windows Server 2012

string

Windows Server 2012 R2

string

LicenseType

Tipo del recurso de licencia.

Nombre Tipo Description
ESU

string

ProgramYear

Describe el año del programa para el que está la licencia por volumen.

Nombre Tipo Description
Year 1

string

Year 2

string

Year 3

string

ProvisioningState

Estado de aprovisionamiento, que solo aparece en la respuesta.

Nombre Tipo Description
Accepted

string

Canceled

string

Creating

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

VolumeLicenseDetails

Nombre Tipo Description
invoiceId

string

Identificador de factura de la licencia por volumen.

programYear

ProgramYear

Describe el año del programa para el que está la licencia por volumen.