Compartir a través de

Microsoft.DevTestLab labs/virtualmachines 2016-05-15

  • Artículo

Definición de recursos de Bicep

El tipo de recurso labs/virtualmachines se puede implementar con operaciones destinadas a:

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.DevTestLab/labs/virtualmachines, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.DevTestLab/labs/virtualmachines@2016-05-15' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    allowClaim: bool
    applicableSchedule: {
      location: 'string'
      properties: {
        labVmsShutdown: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
        labVmsStartup: {
          location: 'string'
          properties: {
            dailyRecurrence: {
              time: 'string'
            }
            hourlyRecurrence: {
              minute: int
            }
            notificationSettings: {
              status: 'string'
              timeInMinutes: int
              webhookUrl: 'string'
            }
            provisioningState: 'string'
            status: 'string'
            targetResourceId: 'string'
            taskType: 'string'
            timeZoneId: 'string'
            uniqueIdentifier: 'string'
            weeklyRecurrence: {
              time: 'string'
              weekdays: [
                'string'
              ]
            }
          }
          tags: {
            {customized property}: 'string'
          }
        }
      }
      tags: {
        {customized property}: 'string'
      }
    }
    artifactDeploymentStatus: {
      artifactsApplied: int
      deploymentStatus: 'string'
      totalArtifacts: int
    }
    artifacts: [
      {
        artifactId: 'string'
        deploymentStatusMessage: 'string'
        installTime: 'string'
        parameters: [
          {
            name: 'string'
            value: 'string'
          }
        ]
        status: 'string'
        vmExtensionStatusMessage: 'string'
      }
    ]
    computeVm: {
      dataDiskIds: [
        'string'
      ]
      dataDisks: [
        {
          diskSizeGiB: int
          diskUri: 'string'
          managedDiskId: 'string'
          name: 'string'
        }
      ]
      networkInterfaceId: 'string'
      osDiskId: 'string'
      osType: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          message: 'string'
        }
      ]
      vmSize: 'string'
    }
    createdByUser: 'string'
    createdByUserId: 'string'
    createdDate: 'string'
    customImageId: 'string'
    disallowPublicIpAddress: bool
    environmentId: 'string'
    expirationDate: 'string'
    fqdn: 'string'
    galleryImageReference: {
      offer: 'string'
      osType: 'string'
      publisher: 'string'
      sku: 'string'
      version: 'string'
    }
    isAuthenticationWithSshKey: bool
    labSubnetName: 'string'
    labVirtualNetworkId: 'string'
    networkInterface: {
      dnsName: 'string'
      privateIpAddress: 'string'
      publicIpAddress: 'string'
      publicIpAddressId: 'string'
      rdpAuthority: 'string'
      sharedPublicIpAddressConfiguration: {
        inboundNatRules: [
          {
            backendPort: int
            frontendPort: int
            transportProtocol: 'string'
          }
        ]
      }
      sshAuthority: 'string'
      subnetId: 'string'
      virtualNetworkId: 'string'
    }
    notes: 'string'
    osType: 'string'
    ownerObjectId: 'string'
    ownerUserPrincipalName: 'string'
    password: 'string'
    provisioningState: 'string'
    size: 'string'
    sshKey: 'string'
    storageType: 'string'
    uniqueIdentifier: 'string'
    userName: 'string'
    virtualMachineCreationSource: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

ApplicableSchedule

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
Propiedades Propiedades del recurso. applicableScheduleProperties (obligatorio)
Etiquetas Etiquetas del recurso. resourceTags de

ApplicableScheduleProperties

Nombre Descripción Valor
labVmsShutdown La programación de apagado automático, si se ha establecido una en el nivel de recurso de laboratorio o laboratorio. programación
labVmsStartup La programación de inicio automático, si se ha establecido una en el nivel de recurso de laboratorio o laboratorio. programación

ArtifactDeploymentStatusProperties

Nombre Descripción Valor
artifactsApplied Recuento total de los artefactos que se aplicaron correctamente. Int
deploymentStatus Estado de implementación del artefacto. cuerda
totalArtifacts Recuento total de los artefactos que se aplicaron provisionalmente. Int

ArtifactInstallProperties

Nombre Descripción Valor
artifactId Identificador del artefacto. cuerda
deploymentStatusMessage Mensaje de estado de la implementación. cuerda
installTime Hora en que el artefacto comienza a instalarse en la máquina virtual. cuerda
Parámetros Parámetros del artefacto. ArtifactParameterProperties[]
estado Estado del artefacto. cuerda
vmExtensionStatusMessage Mensaje de estado de la extensión de máquina virtual. cuerda

ArtifactParameterProperties

Nombre Descripción Valor
nombre Nombre del parámetro artifact. cuerda
valor Valor del parámetro artifact. cuerda

