こんにちは、エンジニアの君島です。
AWS パートナーならご存知、パートナーセントラルにAPIができました。オポチュニティの管理や自社CRMへの組み込みなど、いくつかの応用が考えられそうですね。
APIを使って色々する前にAWS CloudShellで疎通と動作の確認をしてみましょう。
目次
事前準備
概要
API利用するためには大きく分けて3つのステップがあります。
- AWS Marketplace Seller アカウントを Partner Central にリンク
- IAM で権限設定
- 署名バージョン 4 (SigV4) を使用して API 呼び出し認証
この通りであれば、アドミン権限でAWS CloudShellで疎通確認しようと思った時は権限やAPI認証は省略できそうです。実際にやってみましょう。
AWS Marketplace セラーアカウントを Partner Central にリンク
APNポータルでのユーザー設定
APNポータルにアクセスしてリンクしてみましょう。
ただし、アライアンスチームの権限だけでは以下のように権限が足りていないようです。
APNポータル上で、権限のあるユーザーに依頼をして、Cloud adminの権限を自分のユーザーに追加してもらいましょう。Manage rolesの画面でこのように出ていればOKです。
APNポータルとセラーアカウントとの紐づけ
APNポータルとセラーアカウントとの紐づけをするにあたって、確認ダイアログがでてきますが、そのまま続行しましょう。
画面下部の方にAWS Marletplace accountのエリアがあるので、そこからMarketplace Sellerアカウントの情報を登録してください。
AWS CloudShellから疎通確認してみよう
実践編
Adminアクセスできるようなユーザーでマネコンに入ってAWS CloudShellを開いてみましょう。
サンドボックスでテストしたい場合はcatalogにSandboxを指定します。
catalogをAWSにすれば本番、つまりは自社のパートナーセントラルで登録してある情報を参照することができるようになります。ということで、基本的にはSandboxを指定して検証を進めましょう。動作が確保できるようになってから、向き先を本番に切り替えるのがいいでしょう。
では、早速Sandbox向けに試してみましょう。
例えば、オポチュニティをリストするには以下のようなコマンドを打ってみると、結果が返ってきます。
|
1 |
aws partnercentral-selling list-opportunities --catalog Sandbox |
ちなみにAmazon Qのサポートをオンにしましたが、まだまだデータが少ないのか、partnercentral-sellingでの入力補助はなかなか利用が難しいかもしれません。
制約
AWS CloudShellとはいえ、以下の条件を満たしてないと正常に結果が返らないのでご注意ください。
- リージョンはus-east-1
- AWSアカウントはMaketplace Seller アカウント
これらを満たさない状態では、そもそもエンドポイントにアクセスできないようですね。コマンドを実行しても以下のようにエラーになってしまいます。
まとめ
AWS Partner Central API for Sellingを使用するための準備と、AWS CloudShellを使った疎通確認の方法をまとめてみました。
Marketplace Sellerアカウントの設定が必要なので、誰もが試すことができるというような内容ではないかもしれませんが、今度は応用をしてみたいですね。
- オフィスにかかってきた電話の内容を生成AIにかませて議事録作成を自動化する - 2024-12-25
- AWS Partner Central API for Sellingを使うための準備と疎通確認してみた - 2024-12-25
- Amazon Bedrockでコード生成したスタンプラリーアプリをAWS Summit Japanで展示するまで - 2024-12-17
- AWS CloudShellでAmazon Q使えんの - 2024-12-08
- Pascalについて調べたまとめ - 2024-12-08
【採用情報】一緒に働く仲間を募集しています
