Account - List Supported Images

Referencia

Servicio:: Batch Service

Versión de la API:: 2024-07-01.20.0

Enumera todas las imágenes de máquina virtual compatibles con el servicio Azure Batch.

GET {batchUrl}/supportedimages?api-version=2024-07-01.20.0

Con parámetros opcionales:

GET {batchUrl}/supportedimages?$filter={$filter}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
batchUrl	path	True	string	Dirección URL base de todas las solicitudes de servicio de Azure Batch.
api-version	query	True	string	Versión de la API de cliente.
$filter	query		string	Una cláusula $filter de OData. Para obtener más información sobre cómo construir este filtro, vea https://docs.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-support-images.
maxresults	query		integer int32	Número máximo de elementos que se van a devolver en la respuesta. Se devolverá un máximo de 1000 resultados.
timeout	query		integer int32	Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos. Si el valor es mayor que 30, se usará el valor predeterminado en su lugar.

Encabezado de la solicitud

Media Types: "application/json; odata=minimalmetadata"

Nombre	Tipo	Description
client-request-id	string uuid	La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Si el servidor debe devolver el client-request-id en la respuesta.
ocp-date	string date-time-rfc1123	Hora en que se emitió la solicitud. Las bibliotecas cliente suelen establecer esto en la hora del reloj del sistema actual; establézcalo explícitamente si llama directamente a la API REST.

Respuestas

Nombre	Tipo	Description
200 OK	AccountListSupportedImagesResult	Respuesta que contiene la lista de imágenes de máquina virtual admitidas. Encabezados client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Error del servicio Batch.

Nombre

Tipo

Description

200 OK

AccountListSupportedImagesResult

Respuesta que contiene la lista de imágenes de máquina virtual admitidas.

Encabezados

client-request-id: string
request-id: string
ETag: string
Last-Modified: string

Other Status Codes

BatchError

Error del servicio Batch.

Seguridad

azure_auth

Flujo de código de autenticación de Microsoft Entra OAuth 2.0

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

Ámbitos

Nombre	Description
user_impersonation	Suplantar la cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

Account list node agent skus

Solicitud de ejemplo

HTTP

GET account.region.batch.azure.com/supportedimages?api-version=2024-07-01.20.0

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "nodeAgentSKUId": "batch.node.centos 7",
      "imageReference": {
        "publisher": "OpenLogic",
        "offer": "CentOS",
        "sku": "7.2",
        "version": "latest"
      },
      "verificationType": "verified",
      "capabilities": [
        "DockerCompatible",
        "NvidiaTeslaDriverInstalled"
      ],
      "osType": "linux"
    },
    {
      "nodeAgentSKUId": "batch.node.centos 7",
      "imageReference": {
        "publisher": "OpenLogic",
        "offer": "CentOS",
        "sku": "7.1",
        "version": "latest"
      },
      "verificationType": "unverified",
      "osType": "linux",
      "batchSupportEndOfLife": "2019-11-01T00:00:00.0Z"
    },
    {
      "nodeAgentSKUId": "batch.node.debian 8",
      "imageReference": {
        "publisher": "Credativ",
        "offer": "Debian",
        "sku": "8",
        "version": "latest"
      },
      "verificationType": "verified",
      "osType": "linux"
    },
    {
      "nodeAgentSKUId": "batch.node.windows amd64",
      "imageReference": {
        "publisher": "MicrosoftWindowsServer",
        "offer": "WindowsServer",
        "sku": "2012-R2-Datacenter",
        "version": "latest"
      },
      "verificationType": "verified",
      "osType": "windows"
    },
    {
      "nodeAgentSKUId": "batch.node.windows amd64",
      "imageReference": {
        "publisher": "MicrosoftWindowsServer",
        "offer": "WindowsServer",
        "sku": "2012-Datacenter",
        "version": "latest"
      },
      "verificationType": "verified",
      "osType": "windows"
    }
  ]
}

Definiciones

Nombre	Description
AccountListSupportedImagesResult	Resultado de enumerar las imágenes de máquina virtual admitidas.
BatchError	Respuesta de error recibida del servicio Azure Batch.
BatchErrorDetail	Un elemento de información adicional incluida en una respuesta de error de Azure Batch.
ErrorMessage	Mensaje de error recibido en una respuesta de error de Azure Batch.
ImageInformation	Referencia a la imagen de Marketplace de Azure Virtual Machines e información adicional sobre la imagen.
ImageReference	Referencia a una imagen de Marketplace de Azure Virtual Machines o a una imagen de Azure Compute Gallery. Para obtener la lista de todas las referencias de imágenes de Azure Marketplace verificadas por Azure Batch, consulte la operación "Enumerar imágenes admitidas".
OSType	Tipo de sistema operativo (por ejemplo, Windows o Linux) de la imagen.
VerificationType	Si el servicio Azure Batch comprueba activamente que la imagen es compatible con la SKU del agente de nodo de proceso asociada.

AccountListSupportedImagesResult

Resultado de enumerar las imágenes de máquina virtual admitidas.

