Skip to content

list_linux_subscription_instances async

list_linux_subscription_instances(
    *,
    config_overrides: Optional[
        AsyncLicenseManagerLinuxSubscriptionsClientConfig
    ] = None,
    filters: Optional[FilterList] = None,
    max_results: Optional[BoxInteger] = None,
    next_token: Optional[str] = None,
) -> ListLinuxSubscriptionInstancesResponse

Lists the running Amazon EC2 instances that were discovered with commercial Linux subscriptions.

Parameters:

  • filters (Optional[FilterList], default: None ) –

    An array of structures that you can use to filter the results by your specified criteria. For example, you can specify Region in the Name, with the contains operator to list all subscriptions that match a partial string in the Value, such as us-west.

    For each filter, you can specify one of the following values for the Name key to streamline results:

    • AccountID

    • AmiID

    • DualSubscription

    • InstanceID

    • InstanceType

    • ProductCode

    • Region

    • Status

    • UsageOperation

    For each filter, you can use one of the following Operator values to define the behavior of the filter:

    • contains

    • equals

    • Notequal

  • max_results (Optional[BoxInteger], default: None ) –

    The maximum items to return in a request.

  • next_token (Optional[str], default: None ) –

    A token to specify where to start paginating. This is the nextToken from a previously truncated response.

Raises:

Source code in docs_src/capo_license_manager_linux_subscriptions/_services/async_license_manager_linux_subscriptions.py
async def list_linux_subscription_instances(
    self,
    *,
    config_overrides: Optional[
        AsyncLicenseManagerLinuxSubscriptionsClientConfig
    ] = None,
    filters: Optional[
        "capo_license_manager_linux_subscriptions.types.filter_list.FilterList"
    ] = None,
    max_results: Optional[
        "capo_license_manager_linux_subscriptions.types.box_integer.BoxInteger"
    ] = None,
    next_token: Optional[str] = None,
) -> "capo_license_manager_linux_subscriptions.types.list_linux_subscription_instances_response.ListLinuxSubscriptionInstancesResponse":
    """<p>Lists the running Amazon EC2 instances that were discovered with commercial Linux subscriptions.</p>

    Args:
        filters: <p>An array of structures that you can use to filter the results by your specified criteria. For example, you can specify <code>Region</code> in the <code>Name</code>, with the <code>contains</code> operator to list all subscriptions that match a partial string in the <code>Value</code>, such as <code>us-west</code>.</p> <p>For each filter, you can specify one of the following values for the <code>Name</code> key to streamline results:</p> <ul> <li> <p> <code>AccountID</code> </p> </li> <li> <p> <code>AmiID</code> </p> </li> <li> <p> <code>DualSubscription</code> </p> </li> <li> <p> <code>InstanceID</code> </p> </li> <li> <p> <code>InstanceType</code> </p> </li> <li> <p> <code>ProductCode</code> </p> </li> <li> <p> <code>Region</code> </p> </li> <li> <p> <code>Status</code> </p> </li> <li> <p> <code>UsageOperation</code> </p> </li> </ul> <p>For each filter, you can use one of the following <code>Operator</code> values to define the behavior of the filter:</p> <ul> <li> <p> <code>contains</code> </p> </li> <li> <p> <code>equals</code> </p> </li> <li> <p> <code>Notequal</code> </p> </li> </ul>
        max_results: <p>The maximum items to return in a request.</p>
        next_token: <p>A token to specify where to start paginating. This is the nextToken from a previously truncated response.</p>

    Raises:
        capo_license_manager_linux_subscriptions.errors.internal_server_exception.InternalServerException: <p>An exception occurred with the service.</p>
        capo_license_manager_linux_subscriptions.errors.throttling_exception.ThrottlingException: <p>The request was denied due to request throttling.</p>
        capo_license_manager_linux_subscriptions.errors.validation_exception.ValidationException: <p>The provided input is not valid. Try your request again.</p>
        capo_license_manager_linux_subscriptions.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_license_manager_linux_subscriptions.types.list_linux_subscription_instances_request.ListLinuxSubscriptionInstancesRequest]",
    ) -> AsyncOperationResponse[
        "capo_license_manager_linux_subscriptions.types.list_linux_subscription_instances_response.ListLinuxSubscriptionInstancesResponse"
    ]:
        import capo_license_manager_linux_subscriptions._operations.license_manager_linux_subscriptions.list_linux_subscription_instances

        (
            output,
            http_response,
        ) = await capo_license_manager_linux_subscriptions._operations.license_manager_linux_subscriptions.list_linux_subscription_instances.async_list_linux_subscription_instances(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListLinuxSubscriptionInstances")
    )
    input_: capo_license_manager_linux_subscriptions.types.list_linux_subscription_instances_request.ListLinuxSubscriptionInstancesRequest = {}
    if filters is not None:
        input_["filters"] = filters
    if max_results is not None:
        input_["max_results"] = max_results
    if next_token is not None:
        input_["next_token"] = next_token

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output