Amazonin konekuva on malli, jota käytetään EC2-esiintymien käynnistämiseen. AMI on samanlainen kuin suunnitelma, joka sisältää käyttöjärjestelmän ja kaikki tarvittavat ohjelmistot tai sovelluskokoonpanot ilmentymiä varten. AMI:t voidaan rakentaa valmiiksi tai räätälöityjä. AWS CLI on tehokas apuohjelma kuvien käyttämiseen ja hallintaan yksinkertaisilla komennoilla, kuten 'kuvaile-kuvat' komento. The 'kuvaile-kuvat' -komentoa käytetään luetteloimaan kaikki tietylle tilille määritetyt AMI:t.
Quick Outline
Tässä artikkelissa opimme:
- Mikä on AWS CLI:n 'describe-images' -komento?
- Kuinka käyttää 'describe-images' -komentoa AWS CLI:ssä?
- Johtopäätös
Mikä on AWS CLI:n 'describe-images' -komento?
The 'kuvaile-kuvat' komento AWS CLI:ssä on sivutettu toiminto, jota käytetään luetteloimaan kaikki tai tietyt tilin AMI:t. Tuotos 'kuvaile-kuvat' komento on luettelomuodossa, joka sisältää tietoa eri kuvista. Nämä kuvat voivat olla julkisia, yksityisiä, käyttäjän määrittämiä tai AWS-hallittuja. AMI:n tietoihin päästään useissa API-kutsuissa palveluun, kun sivutus on käytössä.
Lue lisää: Kuinka poistaa sivu käytöstä AWS CLI:ssä?
Kuinka käyttää 'describe-images' -komentoa AWS CLI:ssä?
Rekisteröidyt kuvat ovat niitä, jotka on poistettu AWS:stä ja joita EC2-palvelu ja alusta eivät enää tue. Nämä kuvat ovat kuitenkin myös mukana julkaisussa 'kuvaile-kuvat' komento. Käyttäjä voi ohjata komennon tulosta suodattamalla, kyselemällä tai määrittämällä tietyn AMI:n jne. useiden eri parametrien avulla.
Syntaksi
Kohteen syntaksi 'kuvaile-kuvat' komento annetaan seuraavasti:
aws ec2 description-kuvat < Vaihtoehdot >
Vaihtoehdot
Tässä on lyhyt kuvaus yllä mainitun komennon vaihtoehdoista:
| Vaihtoehto | Kuvaukset |
| -suoritettavat käyttäjät | Tätä parametria käytetään poimimaan ja luetteloimaan AMI:t käyttäjän käyttöoikeuksien perusteella. Käyttäjä voi määrittää joko 'itse', 'kaikki' tai AWS-tilin tunnuksen. |
| – suodattimet | Parametrilla –filters luetellaan tietyt tiedot tai AMI:t tulosteessa. Tämä komento tukee erilaisia suodatintyyppejä: – nimi: Käyttäjä voi suodattaa AMI:t määrittämällä nimen. – omistajan tunnus: AWS-tilin tunnus voi myös suodattaa AMI:t kuvaamalla vain ne kuvat, jotka on määritetty tietyllä tilillä. – tag: Tunnisteet ovat avain-arvo-parien yhdistelmä. Määrittämällä tunnisteet käyttäjä voi helposti suodattaa tietyn tilin AMI:t. – kuvatunnus: Toinen tapa suodattaa AMI:t on määrittää kuvatunnus. Tämä listaa vain tietyn AMI:n. |
| -kuvatunnukset | Tämä parametri syöttää AMI:n tunnuksen. |
| – omistajat | Parametri –owner hyväksyy tilin tunnuksen, self-, amazon- tai aws-marketplace-asetukset. Nämä vaihtoehdot näyttävät vain ne AMI:t, jotka vastaavat tarkasti määritettyä vaihtoehtoa. |
| -sisällytä-poistettu | Tätä parametria käytetään määrittämään, luetellaanko vanhentuneet AMI:t vai ei. Vanhentuneet AMI:t ovat kuvia, joiden käyttöä ei enää suositella. |
| -sisällytä-pois käytöstä | Tämä kenttä määrittää, luetellaanko käytöstä poistetut AMI:t lähdössä vai ei. |
| -kuivaharjoittelu | -Dry-run-parametria käytetään määrittämään, onko käyttäjällä lupa haluttuun toimintoon vai ei. Se palauttaa tulosteen Error-muodossa. Lisäksi, jos käyttäjällä on käyttöoikeudet, tulos sisältää 'DryRunOperationin'. Jos käyttäjällä ei ole tätä lupaa, se palauttaa 'UnauthorizedOperation' ulostuloon. |
| –cli-input-json | Tätä parametria käytetään tarjoamaan useita JSON-käskyjä kerralla mallin muodossa AWS-palveluille. Seuraava malli luodaan parametrilla '–generate-cli-skeleton'. |
| -aloitusmerkki | Tämä parametri syöttää 'NextToken'-kentän arvon lähdöstä. NextToken symboloi, että listattavaa dataa on enemmän. Kun NextTokenin arvo annetaan -aloitustunnukselle, se alkaa listata edellisen vastauksen tiedot. |
| -sivun koko | Tämä parametri määrittää sivun koon jokaisessa palvelun AWS-palvelukutsussa. Pienempi sivukoko johtaa enemmän API-kutsuihin, jotka estävät aikakatkaisuvirheen. Se kuitenkin hakee vähemmän dataa jokaisessa puhelussa. |
| – tavaran enimmäismäärä | Parametria –max-items käytetään rajoittamaan tulosteessa näytettävien merkintöjen määrää. |
| – luo klii-luuranko | Se luo rungon tai mallin, jota on noudatettava, kun AWS-palvelulle annetaan useita ohjeita kerralla. |
Näiden vaihtoehtojen lisäksi AWS tarjoaa myös maailmanlaajuisia vaihtoehtoja. Yleiset valinnat ovat yhteisiä AWS CLI -komennolle, ja niitä voidaan käyttää eri komentojen kanssa. The AWS-dokumentaatio keskustelee erilaisista globaaleista vaihtoehdoista.
Esimerkkejä
Tässä artikkelin osassa käsitellään erilaisia esimerkkejä 'kuvaile-kuvat' komento AWS CLI:ssä:
- Esimerkki 1: Miten kuvata kuvia AWS CLI:ssä?
- Esimerkki 2: Kuinka kuvata kaikki kuvat AWS CLI:ssä?
- Esimerkki 3: Miten AMI kuvataan omistajatunnuksella AWS CLI:ssä?
- Esimerkki 4: Kuvien suodattaminen AWS CLI:ssä?
- Esimerkki 5: Kuinka kysyä AMI:tä AWS CLI:ssä?
- Esimerkki 6: Kuinka kuvailla vanhentuneita kuvia AWS CLI:ssä?
- Esimerkki 7: Miten kuvataan käytössä olevia tai käytöstä poistettuja kuvia AWS CLI:ssä?
- Esimerkki 8: Kuinka kuvata kuvia useissa tulostusmuodoissa?
Esimerkki 1: Miten kuvata kuvia AWS CLI:ssä?
The 'kuvaile-kuvat' -komentoa AWS CLI:ssä käytetään luetteloimaan tietyn tilin tietyn AMI:n tiedot. Tämä komento vaatii AMI:n kuvatunnuksen. Vieraile EC2-palvelussa ja napsauta 'MIKÄ' vaihtoehto vasemmasta navigointiruudusta. Valitse luotava kuva, niin se näyttää kuvan määritykset. Sisällä Yksityiskohdat -osio, kopioi ja tallenna AMI-tunnus:
Komento tietyn AMI:n luetteloimiseksi annetaan seuraavasti:
aws ec2 description-kuvat --alue ap-kaakkoon- 1 --kuva-tunnukset < AMIIkuvatunnus >
Korvata
Lähtö
Esimerkki 2: Kuinka kuvata kaikki kuvat AWS CLI:ssä?
Komento luetella kaikki AWS CLI:ssä saatavilla olevat kuvat on seuraava:
aws ec2 description-kuvat
Lähtö
Kaikkien kuvien luettelon näyttäminen kestää jonkin aikaa. Jatka -painikkeen painamista 'Tulla sisään' näppäimistön näppäin nähdäksesi kaikkien kuvien tiedot:
Esimerkki 3: Miten AMI kuvataan omistajatunnuksella AWS CLI:ssä?
AWS-tilillä määritetyt AMI:t voidaan määrittää myös omistajan tai tilitunnuksen perusteella. Tilitunnus voidaan määrittää napsauttamalla käyttäjänimeä AWS-hallintakonsolin oikeassa yläkulmassa. Klikkaa 'kopio' -kuvaketta tilin tunnuksen kopioimiseksi:
Komento mukautetaan lisäparametrilla seuraavasti:
aws ec2 description-kuvat --omistajat < Tilin tunnus >
Korvata
Lähtö
Esimerkki 4: Kuvien suodattaminen AWS CLI:ssä?
Saatavilla on erilaisia suodattimia tiettyjen kuvien yksityiskohtien poimimiseen. Käyttäjä voi suodattaa kuvat omistajan tunnuksen, kuvatunnuksen, tunnisteiden, nimen tai tilan jne. mukaan. Kuvan listaamiseksi sen nimen mukaan käytetään seuraavaa komentoa:
aws ec2 description-kuvat -- suodattimet 'Nimi=nimi, Arvot=ec2kuva'
Korvata 'ec2image' Arvoissa AMI:n nimellä.
Lähtö
AMI-tunnisteen avain-arvoparien arvo voidaan määrittää valitsemalla AMI AMI-kojelautasta. Tämä näyttää kuvan kokoonpanot. Napauta 'Tagit' välilehti ja kopioi avainarvokenttien arvot:
Suodattaaksesi kuvan sen tunnisteiden perusteella, annetaan alla oleva komento:
aws ec2 description-kuvat -- suodattimet 'Nimi=tunniste:ensimmäinen avain, arvot = ensimmäinen'
Korvata 'ensimmäinen avain' Nimi-kentässä avaimella. Vaihda samalla tavalla 'ensimmäinen' arvoissa tagin arvon kanssa.
Lähtö
Esimerkki 5: Kuinka kysyä AMI:tä AWS CLI:ssä?
Käyttäjä voi poimia kuvan tiettyjä yksityiskohtia näytettävästä luettelosta käyttämällä '-kysely' parametri. Komento annetaan seuraavasti:
aws ec2 description-kuvat --kysely 'Kuvat[*].[ImageId]'
Lähtö
Vastaavasti käyttäjä voi myös tiedustella kuvan tiettyjä yksityiskohtia määrittämällä kuvan tunnuksen kyselyparametrilla:
aws ec2 description-kuvat --kuvan tunnus < AMII:t > --kysely 'Kuva[*].[ImageType, Description, State]'
Lähtö
Esimerkki 6: Kuinka kuvailla vanhentuneita kuvia AWS CLI:ssä?
Vanhentuneet AMI:t ovat kuvia, joita ei enää suositella AWS:n käytettäväksi. Voit määrittää, mitkä kuvat ovat vanhentuneita, käyttämällä seuraavaa komentoa:
aws ec2 description-kuvat --include-deprecated
Lähtö
Vastaavasti käyttäjä voi myös määrittää '–ei sisällytä-poistettu' parametri listataksesi kaikki kuvat mukaan lukien vanhentuneet kuvat:
aws ec2 description-kuvat --ei-include-deprecated
Lähtö
Esimerkki 7: Miten kuvataan käytössä olevia tai käytöstä poistettuja kuvia AWS CLI:ssä?
The 'kuvaile-kuvat' -komentoa voidaan käyttää myös niiden kuvien luetteloimiseen, jotka on poistettu käytöstä tai joita ei ole poistettu käytöstä tilissä. Tämä auttaa käyttäjiä päättämään, mitä AMI:itä he käyttävät. Alla annettua komentoa käytetään tilin käytöstä poistettujen AMI:iden luetteloimiseen:
aws ec2 description-kuvat --sisällytä-pois käytöstä
Lähtö
Samoin, 'kuvaile-kuvat' komento palauttaa vain ne AMI:t, joita ei ole poistettu käytöstä tietylle tilille. Käytä tätä tarkoitusta varten alla olevaa komentoa:
aws ec2 description-kuvat --ei sisällytä-pois käytöstä
Lähtö
Esimerkki 8: Kuinka kuvata kuvia useissa tulostusmuodoissa?
Tukee useita tulostusmuotoja 'kuvaile-kuvat' komento. Muodot sisältävät YAML, JSON, teksti tai taulukko. Alla on komento kuvien kuvaamiseksi taulukkomuodossa:
aws ec2 description-kuvat --lähtö pöytä
Korvata 'pöytä' arvo tuloskentässä valitsemallasi eri tulostusmuodolla, kuten JSON, YAML tai teksti.
Lähtö
Lehdistö 'Tulla sisään' näppäimistöltä jatkaaksesi tietojen listaamista:
Johtopäätös
The 'kuvaile-kuvat' -komento AWS:ssä palauttaa luettelon tietyn tilin kaikista tai tietyistä AMI:istä. Se hyväksyy valinnaiset parametrit, kuten -query, -output jne 'kuvaile-kuvat' komento on hyödyllinen AWS-kehittäjille, koska se auttaa heitä ymmärtämään ja päättämään sovellustensa eri AMI:istä. Ennen kuin käytät 'kuvaile-kuvat' -komentoa, varmista, että AWS CLI on määritetty paikallisissa koneissasi, ja anna sitten mainitut komennot päätteelle. Tämä artikkeli tarjoaa perusteellisen käsityksen 'kuvaile-kuvat' komento useilla esimerkeillä keskustellaksesi sen eri parametreista.