Esempi di License Manager che utilizzano AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di License Manager che utilizzano AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with License Manager.

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

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-license-configuration.

AWS CLI

Esempio 1: come creare una configurazione di licenza

L’esempio create-license-configuration seguente 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: come creare una configurazione di licenza

L'create-license-configurationesempio seguente crea una configurazione di licenza con un limite flessibile di 100 vCPUs. 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"
}

Il seguente esempio di codice mostra come utilizzaredelete-license-configuration.

AWS CLI

Come eliminare una configurazione della licenza

L’esempio delete-license-configuration seguente 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.

Il seguente esempio di codice mostra come utilizzareget-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
        }
    ]
}

Il seguente esempio di codice mostra come utilizzareget-service-settings.

AWS CLI

Come ottenere le impostazioni dello Strumento di gestione delle licenze

L’esempio get-service-settings seguente 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
}

Il seguente esempio di codice mostra come utilizzarelist-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
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-license-configurations.

AWS CLI

Esempio 1: come elencare tutte le configurazioni delle licenze

L’esempio list-license-configurations seguente 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: come elencare una configurazione della licenza specifica

L’esempio list-license-configurations seguente 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

Il seguente esempio di codice mostra come utilizzarelist-license-specifications-for-resource.

AWS CLI

Come elencare le configurazioni delle licenze per una risorsa

L’esempio list-license-specifications-for-resource seguente 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"
}

Il seguente esempio di codice mostra come utilizzarelist-resource-inventory.

AWS CLI

Come elencare le risorse nell’inventario delle risorse

L’esempio list-resource-inventory seguente 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Come elencare i tag per una configurazione della licenza

L’esempio list-tags-for-resource seguente 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"
        }
    ]
}

Il seguente esempio di codice mostra come utilizzarelist-usage-for-license-configuration.

AWS CLI

Come elencare le licenze in uso per una configurazione della licenza

L’esempio list-usage-for-license-configuration seguente elenca le informazioni sulle risorse che utilizzano le licenze per la configurazione di 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
        }
    ]
}

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come aggiungere un tag a una configurazione della licenza

L’esempio tag-resource seguente aggiunge il tag specificato (nome e valore di 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.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere i tag da una configurazione della licenza

L’esempio untag-resource seguente rimuove il tag specificato (nome di 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.

Il seguente esempio di codice mostra come utilizzareupdate-license-configuration.

AWS CLI

Come aggiornare una configurazione della licenza

L’esempio update-license-configuration seguente 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.

L’esempio update-license-configuration seguente 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.

Il seguente esempio di codice mostra come utilizzareupdate-license-specifications-for-resource.

AWS CLI

Come aggiornare le configurazioni delle licenze per una risorsa

L’esempio update-license-specifications-for-resource seguente sostituisce la configurazione di 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.

Il seguente esempio di codice mostra come utilizzareupdate-service-settings.

AWS CLI

Come aggiornare le impostazioni dello Strumento di gestione delle licenze

L'update-service-settingsesempio seguente abilita l'individuazione delle risorse tra account per License Manager nella AWS regione 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.