ComputeDataDisk

Nombre Descripción Valor
diskSizeGiB Obtiene el tamaño del disco de datos en GiB. Int
diskUri Cuando un blob está respaldado por un blob, el URI del blob subyacente. cuerda
managedDiskId Cuando el disco administrado está respaldado por el disco administrado, este es el identificador del recurso de disco de proceso. cuerda
nombre Obtiene el nombre del disco de datos. cuerda

ComputeVmInstanceViewStatus

Nombre Descripción Valor
código Obtiene el código de estado. cuerda
displayStatus Obtiene la etiqueta localizable corta para el estado. cuerda
Mensaje Obtiene el mensaje asociado al estado. cuerda

ComputeVmProperties

Nombre Descripción Valor
dataDiskIds Obtiene el URI de blob de discos de datos de la máquina virtual. string[]
dataDisks Obtiene todos los discos de datos conectados a la máquina virtual. ComputeDataDisk []
networkInterfaceId Obtiene el identificador de interfaz de red de la máquina virtual. cuerda
osDiskId Obtiene el URI del blob de disco del sistema operativo para la máquina virtual. cuerda
osType Obtiene el tipo de sistema operativo de la máquina virtual. cuerda
Estados Obtiene los estados de la máquina virtual. ComputeVmInstanceViewStatus[]
vmSize Obtiene el tamaño de la máquina virtual. cuerda

DayDetails

Nombre Descripción Valor
Hora Hora del día en que se producirá la programación. cuerda

GalleryImageReference

Nombre Descripción Valor
ofrecer Oferta de la imagen de la galería. cuerda
osType Tipo de sistema operativo de la imagen de la galería. cuerda
editor Publicador de la imagen de la galería. cuerda
Sku SKU de la imagen de la galería. cuerda
Versión Versión de la imagen de la galería. cuerda

HourDetails

Nombre Descripción Valor
minuto Minutos de la hora en que se ejecutará la programación. Int

InboundNatRule

Nombre Descripción Valor
backendPort Puerto al que se redirigirá el tráfico externo. Int
frontendPort Puerto de punto de conexión externo de la conexión entrante. Los valores posibles oscilan entre 1 y 65535, ambos incluidos. Si no se especifica, se asignará automáticamente un valor. Int
transportProtocol Protocolo de transporte para el punto de conexión. 'Tcp'
'Udp'

LabVirtualMachineProperties

