Publicar un producto AWS Data Exchange conteniendo APIs

Añada la siguiente política a su política API de recursos:

{
"Effect": "Allow",
"Principal": {"Service": "dataexchange.amazonaws.com"},
"Action": "execute-api:Invoke",
"Resource": "*",
"Condition": {"StringEquals": {"aws:SourceAccount": "<account-id>"}}
}

account-idSustitúyala por la cuenta que creará el conjunto API de datos.

La cuenta con el recurso API Gateway no necesita estar en la misma cuenta que está creando el conjunto de datos.

Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

En el panel de navegación de la izquierda, en Mis datos, elija Conjuntos de datos propios.

En Conjuntos de datos propios, elija Crear conjunto de datos para abrir el asistente Pasos para crear un conjunto de datos.

En Seleccione el tipo de conjunto de datos, elija Amazon API Gateway API.

En Definir conjunto de datos, introduzca un Nombre y una Descripción para el conjunto de datos. Para obtener más información, consulte Prácticas recomendadas con conjuntos de datos.

(Opcional) En Agregar etiquetas - opcional, agregue etiquetas.

Seleccione Crear.

Utilice el create-data-set comando para crear un conjunto API de datos:

$ AWS dataexchange create-data-set \
--asset-type API_GATEWAY_API \
--description 'Data Set Description' \
--name 'Data Set Name'

{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID",
"AssetType": "API_GATEWAY_API",
"CreatedAt": "2021-09-11T00:16:46.349000+00:00",
"Description": "Data Set Description",
"Id": "$DATA_SET_ID",
"Name": "Data Set Name",
"Origin": "OWNED",
"UpdatedAt": "2021-09-11T00:16:46.349000+00:00"
}

Anote el nuevo tipo de activo de API_GATEWAY_API.

En la sección Información general sobre el conjunto de datos de la página de detalles del conjunto de datos:

1. (Opcional) Elija Editar nombre para editar la información sobre su conjunto de datos.

2. (Opcional) Elija Eliminar para eliminar el conjunto de datos.

En la sección Revisiones, elija Crear revisión.

En Definir revisión, proporcione un comentario opcional sobre la revisión que describa su finalidad.

(Opcional) En Agregar etiquetas: opcional, agregue las etiquetas asociadas al recurso.

Elija Crear revisión.

Revise, edite o elimine los cambios del paso anterior.

Utilice el comando create-revision para crear una revisión:

$ AWS dataexchange create-revision \
--data-set-id $DATA_SET_ID \
--comment 'First Atlas Revision'
{
"Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID",
"Comment": "First Atlas Revision",
"CreatedAt": "2021-09-11T00:18:49.160000+00:00",
"DataSetId": "$DATA_SET_ID",
"Finalized": false,
"Id": "$REVISION_ID",
"UpdatedAt": "2021-09-11T00:18:49.160000+00:00"
}

Añada los API activos a la revisión.

En la sección de APIactivos de la página de detalles del conjunto de datos, seleccione Añadir API etapa.

En Seleccionar API etapa, para Amazon API Gateway API, introduce una API en el cuadro de entrada o elige una de las siguientes opciones de la lista desplegable:

1. Si ha elegido APIotro Cuenta de AWS, introduzca el API ID y el nombre del API escenario en los cuadros de entrada.

2. Si seleccionó En esto Cuenta de AWS, elija el nombre del API escenario en la lista desplegable

En Configuración avanzada (opcional), puede elegir Conectar el plan de uso de Amazon API Gateway existente para utilizar los límites de limitación y cuota definidos en el plan de uso existente e introducir la API clave.

En Documento API para suscriptores, proporciona detalles sobre lo API que verán los suscriptores después de suscribirse a tu producto.

1. En el APIcampo Nombre, introduce un nombre que los suscriptores puedan usar para identificar el API activo.

   nota

   Si Cuenta de AWS ha seleccionado En esto, el APInombre se rellena automáticamente y puede modificarlo si es necesario.

   Si Cuenta de AWS se ha seleccionado uno APIen otro, el APInombre se rellena con un nombre predeterminado, que debes modificar para que el suscriptor pueda entender fácilmente de qué se trata.

