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à.
Recupero dei metadati ECS-optimized AMI di Amazon Windows
L'ID AMI, il nome dell'immagine, il sistema operativo, la versione dell'agente contenitore e la versione di runtime per ogni variante delle AMI Amazon possono essere recuperati a livello di codice interrogando l'API Systems Manager ECS-optimized Parameter Store. Per ulteriori informazioni sull'API Systems Manager Parameter Store, vedere GetParameterse GetParametersByPath.
Nota
L'utente amministrativo deve disporre delle seguenti autorizzazioni IAM per recuperare i metadati Amazon ECS-optimized AMI. Queste autorizzazioni sono state aggiunte alla policy IAM AmazonECS_FullAccess.
-
ssm: GetParameters
-
sms: GetParameter
-
sms: GetParametersByPath
Formato del parametro dell'archivio parametri di Systems Manager
Nota
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 variante di Amazon ECS-optimized AMI.
-
Metadati AMI completi di Windows Server 2025:
/aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized -
Metadati AMI Core 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": [] }
Ognuno dei campi nell'output riportato sopra sono disponibili per essere interrogati come parametri secondari. 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 è possibile recuperare i metadati per ogni variante di Amazon ECS-optimized AMI.
Recupero dei metadati dell'ultima AMI Amazon stabile ECS-optimized
Puoi recuperare l'ultima ECS-optimized AMI Amazon stabile utilizzando AWS CLI i seguenti AWS CLI comandi.
-
Per l'AMI completa ECS-optimized di Amazon Windows Server 2025:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --regionus-east-1 -
Per l'AMI Amazon ECS-optimized Windows Server 2025 Core:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --regionus-east-1 -
Per l'AMI completa di Amazon ECS-optimized Windows Server 2022:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --regionus-east-1 -
Per l'AMI Amazon ECS-optimized Windows Server 2022 Core:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --regionus-east-1 -
Per l'AMI completa di Amazon ECS-optimized Windows Server 2019:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --regionus-east-1 -
Per l'AMI Amazon ECS-optimized Windows Server 2019 Core:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --regionus-east-1 -
Per l'AMI completa di Amazon ECS-optimized Windows Server 2016:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --regionus-east-1
Utilizzo della versione più recente di Amazon ECS-optimized AMI consigliata in un CloudFormation modello
Puoi fare riferimento all'ultima Amazon ECS-optimized AMI consigliata 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