View a markdown version of this page

Menggunakan AWS Marketplace API untuk berbagi sumber daya - AWS Marketplace
Prasyarat untuk dibagikan AWS Marketplace pengadaBagikan sebuah AWS Marketplace entitas

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

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

Menggunakan AWS Marketplace API untuk berbagi sumber daya

AWS Marketplace Catalog API terintegrasi dengan AWS Resource Access Manager (AWS RAM) untuk mengaktifkan berbagi sumber daya. Sumber daya adalah entitas yang dapat digunakan pengguna AWS Marketplace, seperti produk, penawaran, atau otorisasi penjualan kembali. Dengan AWS RAM, Anda dapat berbagi beberapa AWS Marketplace Catalog API sumber daya dengan yang lain Akun AWS. Anda berbagi sumber daya yang Anda miliki dengan membuat pembagian sumber daya. Pembagian sumber daya menentukan sumber daya yang ingin Anda bagikan dan konsumen yang akan dibagikan.

Prasyarat untuk dibagikan AWS Marketplace pengada

Sebelum berbagi entitas di AWS Marketplace Catalog API, Anda harus memenuhi prasyarat berikut:

  • Anda hanya dapat memiliki satu kebijakan sumber daya yang dilampirkan ke AWS Marketplace entitas Anda.

  • Untuk berbagi AWS Marketplace entitas, Anda harus memilikinya di entitas Anda Akun AWS. Persyaratan ini berarti bahwa entitas harus dialokasikan atau disediakan di akun Anda. Anda tidak dapat berbagi AWS Marketplace entitas yang telah dibagikan dengan Anda.

Bagikan sebuah AWS Marketplace entitas

Dengan berbagi AWS Marketplace sumber daya, pemilik entitas dapat berbagi entitas mereka dengan orang lain Akun AWS di AWS Marketplace. Entity-owners dapat menjadi ISV dan mitra saluran. Entitas yang dapat dibagikan adalah produk, penawaran, dan otorisasi penjualan kembali.

catatan

Saat ini, Anda hanya dapat berbagi entitas. Entitas AWS Marketplace termasukAmiProduct,Audience,BrandingSettings,ContainerProduct,Experience, danProcurementPolicy.

Untuk informasi selengkapnya AWS RAM, lihat Panduan AWS RAM Pengguna. Untuk informasi selengkapnya tentang mengelola sumber daya bersama, lihat Menggunakan AWS sumber daya bersama di Panduan AWS RAM Pengguna.

Sebagai akun berbagi, Anda dapat mengatur read-only atau keduanya read/write pada sumber daya yang ingin Anda bagikan. Izin ini menentukan operasi apa yang dapat dilakukan akun konsumsi pada sumber daya yang dibagikan dengannya.

  • Berbagi akun — Sumber daya yang dibagikan dan di mana AWS RAM administrator membuat pembagian AWS sumber daya dengan menggunakan AWS RAM.

  • Akun konsumsi — Yang Akun AWS menjadi sumber daya dibagikan. Pembagian sumber daya dapat menentukan seluruh akun sebagai prinsipal, atau untuk beberapa jenis sumber daya, peran individu, atau pengguna dalam akun.

Untuk berbagi AWS Marketplace entitas, Anda harus menambahkannya ke berbagi sumber daya. Berbagi sumber daya adalah AWS RAM sumber daya yang memungkinkan Anda berbagi sumber daya Akun AWS. Pembagian sumber daya menentukan sumber daya yang akan dibagikan, dan konsumen yang akan berbagi dengan mereka. Saat membagikan entitas menggunakan AWS Marketplace konsol, Anda menambahkannya ke pembagian sumber daya yang ada. Untuk menambahkan AWS Marketplace entitas ke pembagian sumber daya baru, Anda harus terlebih dahulu membuat pembagian sumber daya menggunakan AWS RAM konsol.

Anda dapat membagikan AWS Marketplace entitas yang Anda miliki menggunakan AWS Marketplace konsol, AWS RAM konsol, atau AWS Command Line Interface (AWS CLI).

Untuk berbagi AWS Marketplace entitas yang Anda miliki menggunakan AWS RAM konsol

Lihat Membuat Sumber Daya Bersama di Panduan Pengguna AWS RAM .

Untuk berbagi AWS Marketplace entitas yang Anda miliki menggunakan AWS CLI

Gunakan perintah create-resource-share.

catatan

Untuk jenis sumber daya seperti entitas yang mendukung kebijakan berbasis sumber daya, Anda dapat menggunakan AWS RAM untuk berbagi sumber daya untuk menggunakan fitur tambahan. AWS RAM Untuk informasi selengkapnya, lihat Resource-based kebijakan di Panduan AWS RAM Pengguna. AWS RAM menggunakan AWS Marketplace Catalog API untuk secara otomatis membuat kebijakan sumber daya dari izin dalam pembagian sumber daya dan mengelola kebijakan sumber daya tersebut untuk Anda.

Untuk informasi tentang cara menyetel, melihat, atau menghapus kebijakan AWS berbasis sumber daya pada AWS Marketplace entitas Anda AWS RAM, lihat Mengizinkan tindakan pada semua sumber daya di Panduan Pengguna. AWS RAM

Perbedaan antara berbagi entitas melalui AWS RAM dan AWS Marketplace Catalog API

