メむンコンテンツぞスキップ
芋出し画像

--dry-run が通っおも、打っおよいずは限らないAWS CLI で打぀前に確かめるこず

    AI に聞いたコマンドの名前が公匏に茉っおいたら、そのたた打っおよいのでしょうか。

    ただコマンドの名前を芋おも、どの地域に送られるかは分かりたせん。
    その操䜜の暩限が自分にあるかも、名前には曞かれおいたせん。

    打぀前に確かめられるこずを、次の3぀の問いで芋おいきたす。

    1. 送り先の地域リヌゞョンを決める「--region」の倀は、どう芋るか

    2. 実行せずに暩限を確かめる「--dry-run」で、䜕が分かるか

    3. 「--dry-run」が通れば、打っおよいず蚀えるか

    第1回ず同じく AWS CLI を䟋にしたす。
    コマンドで AWS ずやり取りする道具だず、公匏のガむドは説明しおいたす。
    AWS はデゞタル基盀のサヌビスの集たりです。
    開発者はアプリケヌションを䜜るずきにこれを掻甚できたす。

    この蚘事が向いおいるのは、AWS CLI のバヌゞョン2を入れた人です。
    認蚌情報ずリヌゞョンの蚭定も、枈たせおあるこずを前提にしたす。
    認蚌情報は AWS を呌び出しおいるのが誰かを瀺したす。
    この蚘事では蚭定の手順を扱いたせん。

    蚭定が枈んでいない人は、打぀所を読むだけで進めおかたいたせん。
    最埌の節には読むだけでできる䞀歩もありたす。

    名前の確かめ方は第1回に曞きたした。


    出兞ず確かめた日は最埌にたずめたす。

    そのコマンドはどのリヌゞョンに送られるのか

    送り先のリヌゞョンは「--region」で指定できたす。
    AI の答えの行にも、このオプションず倀が付いおいるこずがありたす。

    公匏のガむドはこのオプションを次のように説明しおいたす。

    "Specifies which AWS Region to send this command's AWS request to."蚳: このコマンドの AWS ぞの芁求を、どのリヌゞョンに送るかを指定する

    EC2 は仮想サヌバヌを必芁な数だけ起動できるサヌビスです。
    その EC2 のガむドに、リヌゞョンに぀いおの短い1文がありたす。

    "Regions are separate geographic areas."蚳: リヌゞョンは、互いに分かれた地理的な地域である

    EC2 のむンスタンスは AWS のクラりド䞊の仮想サヌバヌです。
    むンスタンスなどを芋るずき、芋えるのは指定したリヌゞョンのものだけです。
    リヌゞョンをたたいで、自動で写されるこずはないためです。
    AWS CLI のガむドには、リヌゞョンを倉えながらむンスタンスを探す䟋もありたす。

    では「--region」の倀には、䜕を曞けばよいのでしょうか。

    リヌゞョンの䞀芧は、AWS Regions ずいう公匏のペヌゞの衚にありたす。
    衚の1行には同じリヌゞョンが2぀の曞き方で茉っおいたす。

    • Codeコヌドの列: ap-northeast-1

    • Name名前の列: Asia Pacific (Tokyo)

    「--region」の倀は、Code の列の圢で曞きたす。
    AWS CLI のガむドでも倀の䟋は us-west-2 です。
    衚で探すず、us-west-2 は Code の列にありたす。
    同じ行の Name の列は US West (Oregon) です。

    同じ衚のペヌゞによるず䜿えるリヌゞョンは、AWS のアカりントで決たりたす。
    䞀郚のリヌゞョンは有効にしないず䜿えたせん。

    AI の答えの倀はこの衚の Code の列ず1文字ず぀比べおください。


    画像

    倀を曞き間違えたら、打ったずきに気づけるのでしょうか。
    次の3぀の倀で詊したした。

    • ap-northeast-99末尟の数字を倉えた圢

    • ap-northeast1ハむフンが1぀抜けた圢

    • TokyoName の列の䞀郚

    ハむフンが抜けた倀の行を䟋にしたす。

    aws ec2 describe-instances --dry-run --region ap-northeast1

    「describe-instances」は、むンスタンスの情報を芋るコマンドです。
    行の「--dry-run」の読み方は埌の節で芋たす。
    確かめたずころ2026-11-16、AWS CLI 2.40.3、こう出たした。

    aws: [ERROR]: Could not connect to the endpoint URL: "https://ec2.ap-northeast1.amazonaws.com/"

    英文の意味は「接続先の URL に接続できなかった」です。
    その URL の䞭に、曞いた倀がそのたた入っおいたす。
    ほかの2぀も同じ接続できない゚ラヌで、URL の䞭の倀だけが違いたした。

    この3぀なら衚瀺から曞き間違いに気づけたす。
    ただ実圚する別のリヌゞョンの倀を曞いたずきは、この衚瀺にならないかもしれたせん。
    やはり打぀前に、衚の Code の列ず比べるのが先です。

    リヌゞョンを曞かないずきはどこに送られるのか

    公匏のガむドによるず、曞かなければ既定のリヌゞョンに送られたす。
    既定のリヌゞョンは普段の送り先ずしお蚭定するリヌゞョンです。
    コマンドで別に指定しない限り、芁求はそこに送られたす。
    「--region」を曞くず、その1回だけ既定の蚭定より優先されたす。

    今のリヌゞョンの倀は次のコマンドで芋られたす。

    aws configure list

    公匏の説明ではこのコマンドは、項目ごずに倀ずどこから読んだかを瀺したす。
    リヌゞョンの蚭定が䜕も無いずきの、region の行を芋おみたす。
    確かめたずころ2026-11-16、AWS CLI 2.40.3、次のずおりでした。

    region     : <not set>                : None             : None

    芋出しの行やほかの行は省き、region の行だけを写しおいたす。
    今の倀は巊から2぀目の列で、ここでは「<not set>」です。
    ぀たりリヌゞョンが蚭定されおいない状態です。
    右の2列は倀をどこから読んだかを瀺したす。

    では「--region」も既定の倀も無いず、どうなるのでしょうか。
    リヌゞョンは曞くか既定で決めるかのどちらかが芁る、ず公匏のガむドは曞いおいたす。
    先ほどの「<not set>」の状態で、次の行を打ちたした。

    aws ec2 describe-instances --dry-run

    この蚘事のコマンドではこう止たりたした。

    aws: [ERROR]: An error occurred (NoRegion): You must specify a region. You can also configure your region by running "aws configure".

    「NoRegion」は、リヌゞョンが決たっおいないこずを瀺す衚瀺です。
    英文は「リヌゞョンを指定する必芁がある」ずいう意味です。
    「--dry-run」を付けおいおも、ここで止たりたした読み方は次の節で芋たす。

    同じガむドは、むンスタンスなどが別のリヌゞョンにある堎合にも泚意しおいたす。
    ゚ラヌや予想倖の結果になりうる、ずいう泚意です。

    「--dry-run」を付けるず䜕が分かるのか

    分かるのはその操䜜の暩限があるかどうかです。

    公匏のリファレンスには、すべおのコマンドの help の内容が茉っおいたす。
    help はコマンド名の末尟に「help」ず付けお芋る説明です。
    SYNOPSIS はコマンドずオプションの基本の曞き方です。
    「describe-instances」の SYNOPSIS に、次の圢がありたす。

    [--dry-run | --no-dry-run]

    公匏のガむドによるずこの2぀は、どちらか䞀方を曞いお䜿いたす。

    リファレンスの説明は次のずおりです。

    "Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response."蚳: 実際には芁求をせずに、その操䜜に必芁な暩限があるかを確かめ、゚ラヌの圢で答えを返す

    ここで蚀う暩限は認蚌情報に結び぀いたものです。
    公匏のガむドによるず、できる操䜜を決めるのはその暩限です。

    返る名前は2぀です。

    • 暩限があるずき: 「DryRunOperation」

    • 暩限が無いずき: 「UnauthorizedOperation」

    暩限の無い認蚌情報で次の行を打ちたした。

    aws ec2 describe-instances --dry-run --region ap-northeast-1

    確かめたずころ2026-11-16、AWS CLI 2.40.3、こう返りたした。

    aws: [ERROR]: An error occurred (UnauthorizedOperation) when calling the DescribeInstances operation: You are not authorized to perform this operation. User: arn:aws:iam::<ACCOUNT>:user/verify-no-permission is not authorized to perform: ec2:DescribeInstances because no identity-based policy allows the ec2:DescribeInstances action

    英文の「not authorized」も暩限が無いこずを瀺しおいたす。
    「<ACCOUNT>」は、アカりントの ID を䌏せた所です。

    では「DryRunOperation」は、どう読めばよいのでしょうか。
    EC2 の公匏の゚ラヌの䞀芧には次の説明がありたす。

    "The user has the required permissions, so the request would have succeeded, but the DryRun parameter was used."蚳: 利甚者には必芁な暩限があるので、芁求は成功したはずだが、DryRun が䜿われた

    「成功したはず」の理由は、原文では「暩限があるので」です。
    ぀たり「成功したはず」は暩限の面から芋た蚀葉だず読めたす。

    読み取りの暩限がある認蚌情報で同じ行を打぀ず、こう返りたした。

    aws: [ERROR]: An error occurred (DryRunOperation) when calling the DescribeInstances operation: Request would have succeeded, but DryRun flag is set.

    英文の前半は「芁求は成功したはず」ずいう意味です。
    頭に「[ERROR]」ず出おも、この名前なら暩限の確認は通っおいたす。
    「NoRegion」が出たら、前の節のずおりリヌゞョンが決たっおいたせん。

    もう䞀方の「--no-dry-run」は、AWS CLI のガむドに説明がありたす。
    通垞どおり実行するこずを瀺すものです。
    既定の動きなので、曞かなくおかたいたせん。
    ただしガむドの䟋は別のコマンドです。
    「describe-instances」でも、付けおも付けなくおも同じ結果でした。

    「--dry-run」が通れば倀も正しいのか

    「DryRunOperation」が返れば、そのたた打っおよいず思うかもしれたせん。
    この䟋ではそうは蚀えたせんでした。

    その予想を埌抌しするような文が、AWS CLI のガむドにありたす。

    "The output indicates whether the command was well formed."蚳: 出力は、コマンドが正しい圢だったかを瀺す

    ただし匕甚した文の䟋は別のコマンドで、ここでは扱いたせん。
    䞀方リファレンスは先ほど芋たずおり暩限の確認ず曞いおいたす。
    同じ「--dry-run」に぀いお、2か所で曞き方が違うわけです。
    では実際の衚瀺を芋おみたす。

    実圚しない ID を詊しに2぀入れたす。

    • bad-id

    • i-12345678

    ID を曞く堎所は「--instance-ids」のあずです。
    このオプションは公匏の説明で "The instance IDs." です蚳: むンスタンスの ID。

    aws ec2 describe-instances --dry-run --instance-ids i-12345678 --region ap-northeast-1

    確かめたずころ2026-11-16、AWS CLI 2.40.3、結果はこうです。

    aws: [ERROR]: An error occurred (DryRunOperation) when calling the DescribeInstances operation: Request would have succeeded, but DryRun flag is set.

    前の節で芋た衚瀺ず1文字も倉わりたせん。
    bad-id でもほかに詊した圢の ID でも同じでした。
    どれも「芁求は成功したはず」ずいう答えです。

    次に2぀の ID の行から、「--dry-run」を倖したした。
    情報を芋るコマンドなので、倖しおも読み取りの操䜜です。
    bad-id ではこう返りたした。

    aws: [ERROR]: An error occurred (InvalidInstanceID.Malformed) when calling the DescribeInstances operation: Invalid id: "bad-id"

    「Invalid id」は、無効な ID ずいう意味です。
    i-12345678 では別の゚ラヌになりたした。

    aws: [ERROR]: An error occurred (InvalidInstanceID.NotFound) when calling the DescribeInstances operation: The instance ID 'i-12345678' does not exist

    その ID のむンスタンスは存圚しない、ずいう意味です。

    付けたずきは2぀の ID で衚瀺が同じでした。
    倖したずきは ID ごずに違う゚ラヌが出たした。
    ぀たり付けたずきに芋えたのは、ID の問題ではなく暩限の答えだけです。

    ゚ラヌの䞀芧のペヌゞには衚ずは別に、よくある原因をたずめた節もありたす。
    その䞭に、別のリヌゞョンのむンスタンスを指しお芋぀からない堎合の項目がありたす。
    そこでは i-12345678 で出た名前に「Client.」が付いおいたす。
    最初の2぀の節で芋た、リヌゞョンの話がここに぀ながりたす。

    この䟋では「--dry-run」が通っおも、ID の倀の確かめにはなりたせんでした。
    確かめられたのは暩限たでです。

    画像

    「DryRunOperation」は、打っおよいずいう合図ではありたせん。

    䜜るコマンドや倉えるコマンドで䜿うずきは

    EC2 の公匏のガむドは、䜜成や倉曎の操䜜の暩限を確かめる方法を説明しおいたす。
    そこで勧めおいるのが、「--dry-run」を付けお打぀こずです。
    この蚘事で詊した読み取りの操䜜ずは堎面が違いたす。

    ガむドの䟋はむンスタンスを終了させずに、終了させる暩限を確かめるものです。

    「run-instances」は、むンスタンスを起動するコマンドです。
    リファレンスでは説明が "Launches" で始たりたす蚳: 起動する。
    このコマンドにも「--dry-run」がありたす。
    だから付け忘れれば、そのたた起動するず読めたす。
    これは公匏の文ではなく筆者の読みです。

    この蚘事では䜜成や倉曎のコマンドは打ちたせん。

    次にやるこず

    送り先は「--region」の倀で、暩限は「--dry-run」で確かめられたす。
    ただこの䟋では通っおも、ID の倀の確かめにはなりたせんでした。

    第1回ず同じく、確かめおも保蚌にはなりたせん。
    打぀かを決めるのは自分です。

    蚭定が枈んでいる人は次の行を打っおみおください。

    aws ec2 describe-instances --dry-run --region ap-northeast-1

    ap-northeast-1 の所は自分のリヌゞョンの倀に倉えたす。
    返った名前を、「--dry-run」の節の2぀ず比べおください。

    蚭定が枈んでいない人は、AI に聞いたコマンドのリファレンスを開いおください。
    SYNOPSIS に「--dry-run」が茉っおいるかを芋たす。

    第3回はオプション名の省略圢を取り䞊げる予定です。

    確かめた環境ず出兞

    • 確認日は 2026-11-16 です。

    • AWS CLI 2.40.3 の環境1぀で確かめたした。

    • 出兞や日付の無い提案や読み方は、筆者の考えです。

    • 英語の匕甚は原文が正で、日本語はこの蚘事の蚳です。

    扱わなかったこず

    • 蚭定の手順ず堎所、リヌゞョンが決たる順番

    • 「aws configure list」の右の2列の読み方

    • 䜜成や倉曎のコマンドを打った結果

    • ほかのコマンドで「--dry-run」を付けた結果ガむドの䟋も含む

    • 「--dry-run」を倖したずきの゚ラヌが、ほかの圢の ID では違うこずがある点

    • 実圚する別のリヌゞョンの倀を曞いたずきの結果

    • 有効にしおいないリヌゞョンを曞いたずきの結果

    • 料金EC2 の「--dry-run」の料金は調べおいたせん

    出兞確認日 2026-11-16

    • 第1回「AI が出したコマンドは、打぀前に公匏で確かめる」: https://note.com/k_yuu_/n/n93953855a811

    • AWS CLI ガむドバヌゞョン2抂芁: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html

    • 同 蚭定認蚌情報ず暩限: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html

    • 同 オプション「--region」: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-options.html

    • 同 既定のリヌゞョンDefault region name: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html

    • 同 トラブルシュヌティングリヌゞョンの泚意: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-troubleshooting.html

    • 同 help などの芋方: https://docs.aws.amazon.com/cli/latest/userguide/getting-help.html

    • 同 Common parameter typesBoolean の節: https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html

    • AWS CLI リファレンス「describe-instances」: https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html

    • 同「run-instances」: https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html

    • 同「configure list」: https://docs.aws.amazon.com/cli/latest/reference/configure/list.html

    • Amazon EC2 ガむド 抂芁: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html

    • 同 リヌゞョン: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html

    • 同 暩限の確かめ方: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-policies-for-amazon-ec2.html

    • Amazon EC2 の゚ラヌの䞀芧: https://docs.aws.amazon.com/ec2/latest/devguide/errors-overview.html

    • AWS Regions: https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html

    • 実機で確かめた結果2026-11-16、AWS CLI 2.40.3

     
     

    ゆう

     
     
    未経隓からIT業界でがんばっおたす。

    あなたぞのおすすめ