Beispiele für die Verwendung der AWS CLI mit License Manager - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit License Manager

Das folgende Codebeispiel zeigt, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie das AWS Command Line Interface mit License Manager nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-license-configuration verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie eine Lizenzkonfiguration

Im folgenden Beispiel für create-license-configuration wird eine Lizenzkonfiguration mit einem harten Limit von 10 Kernen erstellt.

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

Ausgabe:

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

Beispiel 2: So erstellen Sie eine Lizenzkonfiguration

Im folgenden Beispiel für create-license-configuration wird eine Lizenzkonfiguration mit einem weichen Limit von 100 vCPUs erstellt. Es verwendet eine Regel, um die vCPU-Optimierung zu aktivieren.

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie delete-license-configuration verwendet wird.

AWS CLI

So löschen Sie eine Lizenzkonfiguration

Im folgenden Beispiel für delete-license-configuration wird die angegebene Lizenzkonfiguration gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt, wie get-license-configuration verwendet wird.

AWS CLI

So rufen Sie Informationen zur Lizenzkonfiguration ab

Im folgenden Beispiel für get-license-configuration werden Details zur angegebenen Lizenzkonfiguration angezeigt.

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie get-service-settings verwendet wird.

AWS CLI

So rufen Sie die Einstellungen für License Manager ab

Im folgenden Beispiel für get-service-settings werden die Service-Einstellungen für License Manager in der aktuellen Region angezeigt.

aws license-manager get-service-settings

Das folgende Beispiel zeigt eine Ausgabe für den Fall, dass die kontoübergreifende Ressourcenerkennung deaktiviert ist.

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

Das folgende Beispiel zeigt eine Ausgabe für den Fall, dass die kontoübergreifende Ressourcenerkennung deaktiviert ist.

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

Das folgende Codebeispiel zeigt, wie list-associations-for-license-configuration verwendet wird.

AWS CLI

So rufen Sie Zuordnungen für eine Lizenzkonfiguration ab

Im folgenden Beispiel für list-associations-for-license-configuration werden detaillierte Informationen zu den Zuordnungen der angegebenen Lizenzkonfiguration angezeigt.

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie list-license-configurations verwendet wird.

AWS CLI

Beispiel 1: So listen Sie alle Ihre Lizenzkonfigurationen auf

Im folgenden Beispiel für list-license-configurations werden Ihre DNS-Firewall-Konfigurationen aufgelistet.

aws license-manager list-license-configurations

Ausgabe:

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

Beispiel 2: So listen Sie eine bestimmte Lizenzkonfiguration auf

Im folgenden Beispiel für list-license-configurations wird die angegebene Lizenzkonfiguration aufgelistet.

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

Das folgende Codebeispiel zeigt, wie list-license-specifications-for-resource verwendet wird.

AWS CLI

So listen Sie die Lizenzkonfigurationen für eine Ressource auf

Im folgenden Beispiel für list-license-specifications-for-resource werden die Lizenzkonfigurationen aufgelistet, die dem angegebenen Amazon Machine Image (AMI) zugeordnet sind.

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie list-resource-inventory verwendet wird.

AWS CLI

So listen Sie Ressourcen im Ressourcenbestand auf

Im folgenden Beispiel für list-resource-inventory werden die Ressourcen aufgelistet, die mithilfe des Systems-Manager-Bestand verwaltet werden.

aws license-manager list-resource-inventory

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie die Tags für eine Lizenzkonfiguration auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags für die angegebene Lizenzkonfiguration aufgelistet.

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie list-usage-for-license-configuration verwendet wird.

AWS CLI

So listen Sie die Lizenzen auf, die für eine Lizenzkonfiguration verwendet werden

Im folgenden Beispiel für list-usage-for-license-configuration werden Informationen zu den Ressourcen aufgelistet, die Lizenzen für die angegebene Lizenzkonfiguration verwenden. Wenn der Lizenztyp beispielsweise vCPU lautet, verbrauchen alle Instances eine Lizenz pro vCPU.

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

Ausgabe:

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

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie einer Lizenzkonfiguration ein Tag hinzu

Im folgenden Beispiel für tag-resource wird das angegebene Tag (Schlüsselname und Wert) der angegebenen Lizenzkonfiguration hinzugefügt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags aus einer Lizenzkonfiguration

Im folgenden Beispiel für untag-resource wird das angegebene Tag (Schlüsselname und Wert) aus der angegebenen Lizenzkonfiguration entfernt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-license-configuration verwendet wird.

AWS CLI

So aktualisieren Sie eine Lizenzkonfiguration

Im folgenden Beispiel für update-license-configuration wird die angegebene Lizenzkonfiguration aktualisiert, um das harte Limit zu entfernen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Im folgenden Beispiel für update-license-configuration wird die angegebene Lizenzkonfiguration aktualisiert, um ihren Status in DISABLEDzu ändern.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt, wie update-license-specifications-for-resource verwendet wird.

AWS CLI

So aktualisieren Sie die Lizenzkonfigurationen für eine Ressource

Im folgenden Beispiel für update-license-specifications-for-resource wird die dem angegebenen Amazon Machine Image (AMI) zugeordnete Lizenzkonfiguration ersetzt, indem eine Lizenzkonfiguration entfernt und eine andere hinzugefügt wird.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Das folgende Codebeispiel zeigt, wie update-service-settings verwendet wird.

AWS CLI

So aktualisieren Sie die Einstellungen für License Manager

Im folgenden Beispiel für update-service-settings wird die kontenübergreifende Ressourcensuche für License Manager in der aktuellen AWS-Region aktiviert. Der Amazon-S3-Bucket ist die Synchronisierung von Ressourcendaten, die für den Systems-Manager-Bestand erforderlich ist.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.