Obrázok stroja Amazon je šablóna, ktorá sa používa na spustenie inštancií EC2. AMI je podobný plánu, ktorý obsahuje operačný systém a všetok potrebný softvér alebo konfigurácie aplikácií pre inštancie. Rozhrania AMI môžu byť vopred vytvorené alebo spravované na mieru. AWS CLI je výkonný nástroj na prístup a správu obrázkov pomocou jednoduchých príkazov, ako je napr 'popis-obrázky' príkaz. The 'popis-obrázky' príkaz sa používa na zoznam všetkých nakonfigurovaných AMI pre daný účet.
Rýchly prehľad
V tomto článku sa dozvieme o:
Čo je príkaz „describe-images“ v AWS CLI?
The 'popis-obrázky' príkaz v AWS CLI je stránkovaná operácia, ktorá sa používa na zoznam všetkých alebo konkrétnych AMI v rámci účtu. Výstup z 'popis-obrázky' príkaz je vo forme zoznamu, ktorý obsahuje informácie o rôznych obrázkoch. Tieto obrázky môžu byť verejné, súkromné, definované používateľom alebo spravované AWS. K údajom AMI sa pristupuje vo viacerých volaniach API do služby, keď je povolené stránkovanie.
Čítaj viac: Ako zakázať stránku v AWS CLI?
Ako používať príkaz „describe-images“ v AWS CLI?
Odregistrované obrázky sú tie, ktoré sú odstránené z AWS a už nie sú podporované službou EC2 a platformou. Tieto obrázky sú však zahrnuté aj vo výstupe 'popis-obrázky' príkaz. Používateľ môže ovládať výstup príkazu filtrovaním, dotazovaním alebo špecifikovaním konkrétneho AMI atď. prostredníctvom viacerých rôznych parametrov.
Syntax
Syntax súboru 'popis-obrázky' príkaz je zadaný takto:
aws ec2 description-images < možnosti >
možnosti
Tu je stručný popis možností vo vyššie uvedenom príkaze:
| Možnosť | Popisy |
| – spustiteľných používateľov | Tento parameter sa používa na extrahovanie a zoznam AMI na základe povolení používateľa. Používateľ môže zadať „self“, „all“ alebo ID účtu AWS. |
| -filtre | Parameter –filters sa používa na vypísanie konkrétnych podrobností alebo AMI vo výstupe. Tento príkaz podporuje rôzne typy filtrov: – názov: Používateľ môže filtrovať AMI zadaním názvu. – ID vlastníka: ID účtu AWS môže tiež filtrovať AMI tak, že popisuje iba tie obrázky, ktoré sú nakonfigurované v rámci konkrétneho účtu. – značka: Značky sú kombináciou párov kľúč – hodnota. Zadaním značiek môže používateľ jednoducho filtrovať AMI pre daný účet. – image-id: Ďalšou metódou filtrovania AMI je zadanie ID obrázka. Toto zobrazí iba konkrétny AMI. |
| –image-ids | Tento parameter zadáva ID AMI. |
| – vlastníkov | Parameter –owner akceptuje možnosti ID účtu, self, amazon alebo aws-marketplace. Tieto možnosti zobrazia iba tie AMI, ktoré sa presne zhodujú so zadanou možnosťou. |
| – zahŕňajú-zastarané | Tento parameter sa používa na určenie, či sa majú uvádzať zastarané AMI alebo nie. Zastarané AMI sú tie obrázky, ktoré sa už neodporúčajú používať. |
| -zahrnúť-zakázané | Toto pole určuje, či sa majú vo výstupe uviesť zakázané AMI alebo nie. |
| – chod nasucho | Parameter –dry-run sa používa na určenie, či má používateľ povolenie na požadovanú akciu alebo nie. Vracia výstup vo formáte Error. Okrem toho, ak má používateľ povolenia, výstup bude obsahovať „DryRunOperation“. Ak používateľ nemá toto oprávnenie, vo výstupe vráti „UnauthorizedOperation“. |
| –cli-input-json | Tento parameter sa používa na poskytovanie viacerých inštrukcií JSON naraz vo forme šablóny pre služby AWS. Nasledovaná šablóna je vygenerovaná parametrom „–generate-cli-skeleton“. |
| – štartovací token | Tento parameter zadáva hodnotu poľa „NextToken“ z výstupu. NextToken symbolizuje, že je potrebné uviesť viac údajov. Keď je hodnota NextToken poskytnutá tokenu –starting, začne vypisovať údaje z predchádzajúcej odpovede. |
| - veľkosť strany | Tento parameter definuje veľkosť stránky v každom servisnom volaní služby AWS. Menšia veľkosť stránky má za následok viac volaní API, ktoré zabraňujú chybe časového limitu. Pri každom hovore však získava menej údajov. |
| – maximálny počet položiek | Parameter –max-items sa používa na obmedzenie počtu záznamov, ktoré sa majú zobraziť vo výstupe. |
| –generovať-kli-kostru | Vygeneruje kostru alebo šablónu, ktorá sa má dodržiavať pri poskytovaní viacerých pokynov službe AWS naraz. |
Okrem týchto možností existujú aj globálne možnosti, ktoré poskytuje AWS. Globálne možnosti sú spoločné pre príkaz AWS CLI a možno ich použiť s rôznymi príkazmi. The Dokumentácia AWS diskutuje o rôznych globálnych možnostiach.
Príklady
Táto časť článku popisuje rôzne príklady 'popis-obrázky' príkaz v AWS CLI:
- Príklad 1: Ako opísať obrázky v AWS CLI?
- Príklad 2: Ako opísať všetky obrázky v AWS CLI?
- Príklad 3: Ako opísať AMI podľa ID vlastníka v AWS CLI?
- Príklad 4: Ako filtrovať obrázky v AWS CLI?
- Príklad 5: Ako sa dotazovať na AMI v AWS CLI?
- Príklad 6: Ako opísať zastarané obrázky v AWS CLI?
- Príklad 7: Ako opísať povolené alebo zakázané obrázky v AWS CLI?
- Príklad 8: Ako opísať obrázky vo viacerých výstupných formátoch?
Príklad 1: Ako opísať obrázky v AWS CLI?
The 'popis-obrázky' príkaz v AWS CLI sa používa na výpis podrobností konkrétneho AMI pre daný účet. Tento príkaz vyžaduje ID obrazu AMI. Navštívte službu EC2 a kliknite na 'KTORÉ' možnosť z ľavého navigačného panela. Vyberte obrázok na vytvorenie a zobrazia sa konfigurácie obrázka. V rámci Podrobnosti časť, skopírujte a uložte AMI ID:
Príkaz na vypísanie konkrétneho AMI je zadaný takto:
aws ec2 description-images --región ap-juhovýchod- 1 --image-ids < AMIImageID >
Vymeňte
Výkon
Príklad 2: Ako opísať všetky obrázky v AWS CLI?
Príkaz na zoznam všetkých obrázkov dostupných v AWS CLI je nasledujúci:
aws ec2 description-images
Výkon
Zobrazenie zoznamu všetkých obrázkov bude chvíľu trvať. Pokračujte stlačením tlačidla 'Enter' na klávesnici zobrazíte podrobnosti o všetkých obrázkoch:
Príklad 3: Ako opísať AMI podľa ID vlastníka v AWS CLI?
Rozhrania AMI nakonfigurované v rámci účtu AWS možno určiť aj podľa vlastníka alebo ID účtu. ID účtu možno určiť kliknutím na používateľské meno v pravom hornom rohu konzoly AWS Management Console. Kliknite na 'kopírovať' ikona na skopírovanie ID účtu:
Príkaz je prispôsobený ďalším parametrom nasledujúcim spôsobom:
aws ec2 description-images -- majitelia < Číslo účtu >
Vymeňte
Výkon
Príklad 4: Ako filtrovať obrázky v AWS CLI?
Na extrakciu konkrétnych detailov obrázka sú k dispozícii rôzne filtre. Používateľ môže filtrovať obrázky podľa ID vlastníka, ID obrázka, značiek, názvu alebo stavu atď. Ak chcete zobraziť obrázok podľa názvu, použije sa nasledujúci príkaz:
aws ec2 description-images --filtre 'Meno=meno, hodnoty=ec2image'
Vymeňte 'ec2image' v hodnotách s názvom vášho AMI.
Výkon
Hodnotu párov kľúč-hodnota značky AMI možno určiť výberom AMI na paneli AMI. Tým sa zobrazia konfigurácie obrázka. Klepnite na ikonu 'Štítky' tab a skopírujte hodnotu polí kľúč – hodnota:
Ak chcete filtrovať obrázok podľa jeho značiek, príkaz je uvedený nižšie:
aws ec2 description-images --filtre 'Name=tag:firstkey, Values=first'
Vymeňte 'prvý kľúč' v poli Názov pomocou kľúča. Podobne nahraďte 'najprv' v hodnotách s hodnotou značky.
Výkon
Príklad 5: Ako sa dotazovať na AMI v AWS CLI?
Používateľ môže zo zobrazeného zoznamu extrahovať konkrétne podrobnosti o obrázku pomocou '-dopyt' parameter. Príkaz je zadaný takto:
aws ec2 description-images --dopyt 'Obrázky[*].[ImageId]'
Výkon
Podobne môže používateľ vyhľadávať aj konkrétne podrobnosti obrázka zadaním ID obrázka pomocou parametra dotazu:
aws ec2 description-images --image-id < AMII > --dopyt 'Obrázok[*].[ImageType, Description, State]'
Výkon
Príklad 6: Ako opísať zastarané obrázky v AWS CLI?
Zastarané AMI sú tie obrázky, ktoré už AWS neodporúča používať. Ak chcete zistiť, ktoré obrázky sú zastarané, použite nasledujúci príkaz:
aws ec2 description-images --include-deprecated
Výkon
Podobne môže používateľ zadať aj „–no-include-deprecated“ parameter na zobrazenie všetkých obrázkov vrátane tých, ktoré už nie sú podporované:
aws ec2 description-images --no-include-deprecated
Výkon
Príklad 7: Ako opísať povolené alebo zakázané obrázky v AWS CLI?
The 'popis-obrázky' príkaz možno použiť aj na zobrazenie zoznamu obrázkov, ktoré sú alebo nie sú pre účet zakázané. To pomôže používateľom pri určovaní, ktoré AMI použiť. Príkaz uvedený nižšie sa používa na zoznam AMI, ktoré sú pre účet zakázané:
aws ec2 description-images --include-disabled
Výkon
Podobne aj 'popis-obrázky' príkaz vráti iba tie AMI, ktoré nie sú pre daný účet zakázané. Na tento účel použite príkaz nižšie:
aws ec2 description-images --no-include-disabled
Výkon
Príklad 8: Ako opísať obrázky vo viacerých výstupných formátoch?
Existuje viacero výstupných formátov podporovaných 'popis-obrázky' príkaz. Medzi formáty patrí YAML, JSON, text alebo tabuľka. Nižšie je uvedený príkaz na popis obrázkov v tabuľkovom formáte:
aws ec2 description-images --výkon tabuľky
Vymeňte 'stôl' hodnotu vo výstupnom poli s iným výstupným formátom podľa vášho výberu, napríklad JSON, YAML alebo text.
Výkon
Stlačte tlačidlo 'Enter' z klávesnice, aby ste pokračovali vo vypisovaní údajov:
Záver
The 'popis-obrázky' príkaz v AWS vráti zoznam všetkých alebo konkrétnych AMI pre daný účet. Akceptuje voliteľné parametre, napr. –query, –output, atď 'popis-obrázky' príkaz je užitočný pre vývojárov AWS, pretože im pomáha pochopiť a rozhodnúť sa medzi rôznymi AMI pre ich aplikácie. Pred použitím 'popis-obrázky' skontrolujte, či je AWS CLI nakonfigurované na vašich lokálnych počítačoch, a potom poskytnite terminálu uvedené príkazy. Tento článok poskytuje hĺbkové pochopenie 'popis-obrázky' príkaz s viacerými príkladmi na diskusiu o jeho rôznych parametroch.