Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Recuperare Amazon ECS-optimized Metadati Windows AMI
L'ID AMI, il nome dell'immagine, il sistema operativo, la versione dell'agente contenitore e la versione di runtime per ciascuna variante di Amazon ECS-optimized Le AMI possono essere recuperate a livello di codice interrogando l'API Systems Manager Parameter Store. Per ulteriori informazioni sull'API Systems Manager Parameter Store, vedere GetParameters e GetParametersByPath.
Il tuo utente amministrativo deve disporre delle seguenti autorizzazioni IAM per recuperare Amazon ECS-optimized Metadati AMI. Queste autorizzazioni sono state aggiunte alla policy IAM AmazonECS_FullAccess.
-
sms:GetParameters
-
sms:GetParameter
-
sms:GetParametersByPath
Formato del parametro dell'archivio parametri di Systems Manager
I seguenti parametri dell'API Systems Manager Parameter Store sono obsoleti e non devono essere utilizzati per recuperare le AMI Windows più recenti:
-
/aws/service/ecs/optimized-ami/windows_server/2016/english/full/recommended/image_id -
/aws/service/ecs/optimized-ami/windows_server/2019/english/full/recommended/image_id
Di seguito è riportato il formato del nome del parametro per ogni Amazon ECS-optimized Variante AMI.
-
Metadati AMI completi di Windows Server 2025:
/aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized -
Metadati AMI principali di Windows Server 2025:
/aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized -
Metadati dell'AMI di Windows Server 2022 Full:
/aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized -
Metadati dell'AMI di Windows Server 2022 Core:
/aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized -
Metadati dell'AMI di Windows Server 2019 Full:
/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized -
Metadati dell'AMI di Windows Server 2019 Core:
/aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized -
Metadati dell'AMI di Windows Server 2016 Full:
/aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized
Il formato dei nomi di parametro seguente recupera i metadati dell'AMI stabile Windows Server 2019 completa più recente.
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized
Di seguito viene mostrato un esempio dell'oggetto JSON restituito per il valore del parametro.
{ "Parameters": [ { "Name": "/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized", "Type": "String", "Value": "{\"image_name\":\"Windows_Server-2019-English-Full-ECS_Optimized-2023.06.13\",\"image_id\":\"ami-0debc1fb48e4aee16\",\"ecs_runtime_version\":\"Docker (CE) version 20.10.21\",\"ecs_agent_version\":\"1.72.0\"}", "Version": 58, "LastModifiedDate": "2023-06-22T19:37:37.841000-04:00", "ARN": "arn:aws:ssm:us-east-1::parameter/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized", "DataType": "text" } ], "InvalidParameters": [] }
Ciascuno dei campi dell'output precedente può essere interrogato come sottoparametro. Costruisci il percorso di parametro per un parametro secondario aggiungendo il nome del parametro secondario al percorso per l'AMI selezionata. Sono disponibili i seguenti parametri secondari:
-
schema_version -
image_id -
image_name -
os -
ecs_agent_version -
ecs_runtime_version
Esempi
Gli esempi seguenti mostrano i modi in cui puoi recuperare i metadati per ogni Amazon ECS-optimized Variante AMI.
Recupero dei metadati dell'ultima versione stabile di Amazon ECS-optimized IMA
Puoi recuperare l'ultima versione stabile di Amazon ECS-optimized AMI utilizzando il AWS CLI con quanto segue AWS CLI comandi.
-
Per Amazon ECS-optimized AMI completa per Windows Server 2025:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --regionus-east-1 -
Per Amazon ECS-optimized AMI principale di Windows Server 2025:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --regionus-east-1 -
Per Amazon ECS-optimized AMI completa per Windows Server 2022:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --regionus-east-1 -
Per Amazon ECS-optimized AMI principale di Windows Server 2022:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --regionus-east-1 -
Per Amazon ECS-optimized AMI completa per Windows Server 2019:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --regionus-east-1 -
Per Amazon ECS-optimized AMI principale di Windows Server 2019:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --regionus-east-1 -
Per Amazon ECS-optimized AMI completa per Windows Server 2016:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --regionus-east-1
Utilizzando l'ultima versione consigliata di Amazon ECS-optimized AMI in un CloudFormation modello
Puoi fare riferimento all'ultima versione consigliata di Amazon ECS-optimized AMI in un CloudFormation modello facendo riferimento al nome dell'archivio dei parametri di Systems Manager.
Parameters: LatestECSOptimizedAMI: Description: AMI ID Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id> Default:/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized/image_id