Esempi di License Manager con AWS CLI - AWS Command Line Interface
Operazioni

Esempi di License Manager con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface con lo Strumento di gestione delle licenze.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare create-license-configuration.

AWS CLI

Esempio 1: per creare una configurazione di licenza

Nell’esempio seguente create-license-configuration crea una configurazione di licenza con un limite rigido di 10 core.

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

Output:

{
  "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111"
}

Esempio 2: per creare una configurazione di licenza

Nell’esempio seguente create-license-configuration crea una configurazione di licenza con un limite minimo di 100 vCPU. Utilizza una regola per abilitare l’ottimizzazione della vCPU.

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

Output:

{
  "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222"
}

L’esempio di codice seguente mostra come utilizzare delete-license-configuration.

AWS CLI

Come eliminare una configurazione di licenza

Nell’esempio seguente delete-license-configuration elimina la configurazione di licenza specificata.

aws license-manager delete-license-configuration \
    --license-configuration-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

Questo comando non produce alcun output.

L’esempio di codice seguente mostra come utilizzare get-license-configuration.

AWS CLI

Come ottenere informazioni sulla configurazione della licenza

L’esempio get-license-configuration seguente mostra i dettagli della configurazione di licenza specificata.

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

Output:

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

L’esempio di codice seguente mostra come utilizzare get-service-settings.

AWS CLI

Come ottenere le impostazioni dello Strumento di gestione delle licenze

Nell’esempio seguente get-service-settings visualizza le impostazioni del servizio per lo Strumento di gestione delle licenze nella Regione corrente.

aws license-manager get-service-settings

Di seguito viene illustrato un esempio di output se il rilevamento di risorse tra account è disabilitato.

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

Di seguito viene mostrato un esempio di output se il rilevamento di risorse tra account è abilitato.

{
    "S3BucketArn": "arn:aws:s3:::aws-license-manager-service-c22d6279-35c4-47c4-bb",
    "OrganizationConfiguration": {
        "EnableIntegration": true
    },
    "EnableCrossAccountsDiscovery": true
}

  • Per informazioni dettagliate sull’API, consulta GetServiceSettings in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-associations-for-license-configuration.

AWS CLI

Come ottenere le associazioni per la configurazione di una licenza

L’esempio list-associations-for-license-configuration seguente visualizza informazioni dettagliate per le associazioni della configurazione di licenza specificata.

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

Output:

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

L’esempio di codice seguente mostra come utilizzare list-license-configurations.

AWS CLI

Esempio 1: elencare tutte le configurazioni di licenza

Nell’esempio seguente list-license-configurations elenca tutte le configurazioni di licenza.

aws license-manager list-license-configurations

Output:

{
    "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
                }
            ]
        },
        {
            ...
        }
    ]
}

Esempio 2: elencare una configurazione di licenza specifica

Nell’esempio seguente list-license-configurations elenca solo la configurazione di licenza specificata.

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

L’esempio di codice seguente mostra come utilizzare list-license-specifications-for-resource.

AWS CLI

Come elencare le configurazioni di licenza per una risorsa

Nell’esempio seguente list-license-specifications-for-resource elenca le configurazioni di licenza associate all’Amazon Machine Image (AMI) specificata.

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

Output:

{
    "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE"
}

L’esempio di codice seguente mostra come utilizzare list-resource-inventory.

AWS CLI

Come elencare le risorse nell’inventario delle risorse

Nell’esempio seguente list-resource-inventory elenca le risorse gestite utilizzando l’inventario di Systems Manager.

aws license-manager list-resource-inventory

Output:

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

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come elencare i tag per una configurazione di licenza

Nell’esempio seguente list-tags-for-resource elenca i tag per la configurazione di licenza specificata.

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

Output:

{
    "Tags": [
        {
            "Key": "project",
            "Value": "lima"
        }
    ]
}

  • Per informazioni dettagliate sull'API, consulta ListTagsForResource nella Documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare list-usage-for-license-configuration.

AWS CLI

Come elencare le licenze in uso per una configurazione di licenza

Nell’esempio seguente list-usage-for-license-configuration elenca le informazioni sulle risorse che utilizzano le licenze per la configurazione di una licenza specificata. Ad esempio, se il tipo di licenza è vCPU, tutte le istanze impiegano una licenza per vCPU.

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

Output:

{
    "LicenseConfigurationUsageList": [
        {
            "ResourceArn": "arn:aws:ec2:us-west-2:123456789012:instance/i-04a636d18e83cfacb",
            "ResourceType": "EC2_INSTANCE",
            "ResourceStatus": "running",
            "ResourceOwnerId": "123456789012",
            "AssociationTime": 1570892850.519,
            "ConsumedLicenses": 2
        }
    ]
}

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come aggiungere un tag a una configurazione di licenza

Nell’esempio seguente tag-resource aggiunge il tag specificato (nome e valore della chiave) alla configurazione di licenza specificata.

aws license-manager tag-resource \
    --tags Key=project,Value=lima \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

Questo comando non produce alcun output.

  • Per informazioni dettagliate sulle API, consulta TagResource nel Riferimento ai comandi AWS CLI.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere i tag da una configurazione di licenza

Nell’esempio seguente untag-resource rimuove il tag specificato (nome chiave e risorsa) dalla configurazione di licenza specificata.

aws license-manager untag-resource \
    --tag-keys project \
    --resource-arn arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE

Questo comando non produce alcun output.

  • Per i dettagli dell'API, consulta UntagResource in Riferimento ai comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare update-license-configuration.

AWS CLI

Come aggiornare una configurazione di licenza

Nell’esempio seguente update-license-configuration aggiorna la configurazione di licenza specificata per rimuovere il limite rigido.

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

Questo comando non produce alcun output.

Nell’esempio seguente update-license-configuration aggiorna la configurazione di licenza specificata per modificarne lo stato in 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

Questo comando non produce alcun output.

L’esempio di codice seguente mostra come utilizzare update-license-specifications-for-resource.

AWS CLI

Come aggiornare le configurazioni di licenza per una risorsa

Nell’esempio seguente update-license-specifications-for-resource sostituisce la configurazione della licenza associata all’Amazon Machine Image (AMI) specificata rimuovendo una configurazione di licenza e aggiungendone un’altra.

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

Questo comando non produce alcun output.

L’esempio di codice seguente mostra come utilizzare update-service-settings.

AWS CLI

Come aggiornare le impostazioni dello Strumento di gestione delle licenze

Nell’esempio seguente update-service-settings abilita l’individuazione delle risorse tra account per lo Strumento di gestione delle licenze nella Regione AWS corrente. Il bucket Amazon S3 è lo strumento di sincronizzazione dei dati della risorsa necessario per l’inventario di 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

Questo comando non produce alcun output.