2. Para la especificación Open API 3.0, haga lo siguiente:

   1. Introduzca o copie y pegue el archivo de especificaciones de Open API 3.0.

   2. Seleccione Importar desde. JSONy, a continuación, selecciona el archivo.json de tu ordenador local para importarlo.

      La especificación importada aparece en el cuadro.

   3. Selecciona Importar desde Amazon API Gateway y, a continuación, elige una especificación para importar.

      La especificación importada aparece en el cuadro.

3. Para obtener documentación adicional (opcional), introduce cualquier información adicional que sea útil que el suscriptor conozca sobre tiAPI. Se admite Markdown.

Seleccione Añadir API etapa.

Se inicia un trabajo para importar el activo (en este caso, elAPI) a su conjunto de datos.

Después de finalizar el trabajo, el campo Estado de la sección Trabajos se actualiza a Completado.

Si tiene más APIs para añadir, repita el paso 2.

En Información general sobre la revisión, revise la revisión y sus activos.

Elija Finalizar.

Utilice el create-job comando para añadir API activos a la revisión:

$ AWS dataexchange create-job \
  --type IMPORT_ASSET_FROM_API_GATEWAY_API \
  --details '{"ImportAssetFromApiGatewayApi":{"DataSetId":"$DATA_SET_ID","RevisionId":"$REVISION_ID","ApiId":"$API_ID","Stage":"$API_STAGE","ProtocolType":"REST"}}'
{
    "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/$JOB_ID",
    "CreatedAt": "2021-09-11T00:38:19.875000+00:00",
    "Details": {
        "ImportAssetFromApiGatewayApi": {
            "ApiId": "$API_ID",
            "DataSetId": "$DATA_SET_ID",
            "ProtocolType": "REST",
            "RevisionId": "$REVISION_ID",
            "Stage": "$API_STAGE"
        }
    },
    "Id": "$JOB_ID",
    "State": "WAITING",
    "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
    "UpdatedAt": "2021-09-11T00:38:19.875000+00:00"
}

$ AWS dataexchange start-job --job-id $JOB_ID
$ AWS dataexchange get-job --job-id $JOB_ID
{
    "Arn": "arn:aws:dataexchange:us-east-1:0123456789012:jobs/$JOB_ID",
    "CreatedAt": "2021-09-11T00:38:19.875000+00:00",
    "Details": {
        "ImportAssetFromApiGatewayApi": {
            "ApiId": "$API_ID",
            "DataSetId": "$DATA_SET_ID",
            "ProtocolType": "REST",
            "RevisionId": "$REVISION_ID",
            "Stage": "$API_STAGE"
            "ApiEndpoint": "string",
            "ApiKey": "string",
            "ApiName": "string",            
            "ApiDescription": "string",
            "ApiSpecificationDownloadUrl": "string",
            "ApiSpecificationDownloadUrlExpiresAt": "string"
        }
    },
    "Id": "$JOB_ID",
    "State": "COMPLETED",
    "Type": "IMPORT_ASSET_FROM_API_GATEWAY_API",
    "UpdatedAt": "2021-09-11T00:38:52.538000+00:00"
}

Utilice el comando list-revision-assets para confirmar que se ha creado el nuevo activo correctamente:

$ AWS dataexchange list-revision-assets \
  --data-set-id $DATA_SET_ID \
  --revision-id $REVISION_ID
{
    "Assets": [
    {
        "Arn": "arn:aws:dataexchange:us-east-1:123456789012:data-sets/$DATA_SET_ID/revisions/$REVISION_ID/assets/$ASSET_ID",
        "AssetDetails": {
            "ApiGatewayApiAsset": {
                "ApiEndpoint": "https://$API_ID.execute-api.us-east-1.amazonaws.com/$API_STAGE",
                "ApiId": "$API_ID",
                "ProtocolType": "REST",
                "Stage": "$API_STAGE"
            }
        },
        "AssetType": "API_GATEWAY_API",
        "CreatedAt": "2021-09-11T00:38:52.457000+00:00",
        "DataSetId": "$DATA_SET_ID",
        "Id": "$ASSET_ID",
        "Name": "$ASSET_ID/$API_STAGE",
        "RevisionId": "$REVISION_ID",
        "UpdatedAt": "2021-09-11T00:38:52.457000+00:00"
    }
    ]
}