Nombre Descripción Valor
allowClaim Indica si otro usuario puede tomar posesión de la máquina virtual. Bool
applicableSchedule Programación aplicable para la máquina virtual. ApplicableSchedule
artifactDeploymentStatus Estado de implementación del artefacto para la máquina virtual. ArtifactDeploymentStatusProperties
Artefactos Artefactos que se van a instalar en la máquina virtual. ArtifactInstallProperties[]
computeVm Propiedades de la máquina virtual de proceso. ComputeVmProperties
createdByUser Dirección de correo electrónico del creador de la máquina virtual. cuerda
createdByUserId Identificador de objeto del creador de la máquina virtual. cuerda
createdDate Fecha de creación de la máquina virtual. cuerda
customImageId Identificador de imagen personalizado de la máquina virtual. cuerda
disallowPublicIpAddress Indica si la máquina virtual se va a crear sin una dirección IP pública. Bool
environmentId Identificador de recurso del entorno que contiene esta máquina virtual, si existe. cuerda
expirationDate Fecha de expiración de la máquina virtual. cuerda
Fqdn Nombre de dominio completo de la máquina virtual. cuerda
galleryImageReference Referencia de imagen de Microsoft Azure Marketplace de la máquina virtual. GalleryImageReference
isAuthenticationWithSshKey Indica si esta máquina virtual usa una clave SSH para la autenticación. Bool
labSubnetName Nombre de subred del laboratorio de la máquina virtual. cuerda
labVirtualNetworkId Identificador de red virtual del laboratorio de la máquina virtual. cuerda
networkInterface Propiedades de la interfaz de red. NetworkInterfaceProperties
Notas Notas de la máquina virtual. cuerda
osType El tipo de sistema operativo de la máquina virtual. cuerda
ownerObjectId Identificador de objeto del propietario de la máquina virtual. cuerda
ownerUserPrincipalName Nombre principal de usuario del propietario de la máquina virtual. cuerda
contraseña Contraseña del administrador de la máquina virtual. cuerda
provisioningState Estado de aprovisionamiento del recurso. cuerda
tamaño Tamaño de la máquina virtual. cuerda
sshKey Clave SSH del administrador de la máquina virtual. cuerda
storageType Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium). cuerda
uniqueIdentifier Identificador inmutable único de un recurso (Guid). cuerda
nombre de usuario Nombre de usuario de la máquina virtual. cuerda
virtualMachineCreationSource Indica el origen de la creación de una máquina virtual de laboratorio. Solo propiedad de salida. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
nombre El nombre del recurso string (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: laboratorios
Propiedades Propiedades del recurso. LabVirtualMachineProperties (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

NetworkInterfaceProperties

Nombre Descripción Valor
dnsName Nombre DNS. cuerda
privateIpAddress Dirección IP privada. cuerda
publicIpAddress Dirección IP pública. cuerda
publicIpAddressId Identificador de recurso de la dirección IP pública. cuerda
rdpAuthority La propiedad RdpAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para RDP (Protocolo de escritorio remoto). cuerda
sharedPublicIpAddressConfiguration Configuración para compartir una dirección IP pública en varias máquinas virtuales. sharedPublicIpAddressConfiguration
sshAuthority La propiedad SshAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para SSH. cuerda
subnetId Identificador de recurso de la subred. cuerda
virtualNetworkId Identificador de recurso de la red virtual. cuerda

NotificationSettings

Nombre Descripción Valor
estado Si las notificaciones están habilitadas para esta programación (es decir, Habilitada, Deshabilitada). 'Deshabilitado'
'Habilitado'
timeInMinutes Tiempo en minutos antes del evento en el que se enviará la notificación. Int
webhookUrl Dirección URL del webhook a la que se enviará la notificación. cuerda

ResourceTags

Nombre Descripción Valor

ResourceTags

Nombre Descripción Valor

ResourceTags

Nombre Descripción Valor

Horario

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
Propiedades Propiedades del recurso. ScheduleProperties (obligatorio)
Etiquetas Etiquetas del recurso. resourceTags de

ScheduleProperties

Nombre Descripción Valor
dailyRecurrence Si la programación se producirá una vez cada día de la semana, especifique la periodicidad diaria. DayDetails
hourlyRecurrence Si la programación se producirá varias veces al día, especifique la periodicidad por hora. hourDetails
notificationSettings Configuración de notificaciones. notificationSettings
provisioningState Estado de aprovisionamiento del recurso. cuerda
estado Estado de la programación (es decir, Habilitado, Deshabilitado) 'Deshabilitado'
'Habilitado'
targetResourceId Identificador de recurso al que pertenece la programación cuerda
taskType El tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart). cuerda
timeZoneId Identificador de zona horaria (por ejemplo, hora estándar del Pacífico). cuerda
uniqueIdentifier Identificador inmutable único de un recurso (Guid). cuerda
weeklyRecurrence Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal. WeekDetails

SharedPublicIpAddressConfiguration

Nombre Descripción Valor
inboundNatRules Reglas NAT entrantes inboundNatRule []

WeekDetails

Nombre Descripción Valor
Hora Hora del día en que se producirá la programación. cuerda
días entre semana Los días de la semana para los que se establece la programación (por ejemplo, domingo, lunes, martes, etc.). string[]

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada Esta plantilla crea una nueva instancia de DevTest Lab /DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de plantilla de ARM

El tipo de recurso labs/virtualmachines se puede implementar con operaciones destinadas a:

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.DevTestLab/labs/virtualmachines, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.DevTestLab/labs/virtualmachines",
  "apiVersion": "2016-05-15",
  "name": "string",
  "location": "string",
  "properties": {
    "allowClaim": "bool",
    "applicableSchedule": {
      "location": "string",
      "properties": {
        "labVmsShutdown": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        },
        "labVmsStartup": {
          "location": "string",
          "properties": {
            "dailyRecurrence": {
              "time": "string"
            },
            "hourlyRecurrence": {
              "minute": "int"
            },
            "notificationSettings": {
              "status": "string",
              "timeInMinutes": "int",
              "webhookUrl": "string"
            },
            "provisioningState": "string",
            "status": "string",
            "targetResourceId": "string",
            "taskType": "string",
            "timeZoneId": "string",
            "uniqueIdentifier": "string",
            "weeklyRecurrence": {
              "time": "string",
              "weekdays": [ "string" ]
            }
          },
          "tags": {
            "{customized property}": "string"
          }
        }
      },
      "tags": {
        "{customized property}": "string"
      }
    },
    "artifactDeploymentStatus": {
      "artifactsApplied": "int",
      "deploymentStatus": "string",
      "totalArtifacts": "int"
    },
    "artifacts": [
      {
        "artifactId": "string",
        "deploymentStatusMessage": "string",
        "installTime": "string",
        "parameters": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "status": "string",
        "vmExtensionStatusMessage": "string"
      }
    ],
    "computeVm": {
      "dataDiskIds": [ "string" ],
      "dataDisks": [
        {
          "diskSizeGiB": "int",
          "diskUri": "string",
          "managedDiskId": "string",
          "name": "string"
        }
      ],
      "networkInterfaceId": "string",
      "osDiskId": "string",
      "osType": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "message": "string"
        }
      ],
      "vmSize": "string"
    },
    "createdByUser": "string",
    "createdByUserId": "string",
    "createdDate": "string",
    "customImageId": "string",
    "disallowPublicIpAddress": "bool",
    "environmentId": "string",
    "expirationDate": "string",
    "fqdn": "string",
    "galleryImageReference": {
      "offer": "string",
      "osType": "string",
      "publisher": "string",
      "sku": "string",
      "version": "string"
    },
    "isAuthenticationWithSshKey": "bool",
    "labSubnetName": "string",
    "labVirtualNetworkId": "string",
    "networkInterface": {
      "dnsName": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string",
      "publicIpAddressId": "string",
      "rdpAuthority": "string",
      "sharedPublicIpAddressConfiguration": {
        "inboundNatRules": [
          {
            "backendPort": "int",
            "frontendPort": "int",
            "transportProtocol": "string"
          }
        ]
      },
      "sshAuthority": "string",
      "subnetId": "string",
      "virtualNetworkId": "string"
    },
    "notes": "string",
    "osType": "string",
    "ownerObjectId": "string",
    "ownerUserPrincipalName": "string",
    "password": "string",
    "provisioningState": "string",
    "size": "string",
    "sshKey": "string",
    "storageType": "string",
    "uniqueIdentifier": "string",
    "userName": "string",
    "virtualMachineCreationSource": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

