今年の AWS サービス名前空間、今年のうちに。 2021

コンバンハ、千葉（幸）です。

2021 年ももう終わりますね。今年も AWS では様々な サービス、新機能が発表されました。

果てして AWS サービス名前空間は何個増えて、トータルで何個あるのか？考えたことはあるでしょうか。

……え？違いますよ、わたしがしているのは AWS サービスの話ではなくAWS サービス名前空間の話です。

AWS サービスは「何を持って AWS サービスと呼ぶか」という曖昧さが付き纏うので、正確な数をカウントするのは難しいでしょう。その点 AWS サービス名前空間は定義が明確なので、カウントするには持ってこいです。一年に一回くらいは思いを馳せてみましょう。

ちなみにわたしの中での 2021 年に増えた AWS サービス名前空間 Best 3 は以下です。

1. rbin
2. mediaimport
3. ssm-guiconnect

上記はいずれも何かしらの新サービス、新機能をきっかけに追加された名前空間ですが、該当する「きっかけ」が何か思い浮かぶでしょうか？

初見で 3 つとも正解した人は、今から自己の責任において AWS マスターを名乗ってもいいですよ。

まとめ

• 2021/12/30 時点で確認できる AWS サービス名前空間は 300 個
• 2021 年に増加した AWS サービス名前空間は 40 個くらい
• AWS サービス名前空間が増えても API は増えない時もある

AWS サービス名前空間とは何か

先に名前空間とは何かをおさらいすると、AWS 用語集では以下のように定義されています。

保持する項目 (名前、技術用語、または単語) のコンテキストを提供し、複数の異なる名前空間に存在する同音異義語項目のあいまい性解消を可能にする抽象的なコンテナ。

• AWS 用語集 - AWS 全般のリファレンス

AWS サービス名前空間とは、その名の通り AWS サービスを一意に特定するために用いられる名前空間です。ARN （Amazon Resource Name）や IAM のポリシーステートメントで意識する機会が多いです。

例えば ARN では左から 3 番目のセクションのs3やiamが AWS サービス名前空間です。

arn:aws:s3:::my_corporate_bucket
arn:aws:iam::123456789012:user/Test

IAM ポリシーの中ではActionやConditionで登場します。ここではサービスプレフィックスという呼ばれ方もします。

# Action で用いるアクションの例
ec2:CreateVpc
s3:GetObject

# Condition で用いる条件キーの例
iam:AWSServiceName
rds:DatabaseName

完全には一致していませんが、AWS CLI のコマンドの名称（aws s3やaws ec2）としても用いられることが多いです。

AWS サービスと AWS サービス名前空間は 1 対 1 の関係にはなっていません。例えばec2という名前空間の中に Amazon VPC のリソースやアクションが含まれていたり、ひとつの AWS サービスの中で複数の名前空間に分かれているということもあります。

AWS サービス名前空間一覧をどう確認するか

唯一の手段ではないと思いますが、手軽さからわたしはいつも以下のコマンドで確認しています。

i=`aws iam generate-service-last-accessed-details --arn arn:aws:iam::aws:policy/AdministratorAccess --output text` && sleep 1 && aws iam get-service-last-accessed-details --job-id $i --max-items 1000  | jq -c '.ServicesLastAccessed[] | [.ServiceName,.ServiceNamespace]'

改行を挟むと以下の形式です。

i=`aws iam generate-service-last-accessed-details --arn arn:aws:iam::aws:policy/AdministratorAccess --output text`\
&& sleep 1\
&& aws iam get-service-last-accessed-details --job-id $i --max-items 1000\
  | jq -c '.ServicesLastAccessed[] | [.ServiceName,.ServiceNamespace]'

ここでは以下のコマンドを組み合わせています。

• generate-service-last-accessed-details — AWS CLI 2.4.7 Command Reference
• get-service-last-accessed-details — AWS CLI 2.4.7 Command Reference

簡単に言うと「指定した IAM リソースがアクセス可能な AWS サービスと過去のアクセス実績を表示してくれる」コマンドで、マネジメントコンソールでは「アクセスアドバイザー」を参照するのと同等の操作です。

（ほぼ）すべての操作が可能な AWS 管理ポリシーAdministratorAccessを指定して実行することで、その時点で有効な AWS サービス名前空間を確認できます。

過去に書いた以下エントリで取り上げています。

re:Invent 期間はこまめに叩くと捗る

re:Invent は言うまでもなく新サービス、新機能の発表が多い期間です。新サービスが発表されたらすぐカスタマーがそれを触ることができるということは、関連する API などは事前に用意されているということです。新たな API は大抵の場合新たな名前空間に作成されます。

そのため、正式な発表の前から名前空間を確認できることが多いです。2021年で一番最後に追加された AWS サービス名前空間はamplifyuibuilderで、先述のコマンドの結果においては紐づく AWS サービス名がAWS Amplify UI Builderとして表示されます。これは 12/2 に追加されたことを確認しました。

