Account - List Supported Images
Een lijst met alle vm-installatiekopieën die worden ondersteund door de Azure Batch-service.
GET {batchUrl}/supportedimages?api-version=2023-11-01.18.0
GET {batchUrl}/supportedimages?$filter={$filter}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
batch
|
path | True |
string |
De basis-URL voor alle Azure Batch serviceaanvragen. |
api-version
|
query | True |
string |
Client-API-versie. |
$filter
|
query |
string |
Een OData $filter component. Zie voor meer informatie over het maken van dit filter https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-support-images. |
|
maxresults
|
query |
integer int32 |
Het maximum aantal items dat in het antwoord moet worden geretourneerd. Er worden maximaal 1000 resultaten geretourneerd. |
|
timeout
|
query |
integer int32 |
De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. |
Aanvraagkoptekst
Media Types: "application/json; odata=minimalmetadata"
Name | Vereist | Type | Description |
---|---|---|---|
client-request-id |
string uuid |
De aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Of de server de client-request-id in het antwoord moet retourneren. |
|
ocp-date |
string date-time-rfc1123 |
Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige systeemkloktijd; stel dit expliciet in als u de REST API rechtstreeks aanroept. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Een antwoord met de lijst met ondersteunde installatiekopieën van virtuele machines. Headers
|
|
Other Status Codes |
De fout van de Batch-service. |
Beveiliging
azure_auth
Microsoft Entra OAuth 2.0-verificatiecodestroom
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Authorization
Type:
apiKey
In:
header
Voorbeelden
Account list node agent skus
Sample Request
GET account.region.batch.azure.com/supportedimages?api-version=2023-11-01.18.0
Sample Response
{
"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"
}
]
}
Definities
Name | Description |
---|---|
Account |
Het resultaat van het weergeven van de ondersteunde vm-installatiekopieën. |
Batch |
Een foutbericht dat is ontvangen van de Azure Batch-service. |
Batch |
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie. |
Error |
Een foutbericht ontvangen in een Azure Batch antwoord. |
Image |
Een verwijzing naar de installatiekopieën van Azure Virtual Machines Marketplace en aanvullende informatie over de installatiekopieën. |
Image |
Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of een installatiekopieën van een Azure Compute Gallery. Zie de bewerking Ondersteunde installatiekopieën weergeven om de lijst met alle Azure Marketplace afbeeldingsverwijzingen op te halen die door Azure Batch zijn geverifieerd. |
OSType |
Het type besturingssysteem (bijvoorbeeld Windows of Linux) van de installatiekopieën. |
Verification |
Of de Azure Batch-service actief controleert of de installatiekopieën compatibel zijn met de bijbehorende Compute Node-agent-SKU. |
AccountListSupportedImagesResult
Het resultaat van het weergeven van de ondersteunde vm-installatiekopieën.
Name | Type | Description |
---|---|---|
odata.nextLink |
string |
De URL voor het ophalen van de volgende set resultaten. |
value |
De lijst met ondersteunde installatiekopieën van virtuele machines. |
BatchError
Een foutbericht dat is ontvangen van de Azure Batch-service.
Name | Type | Description |
---|---|---|
code |
string |
Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt. |
message |
Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface. |
|
values |
Een verzameling sleutel-waardeparen met aanvullende details over de fout. |
BatchErrorDetail
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
Name | Type | Description |
---|---|---|
key |
string |
Een id die de betekenis van de eigenschap Value aangeeft. |
value |
string |
De aanvullende informatie die is opgenomen in de foutreactie. |
ErrorMessage
Een foutbericht ontvangen in een Azure Batch antwoord.
Name | Type | Description |
---|---|---|
lang |
string |
De taalcode van het foutbericht |
value |
string |
De tekst van het bericht. |
ImageInformation
Een verwijzing naar de installatiekopieën van Azure Virtual Machines Marketplace en aanvullende informatie over de installatiekopieën.
Name | Type | Description |
---|---|---|
batchSupportEndOfLife |
string |
Het tijdstip waarop de Azure Batch-service geen groepsaanvragen meer accepteert voor de installatiekopieën. |
capabilities |
string[] |
De mogelijkheden of functies die door de installatiekopieën worden ondersteund. |
imageReference |
De verwijzing naar de Marketplace-installatiekopieën van de virtuele Azure-machine. |
|
nodeAgentSKUId |
string |
De id van de Compute Node-agent-SKU die door de installatiekopieën wordt ondersteund. |
osType |
Het type besturingssysteem (bijvoorbeeld Windows of Linux) van de installatiekopieën. |
|
verificationType |
Of de Azure Batch-service actief controleert of de installatiekopieën compatibel zijn met de bijbehorende Compute Node-agent-SKU. |
ImageReference
Een verwijzing naar een Azure Virtual Machines Marketplace-installatiekopieën of een installatiekopieën van een Azure Compute Gallery. Zie de bewerking Ondersteunde installatiekopieën weergeven om de lijst met alle Azure Marketplace afbeeldingsverwijzingen op te halen die door Azure Batch zijn geverifieerd.
Name | Type | Description |
---|---|---|
exactVersion |
string |
De specifieke versie van de platforminstallatiekopieën of marketplace-installatiekopieën die worden gebruikt om het knooppunt te maken. Dit alleen-lezenveld verschilt alleen van 'version' als de waarde die is opgegeven voor 'version' toen de pool werd gemaakt, 'latest' was. |
offer |
string |
Het aanbiedingstype van de Azure Virtual Machines Marketplace-installatiekopieën. |
publisher |
string |
De uitgever van de Azure Virtual Machines Marketplace-installatiekopieën. |
sku |
string |
De SKU van de Azure Virtual Machines Marketplace-installatiekopieën. |
version |
string |
De versie van de Azure Virtual Machines Marketplace-installatiekopieën. |
virtualMachineImageId |
string |
De ARM-resource-id van de installatiekopieën van de Azure Compute Gallery. Rekenknooppunten in de pool worden gemaakt met behulp van deze installatiekopieën-id. Dit heeft de vorm /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} of /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} om altijd de meest recente versie van de installatiekopie te gebruiken. |
OSType
Het type besturingssysteem (bijvoorbeeld Windows of Linux) van de installatiekopieën.
Name | Type | Description |
---|---|---|
linux |
string |
Het Linux-besturingssysteem. |
windows |
string |
Het Windows-besturingssysteem. |
VerificationType
Of de Azure Batch-service actief controleert of de installatiekopieën compatibel zijn met de bijbehorende Compute Node-agent-SKU.
Name | Type | Description |
---|---|---|
unverified |
string |
De gekoppelde Compute Node-agent-SKU moet binaire compatibiliteit hebben met de installatiekopieën, maar de specifieke functionaliteit is niet geverifieerd. |
verified |
string |
De installatiekopieën zijn gegarandeerd compatibel met de bijbehorende Compute Node-agent-SKU en alle Batch-functies werken zoals verwacht. |