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 Amazon ECS-optimized 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 delle AMI Amazon ECS-optimized possono essere recuperati a livello di codice interrogando l'API Systems Manager Parameter Store. Per ulteriori informazioni sull'API Systems Manager Parameter Store, consulta e. GetParameters 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 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 è possibile recuperare i metadati per ogni variante di Amazon AMI. ECS-optimized
Recupero dei metadati dell'ultima Amazon AMI stabile ECS-optimized
Puoi recuperare l'ultima Amazon ECS-optimized AMI stabile utilizzando i AWS CLI seguenti comandi. AWS CLI
-
Per l'AMI completa di Amazon ECS-optimized 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 Core ECS-optimized di Amazon Windows Server 2025:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --regionus-east-1 -
Per l'AMI completa ECS-optimized di Amazon 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 Core di Amazon ECS-optimized Windows Server 2022:
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 Core di Amazon ECS-optimized Windows Server 2019:
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
Utilizzando l'ultima 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