View a markdown version of this page

Uso de AWS Marketplace API para compartir recursos - AWS Marketplace
Requisitos previos para compartir AWS Marketplace entitiesComparte un AWS Marketplace entidad

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.

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.

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 incluidasAudience,BrandingSettings, ContainerProductExperience, yProcurementPolicy.

Para obtener más información al respecto AWS RAM, consulte la Guía AWS RAM del usuario. Para obtener más información sobre la administración de los recursos compartidos, consulte Uso de AWS los recursos compartidos 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.

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 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 create-resource-share.

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 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 la Guía del AWS RAMusuario.

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 enSHARED.

  • Debe cumplir con varias cuotas de recursos. Para obtener más información, consulte Service Quotas para AWS RAM 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

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": "" 
}