ApplicableSchedule

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
Propiedades Propiedades del recurso. applicableScheduleProperties (obligatorio)
Etiquetas Etiquetas del recurso. resourceTags de

ApplicableScheduleProperties

Nombre Descripción Valor
labVmsShutdown La programación de apagado automático, si se ha establecido una en el nivel de recurso de laboratorio o laboratorio. programación
labVmsStartup La programación de inicio automático, si se ha establecido una en el nivel de recurso de laboratorio o laboratorio. programación

ArtifactDeploymentStatusProperties

Nombre Descripción Valor
artifactsApplied Recuento total de los artefactos que se aplicaron correctamente. Int
deploymentStatus Estado de implementación del artefacto. cuerda
totalArtifacts Recuento total de los artefactos que se aplicaron provisionalmente. Int

ArtifactInstallProperties

Nombre Descripción Valor
artifactId Identificador del artefacto. cuerda
deploymentStatusMessage Mensaje de estado de la implementación. cuerda
installTime Hora en que el artefacto comienza a instalarse en la máquina virtual. cuerda
Parámetros Parámetros del artefacto. ArtifactParameterProperties[]
estado Estado del artefacto. cuerda
vmExtensionStatusMessage Mensaje de estado de la extensión de máquina virtual. cuerda

ArtifactParameterProperties

Nombre Descripción Valor
nombre Nombre del parámetro artifact. cuerda
valor Valor del parámetro artifact. cuerda

ComputeDataDisk

Nombre Descripción Valor
diskSizeGiB Obtiene el tamaño del disco de datos en GiB. Int
diskUri Cuando un blob está respaldado por un blob, el URI del blob subyacente. cuerda
managedDiskId Cuando el disco administrado está respaldado por el disco administrado, este es el identificador del recurso de disco de proceso. cuerda
nombre Obtiene el nombre del disco de datos. cuerda

ComputeVmInstanceViewStatus

Nombre Descripción Valor
código Obtiene el código de estado. cuerda
displayStatus Obtiene la etiqueta localizable corta para el estado. cuerda
Mensaje Obtiene el mensaje asociado al estado. cuerda

ComputeVmProperties

Nombre Descripción Valor
dataDiskIds Obtiene el URI de blob de discos de datos de la máquina virtual. string[]
dataDisks Obtiene todos los discos de datos conectados a la máquina virtual. ComputeDataDisk []
networkInterfaceId Obtiene el identificador de interfaz de red de la máquina virtual. cuerda
osDiskId Obtiene el URI del blob de disco del sistema operativo para la máquina virtual. cuerda
osType Obtiene el tipo de sistema operativo de la máquina virtual. cuerda
Estados Obtiene los estados de la máquina virtual. ComputeVmInstanceViewStatus[]
vmSize Obtiene el tamaño de la máquina virtual. cuerda

DayDetails

Nombre Descripción Valor
Hora Hora del día en que se producirá la programación. cuerda

GalleryImageReference

Nombre Descripción Valor
ofrecer Oferta de la imagen de la galería. cuerda
osType Tipo de sistema operativo de la imagen de la galería. cuerda
editor Publicador de la imagen de la galería. cuerda
Sku SKU de la imagen de la galería. cuerda
Versión Versión de la imagen de la galería. cuerda

HourDetails