En Información general sobre la revisión, elija Revertir finalización.

Se muestra un mensaje que indica que la revisión ya no está en estado finalizador.

Para editar la revisión, en Información general sobre la revisión, elija Acciones, Editar.

Realice los cambios y elija Actualizar.

Revise los cambios y, a continuación, elija Finalizar.

En Información general sobre la revisión, elija Eliminar.

En el cuadro de diálogo Eliminar, escriba Delete y, a continuación, elija Eliminar.

En el panel de navegación izquierdo de la consola de AWS Data Exchange, en Publicar datos, elija Productos.

En Productos, elija Publicar producto nuevo para abrir el asistente Publicar producto nuevo.

En Visibilidad del producto:

1. Elija las Opciones de visibilidad del producto como Público o Privado.

   Todos los AWS Data Exchange productos cuya visibilidad esté configurada como Pública requieren una oferta pública.

   Para obtener más información, consulte Visibilidad del producto en AWS Data Exchange.

2. Elija la configuración de Información confidencial del producto.

   Para obtener más información, consulte Categorías de información confidencial en AWS Data Exchange.

3. Elija Next (Siguiente).

En Agregar datos:

1. En Conjuntos de datos propios, seleccione las casillas de verificación situadas junto a los conjuntos de datos que quiera agregar y, a continuación, elija Agregar selección.

   nota

   Los conjuntos de datos que elija deben tener una revisión finalizada. No se pueden agregar conjuntos de datos sin versiones finalizadas.

2. Vaya a Conjuntos de datos seleccionados para revisar sus selecciones.

   Puede revisar el Nombre del conjunto de datos, el Tipo de conjunto de datos y la fecha y hora de la Última actualización del conjunto de datos.

3. Vaya a Seleccionar reglas de acceso a revisiones y elija las reglas de acceso a las revisiones que desee establecer para los conjuntos de datos incluidos en este producto.

   Para obtener más información, consulte Revise las reglas de acceso en AWS Data Exchange.

4. Elija Next (Siguiente).

En Definir producto:

1. En Descripción general del producto, introduzca la información sobre el producto, incluidos el Nombre del producto, el Logotipo del producto, la información de Contacto de soporte y Categorías de productos.

   Para obtener más información, consulte Mejores prácticas de productos en AWS Data Exchange.

2. (Opcional) En Diccionarios de datos y muestras (opcional), seleccione un conjunto de datos pulsando el botón de opción situado junto al nombre del conjunto de datos y, a continuación, elija Editar.

   1. En el cuadro de diálogo Editar, elija Cargar para cargar un diccionario de datos nuevo.

      Puede elegir un diccionario de datos, en formato .csv, con un tamaño máximo de 1 MB.

   2. Elija un diccionario de datos guardado en su ordenador y, a continuación, elija Abrir.

      El archivo .csv del diccionario de datos aparece en el cuadro de diálogo Editar.

      nota

      El diccionario de datos debe ajustarse a la plantilla de diccionario de datos de AWS Data Exchange . Si no tiene ningún diccionario de datos guardado para cargar, puede elegir el enlace de plantilla de diccionario de datos vacía o el enlace de diccionario de datos de ejemplo en la consola de AWS Data Exchange .

   3. Seleccione Vista previa del diccionario de datos para obtener una vista previa del diccionario de datos.

   4. En Muestras (opcional), elija Cargar muestras, seleccione una muestra de su ordenador y, a continuación, seleccione Abrir.

      Las muestras aparecen en el cuadro de diálogo Editar.

      nota

      Puede cargar hasta 10 muestras con un tamaño máximo de 50 MB. Es posible previsualizar las muestras en formato .csv.

   5. Introduzca una descripción para cada muestra que vaya a estar visible en la página de detalles del producto.

   6. Seleccione Guardar.

En Definición del producto, introduzca una Descripción breve y una Descripción larga del producto.

Si desea usar una plantilla para la descripción larga, seleccione Aplicar plantilla, elija el tipo de plantilla y, a continuación, rellene la plantilla con los detalles específicos del producto.

Elija Next (Siguiente).

