registered_subscription_providers

Creates, updates, deletes, gets or lists a registered_subscription_providers resource.

Overview

Name	registered_subscription_providers
Type	Resource
Id	aws.license_manager_linux_subscriptions.registered_subscription_providers

Fields

The following fields are returned by SELECT queries:

get_registered_subscription_provider

Name	Datatype	Description
last_successful_data_retrieval_time	string	The timestamp from the last time License Manager retrieved subscription details from your registered third-party Linux subscription provider.
secret_arn	string	The Amazon Resource Name (ARN) of the third-party access secret stored in Secrets Manager for the BYOL registration resource specified in the request. (pattern: <code>^arn:[a-z0-9-.]{1,63}:secretsmanager:[a-z0-9-.]{0,63}:[a-z0-9-.]{0,63}㊙️[^/]{1,1023}$</code>)
subscription_provider_arn	string	The Amazon Resource Name (ARN) for the BYOL registration resource specified in the request. (pattern: <code>^arn:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,510}/[a-z0-9-.]{1,510}$</code>)
subscription_provider_source	string	The subscription provider for the BYOL registration resource specified in the request. (RedHat)
subscription_provider_status	string	The status of the Linux subscription provider access token from the last successful subscription data request. (ACTIVE, INVALID, PENDING)
subscription_provider_status_message	string	The detailed message from your subscription provider token status.

list_registered_subscription_providers

Name	Datatype	Description
last_successful_data_retrieval_time	string	The timestamp from the last time that License Manager accessed third-party subscription data for your account from your registered Linux subscription provider.
secret_arn	string	The Amazon Resource Name (ARN) of the Secrets Manager secret that stores your registered Linux subscription provider access token. For RHEL account subscriptions, this is the offline token. (pattern: <code>^arn:[a-z0-9-.]{1,63}:secretsmanager:[a-z0-9-.]{0,63}:[a-z0-9-.]{0,63}㊙️[^/]{1,1023}$</code>)
subscription_provider_arn	string	The Amazon Resource Name (ARN) of the Linux subscription provider resource that you registered. (pattern: <code>^arn:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,63}:[a-z0-9-.]{1,510}/[a-z0-9-.]{1,510}$</code>)
subscription_provider_source	string	A supported third-party Linux subscription provider. License Manager currently supports Red Hat subscriptions. (RedHat)
subscription_provider_status	string	Indicates the status of your registered Linux subscription provider access token from the last time License Manager retrieved subscription data. For RHEL account subscriptions, this is the status of the offline token. (ACTIVE, INVALID, PENDING)
subscription_provider_status_message	string	A detailed message that's associated with your BYOL subscription provider token status.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_registered_subscription_provider	select	region		Get details for a Bring Your Own License (BYOL) subscription that's registered to your account.
list_registered_subscription_providers	select	region		List Bring Your Own License (BYOL) subscription registration resources for your account.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

get_registered_subscription_provider

Get details for a Bring Your Own License (BYOL) subscription that's registered to your account.

SELECT
last_successful_data_retrieval_time,
secret_arn,
subscription_provider_arn,
subscription_provider_source,
subscription_provider_status,
subscription_provider_status_message
FROM aws.license_manager_linux_subscriptions.registered_subscription_providers
WHERE region = '{{ region }}' -- required
;

list_registered_subscription_providers

List Bring Your Own License (BYOL) subscription registration resources for your account.

SELECT
last_successful_data_retrieval_time,
secret_arn,
subscription_provider_arn,
subscription_provider_source,
subscription_provider_status,
subscription_provider_status_message
FROM aws.license_manager_linux_subscriptions.registered_subscription_providers
WHERE region = '{{ region }}' -- required
;