Nombre Descripción Valor
minuto Minutos de la hora en que se ejecutará la programación. Int

InboundNatRule

Nombre Descripción Valor
backendPort Puerto al que se redirigirá el tráfico externo. Int
frontendPort Puerto de punto de conexión externo de la conexión entrante. Los valores posibles oscilan entre 1 y 65535, ambos incluidos. Si no se especifica, se asignará automáticamente un valor. Int
transportProtocol Protocolo de transporte para el punto de conexión. 'Tcp'
'Udp'

LabVirtualMachineProperties

Nombre Descripción Valor
allowClaim Indica si otro usuario puede tomar posesión de la máquina virtual. Bool
applicableSchedule Programación aplicable para la máquina virtual. ApplicableSchedule
artifactDeploymentStatus Estado de implementación del artefacto para la máquina virtual. ArtifactDeploymentStatusProperties
Artefactos Artefactos que se van a instalar en la máquina virtual. ArtifactInstallProperties[]
computeVm Propiedades de la máquina virtual de proceso. ComputeVmProperties
createdByUser Dirección de correo electrónico del creador de la máquina virtual. cuerda
createdByUserId Identificador de objeto del creador de la máquina virtual. cuerda
createdDate Fecha de creación de la máquina virtual. cuerda
customImageId Identificador de imagen personalizado de la máquina virtual. cuerda
disallowPublicIpAddress Indica si la máquina virtual se va a crear sin una dirección IP pública. Bool
environmentId Identificador de recurso del entorno que contiene esta máquina virtual, si existe. cuerda
expirationDate Fecha de expiración de la máquina virtual. cuerda
Fqdn Nombre de dominio completo de la máquina virtual. cuerda
galleryImageReference Referencia de imagen de Microsoft Azure Marketplace de la máquina virtual. GalleryImageReference
isAuthenticationWithSshKey Indica si esta máquina virtual usa una clave SSH para la autenticación. Bool
labSubnetName Nombre de subred del laboratorio de la máquina virtual. cuerda
labVirtualNetworkId Identificador de red virtual del laboratorio de la máquina virtual. cuerda
networkInterface Propiedades de la interfaz de red. NetworkInterfaceProperties
Notas Notas de la máquina virtual. cuerda
osType El tipo de sistema operativo de la máquina virtual. cuerda
ownerObjectId Identificador de objeto del propietario de la máquina virtual. cuerda
ownerUserPrincipalName Nombre principal de usuario del propietario de la máquina virtual. cuerda
contraseña Contraseña del administrador de la máquina virtual. cuerda
provisioningState Estado de aprovisionamiento del recurso. cuerda
tamaño Tamaño de la máquina virtual. cuerda
sshKey Clave SSH del administrador de la máquina virtual. cuerda
storageType Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium). cuerda
uniqueIdentifier Identificador inmutable único de un recurso (Guid). cuerda
nombre de usuario Nombre de usuario de la máquina virtual. cuerda
virtualMachineCreationSource Indica el origen de la creación de una máquina virtual de laboratorio. Solo propiedad de salida. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nombre Descripción Valor
apiVersion La versión de api '2016-05-15'
ubicación Ubicación del recurso. cuerda
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades del recurso. LabVirtualMachineProperties (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso 'Microsoft.DevTestLab/labs/virtualmachines'

NetworkInterfaceProperties

Nombre Descripción Valor
dnsName Nombre DNS. cuerda
privateIpAddress Dirección IP privada. cuerda
publicIpAddress Dirección IP pública. cuerda
publicIpAddressId Identificador de recurso de la dirección IP pública. cuerda
rdpAuthority La propiedad RdpAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para RDP (Protocolo de escritorio remoto). cuerda
sharedPublicIpAddressConfiguration Configuración para compartir una dirección IP pública en varias máquinas virtuales. sharedPublicIpAddressConfiguration
sshAuthority La propiedad SshAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para SSH. cuerda
subnetId Identificador de recurso de la subred. cuerda
virtualNetworkId Identificador de recurso de la red virtual. cuerda

NotificationSettings

Nombre Descripción Valor
estado Si las notificaciones están habilitadas para esta programación (es decir, Habilitada, Deshabilitada). 'Deshabilitado'
'Habilitado'
timeInMinutes Tiempo en minutos antes del evento en el que se enviará la notificación. Int
webhookUrl Dirección URL del webhook a la que se enviará la notificación. cuerda

ResourceTags

Nombre Descripción Valor

ResourceTags

Nombre Descripción Valor

ResourceTags

Nombre Descripción Valor

Horario

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
Propiedades Propiedades del recurso. ScheduleProperties (obligatorio)
Etiquetas Etiquetas del recurso. resourceTags de

ScheduleProperties

Nombre Descripción Valor
dailyRecurrence Si la programación se producirá una vez cada día de la semana, especifique la periodicidad diaria. DayDetails
hourlyRecurrence Si la programación se producirá varias veces al día, especifique la periodicidad por hora. hourDetails
notificationSettings Configuración de notificaciones. notificationSettings
provisioningState Estado de aprovisionamiento del recurso. cuerda
estado Estado de la programación (es decir, Habilitado, Deshabilitado) 'Deshabilitado'
'Habilitado'
targetResourceId Identificador de recurso al que pertenece la programación cuerda
taskType El tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart). cuerda
timeZoneId Identificador de zona horaria (por ejemplo, hora estándar del Pacífico). cuerda
uniqueIdentifier Identificador inmutable único de un recurso (Guid). cuerda
weeklyRecurrence Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal. WeekDetails

