update-license-configuration¶

Description¶

Modifies the attributes of an existing license configuration.

Synopsis¶

  update-license-configuration
--license-configuration-arn <value>
[--license-configuration-status <value>]
[--license-rules <value>]
[--license-count <value>]
[--license-count-hard-limit | --no-license-count-hard-limit]
[--name <value>]
[--description <value>]
[--product-information-list <value>]
[--disassociate-when-not-found | --no-disassociate-when-not-found]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options¶

--license-configuration-arn (string)

Amazon Resource Name (ARN) of the license configuration.

--license-configuration-status (string)

New status of the license configuration.

Possible values:

AVAILABLE

DISABLED

--license-rules (list)

New license rule. The only rule that you can add after you create a license configuration is licenseAffinityToHost.

(string)

Syntax:

"string" "string" ...

--license-count (long)

New number of licenses managed by the license configuration.

--license-count-hard-limit | --no-license-count-hard-limit (boolean)

New hard limit of the number of available licenses.

--name (string)

New name of the license configuration.

--description (string)

New description of the license configuration.

--product-information-list (list)

New product information.

(structure)

Describes product information for a license configuration.

ResourceType -> (string)

Resource type. The possible values are SSM_MANAGED | RDS .

ProductInformationFilterList -> (list)

A Product information filter consists of a ProductInformationFilterComparator which is a logical operator, a ProductInformationFilterName which specifies the type of filter being declared, and a ProductInformationFilterValue that specifies the value to filter on.

Accepted values for ProductInformationFilterName are listed here along with descriptions and valid options for ProductInformationFilterComparator .

The following filters and are supported when the resource type is SSM_MANAGED :

Application Name - The name of the application. Logical operator is EQUALS .

Application Publisher - The publisher of the application. Logical operator is EQUALS .

Application Version - The version of the application. Logical operator is EQUALS .

Platform Name - The name of the platform. Logical operator is EQUALS .

Platform Type - The platform type. Logical operator is EQUALS .

Tag:key - The key of a tag attached to an Amazon Web Services resource you wish to exclude from automated discovery. Logical operator is NOT_EQUALS . The key for your tag must be appended to Tag: following the example: Tag:name-of-your-key . ProductInformationFilterValue is optional if you are not using values for the key.

AccountId - The 12-digit ID of an Amazon Web Services account you wish to exclude from automated discovery. Logical operator is NOT_EQUALS .

License Included - The type of license included. Logical operators are EQUALS and NOT_EQUALS . Possible values are: sql-server-enterprise | sql-server-standard | sql-server-web | windows-server-datacenter .

The following filters and logical operators are supported when the resource type is RDS :

Engine Edition - The edition of the database engine. Logical operator is EQUALS . Possible values are: oracle-ee | oracle-se | oracle-se1 | oracle-se2 .

License Pack - The license pack. Logical operator is EQUALS . Possible values are: data guard | diagnostic pack sqlt | tuning pack sqlt | ols | olap .

(structure)

Describes product information filters.

ProductInformationFilterName -> (string)

Filter name.

ProductInformationFilterValue -> (list)

Filter value.

(string)

ProductInformationFilterComparator -> (string)

Logical operator.

JSON Syntax:

[
  {
    "ResourceType": "string",
    "ProductInformationFilterList": [
      {
        "ProductInformationFilterName": "string",
        "ProductInformationFilterValue": ["string", ...],
        "ProductInformationFilterComparator": "string"
      }
      ...
    ]
  }
  ...
]

--disassociate-when-not-found | --no-disassociate-when-not-found (boolean)

When true, disassociates a resource when software is uninstalled.

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Examples¶

To update a license configuration

The following update-license-configuration example updates the specified license configuration to remove the hard limit.

aws license-manager update-license-configuration \
    --no-license-count-hard-limit \
    --license-configuration-arn arn:aws:license-manager:us-west-2:880185128111:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

This command produces no output.

The following update-license-configuration example updates the specified license configuration to change its status to DISABLED.

aws license-manager update-license-configuration \
    --license-configuration-status DISABLED
    --license-configuration-arn arn:aws:license-manager:us-west-2:880185128111:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

This command produces no output.

Output¶

None

Table of Contents

Feedback

User Guide