Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
- Más reciente
- 2025-02-19-preview
- 2025-01-13
- 2024-11-10-preview
- 2024-09-10-preview
- 2024-07-31-preview
- 2024-07-10
- 2024-05-20-preview
- 2024-03-31-preview
- 2023-10-03-preview
- 2023-06-20-preview
- 2023-03-15-preview
- 2022-12-27
- 2022-12-27-preview
- 2022-11-10
- 2022-08-11-preview
- 2022-05-10-preview
- 2022-03-10
- 2021-12-10-preview
- 2021-06-10-preview
- 2021-05-20
- 2021-05-17-preview
- 2021-04-22-preview
- 2021-03-25-preview
- 2021-01-28-preview
- 2020-08-15-preview
- 2020-08-02
- 2020-07-30-preview
- 2019-12-12
- 2019-08-02-preview
- 2019-03-18-preview
Definición de recursos de Bicep
El tipo de recurso machines se puede implementar con operaciones que tienen como destino:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.HybridCompute/machines, agregue lo siguiente a la plantilla de Bicep.
resource symbolicname 'Microsoft.HybridCompute/machines@2025-02-19-preview' = {
identity: {
type: 'SystemAssigned'
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
agentUpgrade: {
correlationId: 'string'
desiredVersion: 'string'
enableAutomaticUpgrade: bool
}
clientPublicKey: 'string'
cloudMetadata: {}
extensions: [
{
name: 'string'
status: {
code: 'string'
displayStatus: 'string'
level: 'string'
message: 'string'
time: 'string'
}
type: 'string'
typeHandlerVersion: 'string'
}
]
hardwareResourceId: 'string'
identityKeyStore: 'string'
licenseProfile: {
esuProfile: {
assignedLicense: {
location: 'string'
properties: {
licenseDetails: {
edition: 'string'
processors: int
state: 'string'
target: 'string'
type: 'string'
volumeLicenseDetails: [
{
invoiceId: 'string'
programYear: 'string'
}
]
}
licenseType: 'string'
tenantId: 'string'
}
tags: {
{customized property}: 'string'
}
}
licenseAssignmentState: 'string'
}
}
locationData: {
city: 'string'
countryOrRegion: 'string'
district: 'string'
name: 'string'
}
mssqlDiscovered: 'string'
osProfile: {
linuxConfiguration: {
patchSettings: {
assessmentMode: 'string'
enableHotpatching: bool
patchMode: 'string'
}
}
windowsConfiguration: {
patchSettings: {
assessmentMode: 'string'
enableHotpatching: bool
patchMode: 'string'
}
}
}
osType: 'string'
parentClusterResourceId: 'string'
privateLinkScopeResourceId: 'string'
serviceStatuses: {
extensionService: {
startupType: 'string'
status: 'string'
}
guestConfigurationService: {
startupType: 'string'
status: 'string'
}
}
tpmEkCertificate: 'string'
vmId: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valores de propiedad
AgentUpgrade
| Nombre | Descripción | Importancia |
|---|---|---|
| correlationId | Identificador de correlación asociado a una operación de actualización del agente. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| desiredVersion | Especifica la información de versión w.r.t AgentUpgrade para la máquina. | cuerda / cadena |
| enableAutomaticUpgrade | Especifica si se debe actualizar el agente de la máquina. | booleano |
CloudMetadata
| Nombre | Descripción | Importancia |
|---|
identidad
| Nombre | Descripción | Importancia |
|---|---|---|
| tipo | Tipo de identidad. | 'SystemAssigned' |
Licencia
| Nombre | Descripción | Importancia |
|---|---|---|
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| Propiedades | Propiedades de licencia de proceso híbrido | LicenseProperties |
| Etiquetas | Etiquetas de recursos. | trackedResourceTags de |
LicenseDetails
| Nombre | Descripción | Importancia |
|---|---|---|
| edición | Describe la edición de la licencia. Los valores son Standard o Datacenter. | "Centro de datos" 'Estándar' |
| Procesadores | Describe el número de procesadores. | Int |
| estado | Describe el estado de la licencia. | "Activado" 'Desactivado' |
| Objetivo | Describe el servidor de destino de licencia. | "Windows Server 2012 R2" "Windows Server 2012" |
| tipo | Describe el tipo de núcleo de licencia (núcleo virtual o núcleo virtual). | 'pCore' "Núcleo virtual" |
| volumeLicenseDetails | Lista de detalles de la licencia por volumen. | VolumeLicenseDetails[] |
LicenseProfileMachineInstanceView
| Nombre | Descripción | Importancia |
|---|---|---|
| esuProfile | Propiedades para el perfil de ESU de máquina. | LicenseProfileMachineInstanceViewEsuProperties |
LicenseProfileMachineInstanceViewEsuProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| assignedLicense | Recurso de licencia asignado. | Licencia |
| licenseAssignmentState | Describe el estado de asignación de licencia (Asignado o NotAssigned). | 'Asignado' 'NotAssigned' |
LicenseProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| licenseDetails | Describe las propiedades de una licencia. | LicenseDetails |
| licenseType | Tipo del recurso de licencia. | 'ESU' |
| ID del arrendatario | Describe el identificador de inquilino. | cuerda / cadena |
LocationData
| Nombre | Descripción | Importancia |
|---|---|---|
| ciudad | Ciudad o localidad donde se encuentra el recurso. | cuerda / cadena |
| countryOrRegion | País o región donde se encuentra el recurso | cuerda / cadena |
| distrito | El distrito, el estado o la provincia donde se encuentra el recurso. | cuerda / cadena |
| nombre | Nombre canónico para la ubicación geográfica o física. | cuerda Restricciones: Longitud máxima = 256 (obligatorio) |
MachineExtensionInstanceView
| Nombre | Descripción | Importancia |
|---|---|---|
| nombre | Nombre de la extensión del equipo. | cuerda / cadena |
| estado | Estado de la vista de instancia. | MachineExtensionInstanceViewStatus |
| tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda / cadena |
| typeHandlerVersion | Especifica la versión del controlador de script. | cuerda / cadena |
MachineExtensionInstanceViewStatus
| Nombre | Descripción | Importancia |
|---|---|---|
| código | Código de estado. | cuerda / cadena |
| displayStatus | Etiqueta localizable corta para el estado. | cuerda / cadena |
| nivel | Código de nivel. | 'Error' 'Info' 'Advertencia' |
| Mensaje | Mensaje de estado detallado, incluido para alertas y mensajes de error. | cuerda / cadena |
| Tiempo | Hora del estado. | cuerda / cadena |
MachineProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| agentUpgrade | La información de la actualización del agente w.r.t de la máquina | AgentUpgrade |
| clientPublicKey | Clave pública que proporciona el cliente que se va a usar durante la incorporación inicial de recursos | cuerda / cadena |
| cloudMetadata | Metadatos del entorno de nube (Azure/GCP/AWS/OCI...). | CloudMetadata |
| Extensiones | Información de extensiones de máquina (campo en desuso) | MachineExtensionInstanceView[] |
| hardwareResourceId | Especifica el identificador de recurso del dispositivo de hardware asociado. Solo se puede establecer mediante HCI RP. | cuerda / cadena |
| identityKeyStore | Especifica el almacén de claves de identidad que usa una máquina. | 'Valor predeterminado' 'TPM' |
| licenseProfile | Especifica las propiedades relacionadas con la licencia para una máquina. | LicenseProfileMachineInstanceView |
| locationData | Metadatos relacionados con la ubicación geográfica del recurso. | LocationData |
| mssqlDiscovered | Especifica si se detecta alguna instancia de MS SQL en la máquina. | cuerda / cadena |
| osProfile | Especifica la configuración del sistema operativo para la máquina híbrida. | OSProfile de |
| osType | Tipo de sistema operativo (windows/linux). | cuerda / cadena |
| parentClusterResourceId | El identificador de recurso del clúster primario (Azure HCI) al que se asigna esta máquina, si existe. | cuerda / cadena |
| privateLinkScopeResourceId | El identificador de recurso del ámbito de vínculo privado al que está asignada esta máquina, si existe. | cuerda / cadena |
| serviceStatuses | Estados de los servicios dependientes que se notifican de nuevo a ARM. | ServiceStatuses |
| tpmEkCertificate | Certificado de clave de aprobación del módulo de plataforma segura (TPM) que proporciona el cliente para su uso durante la incorporación inicial de recursos. | cuerda / cadena |
| vmId | Especifica el identificador único de la máquina híbrida. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
Microsoft.HybridCompute/machines
| Nombre | Descripción | Importancia |
|---|---|---|
| identidad | Identidad del recurso. | Identidad |
| amable | Indica qué tipo de máquina arc coloca en el entorno local, como HCI, SCVMM o VMware, etc. | 'AVS' "AWS" 'EPS' 'GCP' 'HCI' 'SCVMM' "VMware" |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| nombre | El nombre del recurso | cuerda Restricciones: Longitud mínima = 1 Longitud máxima = 54 Patrón = ^[a-zA-Z0-9-_\.]{1,54}$ (obligatorio) |
| Propiedades | Propiedades de la máquina de proceso híbrido | MachineProperties |
| Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
OSProfile
| Nombre | Descripción | Importancia |
|---|---|---|
| linuxConfiguration | Especifica la configuración de Linux para update Management. | OSProfileLinuxConfiguration |
| windowsConfiguration | Especifica la configuración de windows para update management. | OSProfileWindowsConfiguration |
OSProfileLinuxConfiguration
| Nombre | Descripción | Importancia |
|---|---|---|
| patchSettings | Especifica la configuración de revisión. | patchSettings de |
OSProfileWindowsConfiguration
| Nombre | Descripción | Importancia |
|---|---|---|
| patchSettings | Especifica la configuración de revisión. | patchSettings de |
PatchSettings
| Nombre | Descripción | Importancia |
|---|---|---|
| assessmentMode | Especifica el modo de evaluación. | 'AutomaticByPlatform' 'ImageDefault' |
| enableHotpatching | Captura la intención de inscripción de la funcionalidad hotpatch de los clientes, lo que permite a los clientes aplicar revisiones a sus máquinas Windows sin necesidad de reiniciar. | booleano |
| patchMode | Especifica el modo de revisión. | 'AutomaticByOS' 'AutomaticByPlatform' 'ImageDefault' 'Manual' |
ServiceStatus
| Nombre | Descripción | Importancia |
|---|---|---|
| startupType | El comportamiento del servicio cuando se inicia la máquina habilitada para Arc. | cuerda / cadena |
| estado | El estado actual del servicio. | cuerda / cadena |
ServiceStatuses
| Nombre | Descripción | Importancia |
|---|---|---|
| extensionService | Estado del servicio de extensión en la máquina habilitada para Arc. | ServiceStatus |
| guestConfigurationService | Estado del servicio de configuración de invitado en la máquina habilitada para Arc. | ServiceStatus |
TrackedResourceTags
| Nombre | Descripción | Importancia |
|---|
TrackedResourceTags
| Nombre | Descripción | Importancia |
|---|
VolumeLicenseDetails
| Nombre | Descripción | Importancia |
|---|---|---|
| ID de factura | Identificador de factura de la licencia por volumen. | cuerda / cadena |
| programYear | Describe el año del programa para el que está la licencia por volumen. | 'Año 1' 'Año 2' 'Año 3' |
Ejemplos de uso
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
| Módulo | Descripción |
|---|---|
| Máquina de proceso híbrida | Módulo de recursos de AVM para la máquina de proceso híbrido |
Ejemplos de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.
| Archivo de Bicep | Descripción |
|---|---|
| Creación de una máquina virtual Linux desde una imagen de la galería en azure Stack HCI | Esta plantilla crea una máquina virtual Linux sencilla a partir de la imagen personalizada a la que se hace referencia en Azure Stack HCI versión 23H2+ |
| Creación de una máquina virtual a partir de la imagen a la que se hace referencia en azure Stack HCI | Esta plantilla crea una máquina virtual Windows sencilla a partir de la imagen de Azure Marketplace a la que se hace referencia en Azure Stack HCI versión 23H2+ |
Definición de recursos de plantilla de ARM
El tipo de recurso machines se puede implementar con operaciones que tienen como destino:
- grupos de recursos: consulte comandos de implementación de grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.HybridCompute/machines, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.HybridCompute/machines",
"apiVersion": "2025-02-19-preview",
"name": "string",
"identity": {
"type": "SystemAssigned"
},
"kind": "string",
"location": "string",
"properties": {
"agentUpgrade": {
"correlationId": "string",
"desiredVersion": "string",
"enableAutomaticUpgrade": "bool"
},
"clientPublicKey": "string",
"cloudMetadata": {
},
"extensions": [
{
"name": "string",
"status": {
"code": "string",
"displayStatus": "string",
"level": "string",
"message": "string",
"time": "string"
},
"type": "string",
"typeHandlerVersion": "string"
}
],
"hardwareResourceId": "string",
"identityKeyStore": "string",
"licenseProfile": {
"esuProfile": {
"assignedLicense": {
"location": "string",
"properties": {
"licenseDetails": {
"edition": "string",
"processors": "int",
"state": "string",
"target": "string",
"type": "string",
"volumeLicenseDetails": [
{
"invoiceId": "string",
"programYear": "string"
}
]
},
"licenseType": "string",
"tenantId": "string"
},
"tags": {
"{customized property}": "string"
}
},
"licenseAssignmentState": "string"
}
},
"locationData": {
"city": "string",
"countryOrRegion": "string",
"district": "string",
"name": "string"
},
"mssqlDiscovered": "string",
"osProfile": {
"linuxConfiguration": {
"patchSettings": {
"assessmentMode": "string",
"enableHotpatching": "bool",
"patchMode": "string"
}
},
"windowsConfiguration": {
"patchSettings": {
"assessmentMode": "string",
"enableHotpatching": "bool",
"patchMode": "string"
}
}
},
"osType": "string",
"parentClusterResourceId": "string",
"privateLinkScopeResourceId": "string",
"serviceStatuses": {
"extensionService": {
"startupType": "string",
"status": "string"
},
"guestConfigurationService": {
"startupType": "string",
"status": "string"
}
},
"tpmEkCertificate": "string",
"vmId": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valores de propiedad
AgentUpgrade
| Nombre | Descripción | Importancia |
|---|---|---|
| correlationId | Identificador de correlación asociado a una operación de actualización del agente. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| desiredVersion | Especifica la información de versión w.r.t AgentUpgrade para la máquina. | cuerda / cadena |
| enableAutomaticUpgrade | Especifica si se debe actualizar el agente de la máquina. | booleano |
CloudMetadata
| Nombre | Descripción | Importancia |
|---|
identidad
| Nombre | Descripción | Importancia |
|---|---|---|
| tipo | Tipo de identidad. | 'SystemAssigned' |
Licencia
| Nombre | Descripción | Importancia |
|---|---|---|
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| Propiedades | Propiedades de licencia de proceso híbrido | LicenseProperties |
| Etiquetas | Etiquetas de recursos. | trackedResourceTags de |
LicenseDetails
| Nombre | Descripción | Importancia |
|---|---|---|
| edición | Describe la edición de la licencia. Los valores son Standard o Datacenter. | "Centro de datos" 'Estándar' |
| Procesadores | Describe el número de procesadores. | Int |
| estado | Describe el estado de la licencia. | "Activado" 'Desactivado' |
| Objetivo | Describe el servidor de destino de licencia. | "Windows Server 2012 R2" "Windows Server 2012" |
| tipo | Describe el tipo de núcleo de licencia (núcleo virtual o núcleo virtual). | 'pCore' "Núcleo virtual" |
| volumeLicenseDetails | Lista de detalles de la licencia por volumen. | VolumeLicenseDetails[] |
LicenseProfileMachineInstanceView
| Nombre | Descripción | Importancia |
|---|---|---|
| esuProfile | Propiedades para el perfil de ESU de máquina. | LicenseProfileMachineInstanceViewEsuProperties |
LicenseProfileMachineInstanceViewEsuProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| assignedLicense | Recurso de licencia asignado. | Licencia |
| licenseAssignmentState | Describe el estado de asignación de licencia (Asignado o NotAssigned). | 'Asignado' 'NotAssigned' |
LicenseProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| licenseDetails | Describe las propiedades de una licencia. | LicenseDetails |
| licenseType | Tipo del recurso de licencia. | 'ESU' |
| ID del arrendatario | Describe el identificador de inquilino. | cuerda / cadena |
LocationData
| Nombre | Descripción | Importancia |
|---|---|---|
| ciudad | Ciudad o localidad donde se encuentra el recurso. | cuerda / cadena |
| countryOrRegion | País o región donde se encuentra el recurso | cuerda / cadena |
| distrito | El distrito, el estado o la provincia donde se encuentra el recurso. | cuerda / cadena |
| nombre | Nombre canónico para la ubicación geográfica o física. | cuerda Restricciones: Longitud máxima = 256 (obligatorio) |
MachineExtensionInstanceView
| Nombre | Descripción | Importancia |
|---|---|---|
| nombre | Nombre de la extensión del equipo. | cuerda / cadena |
| estado | Estado de la vista de instancia. | MachineExtensionInstanceViewStatus |
| tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda / cadena |
| typeHandlerVersion | Especifica la versión del controlador de script. | cuerda / cadena |
MachineExtensionInstanceViewStatus
| Nombre | Descripción | Importancia |
|---|---|---|
| código | Código de estado. | cuerda / cadena |
| displayStatus | Etiqueta localizable corta para el estado. | cuerda / cadena |
| nivel | Código de nivel. | 'Error' 'Info' 'Advertencia' |
| Mensaje | Mensaje de estado detallado, incluido para alertas y mensajes de error. | cuerda / cadena |
| Tiempo | Hora del estado. | cuerda / cadena |
MachineProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| agentUpgrade | La información de la actualización del agente w.r.t de la máquina | AgentUpgrade |
| clientPublicKey | Clave pública que proporciona el cliente que se va a usar durante la incorporación inicial de recursos | cuerda / cadena |
| cloudMetadata | Metadatos del entorno de nube (Azure/GCP/AWS/OCI...). | CloudMetadata |
| Extensiones | Información de extensiones de máquina (campo en desuso) | MachineExtensionInstanceView[] |
| hardwareResourceId | Especifica el identificador de recurso del dispositivo de hardware asociado. Solo se puede establecer mediante HCI RP. | cuerda / cadena |
| identityKeyStore | Especifica el almacén de claves de identidad que usa una máquina. | 'Valor predeterminado' 'TPM' |
| licenseProfile | Especifica las propiedades relacionadas con la licencia para una máquina. | LicenseProfileMachineInstanceView |
| locationData | Metadatos relacionados con la ubicación geográfica del recurso. | LocationData |
| mssqlDiscovered | Especifica si se detecta alguna instancia de MS SQL en la máquina. | cuerda / cadena |
| osProfile | Especifica la configuración del sistema operativo para la máquina híbrida. | OSProfile de |
| osType | Tipo de sistema operativo (windows/linux). | cuerda / cadena |
| parentClusterResourceId | El identificador de recurso del clúster primario (Azure HCI) al que se asigna esta máquina, si existe. | cuerda / cadena |
| privateLinkScopeResourceId | El identificador de recurso del ámbito de vínculo privado al que está asignada esta máquina, si existe. | cuerda / cadena |
| serviceStatuses | Estados de los servicios dependientes que se notifican de nuevo a ARM. | ServiceStatuses |
| tpmEkCertificate | Certificado de clave de aprobación del módulo de plataforma segura (TPM) que proporciona el cliente para su uso durante la incorporación inicial de recursos. | cuerda / cadena |
| vmId | Especifica el identificador único de la máquina híbrida. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
Microsoft.HybridCompute/machines
| Nombre | Descripción | Importancia |
|---|---|---|
| apiVersion | La versión de api | '2025-02-19-preview' |
| identidad | Identidad del recurso. | Identidad |
| amable | Indica qué tipo de máquina arc coloca en el entorno local, como HCI, SCVMM o VMware, etc. | 'AVS' "AWS" 'EPS' 'GCP' 'HCI' 'SCVMM' "VMware" |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| nombre | El nombre del recurso | cuerda Restricciones: Longitud mínima = 1 Longitud máxima = 54 Patrón = ^[a-zA-Z0-9-_\.]{1,54}$ (obligatorio) |
| Propiedades | Propiedades de la máquina de proceso híbrido | MachineProperties |
| Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas |
| tipo | El tipo de recurso | "Microsoft.HybridCompute/machines" |
OSProfile
| Nombre | Descripción | Importancia |
|---|---|---|
| linuxConfiguration | Especifica la configuración de Linux para update Management. | OSProfileLinuxConfiguration |
| windowsConfiguration | Especifica la configuración de windows para update management. | OSProfileWindowsConfiguration |
OSProfileLinuxConfiguration
| Nombre | Descripción | Importancia |
|---|---|---|
| patchSettings | Especifica la configuración de revisión. | patchSettings de |
OSProfileWindowsConfiguration
| Nombre | Descripción | Importancia |
|---|---|---|
| patchSettings | Especifica la configuración de revisión. | patchSettings de |
PatchSettings
| Nombre | Descripción | Importancia |
|---|---|---|
| assessmentMode | Especifica el modo de evaluación. | 'AutomaticByPlatform' 'ImageDefault' |
| enableHotpatching | Captura la intención de inscripción de la funcionalidad hotpatch de los clientes, lo que permite a los clientes aplicar revisiones a sus máquinas Windows sin necesidad de reiniciar. | booleano |
| patchMode | Especifica el modo de revisión. | 'AutomaticByOS' 'AutomaticByPlatform' 'ImageDefault' 'Manual' |
ServiceStatus
| Nombre | Descripción | Importancia |
|---|---|---|
| startupType | El comportamiento del servicio cuando se inicia la máquina habilitada para Arc. | cuerda / cadena |
| estado | El estado actual del servicio. | cuerda / cadena |
ServiceStatuses
| Nombre | Descripción | Importancia |
|---|---|---|
| extensionService | Estado del servicio de extensión en la máquina habilitada para Arc. | ServiceStatus |
| guestConfigurationService | Estado del servicio de configuración de invitado en la máquina habilitada para Arc. | ServiceStatus |
TrackedResourceTags
| Nombre | Descripción | Importancia |
|---|
TrackedResourceTags
| Nombre | Descripción | Importancia |
|---|
VolumeLicenseDetails
| Nombre | Descripción | Importancia |
|---|---|---|
| ID de factura | Identificador de factura de la licencia por volumen. | cuerda / cadena |
| programYear | Describe el año del programa para el que está la licencia por volumen. | 'Año 1' 'Año 2' 'Año 3' |
Ejemplos de uso
Plantillas de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.
| Plantilla | Descripción |
|---|---|
Creación de una máquina virtual Linux desde una imagen de la galería en azure Stack HCI
|
Esta plantilla crea una máquina virtual Linux sencilla a partir de la imagen personalizada a la que se hace referencia en Azure Stack HCI versión 23H2+ |
|
Creación de una máquina virtual a partir de la imagen a la que se hace referencia en azure Stack HCI
|
Esta plantilla crea una máquina virtual Windows sencilla a partir de la imagen de Azure Marketplace a la que se hace referencia en Azure Stack HCI versión 23H2+ |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso machines se puede implementar con operaciones que tienen como destino:
- grupos de recursos de
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.HybridCompute/machines, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.HybridCompute/machines@2025-02-19-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
kind = "string"
properties = {
agentUpgrade = {
correlationId = "string"
desiredVersion = "string"
enableAutomaticUpgrade = bool
}
clientPublicKey = "string"
cloudMetadata = {
}
extensions = [
{
name = "string"
status = {
code = "string"
displayStatus = "string"
level = "string"
message = "string"
time = "string"
}
type = "string"
typeHandlerVersion = "string"
}
]
hardwareResourceId = "string"
identityKeyStore = "string"
licenseProfile = {
esuProfile = {
assignedLicense = {
location = "string"
properties = {
licenseDetails = {
edition = "string"
processors = int
state = "string"
target = "string"
type = "string"
volumeLicenseDetails = [
{
invoiceId = "string"
programYear = "string"
}
]
}
licenseType = "string"
tenantId = "string"
}
tags = {
{customized property} = "string"
}
}
licenseAssignmentState = "string"
}
}
locationData = {
city = "string"
countryOrRegion = "string"
district = "string"
name = "string"
}
mssqlDiscovered = "string"
osProfile = {
linuxConfiguration = {
patchSettings = {
assessmentMode = "string"
enableHotpatching = bool
patchMode = "string"
}
}
windowsConfiguration = {
patchSettings = {
assessmentMode = "string"
enableHotpatching = bool
patchMode = "string"
}
}
}
osType = "string"
parentClusterResourceId = "string"
privateLinkScopeResourceId = "string"
serviceStatuses = {
extensionService = {
startupType = "string"
status = "string"
}
guestConfigurationService = {
startupType = "string"
status = "string"
}
}
tpmEkCertificate = "string"
vmId = "string"
}
}
}
Valores de propiedad
AgentUpgrade
| Nombre | Descripción | Importancia |
|---|---|---|
| correlationId | Identificador de correlación asociado a una operación de actualización del agente. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| desiredVersion | Especifica la información de versión w.r.t AgentUpgrade para la máquina. | cuerda / cadena |
| enableAutomaticUpgrade | Especifica si se debe actualizar el agente de la máquina. | booleano |
CloudMetadata
| Nombre | Descripción | Importancia |
|---|
identidad
| Nombre | Descripción | Importancia |
|---|---|---|
| tipo | Tipo de identidad. | 'SystemAssigned' |
Licencia
| Nombre | Descripción | Importancia |
|---|---|---|
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| Propiedades | Propiedades de licencia de proceso híbrido | LicenseProperties |
| Etiquetas | Etiquetas de recursos. | trackedResourceTags de |
LicenseDetails
| Nombre | Descripción | Importancia |
|---|---|---|
| edición | Describe la edición de la licencia. Los valores son Standard o Datacenter. | "Centro de datos" 'Estándar' |
| Procesadores | Describe el número de procesadores. | Int |
| estado | Describe el estado de la licencia. | "Activado" 'Desactivado' |
| Objetivo | Describe el servidor de destino de licencia. | "Windows Server 2012 R2" "Windows Server 2012" |
| tipo | Describe el tipo de núcleo de licencia (núcleo virtual o núcleo virtual). | 'pCore' "Núcleo virtual" |
| volumeLicenseDetails | Lista de detalles de la licencia por volumen. | VolumeLicenseDetails[] |
LicenseProfileMachineInstanceView
| Nombre | Descripción | Importancia |
|---|---|---|
| esuProfile | Propiedades para el perfil de ESU de máquina. | LicenseProfileMachineInstanceViewEsuProperties |
LicenseProfileMachineInstanceViewEsuProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| assignedLicense | Recurso de licencia asignado. | Licencia |
| licenseAssignmentState | Describe el estado de asignación de licencia (Asignado o NotAssigned). | 'Asignado' 'NotAssigned' |
LicenseProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| licenseDetails | Describe las propiedades de una licencia. | LicenseDetails |
| licenseType | Tipo del recurso de licencia. | 'ESU' |
| ID del arrendatario | Describe el identificador de inquilino. | cuerda / cadena |
LocationData
| Nombre | Descripción | Importancia |
|---|---|---|
| ciudad | Ciudad o localidad donde se encuentra el recurso. | cuerda / cadena |
| countryOrRegion | País o región donde se encuentra el recurso | cuerda / cadena |
| distrito | El distrito, el estado o la provincia donde se encuentra el recurso. | cuerda / cadena |
| nombre | Nombre canónico para la ubicación geográfica o física. | cuerda Restricciones: Longitud máxima = 256 (obligatorio) |
MachineExtensionInstanceView
| Nombre | Descripción | Importancia |
|---|---|---|
| nombre | Nombre de la extensión del equipo. | cuerda / cadena |
| estado | Estado de la vista de instancia. | MachineExtensionInstanceViewStatus |
| tipo | Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension". | cuerda / cadena |
| typeHandlerVersion | Especifica la versión del controlador de script. | cuerda / cadena |
MachineExtensionInstanceViewStatus
| Nombre | Descripción | Importancia |
|---|---|---|
| código | Código de estado. | cuerda / cadena |
| displayStatus | Etiqueta localizable corta para el estado. | cuerda / cadena |
| nivel | Código de nivel. | 'Error' 'Info' 'Advertencia' |
| Mensaje | Mensaje de estado detallado, incluido para alertas y mensajes de error. | cuerda / cadena |
| Tiempo | Hora del estado. | cuerda / cadena |
MachineProperties
| Nombre | Descripción | Importancia |
|---|---|---|
| agentUpgrade | La información de la actualización del agente w.r.t de la máquina | AgentUpgrade |
| clientPublicKey | Clave pública que proporciona el cliente que se va a usar durante la incorporación inicial de recursos | cuerda / cadena |
| cloudMetadata | Metadatos del entorno de nube (Azure/GCP/AWS/OCI...). | CloudMetadata |
| Extensiones | Información de extensiones de máquina (campo en desuso) | MachineExtensionInstanceView[] |
| hardwareResourceId | Especifica el identificador de recurso del dispositivo de hardware asociado. Solo se puede establecer mediante HCI RP. | cuerda / cadena |
| identityKeyStore | Especifica el almacén de claves de identidad que usa una máquina. | 'Valor predeterminado' 'TPM' |
| licenseProfile | Especifica las propiedades relacionadas con la licencia para una máquina. | LicenseProfileMachineInstanceView |
| locationData | Metadatos relacionados con la ubicación geográfica del recurso. | LocationData |
| mssqlDiscovered | Especifica si se detecta alguna instancia de MS SQL en la máquina. | cuerda / cadena |
| osProfile | Especifica la configuración del sistema operativo para la máquina híbrida. | OSProfile de |
| osType | Tipo de sistema operativo (windows/linux). | cuerda / cadena |
| parentClusterResourceId | El identificador de recurso del clúster primario (Azure HCI) al que se asigna esta máquina, si existe. | cuerda / cadena |
| privateLinkScopeResourceId | El identificador de recurso del ámbito de vínculo privado al que está asignada esta máquina, si existe. | cuerda / cadena |
| serviceStatuses | Estados de los servicios dependientes que se notifican de nuevo a ARM. | ServiceStatuses |
| tpmEkCertificate | Certificado de clave de aprobación del módulo de plataforma segura (TPM) que proporciona el cliente para su uso durante la incorporación inicial de recursos. | cuerda / cadena |
| vmId | Especifica el identificador único de la máquina híbrida. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
Microsoft.HybridCompute/machines
| Nombre | Descripción | Importancia |
|---|---|---|
| identidad | Identidad del recurso. | Identidad |
| amable | Indica qué tipo de máquina arc coloca en el entorno local, como HCI, SCVMM o VMware, etc. | 'AVS' "AWS" 'EPS' 'GCP' 'HCI' 'SCVMM' "VMware" |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| nombre | El nombre del recurso | cuerda Restricciones: Longitud mínima = 1 Longitud máxima = 54 Patrón = ^[a-zA-Z0-9-_\.]{1,54}$ (obligatorio) |
| Propiedades | Propiedades de la máquina de proceso híbrido | MachineProperties |
| Etiquetas | Etiquetas de recursos | Diccionario de nombres y valores de etiqueta. |
| tipo | El tipo de recurso | "Microsoft.HybridCompute/machines@2025-02-19-preview" |
OSProfile
| Nombre | Descripción | Importancia |
|---|---|---|
| linuxConfiguration | Especifica la configuración de Linux para update Management. | OSProfileLinuxConfiguration |
| windowsConfiguration | Especifica la configuración de windows para update management. | OSProfileWindowsConfiguration |
OSProfileLinuxConfiguration
| Nombre | Descripción | Importancia |
|---|---|---|
| patchSettings | Especifica la configuración de revisión. | patchSettings de |
OSProfileWindowsConfiguration
| Nombre | Descripción | Importancia |
|---|---|---|
| patchSettings | Especifica la configuración de revisión. | patchSettings de |
PatchSettings
| Nombre | Descripción | Importancia |
|---|---|---|
| assessmentMode | Especifica el modo de evaluación. | 'AutomaticByPlatform' 'ImageDefault' |
| enableHotpatching | Captura la intención de inscripción de la funcionalidad hotpatch de los clientes, lo que permite a los clientes aplicar revisiones a sus máquinas Windows sin necesidad de reiniciar. | booleano |
| patchMode | Especifica el modo de revisión. | 'AutomaticByOS' 'AutomaticByPlatform' 'ImageDefault' 'Manual' |
ServiceStatus
| Nombre | Descripción | Importancia |
|---|---|---|
| startupType | El comportamiento del servicio cuando se inicia la máquina habilitada para Arc. | cuerda / cadena |
| estado | El estado actual del servicio. | cuerda / cadena |
ServiceStatuses
| Nombre | Descripción | Importancia |
|---|---|---|
| extensionService | Estado del servicio de extensión en la máquina habilitada para Arc. | ServiceStatus |
| guestConfigurationService | Estado del servicio de configuración de invitado en la máquina habilitada para Arc. | ServiceStatus |
TrackedResourceTags
| Nombre | Descripción | Importancia |
|---|
TrackedResourceTags
| Nombre | Descripción | Importancia |
|---|
VolumeLicenseDetails
| Nombre | Descripción | Importancia |
|---|---|---|
| ID de factura | Identificador de factura de la licencia por volumen. | cuerda / cadena |
| programYear | Describe el año del programa para el que está la licencia por volumen. | 'Año 1' 'Año 2' 'Año 3' |