Exemples de License Manager utilisant AWS CLI - AWS Command Line Interface
Actions

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples de License Manager utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with 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 utilisercreate-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'create-license-configurationexemple suivant crée une configuration de licence avec une limite souple de 100 CPUs v. 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 utiliserdelete-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 utiliserget-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, reportez-vous GetLicenseConfigurationà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-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, reportez-vous GetServiceSettingsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 utiliserlist-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 utiliserlist-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 utiliserlist-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, reportez-vous ListResourceInventoryà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-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 utilisertag-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, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-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, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-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 utiliserupdate-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 utiliserupdate-service-settings.

AWS CLI

Pour mettre à jour les paramètres de License Manager

L'update-service-settingsexemple suivant permet la découverte de ressources entre comptes pour License Manager dans la AWS région 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, reportez-vous UpdateServiceSettingsà la section Référence des AWS CLI commandes.