Exemples d’utilisation de l’AWS CLI avec License Manager - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec License Manager

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec License Manager.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser create-license-configuration.

AWS CLI

Exemple 1 : pour créer une configuration de licence

L’exemple create-license-configuration suivant crée une configuration de licence avec une limite stricte de 10 cœurs.

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

Sortie :

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

Exemple 2 : pour créer une configuration de licence

L’exemple create-license-configuration suivant crée une configuration de licence avec une limite flexible de 100 vCPU. Il utilise une règle pour activer l’optimisation des vCPU.

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

Sortie :

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

L’exemple de code suivant montre comment utiliser delete-license-configuration.

AWS CLI

Pour supprimer une configuration de licence

L’exemple delete-license-configuration suivant supprime la configuration de licence spécifiée.

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

Cette commande ne produit aucune sortie.

L’exemple de code suivant montre comment utiliser get-license-configuration.

AWS CLI

Pour obtenir les informations sur la configuration de licence

L’exemple get-license-configuration suivant affiche les détails de la configuration de licence spécifiée.

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

Sortie :

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

  • Pour plus de détails sur l’API, consultez GetLicenseConfiguration dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-service-settings.

AWS CLI

Pour obtenir les paramètres de License Manager

L’exemple get-service-settings suivant affiche les paramètres de service pour License Manager dans la région actuelle.

aws license-manager get-service-settings

Voici un exemple de sortie si la détection des ressources inter-comptes est désactivée.

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

Voici un exemple de sortie si la détection des ressources inter-comptes est activée.

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

  • Pour plus de détails sur l’API, consultez GetServiceSettings dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-associations-for-license-configuration.

AWS CLI

Pour obtenir des associations pour une configuration de licence

L’exemple list-associations-for-license-configuration suivant affiche les informations détaillées sur les associations de la configuration de licence spécifiée.

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

Sortie :

{
    "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’exemple de code suivant montre comment utiliser list-license-configurations.

AWS CLI

Exemple 1 : pour répertorier toutes vos configurations de licence

L’exemple list-license-configurations suivant répertorie toutes vos configurations de licence.

aws license-manager list-license-configurations

Sortie :

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

Exemple 2 : pour répertorier une configuration de licence spécifique

L’exemple list-license-configurations suivant répertorie uniquement la configuration de licence spécifiée.

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

L’exemple de code suivant montre comment utiliser list-license-specifications-for-resource.

AWS CLI

Pour répertorier les configurations de licence pour une ressource

L’exemple list-license-specifications-for-resource suivant répertorie les configurations de licence de l’Amazon Machine Image (AMI) spécifiée.

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

Sortie :

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

L’exemple de code suivant montre comment utiliser list-resource-inventory.

AWS CLI

Pour répertorier les ressources dans l’inventaire des ressources

L’exemple list-resource-inventory suivant répertorie les ressources gérées à l’aide de l’inventaire de Systems Manager.

aws license-manager list-resource-inventory

Sortie :

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

  • Pour plus de détails sur l’API, consultez ListResourceInventory dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-tags-for-resource.

AWS CLI

Pour répertorier les balises d’une configuration de licence

L’exemple list-tags-for-resource suivant répertorie les balises de la configuration de licence spécifiée.

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

Sortie :

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

  • Pour plus de détails sur l’API, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-usage-for-license-configuration.

AWS CLI

Pour répertorier les licences utilisées pour une configuration de licence

L’exemple list-usage-for-license-configuration suivant répertorie les informations relatives aux ressources utilisant des licences pour la configuration de licence spécifiée. Par exemple, si le type de licence est vCPU, toutes les instances consomment une licence par vCPU.

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

Sortie :

{
    "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’exemple de code suivant montre comment utiliser tag-resource.

AWS CLI

Pour ajouter une balise à une configuration de licence

L’exemple tag-resource suivant ajoute la balise spécifiée (nom de clé et valeur) à la configuration de licence spécifiée.

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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l’API, consultez TagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser untag-resource.

AWS CLI

Pour supprimer des balises d’une configuration de licence

L’exemple untag-resource suivant supprime la balise spécifiée (nom de clé et ressource) de la configuration de licence spécifiée.

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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l’API, consultez UntagResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-license-configuration.

AWS CLI

Pour mettre à jour une configuration de licence

L’exemple update-license-configuration suivant met à jour la configuration de licence spécifiée pour supprimer la limite stricte.

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

Cette commande ne produit aucune sortie.

L’exemple update-license-configuration suivant met à jour la configuration de licence spécifiée pour changer son statut en 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

Cette commande ne produit aucune sortie.

L’exemple de code suivant montre comment utiliser update-license-specifications-for-resource.

AWS CLI

Pour mettre à jour les configurations de licence pour une ressource

L’exemple update-license-specifications-for-resource suivant remplace la configuration de licence associée à l’Amazon Machine Image (AMI) spécifiée en supprimant une configuration de licence et en ajoutant une autre.

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

Cette commande ne produit aucune sortie.

L’exemple de code suivant montre comment utiliser update-service-settings.

AWS CLI

Pour mettre à jour les paramètres de License Manager

L’exemple update-service-settings suivant permet la détection des ressources inter-comptes pour License Manager dans la région AWS actuelle. Le compartiment Amazon S3 est la synchronisation de données de ressources requise pour l’inventaire 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

Cette commande ne produit aucune sortie.

  • Pour plus de détails sur l’API, consultez UpdateServiceSettings dans la Référence des commandes de l’AWS CLI.