Selain membagikan entitas Anda AWS RAM, Anda juga dapat mengatur, melihat, atau menghapus kebijakan AWS berbasis sumber daya pada entitas Anda melalui. AWS Marketplace Catalog API Namun, ada beberapa perbedaan antara berbagi entitas Anda melalui AWS RAM dan melalui AWS Marketplace Catalog API.

Saat Anda berbagi entitas melalui AWS RAM:

  • Jika Anda membagikan entitas Anda dengan akun yang berada di luar AWS Organizations, akun pengguna harus terlebih dahulu menerima permintaan berbagi Anda sebelum entitas dibagikan.

  • Akun konsumsi dapat menemukan entitas ListEntities bersama melalui OwnershipType set toSHARED.

  • Anda harus mematuhi beberapa kuota sumber daya. Untuk informasi selengkapnya, lihat Kuota layanan AWS RAM di Panduan AWS RAM Pengguna.

Saat Anda berbagi entitas melalui AWS Marketplace Catalog API:

  • Entitas Anda akan dibagikan segera setelah PutResourcePolicy permintaan berhasil tanpa masukan dari akun konsumsi.

  • Akun konsumsi tidak dapat menemukan entitas ListEntities bersama melalui OwnershipType set toSHARED. Sebagai gantinya, pemilik akun berbagi harus menginformasikan akun konsumsi dari ID entitas bersama.

catatan

Jika kasus penggunaan Anda memerlukan sumber daya berbagi yang mungkin melebihi kuota AWS RAM layanan, atau jika Anda ingin berbagi sumber daya tanpa masukan langsung dari akun yang dikonsumsi, pertimbangkan untuk berbagi melalui. AWS Marketplace Catalog API Untuk semua kasus penggunaan lainnya, pertimbangkan AWS RAM untuk menggunakan untuk berbagi AWS Marketplace sumber daya.

Bagian berikut merinci cara Anda dapat mengatur, melihat, atau menghapus kebijakan AWS berbasis sumber daya pada entitas Anda melalui. AWS Marketplace Catalog API

Lampirkan kebijakan hanya-baca ke sumber daya Anda

Anda dapat membuat kebijakan berbasis sumber daya baca saja di sumber daya bersama menggunakan akun berbagi. Dengan kebijakan ini, kepala sekolah hanya dapat melihat detail sumber daya yang dibagikan dengan mereka.

Permintaan

POST /PutResourcePolicy HTTP/1.1 
Content-type: application/json

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
   "Policy": { 
        "Version": "2012-10-17",
        "Statement": {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::222233334444:root"
            },
            "Action": [
                "aws-marketplace:DescribeEntity"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
            ]
        }
    }
}

Respons

HTTP/1.1 200
Content-type: application/json

{}

Lampirkan kebijakan sumber daya baca dan tulis ke sumber daya Anda

Sebagai akun berbagi, Anda dapat membuat kebijakan berbasis sumber daya baca dan tulis pada sumber daya bersama. Dengan kebijakan ini, kepala sekolah dapat melihat detail dan melakukan operasi tulis pada sumber daya yang dibagikan dengan mereka.

Permintaan

POST /PutResourcePolicy HTTP/1.1 
Content-type: application/json

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
   "Policy": { 
        "Version": "2012-10-17",
        "Statement": {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::222233334444:root"
            },
            "Action": [
                "aws-marketplace:DescribeEntity",
                "aws-marketplace:StartChangeSet"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
            ]
        }
    }
}

Respons

HTTP/1.1 200
Content-type: application/json

{}

Melihat kebijakan sumber daya yang ditetapkan pada sumber daya Anda

Sebagai akun berbagi, Anda dapat melihat kebijakan sumber daya yang ditetapkan pada sumber daya bersama.

Permintaan

POST /GetResourcePolicy HTTP/1.1 
Content-type: application/json

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}

Respons

HTTP/1.1 200
Content-type: application/json

{
  "Policy": { 
        "Version": "2012-10-17",
        "Statement": {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::222233334444:root"
            },
            "Action": [
                "aws-marketplace:DescribeEntity",
                "aws-marketplace:StartChangeSet"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
            ]
        }
    }
}

Menghapus kebijakan sumber daya pada sumber daya Anda

Sebagai akun berbagi, Anda dapat menghapus kebijakan sumber daya yang disetel pada sumber daya bersama.

Permintaan


POST /DeleteResourcePolicy HTTP/1.1 
Content-type: application/json

{
   "ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}

Respons

HTTP/1.1 200
Content-type: application/json

{}

Lihat semua sumber daya yang dimiliki oleh Anda dan dibagikan dengan Anda

Sebagai akun konsumen, Anda dapat melihat sumber daya yang dibagikan dengan Anda.

catatan

Anda dapat melihat sumber daya yang dibagikan dengan Anda hanya jika sumber daya dibagikan AWS RAM.

Permintaan


POST /ListEntities HTTP/1.1
Content-type: application/json
{
   "Catalog": "AWSMarketplace",
   "EntityType": "AmiProduct",
   "FilterList": [ 
      { 
         "Name": "EntityId",
         "ValueList": [ "example2-abcd-1234-5ef6" ]
      }
   ],
   "OwnershipType": "SHARED"
}

Respons

HTTP/1.1 200
Content-type: application/json

{ 
  "EntitySummaryList": [ 
    { 
      "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6",
      "EntityId": "example2-abcd-1234-5ef6",
      "EntityType": "AmiProduct",
      "LastModifiedDate": "2018-02-27T13:45:22Z",
      "Name": "TestProduct",
      "Visibility": "public" 
    } 
  ],
  "NextToken": "" 
}