Ejemplos de License Manager que utilizan AWS CLI - AWS SDKEjemplos de código
Acciones

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de License Manager que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar situaciones comunes AWS Command Line Interface mediante 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

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

AWS CLI

Ejemplo 1: Para crear una configuración de licencia

El siguiente create-license-configuration ejemplo crea una configuración de licencia con un límite estricto 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: Para crear una configuración de licencia

El siguiente create-license-configuration ejemplo crea una configuración de licencia con un límite flexible de 100vCPUs. Utiliza una regla para habilitar la CPU optimización v.

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"
}

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

AWS CLI

Para eliminar una configuración de licencia

En el siguiente delete-license-configuration ejemplo, 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.

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

AWS CLI

Para obtener información sobre la configuración de la licencia

En el siguiente get-license-configuration ejemplo, se muestran los detalles de la configuración de licencia 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
        }
    ]
}

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

AWS CLI

Para obtener la configuración de License Manager

El siguiente get-service-settings ejemplo 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 resultado si la detección de recursos entre cuentas está deshabilitada.

{
    "OrganizationConfiguration": {
        "EnableIntegration": false
    },
    "EnableCrossAccountsDiscovery": false
}

A continuación, se muestra un ejemplo de resultado 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 API obtener más información, consulte GetServiceSettingsla Referencia de AWS CLI comandos.

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

AWS CLI

Para obtener asociaciones para una configuración de licencia

En el siguiente list-associations-for-license-configuration ejemplo, se muestra información detallada sobre las asociaciones de la configuración de licencia 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
        }
    ]
}

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

AWS CLI

Ejemplo 1: Para enumerar todas las configuraciones de licencia

En el siguiente list-license-configurations ejemplo, se enumeran todas las configuraciones de licencia.

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: Para enumerar una configuración de licencia específica

El siguiente list-license-configurations ejemplo muestra solo la configuración de licencia especificada.

aws license-manager list-license-configurations \
    --license-configuration-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE

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

AWS CLI

Para enumerar las configuraciones de licencia de un recurso

En el siguiente list-license-specifications-for-resource ejemplo, se enumeran las configuraciones de licencia asociadas a la Amazon Machine Image (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"
}

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

AWS CLI

Para enumerar los recursos en el inventario de recursos

En el siguiente list-resource-inventory ejemplo, se enumeran los recursos gestionados 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"
        }
    ]
}

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

AWS CLI

Para enumerar las etiquetas de una configuración de licencia

En el siguiente list-tags-for-resource ejemplo, se enumeran las etiquetas de la configuración de licencia 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 API obtener más información, consulte ListTagsForResourcela Referencia de AWS CLI comandos.

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

AWS CLI

Para enumerar las licencias en uso para una configuración de licencia

En el siguiente list-usage-for-license-configuration ejemplo, se muestra información sobre los recursos que utilizan licencias para la configuración de licencia especificada. Por ejemplo, si el tipo de licencia es vCPU, todas las instancias consumen una licencia por cada 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
        }
    ]
}

En el siguiente ejemplo de código se muestra cómo usar tag-resource.

AWS CLI

Para añadir una etiqueta, una configuración de licencia

En el siguiente tag-resource ejemplo, se agrega la etiqueta especificada (nombre y valor de la clave) a la configuración de licencia 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 API obtener más información, consulte TagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar untag-resource.

AWS CLI

Para eliminar etiquetas de una configuración de licencia

En el siguiente untag-resource ejemplo, se elimina la etiqueta especificada (nombre de clave y recurso) de la configuración de licencia 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 API obtener más información, consulte UntagResourcela Referencia de AWS CLI comandos.

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

AWS CLI

Para actualizar la configuración de una licencia

El siguiente update-license-configuration ejemplo actualiza la configuración de licencia 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.

En el siguiente update-license-configuration ejemplo, se actualiza la configuración de licencia especificada para cambiar su estado aDISABLED.

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.

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

AWS CLI

Para actualizar las configuraciones de licencia de un recurso

En el siguiente update-license-specifications-for-resource ejemplo, se reemplaza la configuración de licencia asociada a la Amazon Machine Image (AMI) especificada mediante la eliminación de una configuración de licencia y la adición de 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.

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

AWS CLI

Para actualizar la configuración de License Manager

El siguiente update-service-settings ejemplo permite la detección de recursos entre cuentas para License Manager en la AWS región actual. El bucket de Amazon S3 es el recurso de sincronización de datos necesario 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.