View a markdown version of this page

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

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

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

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

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

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

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

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

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

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

    {
  "Version": "2012-10-17",
    "Statement": [{
            "Sid": "BenefitsManagement",
            "Effect": "Allow",
            "Action": [
                "partnercentral:ListBenefits",
                "partnercentral:GetBenefit",
                "partnercentral:CreateBenefitApplication",
                "partnercentral:AmendBenefitApplication",
                "partnercentral:UpdateBenefitApplication",
                "partnercentral:SubmitBenefitApplication",
                "partnercentral:GetBenefitApplication",
                "partnercentral:CancelBenefitApplication",
                "partnercentral:RecallBenefitApplication",
                "partnercentral:ListBenefitApplications",
                "partnercentral:AssociateBenefitApplicationResource",
                "partnercentral:DisasssociateBenefitApplicationResource",
                "partnercentral:ListBenefitAllocations",
                "partnercentral:GetBenefitAllocation",
                "partnercentral:TagResource",
                "partnercentral:UntagResource",
                "partnercentral:ListTagsForResource"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "AWSPartnerOpportunityAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:GetAwsOpportunitySummary",
                "partnercentral:GetOpportunity",
                "partnercentral:ListOpportunities"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "Sandbox"
                    ]
                }
            }
        },
        {
            "Sid": "ListingAWSMarketplaceEntities",
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:ListEntities"
            ],
            "Resource": "*"
        },
        {
            "Sid": "AWSMarketplaceOffersAccess",
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:DescribeEntity"
            ],

            "Resource": [
                "arn:aws:aws-marketplace:::AWSMarketplace/Offer/*"
            ]
        },
        {
            "Sid": "S3PutObjectAccess",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject"
            ],
            "Resource": ["arn:aws:s3:::aws-partner-central-marketplace-ephemeral-writeonly-files/*"]
        },
        {
            "Sid": "TaggingAccess",
            "Effect": "Allow",
            "Action": [
                "partnercentral:TagResource",
                "partnercentral:UntagResource",
                "partnercentral:ListTagsForResource"
            ],
            "Resource": [
                "arn:aws:partnercentral:us-east-1:*:catalog/Sandbox/benefit-application/*",
                "arn:aws:partnercentral:us-east-1:*:catalog/Sandbox/benefit-allocation/*"
            ],
            "Condition": {
                "StringEquals": {
                    "partnercentral:Catalog": [
                        "Sandbox"
                    ]
                }
            }
        }
    ]
}

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

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

AWSアクションのテスト

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

メリットアプリケーションの作成のシミュレーション

メリットアプリケーションの作成をシミュレートするには、CreateBenefitApplicationアクションのペイロードで、ペイロード"catalog": "Sandbox"に を含めます。

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

{
  "Catalog": "Sandbox", 
  "ClientToken": "String", 
  "BenefitIdentifier": "String", 
  "FulfillmentTypes": ["String"],
  "BenefitApplicationDetails": JsonDocument,
  "Name": "String",
  "Description": "String",
  "Tags": [
    { 
      "Key": "string",
      "Value": "string"
    }
  ],
  "PartnerContacts": [ 
    { 
      "BusinessTitle": "string",
      "Email": "string",
      "FirstName": "string",
      "LastName": "string",
      "Phone": "string"
    }
  ],
  "FileDetails": [
    {
      "FileURI": "String", 
      "BusinessUseCase": "String"
    }
  ],
  "AssociatedResources": [
    {
      "ResourceType": "BENEFIT_ALLOCATION | OPPORTUNITY",
      "ResourceArn": "ARN"
    }
  ] 
}

その他のテストノート

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

  2. サンドボックスカタログと AWS カタログの特典 IDs は異なります。で GetBenefit API コールを行い"catalog": "Sandbox"、サンドボックスでメリット識別子を取得します。

  3. サンドボックスカタログと AWS カタログの利点の割り当ては異なります。

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

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

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

イベントルールの例:

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

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