D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples
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 façon de configurer et d'exécuter le 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'
create-license-configuration
exemple 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-typeCore
\ --license-count10
\ --license-count-hard-limitSortie :
{ "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-configuration
exemple 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-typevCPU
\ --license-count100
\ --license-rules"#honorVcpuOptimization=true"
Sortie :
{ "LicenseConfigurationArn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE2222" }
-
Pour plus de détails sur l'API, voir CreateLicenseConfiguration
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-license-configuration
.
- AWS CLI
-
Pour supprimer une configuration de licence
L'
delete-license-configuration
exemple 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 aucun résultat.
-
Pour plus de détails sur l'API, voir DeleteLicenseConfiguration
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-license-configuration
.
- AWS CLI
-
Pour obtenir des informations de configuration de licence
L'
get-license-configuration
exemple 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, voir 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 du License Manager
L'
get-service-settings
exemple 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écouverte de ressources entre comptes est désactivée.
{ "OrganizationConfiguration": { "EnableIntegration": false }, "EnableCrossAccountsDiscovery": false }
Voici un exemple de sortie si la découverte de ressources entre 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, voir 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'
list-associations-for-license-configuration
exemple suivant affiche des 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 } ] }
-
Pour plus de détails sur l'API, voir ListAssociationsForLicenseConfiguration
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-license-configurations
.
- AWS CLI
-
Exemple 1 : pour répertorier toutes vos configurations de licence
L'
list-license-configurations
exemple 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'
list-license-configurations
exemple 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
-
Pour plus de détails sur l'API, voir ListLicenseConfigurations
la section Référence des AWS CLI commandes.
-
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'
list-license-specifications-for-resource
exemple suivant répertorie les configurations de licence associées à 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" }
-
Pour plus de détails sur l'API, voir ListLicenseSpecificationsForResource
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-resource-inventory
.
- AWS CLI
-
Pour répertorier les ressources dans l'inventaire des ressources
L'
list-resource-inventory
exemple 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, voir 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'
list-tags-for-resource
exemple suivant répertorie les balises correspondant à 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, voir 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'
list-usage-for-license-configuration
exemple 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 } ] }
-
Pour plus de détails sur l'API, voir ListUsageForLicenseConfiguration
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utilisertag-resource
.
- AWS CLI
-
Pour ajouter un tag, une configuration de licence
L'
tag-resource
exemple 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-arnarn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, voir 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'
untag-resource
exemple 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-arnarn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, voir 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 la configuration d'une licence
L'
update-license-configuration
exemple 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 aucun résultat.
L'
update-license-configuration
exemple suivant met à jour la configuration de licence spécifiée pour changer son statut enDISABLED
.aws license-manager update-license-configuration \ --license-configuration-status
DISABLED
--license-configuration-arnarn:aws:license-manager:us-west-2:880185128111:license-configuration:lic-6eb6586f508a786a2ba4f56c1EXAMPLE
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, voir UpdateLicenseConfiguration
la section Référence des AWS CLI commandes.
-
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'
update-license-specifications-for-resource
exemple suivant remplace la configuration de licence associée à l'Amazon Machine Image (AMI) spécifiée en supprimant une configuration de licence et en 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-specificationsLicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-38b658717b87478aaa7c00883EXAMPLE
\ --add-license-specificationsLicenseConfigurationArn=arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-42b6deb06e5399a980d555927EXAMPLE
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, voir UpdateLicenseSpecificationsForResource
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserupdate-service-settings
.
- AWS CLI
-
Pour mettre à jour les paramètres du License Manager
L'
update-service-settings
exemple 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 des données de ressources requise pour l'inventaire de Systems Manager.aws license-manager update-service-settings \ --organization-configuration
EnableIntegration=true
\ --enable-cross-accounts-discovery \ --s3-bucket-arnarn:aws:s3:::aws-license-manager-service-abcd1234EXAMPLE
Cette commande ne produit aucun résultat.
-
Pour plus de détails sur l'API, voir UpdateServiceSettings
la section Référence des AWS CLI commandes.
-