# Ejemplos de License Manager que utilizan la AWS CLI
<a name="cli_license-manager_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con License Manager.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `create-license-configuration`
<a name="license-manager_CreateLicenseConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-license-configuration`.

**AWS CLI**  
**Ejemplo 1: crear una configuración de licencias**  
El siguiente ejemplo de `create-license-configuration` crea una configuración de licencia con un límite máximo de 10 núcleos.  

```
aws license-manager create-license-configuration --name my-license-configuration \
    --license-counting-type Core \
    --license-count 10 \
    --license-count-hard-limit
```
Salida:  

```
{
  "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111"
}
```
**Ejemplo 2: crear una configuración de licencias**  
En el siguiente ejemplo de `create-license-configuration`, se crea una configuración de licencia con un límite flexible de 100 vCPU. Utiliza una regla para habilitar la optimización de vCPU.  

```
aws license-manager create-license-configuration --name my-license-configuration
    --license-counting-type vCPU \
    --license-count 100 \
    --license-rules "#honorVcpuOptimization=true"
```
Salida:  

```
{
  "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222"
}
```
+  Para obtener información sobre la API, consulte [CreateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/create-license-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-license-configuration`
<a name="license-manager_DeleteLicenseConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-license-configuration`.

**AWS CLI**  
**Eliminación de una configuración de licencias**  
En el siguiente ejemplo de `delete-license-configuration`, se elimina la configuración de licencia especificada.  

```
aws license-manager delete-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Este comando no genera ninguna salida.  
+  Para obtener información sobre la API, consulte [DeleteLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/delete-license-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-license-configuration`
<a name="license-manager_GetLicenseConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-license-configuration`.

**AWS CLI**  
**Para obtener información sobre la configuración de licencias**  
En el siguiente ejemplo de `get-license-configuration`, se muestran los detalles de la configuración de licencias especificada.  

```
aws license-manager get-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Salida:  

```
{
    "LicenseConfigurationId": "lic-38b658717b87478aaa7c00883EXAMPLE",
    "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE",
    "Name": "my-license-configuration",
    "LicenseCountingType": "vCPU",
    "LicenseRules": [],
    "LicenseCountHardLimit": false,
    "ConsumedLicenses": 0,
    "Status": "AVAILABLE",
    "OwnerAccountId": "123456789012",
    "ConsumedLicenseSummaryList": [
        {
            "ResourceType": "EC2_INSTANCE",
            "ConsumedLicenses": 0
        },
        {
            "ResourceType": "EC2_HOST",
            "ConsumedLicenses": 0
        },
        {
            "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
            "ConsumedLicenses": 0
        }
    ],
    "ManagedResourceSummaryList": [
        {
            "ResourceType": "EC2_INSTANCE",
            "AssociationCount": 0
        },
        {
            "ResourceType": "EC2_HOST",
            "AssociationCount": 0
        },
        {
            "ResourceType": "EC2_AMI",
            "AssociationCount": 2
        },
        {
            "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
            "AssociationCount": 0
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [GetLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-license-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-service-settings`
<a name="license-manager_GetServiceSettings_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-service-settings`.

**AWS CLI**  
**Para obtener la configuración de License Manager**  
El siguiente ejemplo de `get-service-settings` muestra la configuración del servicio de License Manager en la región actual.  

```
aws license-manager get-service-settings
```
A continuación, se muestra un ejemplo de salida si la detección de recursos entre cuentas está deshabilitada.  

```
{
    "OrganizationConfiguration": {
        "EnableIntegration": false
    },
    "EnableCrossAccountsDiscovery": false
}
```
A continuación, se muestra un ejemplo de salida si la detección de recursos entre cuentas está habilitada.  

```
{
    "S3BucketArn": "arn:aws:s3:::aws-license-manager-service-c22d6279-35c4-47c4-bb",
    "OrganizationConfiguration": {
        "EnableIntegration": true
    },
    "EnableCrossAccountsDiscovery": true
}
```
+  Para obtener información sobre la API, consulte [GetServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/get-service-settings.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-associations-for-license-configuration`
<a name="license-manager_ListAssociationsForLicenseConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-associations-for-license-configuration`.

**AWS CLI**  
**Para obtener asociaciones para una configuración de licencias**  
El siguiente ejemplo de `list-associations-for-license-configuration` muestra información detallada sobre las asociaciones de la configuración de licencias especificada.  

```
aws license-manager list-associations-for-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Salida:  

```
{
    "LicenseConfigurationAssociations": [
        {
            "ResourceArn": "arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0",
            "ResourceType": "EC2_AMI",
            "ResourceOwnerId": "123456789012",
            "AssociationTime": 1568825118.617
        },
        {
            "ResourceArn": "arn:aws:ec2:us-west-2::image/ami-0abcdef1234567890",
            "ResourceType": "EC2_AMI",
            "ResourceOwnerId": "123456789012",
            "AssociationTime": 1568825118.946
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [ListAssociationsForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-associations-for-license-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-license-configurations`
<a name="license-manager_ListLicenseConfigurations_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-license-configurations`.

**AWS CLI**  
**Ejemplo 1: enumeración de todas las configuraciones de licencia**  
El siguiente ejemplo de `list-license-configurations` muestra todas las configuraciones de licencias.  

```
aws license-manager list-license-configurations
```
Salida:  

```
{
    "LicenseConfigurations": [
        {
            "LicenseConfigurationId": "lic-6eb6586f508a786a2ba4f56c1EXAMPLE",
            "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE",
            "Name": "my-license-configuration",
            "LicenseCountingType": "Core",
            "LicenseRules": [],
            "LicenseCount": 10,
            "LicenseCountHardLimit": true,
            "ConsumedLicenses": 0,
            "Status": "AVAILABLE",
            "OwnerAccountId": "123456789012",
            "ConsumedLicenseSummaryList": [
                {
                    "ResourceType": "EC2_INSTANCE",
                    "ConsumedLicenses": 0
                },
                {
                    "ResourceType": "EC2_HOST",
                    "ConsumedLicenses": 0
                },
                {
                    "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
                    "ConsumedLicenses": 0
                }
            ],
            "ManagedResourceSummaryList": [
                {
                    "ResourceType": "EC2_INSTANCE",
                    "AssociationCount": 0
                },
                {
                    "ResourceType": "EC2_HOST",
                    "AssociationCount": 0
                },
                {
                    "ResourceType": "EC2_AMI",
                    "AssociationCount": 0
                },
                {
                    "ResourceType": "SYSTEMS_MANAGER_MANAGED_INSTANCE",
                    "AssociationCount": 0
                }
            ]
        },
        {
            ...
        }
    ]
}
```
**Ejemplo 2: enumeración de configuraciones de licencias específicas**  
El siguiente ejemplo de `list-license-configurations` muestra solo la configuración de licencias especificada.  

```
aws license-manager list-license-configurations \
    --license-configuration-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
+  Para obtener información sobre la API, consulte [ListLicenseConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-configurations.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-license-specifications-for-resource`
<a name="license-manager_ListLicenseSpecificationsForResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-license-specifications-for-resource`.

**AWS CLI**  
**Para enumerar las configuraciones de licencias para un recurso**  
El siguiente ejemplo de `list-license-specifications-for-resource` muestra las configuraciones de licencias asociadas a la Imagen de máquina de Amazon (AMI) especificada.  

```
aws license-manager list-license-specifications-for-resource \
    --resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0
```
Salida:  

```
{
    "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE"
}
```
+  Para obtener información sobre la API, consulte [ListLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-license-specifications-for-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-resource-inventory`
<a name="license-manager_ListResourceInventory_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-resource-inventory`.

**AWS CLI**  
**Para enumerar los recursos del inventario de recursos**  
En el ejemplo de `list-resource-inventory`, se enumeran los recursos administrados mediante el inventario de Systems Manager.  

```
aws license-manager list-resource-inventory
```
Salida:  

```
{
    "ResourceInventoryList": [
        {
            "Platform": "Red Hat Enterprise Linux Server",
            "ResourceType": "EC2Instance",
            "PlatformVersion": "7.4",
            "ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-05d3cdfb05bd36376",
            "ResourceId": "i-05d3cdfb05bd36376",
            "ResourceOwningAccountId": "1234567890129"
        },
        {
            "Platform": "Amazon Linux",
            "ResourceType": "EC2Instance",
            "PlatformVersion": "2",
            "ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-0b1d036cfd4594808",
            "ResourceId": "i-0b1d036cfd4594808",
            "ResourceOwningAccountId": "1234567890129"
        },
        {
            "Platform": "Microsoft Windows Server 2019 Datacenter",
            "ResourceType": "EC2Instance",
            "PlatformVersion": "10.0.17763",
            "ResourceArn": "arn:aws:ec2:us-west-2:1234567890129:instance/i-0cdb3b54a2a8246ad",
            "ResourceId": "i-0cdb3b54a2a8246ad",
            "ResourceOwningAccountId": "1234567890129"
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [ListResourceInventory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-resource-inventory.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-tags-for-resource`
<a name="license-manager_ListTagsForResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.

**AWS CLI**  
**Para enumerar las etiquetas de una configuración de licencias**  
En el siguiente ejemplo de `list-tags-for-resource`, se enumeran las etiquetas para la configuración de licencias especificada.  

```
aws license-manager list-tags-for-resource \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Salida:  

```
{
    "Tags": [
        {
            "Key": "project",
            "Value": "lima"
        }
    ]
}
```
+  Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-usage-for-license-configuration`
<a name="license-manager_ListUsageForLicenseConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-usage-for-license-configuration`.

**AWS CLI**  
**Para enumerar las licencias en uso para una configuración de licencias**  
En el siguiente ejemplo de `list-usage-for-license-configuration`, se muestra información sobre los recursos que utilizan licencias para la configuración de licencias especificada. Por ejemplo, si el tipo de licencia es vCPU, todas las instancias consumen una licencia por vCPU.  

```
aws license-manager list-usage-for-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
```
Salida:  

```
{
    "LicenseConfigurationUsageList": [
        {
            "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-04a636d18e83cfacb",
            "ResourceType": "EC2_INSTANCE",
            "ResourceStatus": "running",
            "ResourceOwnerId": "123456789012",
            "AssociationTime": 1570892850.519,
            "ConsumedLicenses": 2
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [ListUsageForLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/list-usage-for-license-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `tag-resource`
<a name="license-manager_TagResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.

**AWS CLI**  
**Para agregar una etiqueta a una configuración de licencias**  
El siguiente ejemplo de `tag-resource` agrega la etiqueta especificada (nombre y valor de la clave) a la configuración de licencias especificada.  

```
aws license-manager tag-resource \
    --tags Key=project,Value=lima \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Este comando no genera ninguna salida.  
+  Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/tag-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `untag-resource`
<a name="license-manager_UntagResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.

**AWS CLI**  
**Para eliminar etiquetas de una configuración de licencias**  
El siguiente ejemplo de `untag-resource` elimina la etiqueta especificada (nombre de clave y recurso) de la configuración de licencias especificada.  

```
aws license-manager untag-resource \
    --tag-keys project \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
```
Este comando no genera ninguna salida.  
+  Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/untag-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-license-configuration`
<a name="license-manager_UpdateLicenseConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-license-configuration`.

**AWS CLI**  
**Actualización de una configuración de licencias**  
El siguiente ejemplo de `update-license-configuration` actualiza la configuración de licencias especificada para eliminar el límite estricto.  

```
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
```
Este comando no genera ninguna salida.  
El siguiente ejemplo de `update-license-configuration` actualiza la configuración de licencias especificada para cambiar su estado a `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
```
Este comando no genera ninguna salida.  
+  Para obtener información sobre la API, consulte [UpdateLicenseConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-license-specifications-for-resource`
<a name="license-manager_UpdateLicenseSpecificationsForResource_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-license-specifications-for-resource`.

**AWS CLI**  
**Para actualizar las configuraciones de licencias de un recurso**  
El siguiente ejemplo de `update-license-specifications-for-resource` reemplaza la configuración de licencias asociada a la Imagen de máquina de Amazon (AMI) especificada al eliminar una configuración de licencias y agregar otra.  

```
aws license-manager update-license-specifications-for-resource \
    --resource-arn arn:aws:ec2:us-west-2::image/ami-1234567890abcdef0 \
    --remove-license-specifications LicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE \
    --add-license-specifications LicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-42b6deb06e5399a980d555927EXAMPLE
```
Este comando no genera ninguna salida.  
+  Para obtener información sobre la API, consulte [UpdateLicenseSpecificationsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-license-specifications-for-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-service-settings`
<a name="license-manager_UpdateServiceSettings_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-service-settings`.

**AWS CLI**  
**Para actualizar la configuración de License Manager**  
El siguiente ejemplo de `update-service-settings` permite la detección de recursos entre cuentas para License Manager en la región de AWS actual. El bucket de Amazon S3 es la sincronización de datos de recursos necesaria para el inventario de Systems Manager.  

```
aws license-manager update-service-settings \
    --organization-configuration EnableIntegration=true \
    --enable-cross-accounts-discovery \
    --s3-bucket-arn arn:aws:s3:::aws-license-manager-service-abcd1234EXAMPLE
```
Este comando no genera ninguna salida.  
+  Para obtener información sobre la API, consulte [UpdateServiceSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/license-manager/update-service-settings.html) en la *Referencia de comandos de la AWS CLI*.