View a markdown version of this page

AWS Partner Central Channel API のサンドボックスでのテスト - AWS Partner Central
サンドボックスの使用方法AWSアクションのテストその他のテストノートサンドボックス環境でのイベントのテストヘルプの利用

AWS パートナーセントラル API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、 AWS パートナーセントラル API リファレンスを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Partner Central Channel API のサンドボックスでのテスト

サンドボックス内のアカウントはチャネル特典の対象ではなく、すべてのプログラム要件に対して検証されるわけではありません。

サンドボックスの使用方法

サンドボックスを使用するには、次の手順を実行します。

  1. IAM ロールを作成します。

    AWS Partner Central アカウントにリンクAWS アカウントされた に IAM ロールを作成します。

  2. ポリシーの割り当て:

    IAM ロールに次のポリシーを割り当てます。詳細については、「Adding and removing IAM identity permissions」(IAM アクセス許可の追加と削除) を参照してください。

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ChannelManagement",
      "Effect": "Allow",
      "Action": [
        "partnercentral:CreateProgramManagementAccount",
        "partnercentral:UpdateProgramManagementAccount",
        "partnercentral:DeleteProgramManagementAccount",
        "partnercentral:ListProgramManagementAccounts",
        "partnercentral:GetProgramManagementAccount",
        "partnercentral:CreateRelationship",
        "partnercentral:UpdateRelationship",
        "partnercentral:DeleteRelationship",
        "partnercentral:GetRelationship",
        "partnercentral:ListRelationships",
        "partnercentral:CreateChannelHandshake",
        "partnercentral:AcceptChannelHandshake",
        "partnercentral:RejectChannelHandshake",
        "partnercentral:CancelChannelHandshake",
        "partnercentral:ListChannelHandshakes"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "partnercentral:Catalog": [
            "Sandbox"
          ]
        }
      }
    },
    {
      "Sid": "TaggingAccess",
      "Effect": "Allow",
      "Action": [
        "partnercentral:TagResource",
        "partnercentral:UntagResource",
        "partnercentral:ListTagsForResource"
      ],
      "Resource": [
        "arn:aws:partnercentral:*:*:catalog/Sandbox/program-management-account/*",
        "arn:aws:partnercentral:*:*:catalog/Sandbox/channel-handshake/*"
      ],
      "Condition": {
        "StringEquals": {
          "partnercentral:Catalog": [
            "Sandbox"
          ]
        }
      }
    }
  ]
}

  3. IAM ロールの認証情報を使用します。

    ソリューションでこの IAM ロールの認証情報 (シークレットキーとアクセスキー) を使用して API アクションを実行します。

AWSアクションのテスト

テストフェーズでは、多くの場合、AWSアクションをシミュレートする必要があります。このシミュレーションにより、パートナーはAWSサービスとの統合の完全なend-to-endフローを徹底的にテストできます。各リクエストには、データ環境を決定するカタログパラメータが含まれています。

プログラム管理アカウントの作成のシミュレーション

プログラム管理アカウントの作成をシミュレートするには、 CreateProgramManagementAccountアクションのペイロードで、ペイロード"catalog": "Sandbox"に を含めます。

例えば、次のようになります。

{
  "catalog": "Sandbox",
  "accountId": "123456789012",
  "displayName": "Test PMA Name",
  "clientToken": "123abc456def789ghi",
  "program": "SOLUTION_PROVIDER",
  "tags": [
    {
      "key": "testkey",
      "value": "testvalue"
    }
  ]
}

関係の更新をシミュレートする

関係の更新をシミュレートするには、ペイロード"catalog": "Sandbox"で で UpdateRelationshipアクションを使用します。

例えば、次のようになります。

{
  "catalog": "Sandbox",
  "displayName": "Updated Test PMA",
  "identifier": "rs-abc123def456g",
  "programManagementAccountIdentifier": "pma-123abc456def7"
}

その他のテストノート

  1. 他のアクションをテストするには、ペイロード"catalog": "Sandbox"で を設定します。

  2. 本番稼働に移行するには、カタログ値を Sandbox から に変更しますAWS。

サンドボックス環境でのイベントのテスト

パートナーはサンドボックス環境のイベントを使用して、イベントベースの実装をテストできます。イベントの詳細で を指定してサンドボックスイベントをリッスンするルールAWS アカウントを使用して、同じ catalog: Sandbox で EventBridge を設定します。詳細については、「AWS Partner Central Channel API の通知」を参照してください。

イベントルールの例:

{
  "source": ["aws.partnercentral-channel"],
  "detail": {
    "catalog": ["Sandbox"]
  }
}

catalog として を指定するイベントルールSandboxは、サンドボックス環境で実行するアクションによって生成されたサンドボックスからのイベントのみと一致します。

ヘルプの利用

テストで課題が発生した場合、またはここで説明されていない特定のシナリオをテストする必要がある場合は、次の手順でケースを提起して サポートにお問い合わせください。

  1. Partner Network 認証情報を使用してAWS Partner AWS Central にサインインします。

  2. Partner Central のサポートセンターで、新しいケースのログOpen New Case記録を選択します。フィールドに以下のように入力します。

    1. サポートケースのタイプ: Channel Program

    2. 以下に関する質問: General Program Inquiry

    3. 詳細: 最も適切なチャネルケースタイプを選択します。

    4. 件名: リクエストの簡単な説明を含めます。

    5. 説明: 問題、質問、エラー、トラブルシューティング手順の詳細な説明を入力します。

    6. 添付ファイル: 必要に応じて、ログとスクリーンショットを含めます。