Exemplos de recuperação de metadados de instância usando IMDSv1 e IMDSv2 - AWS Snowcone Guia do usuário

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos de recuperação de metadados de instância usando IMDSv1 e IMDSv2

Os exemplos a seguir fornecem comandos que é possível usar em uma instância do Linux.

exemplo de obter as versões disponíveis dos metadados da instância

Este exemplo obtém as versões disponíveis dos metadados da instância. Cada versão indica uma compilação de metadados de instância quando novas categorias de metadados de instância foram lançadas. As versões anteriores estarão disponíveis caso você tenha scripts que contam com a estrutura e as informações presentes em uma versão anterior.

IMDSv2

[ec2-user ~]$ TOKEN=`curl -X PUT "http://192.0.2.0/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` && curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://192.0.2.0/ % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 56 100 56 0 0 3733 0 --:--:-- --:--:-- --:--:-- 3733 * Trying 192.0.2.0... * TCP_NODELAY set * Connected to 192.0.2.0 (192.0.2.0) port 80 (#0) > GET / HTTP/1.1 > Host: 192.0.2.0 > User-Agent: curl/7.61.1 > Accept: */* > X-aws-ec2-metadata-token: MDAXcxNFLbAwJIYx8KzgNckcHTdxT4Tt69TzpKExlXKTULHIQnjEtXvD > * HTTP 1.0, assume close after body < HTTP/1.0 200 OK < Date: Mon, 12 Sep 2022 21:58:03 GMT < Content-Length: 274 < Content-Type: text/plain < Server: EC2ws < 1.0 2007-01-19 2007-03-01 2007-08-29 2007-10-10 2007-12-15 2008-02-01 2008-09-01 2009-04-04 2011-01-01 2011-05-01 2012-01-12 2014-02-25 2014-11-05 2015-10-20 2016-04-19 2016-06-30 2016-09-02 2018-03-28 2018-08-17 2018-09-24 2019-10-01 2020-10-27 2021-01-03 2021-03-23 * Closing connection 0

IMDSv1

[ec2-user ~]$ curl http://192.0.2.0/ 1.0 2007-01-19 2007-03-01 2007-08-29 2007-10-10 2007-12-15 2008-02-01 2008-09-01 2009-04-04 2011-01-01 2011-05-01 2012-01-12 2014-02-25 2014-11-05 2015-10-20 2016-04-19 2016-06-30 2016-09-02 2018-03-28 2018-08-17 2018-09-24 2019-10-01 2020-10-27 2021-01-03 2021-03-23 latest
exemplo de obter itens de metadados de nível superior

Este exemplo obtém itens de metadados de nível superior. Para obter informações sobre itens de metadados de nível superior, consulte Metadados de instâncias compatíveis e dados do usuário neste guia.

IMDSv2

[ec2-user ~]$ TOKEN=`curl -X PUT "http://192.0.2.0/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` && curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://192.0.2.0/latest/meta-data/ ami-id hostname instance-id instance-type local-hostname local-ipv4 mac network/ reservation-id security-groups

IMDSv1

[ec2-user ~]$ curl http://192.0.2.0/latest/meta-data/ ami-id hostname instance-id instance-type local-hostname local-ipv4 mac network/ reservation-id security-groups
exemplo de obter valores de metadados de nível superior

Os exemplos a seguir obtêm os valores de alguns dos itens de metadados de nível superior que foram obtidos no exemplo anterior. As solicitações do IMDSv2 usam o token armazenado que foi criado no comando do exemplo anterior, supondo-se que ele não expirou.

ami‐id IMDSv2

curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://192.0.2.0/latest/meta-data/ami-id ami-0abcdef1234567890

ami-id IMDSv1

curl http://192.0.2.0/latest/meta-data/ami-id ami-0abcdef1234567890

reservation-id IMDSv2

[ec2-user ~]$ curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://192.0.2.0/latest/meta-data/reservation-id r-0efghijk987654321

reservation-id IMDSv1

[ec2-user ~]$ curl http://192.0.2.0/latest/meta-data/reservation-id \ r-0efghijk987654321

local-hostname IMDSv2

[ec2-user ~]$ curl -H "X-aws-ec2-metadata-token: $TOKEN" -v http://192.0.2.0/latest/meta-data/local-hostname ip-00-000-00-00

local-hostname IMDSv1

[ec2-user ~]$ curl http://192.0.2.0/latest/meta-data/local-hostname ip-00-000-00-00