License Manager Manager-Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

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 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 Siecreate-license-configuration.

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 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 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 die Verwendungget-license-configuration.

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 die Verwendungget-service-settings.

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 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

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 die Verwendunglist-license-configurations.

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

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 die Verwendunglist-resource-inventory.

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

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

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 die Verwendungtag-resource.

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.

  • Einzelheiten zur API finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

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.

  • Einzelheiten zur API finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-license-configuration.

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

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 die Verwendungupdate-service-settings.

AWS CLI

So aktualisieren Sie die Einstellungen für License Manager

Das folgende update-service-settings Beispiel ermöglicht die kontenübergreifende Ressourcensuche für License Manager in der aktuellen AWS Region. 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.