Nombre	Tipo	Description
odata.nextLink	string	Dirección URL para obtener el siguiente conjunto de resultados.
value	ImageInformation[]	Lista de imágenes de máquina virtual admitidas.

BatchError

Respuesta de error recibida del servicio Azure Batch.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	ErrorMessage	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
values	BatchErrorDetail[]	Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Un elemento de información adicional incluida en una respuesta de error de Azure Batch.

Nombre	Tipo	Description
key	string	Identificador que especifica el significado de la propiedad Value.
value	string	La información adicional incluida con la respuesta de error.

ErrorMessage

Mensaje de error recibido en una respuesta de error de Azure Batch.

Nombre	Tipo	Description
lang	string	El código de idioma del mensaje de error
value	string	Texto del mensaje.

ImageInformation

Referencia a la imagen de Marketplace de Azure Virtual Machines e información adicional sobre la imagen.

Nombre	Tipo	Description
batchSupportEndOfLife	string	La hora en que el servicio Azure Batch dejará de aceptar solicitudes de creación de grupos para la imagen.
capabilities	string[]	Las funcionalidades o características que admite la imagen. No se muestra ninguna funcionalidad de la imagen. Las funcionalidades de esta lista se consideran de interés especial y generalmente están relacionadas con la integración con otras características del servicio Azure Batch.
imageReference	ImageReference	Referencia a la imagen de Marketplace de la máquina virtual de Azure.
nodeAgentSKUId	string	Identificador de la SKU del agente de nodo de proceso que admite la imagen.
osType	OSType	Tipo de sistema operativo (por ejemplo, Windows o Linux) de la imagen.
verificationType	VerificationType	Si el servicio Azure Batch comprueba activamente que la imagen es compatible con la SKU del agente de nodo de proceso asociada.

ImageReference

Referencia a una imagen de Marketplace de Azure Virtual Machines o a una imagen de Azure Compute Gallery. Para obtener la lista de todas las referencias de imágenes de Azure Marketplace verificadas por Azure Batch, consulte la operación "Enumerar imágenes admitidas".

Nombre	Tipo	Description
communityGalleryImageId	string	Identificador único de la imagen de la galería de la comunidad Esta propiedad es mutuamente excluyente con otras propiedades y se puede capturar desde la llamada GET de imagen de la galería de la comunidad.
exactVersion	string	La versión específica de la imagen de plataforma o la imagen de Marketplace usada para crear el nodo. Este campo de solo lectura difiere de "version" solo si el valor especificado para "version" cuando se creó el grupo era "latest".
offer	string	Tipo de oferta de la imagen de Marketplace de Azure Virtual Machines. Por ejemplo, UbuntuServer o WindowsServer.
publisher	string	Publicador de la imagen de Marketplace de Azure Virtual Machines. Por ejemplo, Canonical o MicrosoftWindowsServer.
sharedGalleryImageId	string	Identificador único de la imagen de la galería compartida Esta propiedad es mutuamente excluyente con otras propiedades y se puede capturar desde la llamada GET de imagen de galería compartida.
sku	string	SKU de la imagen de Marketplace de Azure Virtual Machines. Por ejemplo, 18.04-LTS o 2019-Datacenter.
version	string	Versión de la imagen de Marketplace de Azure Virtual Machines. Se puede especificar un valor de "latest" para seleccionar la versión más reciente de una imagen. Si se omite, el valor predeterminado es "latest".
virtualMachineImageId	string	Identificador de recursos de ARM de la imagen de Azure Compute Gallery. Los nodos de proceso del grupo se crearán con este identificador de imagen. Se trata del formulario /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} para la versión de imagen más reciente. Esta propiedad es mutuamente excluyente con otras propiedades ImageReference. La imagen de Azure Compute Gallery debe tener réplicas en la misma región y debe estar en la misma suscripción que la cuenta de Azure Batch. Si no se especifica la versión de la imagen en imageId, se usará la versión más reciente. Para obtener información sobre la configuración del firewall para que el agente de nodo de proceso de Batch se comunique con el servicio Batch, consulte https://docs.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

OSType

Tipo de sistema operativo (por ejemplo, Windows o Linux) de la imagen.

Nombre	Tipo	Description
linux	string	Sistema operativo Linux.
windows	string	Sistema operativo Windows.

VerificationType

Si el servicio Azure Batch comprueba activamente que la imagen es compatible con la SKU del agente de nodo de proceso asociada.

Nombre	Tipo	Description
unverified	string	La SKU del agente de nodo de proceso asociada debe tener compatibilidad binaria con la imagen, pero no se ha comprobado ninguna funcionalidad específica.
verified	string	Se garantiza que la imagen es compatible con la SKU del agente de nodo de proceso asociada y todas las características de Batch se han confirmado para que funcionen según lo previsto.

Compartir a través de

Account - List Supported Images

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Authorization

Ejemplos

Account list node agent skus

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AccountListSupportedImagesResult

BatchError

BatchErrorDetail

ErrorMessage

ImageInformation

ImageReference

OSType

VerificationType

Recursos adicionales