SharedPublicIpAddressConfiguration

Nombre Descripción Valor
inboundNatRules Reglas NAT entrantes inboundNatRule []

WeekDetails

Nombre Descripción Valor
Hora Hora del día en que se producirá la programación. cuerda
días entre semana Los días de la semana para los que se establece la programación (por ejemplo, domingo, lunes, martes, etc.). string[]

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crea un laboratorio en Azure DevTest Labs con una máquina virtual reclamada

Implementación en Azure 		Esta plantilla crea una nueva instancia de DevTest Lab /DTL con una máquina virtual de Windows Server 2019 Datacenter reclamada en ella. Más plantillas de inicio rápido de Azure Resource Manager para Azure DevTest Labs disponibles en https://github.com/Azure/azure-devtestlab/tree/master/ARMTemplates

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso labs/virtualmachines se puede implementar con operaciones destinadas a:

  • 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.DevTestLab/labs/virtualmachines, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allowClaim = bool
      applicableSchedule = {
        location = "string"
        properties = {
          labVmsShutdown = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
          labVmsStartup = {
            location = "string"
            properties = {
              dailyRecurrence = {
                time = "string"
              }
              hourlyRecurrence = {
                minute = int
              }
              notificationSettings = {
                status = "string"
                timeInMinutes = int
                webhookUrl = "string"
              }
              provisioningState = "string"
              status = "string"
              targetResourceId = "string"
              taskType = "string"
              timeZoneId = "string"
              uniqueIdentifier = "string"
              weeklyRecurrence = {
                time = "string"
                weekdays = [
                  "string"
                ]
              }
            }
            tags = {
              {customized property} = "string"
            }
          }
        }
        tags = {
          {customized property} = "string"
        }
      }
      artifactDeploymentStatus = {
        artifactsApplied = int
        deploymentStatus = "string"
        totalArtifacts = int
      }
      artifacts = [
        {
          artifactId = "string"
          deploymentStatusMessage = "string"
          installTime = "string"
          parameters = [
            {
              name = "string"
              value = "string"
            }
          ]
          status = "string"
          vmExtensionStatusMessage = "string"
        }
      ]
      computeVm = {
        dataDiskIds = [
          "string"
        ]
        dataDisks = [
          {
            diskSizeGiB = int
            diskUri = "string"
            managedDiskId = "string"
            name = "string"
          }
        ]
        networkInterfaceId = "string"
        osDiskId = "string"
        osType = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            message = "string"
          }
        ]
        vmSize = "string"
      }
      createdByUser = "string"
      createdByUserId = "string"
      createdDate = "string"
      customImageId = "string"
      disallowPublicIpAddress = bool
      environmentId = "string"
      expirationDate = "string"
      fqdn = "string"
      galleryImageReference = {
        offer = "string"
        osType = "string"
        publisher = "string"
        sku = "string"
        version = "string"
      }
      isAuthenticationWithSshKey = bool
      labSubnetName = "string"
      labVirtualNetworkId = "string"
      networkInterface = {
        dnsName = "string"
        privateIpAddress = "string"
        publicIpAddress = "string"
        publicIpAddressId = "string"
        rdpAuthority = "string"
        sharedPublicIpAddressConfiguration = {
          inboundNatRules = [
            {
              backendPort = int
              frontendPort = int
              transportProtocol = "string"
            }
          ]
        }
        sshAuthority = "string"
        subnetId = "string"
        virtualNetworkId = "string"
      }
      notes = "string"
      osType = "string"
      ownerObjectId = "string"
      ownerUserPrincipalName = "string"
      password = "string"
      provisioningState = "string"
      size = "string"
      sshKey = "string"
      storageType = "string"
      uniqueIdentifier = "string"
      userName = "string"
      virtualMachineCreationSource = "string"
    }
  })
}

Valores de propiedad

ApplicableSchedule

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
Propiedades Propiedades del recurso. applicableScheduleProperties (obligatorio)
Etiquetas Etiquetas del recurso. resourceTags de