Configure su oferta en Agregar oferta pública (para ofertas públicas) o Agregar oferta personalizada (para ofertas privadas):

Todos los AWS Data Exchange productos cuya visibilidad esté configurada como Pública requieren una oferta pública.

1. Solo para ofertas privadas:

   1. Elige uno de los tipos de ofertas que aparecen en la lista: oferta privada, oferta privada renovada o trae tu propia suscripción (BYOS).

   2. En la sección Información de la cuenta del suscriptor, agregue al menos una cuenta de suscriptor a la que quiera extender la oferta.

2. Elija las opciones de Precios y duración del acceso de la suscripción.

3. En Costos medidos (opcional), elija Agregar.

   1. En Añadir coste medido, selecciona el tipo de coste de la API llamada en la lista de tipos:

      • Por solicitud API

      • Por API solicitud exitosa

      • Por unidad de datos transferida en bytes

      • Nuevo costo medido personalizado

   2. Introduzca o actualice el Nombre de visualización del costo, que aparece en la factura del suscriptor.

   3. Si utiliza un Costo medido predefinido, se genera la Clave automáticamente; no se puede editar y no es necesario devolverla en el encabezado de la respuesta.

   4. Si va a crear un nuevo costo medido personalizado, introduzca la clave, que es el identificador del costo medido, en el encabezado de la API respuesta (15 caracteres como máximo).

      Esta Clave se debe devolver como parte del encabezado de la respuesta de x-amz-dataexchange-metering.

      ejemplo Clave personalizada

      Si tienes una clave personalizada llamada VertexCount y otra llamada clave personalizadaEdgeCount, el encabezado de respuesta «x-amz-dataexchange-metering» podría tener un valor igual VertexCount=3,EdgeCount=10 o podrías devolver dos líneas de encabezado independientes:

      x-amz-dataexchange-metering: VertextCount=3

      x-amz-dataexchange-metering: EdgeCount=10

   5. Introduzca el precio por unidad que se cobra al suscriptor en Precio por unidad.

   6. (Opcional) Introduzca el número de unidades para mostrar un ejemplo del coste en la Calculadora de costos medidos.

   7. (Opcional) Introduzca una breve Descripción del coste medido que se muestra en la página de detalles del producto.

   8. Elija Agregar.

   9. (Opcional) Repita este procedimiento para agregar costes calculados adicionales. 

      El orden de los costes medidos aparece en la página de detalles del producto. No es posible volver a ordenarlos.

      nota

      Después de crear la oferta, es posible editar el precio y la descripción de un coste medido. Para obtener más información, consulte Actualizar los detalles del producto y la oferta en AWS Data Exchange.

4. Solo para ofertas privadas, elija la Fecha de vencimiento de la oferta en la que el suscriptor debe aceptarla.

5. Elige tu configuración fiscal, tu acuerdo de suscripción de datos (DSA) y tu política de reembolso.

6. (Opcional) Solo para ofertas públicas, configure la Verificación de las suscripciones, que permite controlar quién puede suscribirse el producto. Para obtener más información, consulte Verificación de suscripciones para proveedores en AWS Data Exchange.

7. Elija la opción Renovación automática de ofertas. Para obtener más información, consulte Crear una oferta de AWS Data Exchange productos.

8. Elija Next (Siguiente).

En la sección Revisar y publicar, revisa la información del producto.

1. Amplíe la Vista previa de la página del producto para ver cómo quedará la página del producto después de publicarla.

2. (Opcional) Haga clic en el botón Editar en cualquier sección para editar esa sección.

Si está seguro de que desea que el producto y la oferta pública sean visibles y estén disponibles para todos, seleccione Publicar.

Abra el navegador web e inicie sesión en la consola de AWS Data Exchange.

En el panel de navegación izquierdo, en Publicar datos, elija Productos.

En Productos, elija el botón situado al lado del producto cuyo contenido desee copiar.

Seleccione el menú desplegable Acciones y, a continuación, seleccione Crear copia.

Continúe con el flujo de trabajo Publicar un producto nuevo, con los detalles ya rellenados, en función del producto que haya elegido en el paso 3. Para obtener más información, consulte Paso 5: Publicar un producto nuevo.