Obrázek stroje Amazon je šablona, která se používá pro spouštění instancí EC2. AMI je podobný plánu, který obsahuje operační systém a veškerý potřebný software nebo konfigurace aplikací pro instance. Rozhraní AMI mohou být předem vytvořené nebo spravované na míru. AWS CLI je výkonný nástroj pro přístup a správu obrázků pomocí jednoduchých příkazů, jako je např 'popis obrázků' příkaz. The 'popis obrázků' příkaz se používá k zobrazení seznamu všech nakonfigurovaných rozhraní AMI pro daný účet.
Rychlý přehled
V tomto článku se dozvíme o:
Co je příkaz „describe-images“ v AWS CLI?
The 'popis obrázků' příkaz v AWS CLI je stránkovaná operace, která se používá k vypsání všech nebo konkrétních AMI v rámci účtu. Výstup z 'popis obrázků' příkaz je ve formě seznamu, který obsahuje informace o různých obrázcích. Tyto obrázky mohou být veřejné, soukromé, uživatelem definované nebo spravované AWS. K datům rozhraní AMI se přistupuje ve více voláních API do služby, když je povoleno stránkování.
Přečtěte si více: Jak zakázat stránku v AWS CLI?
Jak používat příkaz „describe-images“ v AWS CLI?
Odregistrované obrázky jsou ty, které jsou odstraněny z AWS a již nejsou podporovány službou EC2 a platformou. Tyto obrázky jsou však také součástí výstupu 'popis obrázků' příkaz. Uživatel může řídit výstup příkazu filtrováním, dotazováním nebo specifikováním konkrétního AMI atd. prostřednictvím více různých parametrů.
Syntax
Syntaxe 'popis obrázků' příkaz je zadán takto:
aws ec2 description-images < Možnosti >
Možnosti
Zde je stručný popis možností ve výše uvedeném příkazu:
| Volba | Popisy |
| – spustitelný-uživatelé | Tento parametr se používá k extrahování a seznamu AMI na základě oprávnění uživatele. Uživatel může zadat buď „self“, „all“ nebo ID účtu AWS. |
| – filtry | Parametr –filters se používá k výpisu konkrétních podrobností nebo AMI ve výstupu. Tento příkaz podporuje různé typy filtrů: – název: Uživatel může filtrovat AMI zadáním názvu. – id vlastníka: ID účtu AWS může také filtrovat rozhraní AMI tak, že popisuje pouze ty obrázky, které jsou nakonfigurovány v rámci konkrétního účtu. – štítek: Značky jsou kombinací párů klíč–hodnota. Zadáním značek může uživatel snadno filtrovat AMI pro daný účet. – image-id: Další metodou filtrování rozhraní AMI je zadání ID obrázku. Tím se zobrazí pouze konkrétní AMI. |
| – ID obrázků | Tento parametr zadává ID rozhraní AMI. |
| – majitelé | Parametr –owner přijímá možnosti ID účtu, self, amazon nebo aws-marketplace. Tyto možnosti zobrazí pouze ty AMI, které přesně odpovídají zadané možnosti. |
| –zahrnout-zastaralé | Tento parametr se používá k určení, zda mají být uvedeny zastaralé rozhraní AMI či nikoli. Zastaralé AMI jsou ty obrazy, které se již nedoporučuje používat. |
| –zahrnout-vypnuto | Toto pole určuje, zda mají být ve výstupu uvedeny zakázané AMI nebo ne. |
| – běh nasucho | Parametr –dry-run se používá k určení, zda má uživatel oprávnění k požadované akci či nikoli. Vrací výstup ve formátu Error. Kromě toho, pokud má uživatel oprávnění, výstup bude obsahovat „DryRunOperation“. Pokud uživatel nemá toto oprávnění, vrátí ve výstupu „UnauthorizedOperation“. |
| –cli-input-json | Tento parametr se používá k poskytování více instrukcí JSON najednou ve formě šablony pro služby AWS. Následující šablona je generována parametrem „–generate-cli-skeleton“. |
| – startovní žeton | Tento parametr vloží hodnotu pole „NextToken“ z výstupu. NextToken symbolizuje, že je k dispozici více dat. Když je hodnota NextToken poskytnuta –starting-tokenu, začne vypisovat data z předchozí odpovědi. |
| -velikost stránky | Tento parametr definuje velikost stránky v každém servisním volání služby AWS. Menší velikost stránky má za následek více volání API, která zabraňují chybě vypršení časového limitu. Při každém volání však získá méně dat. |
| – maximální počet položek | Parametr –max-items se používá k omezení počtu položek, které se mají zobrazit na výstupu. |
| –generovat-cli-skeleton | Generuje kostru nebo šablonu, kterou je třeba dodržovat při poskytování více instrukcí službě AWS najednou. |
Kromě těchto možností existují také globální možnosti poskytované AWS. Globální možnosti jsou společné pro příkaz AWS CLI a lze je použít s různými příkazy. The Dokumentace AWS diskutuje o různých globálních možnostech.
Příklady
Tato část článku popisuje různé příklady 'popis obrázků' příkaz v AWS CLI:
- Příklad 1: Jak popsat obrázky v AWS CLI?
- Příklad 2: Jak popsat všechny obrázky v AWS CLI?
- Příklad 3: Jak popsat AMI podle ID vlastníka v AWS CLI?
- Příklad 4: Jak filtrovat obrázky v AWS CLI?
- Příklad 5: Jak se dotazovat na AMI v AWS CLI?
- Příklad 6: Jak popsat zastaralé obrázky v AWS CLI?
- Příklad 7: Jak popsat povolené nebo zakázané obrázky v AWS CLI?
- Příklad 8: Jak popsat obrázky ve více výstupních formátech?
Příklad 1: Jak popsat obrázky v AWS CLI?
The 'popis obrázků' příkaz v AWS CLI se používá k výpisu podrobností o konkrétním AMI pro daný účet. Tento příkaz vyžaduje ID obrazu rozhraní AMI. Navštivte službu EC2 a klikněte na 'KTERÝ' možnost z levého navigačního panelu. Vyberte vytvořit obrázek a zobrazí se konfigurace obrázku. V rámci Podrobnosti sekce, zkopírujte a uložte AMI ID:
Příkaz k vypsání konkrétního AMI je zadán takto:
aws ec2 description-images --kraj ap-jihovýchod- 1 --image-ids < AMIImageID >
Nahradit
Výstup
Příklad 2: Jak popsat všechny obrázky v AWS CLI?
Příkaz k zobrazení seznamu všech obrázků dostupných v AWS CLI je následující:
aws ec2 description-images
Výstup
Zobrazení seznamu všech obrázků bude nějakou dobu trvat. Pokračujte stisknutím tlačítka 'Vstup' stisknutím klávesy na klávesnici zobrazíte podrobnosti o všech obrázcích:
Příklad 3: Jak popsat AMI podle ID vlastníka v AWS CLI?
Rozhraní AMI nakonfigurované v rámci účtu AWS lze také určit podle vlastníka nebo ID účtu. ID účtu lze zjistit kliknutím na uživatelské jméno v pravém horním rohu konzoly pro správu AWS. Klikněte na 'kopírovat' ikona pro zkopírování ID účtu:
Příkaz je přizpůsoben dalším parametrem následujícím způsobem:
aws ec2 description-images -- majitelé < Číslo účtu >
Nahradit
Výstup
Příklad 4: Jak filtrovat obrázky v AWS CLI?
Pro extrakci konkrétních detailů obrázku jsou k dispozici různé filtry. Uživatel může filtrovat obrázky podle ID vlastníka, ID obrázku, značek, názvu nebo stavu atd. Chcete-li zobrazit obrázek podle názvu, použijte následující příkaz:
aws ec2 description-images --filtry 'Name=name, Values=ec2image'
Nahradit 'ec2image' v hodnotách s názvem vašeho AMI.
Výstup
Hodnotu párů klíč-hodnota tagu AMI lze určit výběrem AMI z řídicího panelu AMI. Tím se zobrazí konfigurace obrázku. Klepněte na 'Značky' tab a zkopírujte hodnotu polí klíč–hodnota:
Chcete-li filtrovat obrázek podle jeho značek, příkaz je uveden níže:
aws ec2 description-images --filtry 'Name=tag:firstkey, Values=first'
Nahradit 'první klíč' v poli Název pomocí klíče. Podobně vyměňte 'První' v Hodnotách s hodnotou značky.
Výstup
Příklad 5: Jak se dotazovat na AMI v AWS CLI?
Uživatel může extrahovat konkrétní detaily obrázku ze zobrazeného seznamu pomocí '-dotaz' parametr. Příkaz je zadán následovně:
aws ec2 description-images --dotaz 'Obrázky[*].[ImageId]'
Výstup
Podobně se uživatel může také dotazovat na konkrétní podrobnosti obrázku zadáním ID obrázku pomocí parametru dotazu:
aws ec2 description-images --image-id < AMII > --dotaz 'Obrázek[*].[ImageType, Description, State]'
Výstup
Příklad 6: Jak popsat zastaralé obrázky v AWS CLI?
Zastaralé AMI jsou ty obrázky, které již AWS nedoporučuje používat. Chcete-li zjistit, které obrázky jsou zastaralé, použijte následující příkaz:
aws ec2 description-images --include-deprecated
Výstup
Podobně může uživatel také zadat „–no-include-deprecated“ parametr pro zobrazení všech obrázků včetně těch zastaralých:
aws ec2 description-images --no-include-deprecated
Výstup
Příklad 7: Jak popsat povolené nebo zakázané obrázky v AWS CLI?
The 'popis obrázků' příkaz lze také použít k zobrazení seznamu obrázků, které jsou nebo nejsou pro účet zakázány. To pomůže uživatelům určit, které AMI použít. Níže uvedený příkaz se používá k zobrazení seznamu AMI, které jsou pro účet zakázány:
aws ec2 description-images --zahrnout-zakázáno
Výstup
Podobně, 'popis obrázků' příkaz vrátí pouze ty AMI, které nejsou pro daný účet zakázány. Pro tento účel použijte níže uvedený příkaz:
aws ec2 description-images --no-include-disabled
Výstup
Příklad 8: Jak popsat obrázky ve více výstupních formátech?
Existuje několik výstupních formátů, které podporuje 'popiš-obrázky' příkaz. Mezi formáty patří YAML, JSON, text nebo tabulka. Níže je uveden příkaz pro popis obrázků v tabulkovém formátu:
aws ec2 description-images --výstup stůl
Nahradit 'stůl' hodnotu ve výstupním poli s jiným výstupním formátem dle vašeho výběru, jako je JSON, YAML nebo text.
Výstup
lis 'Vstup' z klávesnice, abyste mohli pokračovat ve výpisu dat:
Závěr
The 'popiš-obrázky' příkaz v AWS vrátí seznam všech nebo konkrétních AMI pro daný účet. Přijímá volitelné parametry, např. –query, –output atd. The 'popiš-obrázky' Příkaz je užitečný pro vývojáře AWS, protože jim pomáhá pochopit a rozhodnout se mezi různými rozhraními AMI pro jejich aplikace. Před použitím 'popiš-obrázky' zajistěte, aby bylo rozhraní AWS CLI nakonfigurováno na vašich místních počítačích, a poté poskytněte uvedené příkazy terminálu. Tento článek poskytuje podrobné pochopení 'popiš-obrázky' příkaz s více příklady k diskusi o jeho různých parametrech.