License Manager Manager-Beispiele mit AWS CLI - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples GitHub verfügbar.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

License Manager Manager-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit License Manager Aktionen ausführen und allgemeine Szenarien implementieren.

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 Szenarios anzeigen.

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

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungcreate-license-configuration.

AWS CLI

Beispiel 1: Um eine Lizenzkonfiguration zu erstellen

Im folgenden create-license-configuration Beispiel wird eine Lizenzkonfiguration mit einem festen 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: Um eine Lizenzkonfiguration zu erstellen

Im folgenden create-license-configuration Beispiel wird eine Lizenzkonfiguration mit einem Soft-Limit von 100 v erstelltCPUs. 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 die Verwendungdelete-license-configuration.

AWS CLI

Um eine Lizenzkonfiguration zu löschen

Im folgenden delete-license-configuration Beispiel 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 die Verwendungget-license-configuration.

AWS CLI

Um Informationen zur Lizenzkonfiguration abzurufen

Im folgenden get-license-configuration Beispiel werden Details für die angegebene 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 die Verwendungget-service-settings.

AWS CLI

So rufen Sie die License Manager Manager-Einstellungen ab

Im folgenden get-service-settings Beispiel werden die Diensteinstellungen 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 kontenübergreifende Ressourcenerkennung deaktiviert ist.

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

Im Folgenden wird eine Beispielausgabe gezeigt, wenn die kontenübergreifende Ressourcensuche aktiviert ist.

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

Das folgende Codebeispiel zeigt die Verwendunglist-associations-for-license-configuration.

AWS CLI

Um Verknüpfungen für eine Lizenzkonfiguration abzurufen

Im folgenden list-associations-for-license-configuration Beispiel 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 die Verwendunglist-license-configurations.

AWS CLI

Beispiel 1: Um alle Ihre Lizenzkonfigurationen aufzulisten

Das folgende list-license-configurations Beispiel listet alle Ihre Lizenzkonfigurationen auf.

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: Um eine bestimmte Lizenzkonfiguration aufzulisten

Im folgenden list-license-configurations Beispiel wird nur die angegebene Lizenzkonfiguration aufgeführt.

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 die Verwendunglist-license-specifications-for-resource.

AWS CLI

Um die Lizenzkonfigurationen für eine Ressource aufzulisten

Das folgende list-license-specifications-for-resource Beispiel listet die Lizenzkonfigurationen auf, 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 die Verwendunglist-resource-inventory.

AWS CLI

Um Ressourcen im Ressourceninventar aufzulisten

Das folgende list-resource-inventory Beispiel listet die Ressourcen auf, die mithilfe des Systems Manager Manager-Inventars 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 die Verwendunglist-tags-for-resource.

AWS CLI

Um die Tags für eine Lizenzkonfiguration aufzulisten

Das folgende list-tags-for-resource Beispiel listet die Tags für die angegebene Lizenzkonfiguration auf.

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 die Verwendunglist-usage-for-license-configuration.

AWS CLI

Um die Lizenzen aufzulisten, die für eine Lizenzkonfiguration verwendet werden

Das folgende list-usage-for-license-configuration Beispiel listet Informationen über die Ressourcen auf, die Lizenzen für die angegebene Lizenzkonfiguration verwenden. Wenn der Lizenztyp beispielsweise vCPU ist, verbrauchen alle Instanzen 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 die Verwendungtag-resource.

AWS CLI

Um ein Tag hinzuzufügen: eine Lizenzkonfiguration

Im folgenden tag-resource Beispiel wird das angegebene Tag (Schlüsselname und Wert) zur 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.

  • Einzelheiten zur API finden Sie TagResourceunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

Um Tags aus einer Lizenzkonfiguration zu entfernen

Im folgenden untag-resource Beispiel wird das angegebene Tag (Schlüsselname und Ressource) 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.

  • Einzelheiten zur API finden Sie UntagResourceunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-license-configuration.

AWS CLI

Um eine Lizenzkonfiguration zu aktualisieren

Im folgenden update-license-configuration Beispiel wird die angegebene Lizenzkonfiguration aktualisiert, um das feste Limit aufzuheben.

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 update-license-configuration Beispiel wird die angegebene Lizenzkonfiguration aktualisiert, sodass ihr Status auf geändert wirdDISABLED.

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 die Verwendungupdate-license-specifications-for-resource.

AWS CLI

Um die Lizenzkonfigurationen für eine Ressource zu aktualisieren

Das folgende update-license-specifications-for-resource Beispiel ersetzt die Lizenzkonfiguration, die dem angegebenen Amazon Machine Image (AMI) zugeordnet ist, indem eine Lizenzkonfiguration entfernt und eine weitere 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 die Verwendungupdate-service-settings.

AWS CLI

Um die License Manager Manager-Einstellungen zu aktualisieren

Das folgende update-service-settings Beispiel ermöglicht die kontenübergreifende Ressourcensuche für License Manager in der aktuellen AWS Region. Der Amazon S3 S3-Bucket ist der Resource Data Sync, der für das Systems Manager Manager-Inventar 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.