Se reestructuró la referencia de API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la [referencia de API de AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso de AWS Marketplace API para compartir recursos
AWS Marketplace Catalog API se integra con AWS Resource Access Manager (AWS RAM) para permitir el intercambio de recursos. Un *recurso* es una entidad con la que los usuarios pueden trabajar AWS Marketplace, como un producto, una oferta o una autorización de reventa. Con AWS RAM, puede compartir algunos AWS Marketplace Catalog API recursos con otros Cuentas de AWS. Puede compartir los recursos que posea creando un *Uso compartido de recursos*. Un recurso compartido especifica los recursos que desea compartir y los consumidores con los que compartirlos.
**Topics**
+ [Requisitos previos para compartir AWS Marketplace entities](#sharing-prereqs)
+ [Comparte un AWS Marketplace entidad](#share-marketplace-entity)
## Requisitos previos para compartir AWS Marketplace entities
Antes de compartir entidades AWS Marketplace Catalog API, debe cumplir los siguientes requisitos previos:
+ Solo puede tener una política de recursos asociada a su AWS Marketplace entidad.
+ Para compartir una AWS Marketplace entidad, debes poseerla en tu Cuenta de AWS. Este requisito significa que la entidad debe estar asignada o aprovisionada en tu cuenta. No puedes compartir una AWS Marketplace entidad que se haya compartido contigo.
## Comparte un AWS Marketplace entidad
Al compartir AWS Marketplace recursos, los propietarios de las entidades pueden compartir sus entidades con otras Cuentas de AWS personas AWS Marketplace. Entity-owners pueden ser ISV y socios de canal. Las entidades que se pueden compartir son los productos, las ofertas y las autorizaciones de reventa.
**nota**
En este momento, solo puedes compartir entidades. Las entidades AWS Marketplace `AmiProduct` incluidas`Audience`,`BrandingSettings`, `ContainerProduct``Experience`, y`ProcurementPolicy`.
Para obtener más información al respecto AWS RAM, consulte la [Guía AWS RAM del usuario](https://docs.aws.amazon.com/ram/latest/userguide/). Para obtener más información sobre la administración de los recursos compartidos, consulte [Uso de AWS los recursos compartidos](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-shared.html) en la *Guía del AWS RAM usuario*.
Como *cuenta compartida*, puede configurar los recursos que desee compartir como read/write de solo lectura o ambos. Estos permisos determinan qué operaciones puede realizar una *cuenta consumidora* en los recursos que se comparten con ella.
+ **Cuenta compartida**: el recurso que se comparte y en el que el AWS RAM administrador crea el AWS recurso compartido mediante AWS RAM.
+ **Cuenta consumidora**: la cuenta Cuenta de AWS con la que se comparte un recurso. El recurso compartido puede especificar una cuenta completa como entidad principal o, en el caso de ciertos tipos de recursos, roles o usuarios individuales de la cuenta.
Para compartir una AWS Marketplace entidad, debe agregarla a un recurso compartido. Un recurso compartido es un recurso de AWS RAM que le permite compartir los recursos a través de Cuentas de AWS. Un recurso compartido especifica los recursos que compartir y los consumidores con quienes se comparten. Cuando compartes una entidad mediante la AWS Marketplace consola, la añades a un recurso compartido existente. Para añadir la AWS Marketplace entidad a un nuevo recurso compartido, primero debe crear el recurso compartido mediante la [AWS RAM consola](https://console.aws.amazon.com/ram).
Puedes compartir una AWS Marketplace entidad de tu propiedad mediante la AWS Marketplace consola, la AWS RAM consola o el AWS Command Line Interface (AWS CLI).
**Para compartir un AWS Marketplace entidad de la que eres propietario mediante el AWS RAM consola**
Consulte [Crear un recurso compartido](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) en la *Guía del usuario de AWS RAM *.
**Para compartir un AWS Marketplace entidad de la que eres propietario mediante el AWS CLI**
Utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).
**nota**
En el caso de los tipos de recursos, como las entidades que admiten políticas basadas en recursos, puede utilizarlos AWS RAM para compartir recursos y utilizar funciones adicionales AWS RAM . Para obtener más información, consulte la [Resource-based política](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-terms-and-concepts.html#term-resource-based-policy) en la Guía del *AWS RAM usuario*. AWS RAM utiliza la AWS Marketplace Catalog API para crear automáticamente la política de recursos a partir de los permisos de un recurso compartido y administra esa política de recursos por usted.
Para obtener información sobre cómo configurar, ver o eliminar políticas AWS basadas en recursos en su AWS Marketplace entidad AWS RAM, consulte [Permitir acciones en todos los recursos en](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/api-access-control.html#allowing-actions-on-all-resources) la Guía del *AWS RAM**usuario*.
### Diferencias entre compartir una entidad mediante AWS RAM y el AWS Marketplace Catalog API
Además de compartir su entidad AWS RAM, también puede establecer, ver o eliminar políticas AWS basadas en recursos en sus entidades a través del. AWS Marketplace Catalog API Sin embargo, existen algunas diferencias entre compartir tu entidad a través de AWS RAM y a través de. AWS Marketplace Catalog API
Cuando compartes una entidad a través de AWS RAM:
+ Si compartes tu entidad con cuentas ajenas a AWS Organizations, la cuenta consumidora primero debe aceptar tu solicitud de uso compartido antes de compartir la entidad.
+ La cuenta consumidora puede detectar la entidad compartida si `ListEntities` se `OwnershipType` establece en`SHARED`.
+ Debe cumplir con varias cuotas de recursos. Para obtener más información, consulte [Service Quotas para AWS RAM](https://docs.aws.amazon.com/ram/latest/userguide/service-quotas.html) en la *Guía del usuario de AWS RAM *.
Cuando compartes una entidad a través de AWS Marketplace Catalog API:
+ Su entidad se compartirá tan pronto como la `PutResourcePolicy` solicitud se realice correctamente sin que la cuenta consumidora participe.
+ La cuenta consumidora no puede detectar la entidad compartida si `ListEntities` se `OwnershipType` establece en. `SHARED` En su lugar, el propietario de la cuenta compartida debe informar a la cuenta consumidora del ID de la entidad compartida.
**nota**
Si su caso de uso requiere compartir recursos que podrían superar las cuotas de AWS RAM servicio, o si desea compartir recursos sin la participación directa de la cuenta consumidora, considere la posibilidad de compartirlos a través de AWS Marketplace Catalog API. Para todos los demás casos de uso, considere la posibilidad de AWS RAM utilizarlos para compartir AWS Marketplace recursos.
En las siguientes secciones se detalla cómo puede establecer, ver o eliminar políticas AWS basadas en recursos en sus entidades a través de. AWS Marketplace Catalog API
**Topics**
+ [Diferencias entre compartir una entidad mediante AWS RAM y el AWS Marketplace Catalog API](#differences-ram-capi)
+ [Adjunte una política de solo lectura a su recurso](#read-only-policy-resource)
+ [Adjunte una política de recursos de lectura y escritura a su recurso](#read-and-write-resource-policy)
+ [Vea la política de recursos establecida en su recurso](#view-resource-policy-set)
+ [Elimine la política de recursos de su recurso](#delete-resource-policy)
+ [Vea todos los recursos que le pertenecen y que se han compartido con usted](#view-entities-owned)
### Adjunte una política de solo lectura a su recurso
Puede crear una política basada en recursos de solo lectura en su recurso compartido mediante una cuenta compartida. Con esta política, el director solo puede ver los detalles del recurso que se comparte con él.
Solicitud
```
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"
]
}
}
}
```
Respuesta
```
HTTP/1.1 200
Content-type: application/json
{}
```
### Adjunte una política de recursos de lectura y escritura a su recurso
Como cuenta compartida, puedes crear una política de lectura y escritura basada en recursos en tu recurso compartido. Con esta política, el director puede ver los detalles y realizar operaciones de escritura en el recurso que se comparte con él.
Solicitud
```
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"
]
}
}
}
```
Respuesta
```
HTTP/1.1 200
Content-type: application/json
{}
```
### Vea la política de recursos establecida en su recurso
Como cuenta de uso compartido, puede ver la política de recursos establecida en el recurso compartido.
Solicitud
```
POST /GetResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}
```
Respuesta
```
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"
]
}
}
}
```
### Elimine la política de recursos de su recurso
Como cuenta compartida, puede eliminar la política de recursos que está configurada en el recurso compartido.
Solicitud
```
POST /DeleteResourcePolicy HTTP/1.1
Content-type: application/json
{
"ResourceArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/example2-abcd-1234-5ef6"
}
```
Respuesta
```
HTTP/1.1 200
Content-type: application/json
{}
```
### Vea todos los recursos que le pertenecen y que se han compartido con usted
Como cuenta consumidora, puedes ver los recursos que se comparten contigo.
**nota**
Puede ver los recursos compartidos con usted solo si los recursos se compartieron a través de él AWS RAM.
Solicitud
```
POST /ListEntities HTTP/1.1
Content-type: application/json
{
"Catalog": "AWSMarketplace",
"EntityType": "AmiProduct",
"FilterList": [
{
"Name": "EntityId",
"ValueList": [ "example2-abcd-1234-5ef6" ]
}
],
"OwnershipType": "SHARED"
}
```
Respuesta
```
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": ""
}
```