View a markdown version of this page

Pengujian di kotak pasir untuk AWS API Manfaat Sentral Mitra - AWS Pusat Partner
Cara menggunakan kotak pasirPengujian AWS tindakanCatatan pengujian tambahanMenguji peristiwa di lingkungan kotak pasir

Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi Pusat Partner AWS API.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pengujian di kotak pasir untuk AWS API Manfaat Sentral Mitra

Cara menggunakan kotak pasir

Untuk menggunakan kotak pasir, selesaikan langkah-langkah berikut:

  1. Buat peran IAM:

    Buat peran IAM dalam Akun AWS tautan dengan akun Pusat AWS Mitra Anda.

  2. Tetapkan Kebijakan:

    Tetapkan kebijakan berikut ke peran IAM. Untuk informasi selengkapnya, lihat Menambahkan dan menghapus izin identitas 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. Gunakan kredenal peran IAM:

    Gunakan kredensi (kunci rahasia dan kunci akses) peran IAM ini dalam solusi Anda untuk melakukan tindakan API.

Pengujian AWS tindakan

Selama fase pengujian, seringkali perlu untuk mensimulasikan AWS tindakan. Simulasi ini memungkinkan mitra untuk menguji secara menyeluruh aliran end-to-end lengkap integrasi mereka dengan layanan.AWS Setiap permintaan menyertakan parameter katalog, yang menentukan lingkungan data.

Mensimulasikan pembuatan Aplikasi Manfaat

Untuk mensimulasikan pembuatan aplikasi manfaat, dalam muatan CreateBenefitApplication tindakan, termasuk "catalog": "Sandbox" dalam muatan.

Contoh:

{
  "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"
    }
  ] 
}

Catatan pengujian tambahan

  1. Untuk menguji tindakan lain, atur "catalog": "Sandbox" di payload.

  2. ID Manfaat dalam katalog Sandbox dan katalog AWS berbeda. Lakukan panggilan GetBenefit API "catalog": "Sandbox" untuk mendapatkan Pengenal Manfaat di Kotak Pasir.

  3. Alokasi Benefit dalam katalog Sandbox dan katalog AWS berbeda.

  4. Untuk pindah ke produksi, ubah nilai katalog dari Sandbox keAWS.

Menguji peristiwa di lingkungan kotak pasir

Mitra dapat menggunakan peristiwa dari lingkungan kotak pasir untuk membantu menguji implementasi berbasis peristiwa. Siapkan EventBridge sama Akun AWS dengan aturan untuk mendengarkan acara kotak pasir dengan menentukan catalog: Sandbox detail acara. Untuk informasi selengkapnya, lihat Pemberitahuan untuk AWS API Manfaat Sentral Mitra.

Contoh aturan acara:

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

Aturan peristiwa yang ditentukan catalog sebagai hanya Sandbox akan cocok dengan peristiwa yang berasal dari kotak pasir, yang dihasilkan oleh tindakan yang Anda lakukan di lingkungan kotak pasir.