ApplicableScheduleProperties

Nombre Descripción Valor
labVmsShutdown La programación de apagado automático, si se ha establecido una en el nivel de recurso de laboratorio o laboratorio. programación
labVmsStartup La programación de inicio automático, si se ha establecido una en el nivel de recurso de laboratorio o laboratorio. programación

ArtifactDeploymentStatusProperties

Nombre Descripción Valor
artifactsApplied Recuento total de los artefactos que se aplicaron correctamente. Int
deploymentStatus Estado de implementación del artefacto. cuerda
totalArtifacts Recuento total de los artefactos que se aplicaron provisionalmente. Int

ArtifactInstallProperties

Nombre Descripción Valor
artifactId Identificador del artefacto. cuerda
deploymentStatusMessage Mensaje de estado de la implementación. cuerda
installTime Hora en que el artefacto comienza a instalarse en la máquina virtual. cuerda
Parámetros Parámetros del artefacto. ArtifactParameterProperties[]
estado Estado del artefacto. cuerda
vmExtensionStatusMessage Mensaje de estado de la extensión de máquina virtual. cuerda

ArtifactParameterProperties

Nombre Descripción Valor
nombre Nombre del parámetro artifact. cuerda
valor Valor del parámetro artifact. cuerda

ComputeDataDisk

Nombre Descripción Valor
diskSizeGiB Obtiene el tamaño del disco de datos en GiB. Int
diskUri Cuando un blob está respaldado por un blob, el URI del blob subyacente. cuerda
managedDiskId Cuando el disco administrado está respaldado por el disco administrado, este es el identificador del recurso de disco de proceso. cuerda
nombre Obtiene el nombre del disco de datos. cuerda

ComputeVmInstanceViewStatus

Nombre Descripción Valor
código Obtiene el código de estado. cuerda
displayStatus Obtiene la etiqueta localizable corta para el estado. cuerda
Mensaje Obtiene el mensaje asociado al estado. cuerda

ComputeVmProperties

Nombre Descripción Valor
dataDiskIds Obtiene el URI de blob de discos de datos de la máquina virtual. string[]
dataDisks Obtiene todos los discos de datos conectados a la máquina virtual. ComputeDataDisk []
networkInterfaceId Obtiene el identificador de interfaz de red de la máquina virtual. cuerda
osDiskId Obtiene el URI del blob de disco del sistema operativo para la máquina virtual. cuerda
osType Obtiene el tipo de sistema operativo de la máquina virtual. cuerda
Estados Obtiene los estados de la máquina virtual. ComputeVmInstanceViewStatus[]
vmSize Obtiene el tamaño de la máquina virtual. cuerda

DayDetails

Nombre Descripción Valor
Hora Hora del día en que se producirá la programación. cuerda

GalleryImageReference

Nombre Descripción Valor
ofrecer Oferta de la imagen de la galería. cuerda
osType Tipo de sistema operativo de la imagen de la galería. cuerda
editor Publicador de la imagen de la galería. cuerda
Sku SKU de la imagen de la galería. cuerda
Versión Versión de la imagen de la galería. cuerda

HourDetails

Nombre Descripción Valor
minuto Minutos de la hora en que se ejecutará la programación. Int

InboundNatRule

Nombre Descripción Valor
backendPort Puerto al que se redirigirá el tráfico externo. Int
frontendPort Puerto de punto de conexión externo de la conexión entrante. Los valores posibles oscilan entre 1 y 65535, ambos incluidos. Si no se especifica, se asignará automáticamente un valor. Int
transportProtocol Protocolo de transporte para el punto de conexión. 'Tcp'
'Udp'

LabVirtualMachineProperties

