Afbeelding van Amazon-machine is een sjabloon die wordt gebruikt voor het starten van de EC2-instanties. Een AMI is vergelijkbaar met een blauwdruk die een besturingssysteem en alle benodigde software of applicatieconfiguraties voor de instances bevat. De AMI's kunnen vooraf worden gebouwd of op maat worden beheerd. AWS CLI is een krachtig hulpprogramma voor het openen en beheren van afbeeldingen via eenvoudige opdrachten zoals “beschrijf-afbeeldingen” commando. De “beschrijf-afbeeldingen” De opdracht wordt gebruikt om alle geconfigureerde AMI's voor een bepaald account weer te geven.
Snel overzicht
In dit artikel zullen we leren over:
- Wat is het commando “describe-images” in AWS CLI?
- Hoe gebruik ik het commando “describe-images” in AWS CLI?
- Conclusie
Wat is het commando “describe-images” in AWS CLI?
De “beschrijf-afbeeldingen” opdracht in AWS CLI is een gepagineerde bewerking die wordt gebruikt om alle of specifieke AMI's binnen een account weer te geven. De uitvoer van de “beschrijf-afbeeldingen” opdracht bevindt zich in de lijstvorm die informatie over verschillende afbeeldingen bevat. Deze afbeeldingen kunnen openbaar, privé, door de gebruiker gedefinieerd of door AWS beheerd zijn. De gegevens van de AMI zijn toegankelijk via meerdere API-aanroepen naar de service wanneer de paginering is ingeschakeld.
Lees verder: Hoe kan ik de pagina uitschakelen in AWS CLI?
Hoe gebruik ik het commando “describe-images” in AWS CLI?
Niet-geregistreerde afbeeldingen zijn afbeeldingen die van de AWS zijn verwijderd en niet langer worden ondersteund door de EC2-service en het platform. Deze afbeeldingen worden echter ook opgenomen in de uitvoer van de “beschrijf-afbeeldingen” commando. De gebruiker kan de uitvoer van de opdracht controleren door een bepaalde AMI, enz. te filteren, te bevragen of te specificeren via meerdere verschillende parameters.
Syntaxis
De syntaxis van de “beschrijf-afbeeldingen” opdracht wordt als volgt gegeven:
aws ec2 beschrijven-afbeeldingen < Opties >
Opties
Hier volgt een korte beschrijving van de opties in de bovengenoemde opdracht:
| Keuze | Beschrijvingen |
| –uitvoerbare-gebruikers | Deze parameter wordt gebruikt om de AMI's te extraheren en weer te geven op basis van de machtigingen van de gebruiker. De gebruiker kan “self”, “all” of de AWS-account-ID opgeven. |
| –filters | De parameter –filters wordt gebruikt om specifieke details of AMI's in de uitvoer weer te geven. Er worden verschillende filtertypen ondersteund door deze opdracht: – naam: De gebruiker kan de AMI's filteren door de naam op te geven. – eigenaar-ID: De AWS-account-ID kan ook de AMI's filteren door alleen die afbeeldingen te beschrijven die binnen een specifiek account zijn geconfigureerd. – label: Tags zijn de combinatie van de sleutel-waardeparen. Door de tags op te geven, kan een gebruiker eenvoudig de AMI's voor een bepaald account filteren. – afbeelding-ID: Een andere methode om de AMI's te filteren is door de afbeeldings-ID op te geven. Hier wordt alleen een specifieke AMI vermeld. |
| –afbeelding-ID's | Deze parameter voert de ID van de AMI in. |
| -eigenaren | De parameter –owner accepteert de opties account-ID, self, amazon of aws-marketplace. Deze opties vermelden alleen die AMI's die exact overeenkomen met de opgegeven optie. |
| –include-verouderd | Deze parameter wordt gebruikt om op te geven of de verouderde AMI's wel of niet moeten worden vermeld. De verouderde AMI's zijn afbeeldingen die niet langer worden aanbevolen om te gebruiken. |
| –inclusief-uitgeschakeld | Dit veld geeft aan of de uitgeschakelde AMI's al dan niet in de uitvoer moeten worden vermeld. |
| -oefening | De parameter –dry-run wordt gebruikt om te bepalen of de gebruiker toestemming heeft voor de gewenste actie of niet. Het retourneert de uitvoer in het Error-formaat. Bovendien, als de gebruiker over de machtigingen beschikt, zal de uitvoer de “DryRunOperation” bevatten. Als de gebruiker niet over deze toestemming beschikt, retourneert hij “UnauthorizedOperation” in de uitvoer. |
| –cli-invoer-json | Deze parameter wordt gebruikt om meerdere JSON-instructies tegelijk aan te bieden in de vorm van een sjabloon voor AWS-services. Het gevolgde sjabloon wordt gegenereerd door de parameter “–generate-cli-skeleton”. |
| –start-token | Deze parameter voert de waarde van het veld “NextToken” in vanuit de uitvoer. De NextToken symboliseert dat er meer gegevens zijn om op te noemen. Wanneer de waarde van NextToken aan het –start-token wordt doorgegeven, worden de gegevens uit het vorige antwoord weergegeven. |
| -pagina grootte | Deze parameter definieert de paginagrootte bij elke AWS-serviceaanroep. Een kleiner paginaformaat resulteert in meer API-aanroepen die de time-outfout voorkomen. Er worden echter bij elk gesprek minder gegevens opgehaald. |
| –max-items | De parameter –max-items wordt gebruikt om het aantal items dat in de uitvoer moet worden weergegeven te beperken. |
| –genereer-cli-skelet | Het genereert een skelet of sjabloon dat moet worden gevolgd bij het tegelijkertijd verstrekken van meerdere instructies aan de AWS-service. |
Naast deze opties zijn er ook globale opties aangeboden door AWS. De globale opties zijn hetzelfde voor de AWS CLI-opdracht en kunnen met verschillende opdrachten worden gebruikt. De AWS-documentatie bespreekt verschillende mondiale opties.
Voorbeelden
In dit gedeelte van het artikel worden verschillende voorbeelden besproken “beschrijf-afbeeldingen” opdracht in AWS CLI:
- Voorbeeld 1: Hoe afbeeldingen beschrijven in AWS CLI?
- Voorbeeld 2: Hoe alle afbeeldingen in AWS CLI beschrijven?
- Voorbeeld 3: Hoe AMI beschrijven op basis van eigenaar-ID in AWS CLI?
- Voorbeeld 4: Afbeeldingen filteren in AWS CLI?
- Voorbeeld 5: Hoe kan ik de AMI opvragen in AWS CLI?
- Voorbeeld 6: Hoe kan ik verouderde afbeeldingen in AWS CLI beschrijven?
- Voorbeeld 7: Hoe beschrijf ik in- of uitgeschakelde afbeeldingen in AWS CLI?
- Voorbeeld 8: Hoe afbeeldingen in meerdere uitvoerformaten beschrijven?
Voorbeeld 1: Hoe afbeeldingen beschrijven in AWS CLI?
De “beschrijf-afbeeldingen” commando in AWS CLI wordt gebruikt om de details van een specifieke AMI voor een bepaald account weer te geven. Voor deze opdracht is de afbeeldings-ID van de AMI vereist. Bezoek de EC2-service en klik op de 'WELKE' optie in het linkernavigatievenster. Selecteer de afbeelding maken en de configuraties van de afbeelding worden weergegeven. Binnen de Details sectie, kopieer en bewaar de AMI ID:
Het commando om een specifieke AMI weer te geven wordt als volgt gegeven:
aws ec2 beschrijven-afbeeldingen --regio ap-zuidoost- 1 --afbeelding-ID's < AMIImageID >
Vervang de
Uitvoer
Voorbeeld 2: Hoe alle afbeeldingen in AWS CLI beschrijven?
De opdracht om alle afbeeldingen weer te geven die beschikbaar zijn in AWS CLI is als volgt:
aws ec2 beschrijven-afbeeldingen
Uitvoer
Het duurt enige tijd voordat een lijst met alle afbeeldingen wordt weergegeven. Blijf op de knop drukken 'Binnenkomen' toets op het toetsenbord om de details van alle afbeeldingen te bekijken:
Voorbeeld 3: Hoe AMI beschrijven op basis van eigenaar-ID in AWS CLI?
AMI's die binnen een AWS-account zijn geconfigureerd, kunnen ook worden bepaald aan de hand van de eigenaar of account-ID. De account-ID kan worden bepaald door op de gebruikersnaam in de rechterbovenhoek van de AWS Management Console te klikken. Klik op de 'kopiëren' pictogram om de account-ID te kopiëren:
De opdracht wordt op de volgende manier aangepast met een extra parameter:
aws ec2 beschrijven-afbeeldingen --eigenaren < Account ID >
Vervang de
Uitvoer
Voorbeeld 4: Afbeeldingen filteren in AWS CLI?
Er zijn verschillende filters beschikbaar om specifieke afbeeldingsdetails te extraheren. De gebruiker kan de afbeeldingen filteren op eigenaar-ID, afbeeldings-ID, tags, naam of status, enz. Om een afbeelding op naam weer te geven, wordt de volgende opdracht gebruikt:
aws ec2 beschrijven-afbeeldingen --filters 'Naam=naam, Waarden=ec2image'
Vervang de “ec2image” in Waarden met de naam van uw AMI.
Uitvoer
De waarde van sleutel-waardeparen van de tag van een AMI kan worden bepaald door de AMI te selecteren in het AMI-dashboard. Hierdoor worden de configuraties van de afbeelding weergegeven. Druk op “Tags” tabblad en kopieer de waarde van sleutelwaardevelden:
Om een afbeelding op tags te filteren, wordt de onderstaande opdracht gegeven:
aws ec2 beschrijven-afbeeldingen --filters 'Naam=tag:eerstesleutel, Waarden=eerste'
Vervang de “eerste sleutel” in het veld Naam met de sleutel. Vervang op dezelfde manier de 'Eerst' in Waarden met de waarde van de tag.
Uitvoer
Voorbeeld 5: Hoe kan ik de AMI opvragen in AWS CLI?
De gebruiker kan specifieke details van een afbeelding uit de weergegeven lijst halen met behulp van de '-vraag' parameter. Het commando wordt als volgt gegeven:
aws ec2 beschrijven-afbeeldingen --vraag 'Afbeeldingen[*].[ImageId]'
Uitvoer
Op dezelfde manier kan de gebruiker ook specifieke details van een afbeelding opvragen door de afbeeldings-ID op te geven met de queryparameter:
aws ec2 beschrijven-afbeeldingen --afbeelding-id < AMII's > --vraag 'Afbeelding[*].[Beeldtype, beschrijving, staat]'
Uitvoer
Voorbeeld 6: Hoe kan ik verouderde afbeeldingen in AWS CLI beschrijven?
Verouderde AMI's zijn afbeeldingen die niet langer worden aanbevolen voor gebruik door AWS. Om te bepalen welke afbeeldingen verouderd zijn, gebruikt u de volgende opdracht:
aws ec2 beschrijven-afbeeldingen --include-verouderd
Uitvoer
Op dezelfde manier kan de gebruiker ook de “–no-include-verouderd” parameter om alle afbeeldingen weer te geven, inclusief de verouderde afbeeldingen:
aws ec2 beschrijven-afbeeldingen --no-include-verouderd
Uitvoer
Voorbeeld 7: Hoe beschrijf ik in- of uitgeschakelde afbeeldingen in AWS CLI?
De “beschrijf-afbeeldingen” De opdracht kan ook worden gebruikt om de afbeeldingen weer te geven die wel of niet zijn uitgeschakeld voor het account. Dit zal de gebruikers helpen bij het bepalen welke AMI's ze moeten gebruiken. De onderstaande opdracht wordt gebruikt om de AMI's weer te geven die zijn uitgeschakeld voor het account:
aws ec2 beschrijven-afbeeldingen --include-uitgeschakeld
Uitvoer
Op dezelfde manier is de “beschrijf-afbeeldingen” commando retourneert alleen die AMI's die niet zijn uitgeschakeld voor een bepaald account. Gebruik hiervoor de onderstaande opdracht:
aws ec2 beschrijven-afbeeldingen --no-include-uitgeschakeld
Uitvoer
Voorbeeld 8: Hoe afbeeldingen in meerdere uitvoerformaten beschrijven?
Er worden meerdere uitvoerformaten ondersteund door de “beschrijf-afbeeldingen” commando. De indelingen omvatten YAML, JSON, tekst of tabel. Hieronder vindt u de opdracht voor het beschrijven van de afbeeldingen in tabelvorm:
aws ec2 beschrijven-afbeeldingen --uitvoer tafel
Vervang de 'tafel' waarde in het uitvoerveld in met een ander uitvoerformaat naar keuze, zoals JSON, YAML of tekst.
Uitvoer
druk op 'Binnenkomen' vanaf het toetsenbord om de gegevens te blijven weergeven:
Conclusie
De “beschrijf-afbeeldingen” commando in AWS retourneert een lijst met alle of specifieke AMI's voor een bepaald account. Het accepteert optionele parameters, bijvoorbeeld –query, –output, enz. De “beschrijf-afbeeldingen” command is nuttig voor AWS-ontwikkelaars omdat het hen helpt verschillende AMI's voor hun toepassingen te begrijpen en te kiezen. Voordat u de “beschrijf-afbeeldingen” opdracht, zorg ervoor dat de AWS CLI is geconfigureerd op uw lokale machines en geef vervolgens de genoemde opdrachten aan de terminal. Dit artikel geeft een diepgaand inzicht in de “beschrijf-afbeeldingen” commando met meerdere voorbeelden om de verschillende parameters ervan te bespreken.