This package has been deprecated

Author message:

The package @aws-sdk/client-marketplace-entitlement-service-node has been renamed to @aws-sdk/client-marketplace-entitlement-service. Please install the renamed package.

@aws-sdk/client-marketplace-entitlement-service-node

Description

AWS Marketplace Entitlement Service

This reference provides descriptions of the AWS Marketplace Entitlement Service API.

AWS Marketplace Entitlement Service is used to determine the entitlement of a customer to a given product. An entitlement represents capacity in a product owned by the customer. For example, a customer might own some number of users or seats in an SaaS application or some amount of data capacity in a multi-tenant database.

Getting Entitlement Records

• GetEntitlements- Gets the entitlements for a Marketplace product.

Installing

To install the this package using NPM, simply type the following into a terminal window:

npm install @aws-sdk/client-marketplace-entitlement-service-node

Getting Started

Import

The AWS SDK is modulized by clients and commands in CommonJS modules. To send a request, you only need to import the client(MarketplaceEntitlementServiceClient) and the commands you need, for example GetEntitlementsCommand:

//JavaScript
const {
  MarketplaceEntitlementServiceClient
} = require("@aws-sdk/client-marketplace-entitlement-service-node/MarketplaceEntitlementServiceClient");
const {
  GetEntitlementsCommand
} = require("@aws-sdk/client-marketplace-entitlement-service-node/commands/GetEntitlementsCommand");

//TypeScript
import { MarketplaceEntitlementServiceClient } from "@aws-sdk/client-marketplace-entitlement-service-node/MarketplaceEntitlementServiceClient";
import { GetEntitlementsCommand } from "@aws-sdk/client-marketplace-entitlement-service-node/commands/GetEntitlementsCommand";

Usage

To send a request, you:

• Initiate client with configuration (e.g. credentials, region). For more information you can refer to the API reference.
• Initiate command with input parameters.
• Call send operation on client with command object as input.
• If you are using a custom http handler, you may call destroy() to close open connections.

const marketplaceEntitlementService = new MarketplaceEntitlementServiceClient({region: 'region'});
//clients can be shared by different commands
const params = {
  ProductCode: /**a string value*/,
};
const getEntitlementsCommand = new GetEntitlementsCommand(params);
marketplaceEntitlementService.send(getEntitlementsCommand).then(data => {
    // do something
}).catch(error => {
    // error handling
})

In addition to using promises, there are 2 other ways to send a request:

// async/await
try {
  const data = await marketplaceEntitlementService.send(getEntitlementsCommand);
  // do something
} catch (error) {
  // error handling
}

// callback
marketplaceEntitlementService.send(getEntitlementsCommand, (err, data) => {
  //do something
});

The SDK can also send requests using the simplified callback style from version 2 of the SDK.

import * as AWS from "@aws-sdk/@aws-sdk/client-marketplace-entitlement-service-node/MarketplaceEntitlementService";
const marketplaceEntitlementService = new AWS.MarketplaceEntitlementService({
  region: "region"
});
marketplaceEntitlementService.getEntitlements(params, (err, data) => {
  //do something
});

Troubleshooting

When the service returns an exception, the error will include the exception information, as well as response metadata (e.g. request id).

try {
  const data = await marketplaceEntitlementService.send(getEntitlementsCommand);
  // do something
} catch (error) {
  const metadata = error.$metadata;
  console.log(
    `requestId: ${metadata.requestId}
cfId: ${metadata.cfId}
extendedRequestId: ${metadata.extendedRequestId}`
  );
  /*
The keys within exceptions are also parsed. You can access them by specifying exception names:
    if(error.name === 'SomeServiceException') {
        const value = error.specialKeyInException;
    }
*/
}

Getting Help

Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.

• Ask a question on StackOverflow and tag it with aws-sdk-js
• Come join the AWS JavaScript community on gitter
• If it turns out that you may have found a bug, please open an issue

Contributing

This client code is generated automatically. Any modifications will be overwritten the next time the `@aws-sdk/@aws-sdk/client-marketplace-entitlement-service-node' package is updated. To contribute to SDK you can checkout our code generator package.

License

This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.