Nombre Descripción Valor
allowClaim Indica si otro usuario puede tomar posesión de la máquina virtual. Bool
applicableSchedule Programación aplicable para la máquina virtual. ApplicableSchedule
artifactDeploymentStatus Estado de implementación del artefacto para la máquina virtual. ArtifactDeploymentStatusProperties
Artefactos Artefactos que se van a instalar en la máquina virtual. ArtifactInstallProperties[]
computeVm Propiedades de la máquina virtual de proceso. ComputeVmProperties
createdByUser Dirección de correo electrónico del creador de la máquina virtual. cuerda
createdByUserId Identificador de objeto del creador de la máquina virtual. cuerda
createdDate Fecha de creación de la máquina virtual. cuerda
customImageId Identificador de imagen personalizado de la máquina virtual. cuerda
disallowPublicIpAddress Indica si la máquina virtual se va a crear sin una dirección IP pública. Bool
environmentId Identificador de recurso del entorno que contiene esta máquina virtual, si existe. cuerda
expirationDate Fecha de expiración de la máquina virtual. cuerda
Fqdn Nombre de dominio completo de la máquina virtual. cuerda
galleryImageReference Referencia de imagen de Microsoft Azure Marketplace de la máquina virtual. GalleryImageReference
isAuthenticationWithSshKey Indica si esta máquina virtual usa una clave SSH para la autenticación. Bool
labSubnetName Nombre de subred del laboratorio de la máquina virtual. cuerda
labVirtualNetworkId Identificador de red virtual del laboratorio de la máquina virtual. cuerda
networkInterface Propiedades de la interfaz de red. NetworkInterfaceProperties
Notas Notas de la máquina virtual. cuerda
osType El tipo de sistema operativo de la máquina virtual. cuerda
ownerObjectId Identificador de objeto del propietario de la máquina virtual. cuerda
ownerUserPrincipalName Nombre principal de usuario del propietario de la máquina virtual. cuerda
contraseña Contraseña del administrador de la máquina virtual. cuerda
provisioningState Estado de aprovisionamiento del recurso. cuerda
tamaño Tamaño de la máquina virtual. cuerda
sshKey Clave SSH del administrador de la máquina virtual. cuerda
storageType Tipo de almacenamiento que se va a usar para la máquina virtual (es decir, Estándar, Premium). cuerda
uniqueIdentifier Identificador inmutable único de un recurso (Guid). cuerda
nombre de usuario Nombre de usuario de la máquina virtual. cuerda
virtualMachineCreationSource Indica el origen de la creación de una máquina virtual de laboratorio. Solo propiedad de salida. 'FromCustomImage'
'FromGalleryImage'

Microsoft.DevTestLab/labs/virtualmachines

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: laboratorios
Propiedades Propiedades del recurso. LabVirtualMachineProperties (obligatorio)
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.DevTestLab/labs/virtualmachines@2016-05-15"

NetworkInterfaceProperties

Nombre Descripción Valor
dnsName Nombre DNS. cuerda
privateIpAddress Dirección IP privada. cuerda
publicIpAddress Dirección IP pública. cuerda
publicIpAddressId Identificador de recurso de la dirección IP pública. cuerda
rdpAuthority La propiedad RdpAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para RDP (Protocolo de escritorio remoto). cuerda
sharedPublicIpAddressConfiguration Configuración para compartir una dirección IP pública en varias máquinas virtuales. sharedPublicIpAddressConfiguration
sshAuthority La propiedad SshAuthority es un nombre de host DNS del servidor o una dirección IP seguido del número de puerto de servicio para SSH. cuerda
subnetId Identificador de recurso de la subred. cuerda
virtualNetworkId Identificador de recurso de la red virtual. cuerda

NotificationSettings

Nombre Descripción Valor
estado Si las notificaciones están habilitadas para esta programación (es decir, Habilitada, Deshabilitada). 'Deshabilitado'
'Habilitado'
timeInMinutes Tiempo en minutos antes del evento en el que se enviará la notificación. Int
webhookUrl Dirección URL del webhook a la que se enviará la notificación. cuerda

ResourceTags

Nombre Descripción Valor

ResourceTags

Nombre Descripción Valor

ResourceTags

Nombre Descripción Valor

Horario

Nombre Descripción Valor
ubicación Ubicación del recurso. cuerda
Propiedades Propiedades del recurso. ScheduleProperties (obligatorio)
Etiquetas Etiquetas del recurso. resourceTags de

ScheduleProperties

Nombre Descripción Valor
dailyRecurrence Si la programación se producirá una vez cada día de la semana, especifique la periodicidad diaria. DayDetails
hourlyRecurrence Si la programación se producirá varias veces al día, especifique la periodicidad por hora. hourDetails
notificationSettings Configuración de notificaciones. notificationSettings
provisioningState Estado de aprovisionamiento del recurso. cuerda
estado Estado de la programación (es decir, Habilitado, Deshabilitado) 'Deshabilitado'
'Habilitado'
targetResourceId Identificador de recurso al que pertenece la programación cuerda
taskType El tipo de tarea de la programación (por ejemplo, LabVmsShutdownTask, LabVmAutoStart). cuerda
timeZoneId Identificador de zona horaria (por ejemplo, hora estándar del Pacífico). cuerda
uniqueIdentifier Identificador inmutable único de un recurso (Guid). cuerda
weeklyRecurrence Si la programación solo se producirá algunos días de la semana, especifique la periodicidad semanal. WeekDetails

SharedPublicIpAddressConfiguration

Nombre Descripción Valor
inboundNatRules Reglas NAT entrantes inboundNatRule []

WeekDetails

Nombre Descripción Valor
Hora Hora del día en que se producirá la programación. cuerda
días entre semana Los días de la semana para los que se establece la programación (por ejemplo, domingo, lunes, martes, etc.). string[]