この名前空間に対応するのは日本時間 12/3 のキーノートで発表された AWS Amplify Studio です。キーノートでの発表の数時間前から新しい名前空間が確認できるので、眺めていると楽しいです。

2021 年末の AWS サービス名前空間一覧

2021/12/30 に実行したコマンドをベースに、一覧を記します。「2021」列に「●」が付与されているのが 2021 に追加されたものです。一部の名前空間はいつ追加されたのか確認ができなかったので、漏れがある可能性はあります。

名前空間のアルファベット順で並んでいます。300 個あるので覚悟してスクロールしてください。

お疲れ様でした。

2021 年に追加された AWS サービス名前空間一覧

上記の一覧で「●」が付与されている行を抽出し、追加された日付を基準にソートしました。追加された日付は後から調べられる範囲で振っているものなので、多少ズレている可能性があります。新サービス・新機能の発表時を基本としています。

「re:」という列で「●」が付いているのは re:Invent 期間に追加されたことを表します。

また、「リンク」列では関連する新サービス・新機能に関するページをリンクさせています。

冒頭で載せた個人的ランキングは何に該当するのか、興味がある方は確認してみてください。ランキングの理由も載せておきます。

1. rbin：名前が好き
2. mediaimport：名称から何に使うのかが全く想像できない
3. ssm-guiconnect：こういう新機能の場合に名前空間が増えるんだなという気づき

サービス名前空間からサービスや機能を確認する手段

今回の一覧をどう作ったか、という部分です。

Service Authorization Reference

基本的には以下リファレンスを参照します。

• Actions, resources, and condition keys for AWS services - Service Authorization Reference

コマンドから得られる AWS サービス名に対応するもののページが用意されています。内訳を見るとアクションやリソースが書かれているので、大体推測できます。

アクションに記載されていても該当する API が無い場合もあります。権限を与えるためにだけ存在するアクションです。例えばiam:PassRoleは ec2:RunInstancesなどで AWS サービスに IAM ロールを割り当てるときに必要になる権限ですが、単独で実行されるものではないため該当する API はありません。名前空間が増えてもそこで定義されているのが「権限のみ」のアクションの場合もあります。

また、ページ上部で関連する AWS ドキュメントがリストされており、そこから該当ページに遷移できます。

mediaimportのリファレンスページから関連ドキュメントに飛んだ際に RDS のページが表示された時は意表を突かれました。（よくよく調べたら意味が分かった。）

AWS CLI v1 の CHANGELOG

新しい API が追加される時、付随して AWS CLI v1 でコマンドが追加されることが多いです。（v2 はちょっと遅れることが多い。）

名前空間で検索すればどのバージョンで追加されたかが分かるので、あとは History からバージョンが追加された日時を確認すれば OK です。

AWS API Changes（非公式）

API の変更履歴を表示してくれるサイトです。本家の API の変更履歴を参照して表示してくれていますが、このサイト自体は公式のものではありません。

• AWS API Changes

トップページは直近の変更しか表示されませんが、パスとして/archive/service/＜サービス名前空間＞を指定するとサービス名前空間単位で履歴を確認できます。

Service Authorization Reference では（権限のみでない）アクションが記載されているがこのサイトでは API の変更履歴が確認できない、ということも何度かありました。唯一のソースとせず色々組み合わせて使いましょう。

おまけ：2020年10月時点と 2021年12月時点の一覧の比較

キリ良く 2020年12月末の情報が手元にあったらよかったのですが、少し早めの10月時点の物しか用意できませんでした。

両者を比較した画像を貼っておきます。

• 左：2021/12/2
• 右：2020/10/5

ここで差分が出ているが「2021 年に追加された AWS サービス名前空間一覧」に載っていないものを抽出して載せておきます。

2020 の re:Invent でプレビューリリースされ、2021 に GA になったものもいくつかありますね。

日付が「？」になっているものは追加されたタイミングが確認できなかったものです。2021年に追加された可能性もあります。自力では調べきれなかったので、答えが分かる方はこっそり教えていただけると嬉しいです。

これで安心して年を越せる

2021 年末時点の AWS サービス名前空間一覧を確認してみました。

一年に数十個増えていると考えると恐ろしいですね。来年はどのくらい増えるのでしょうか。

AWS サービスが増えたとき、そのサービスでどのようなリソースやアクションが用意されているのか？を確認するとより深掘りできると思います。重視すべきは AWS サービスではなく AWS サービス名前空間、覚えておいてください。（個人の感想です。）

ちなみにわたしの推し名前空間はtirosです。皆さんもお気に入りの名前空間を見つけてくださいね！！！！！！

以上、 チバユキ (@batchicchi) がお送りしました。よいお年を。