Unterstützte Konfigurationstypen und Parameter

allowed-resource-types

Dieser Parameter gibt an, dass die Ressourcengruppe nur aus Ressourcen des oder der angegebenen Typen bestehen kann.

Datentyp der Werte: Zeichenfolge

Zulässige Werte:

Erforderlich: Befristet, basierend auf anderen Configuration Elementen, die der Ressourcengruppe zugeordnet sind. Zulässige Werte finden Sie im vorherigen Eintrag.

Das folgende Beispiel beschränkt Gruppenmitglieder auf Amazon EC2-Host-Instances.

[
  {
    "Type": "AWS::ResourceGroups::Generic",
    "Parameters": [
      {
        "Name": "allowed-resource-types",
        "Values": [
          "AWS::EC2::Host"
        ]
      }
    ]
  }
]

deletion-protection

Dieser Parameter gibt an, dass die Ressourcengruppe nur gelöscht werden kann, wenn sie keine Mitglieder enthält. Weitere Informationen finden Sie unter Löschen einer Hostressourcengruppe im License Manager-Benutzerhandbuch

Datentyp der Werte: Array von Zeichenketten

Zulässige Werte: Der einzig zulässige Wert ist [ "UNLESS_EMPTY" ] (der Wert muss in Großbuchstaben geschrieben sein).

Erforderlich: Befristet, basierend auf anderen Configuration Elementen, die an die Ressourcengruppe angehängt sind. Dieser Parameter ist nur erforderlich, wenn die Ressourcengruppe auch ein anderes Configuration Element mit dem Wert Type von hatAWS::EC2::HostManagement.

Das folgende Beispiel aktiviert den Löschschutz für die Gruppe, sofern die Gruppe keine Mitglieder hat.

[
  {
    "Type": "AWS::ResourceGroups::Generic",
    "Parameters": [
      {
        "Name": "deletion-protection",
        "Values": [
          "UNLESS_EMPTY"
        ]
      }
    ]
  }
]

Name

Dieser Parameter gibt den Anzeigenamen der Anwendung an, der vom Benutzer bei der Erstellung in AppRegistry zugewiesen wurde.

Datentyp der Werte: Zeichenfolge

Zulässige Werte: jede Textzeichenfolge, die der AppRegistry Dienst für einen Anwendungsnamen zulässt.

Erforderlich: Ja

Arn

Dieser Parameter gibt den Amazon Resource Name (ARN) -Pfad der Anwendung an, der von zugewiesen wurde AppRegistry.

Datentyp der Werte: Zeichenfolge

Zulässige Werte: ein gültiger ARN.

Erforderlich: Ja

Name

Dieser Parameter gibt den Anzeigenamen des CloudFormation Stacks an, den der Benutzer bei der Erstellung des Stapels zugewiesen hat.

Datentyp der Werte: Zeichenfolge

Zulässige Werte: jede Textzeichenfolge, die der CloudFormation Dienst für einen Stacknamen zulässt.

Erforderlich: Ja

Arn

Dieser Parameter gibt den Amazon Resource Name (ARN) -Pfad des CloudFormation Stacks an, der an die Anwendung in angehängt ist AppRegistry.

Datentyp der Werte: Zeichenfolge

Zulässige Werte: ein gültiger ARN.

Erforderlich: Ja

Ein AWS::ResourceGroups::Generic Typ mit einem Parameter:

Ein AWS::EC2::CapacityReservationPool Typ mit zwei Parametern:

Sie können dieser Ressourcengruppenkonfiguration zusätzliche Kapazitätsreservierungen hinzufügen, aber für zusätzliche Reservierungen müssen auch die reservation-type Werte auf auf capacity-block und trn2u.48xlarge oder instance-type p6e-gb200.48xlarge gesetzt sein.

Derzeit ist der einzig zulässige Wert für reservation-type iscapacity-block, und die einzigen zulässigen Werte für instance-type sind trn2u.48xlarge und. p6e-gb200.48xlarge

Sie können Amazon EC2 Capacity Blocks for ML nicht zu einer Ressourcengruppe hinzufügen, die die Konfigurationen und nicht enthält. reservation-type instance-type

Das Hinzufügen der capacity-block Konfigurationsparameter reservation-type und ändert nichts am Prozess des Hinzufügens oder Entfernens von Gruppenreservierungen.

Wenn Sie die Kapazitätsreservierung aus der Gruppe entfernen oder die Gruppe löschen, werden die Reservierungen innerhalb der Gruppe so lange verwendet, bis die Instanzen beendet werden.

Derzeit können Ressourcengruppen mit den instance-type Konfigurationsparametern reservation-type und nach der Ersteinrichtung nicht aktualisiert werden. Um die Konfiguration zu ändern oder zu entfernen, müssen Sie die Gruppe löschen und dann eine neue Gruppe mit neuen Konfigurationen erstellen.

Sie können eine Instance nicht in einer leeren Gruppe starten oder eine Instance so ändern, dass sie auf eine leere Gruppe abzielt.

Ein AWS::ResourceGroups::Generic Typ mit einem Parameter von allowed-resource-types und einem Einzelwert vonAWS::EC2::Host. Dadurch wird sichergestellt, dass nur Amazon EC2-Dedicated Hosts Mitglieder der Gruppe sein können.

Ein AWS::ResourceGroups::Generic Typ mit einem Parameter von deletion-protection und einem einzelnen Wert vonUNLESS_EMPTY. Dadurch wird sichergestellt, dass die Gruppe nur gelöscht werden kann, wenn die Gruppe leer ist.

auto-allocate-host

Dieser Parameter gibt an, ob Instances auf einem bestimmten dedizierten Host oder auf einem beliebigen verfügbaren Host mit einer entsprechenden Konfiguration gestartet werden. Weitere Informationen finden Sie unter Automatische Platzierung und Affinität im Amazon EC2-Benutzerhandbuch.

Datentyp der Werte: Boolean

Zulässige Werte: „true“ oder „false“ (muss in Kleinbuchstaben geschrieben werden).

Required: No

[
  {
    "Type": "AWS::EC2::HostManagement",
    "Parameters": [
      {
        "Name": "auto-allocate-host",
        "Values": [
          "true"
        ]
      },
      {
        "Name": "any-host-based-license-configuration",
        "Values": [
          "true"
        ]
      }
    ]
  },
  {
    "Type": "AWS::ResourceGroups::Generic",
    "Parameters": [
      {
        "Name": "allowed-resource-types",
        "Values": [
          "AWS::EC2::Host"
        ]
      },
      {
        "Name": "deletion-protection",
        "Values": [
          "UNLESS_EMPTY"
        ]
      }
    ]
  }
]

auto-release-host

Dieser Parameter gibt an, ob ein dedizierter Host in der Gruppe automatisch freigegeben wird, nachdem seine letzte laufende Instanz beendet wurde. Weitere Informationen finden Sie unter Releasing Dedicated Hosts im Amazon EC2-Benutzerhandbuch.

Datentyp der Werte: Boolean

Zulässige Werte: „true“ oder „false“ (muss in Kleinbuchstaben geschrieben werden).

Required: No

[
  {
    "Type": "AWS::EC2::HostManagement",
    "Parameters": [
      {
        "Name": "auto-release-host",
        "Values": [
          "false"
        ]
      },
      {
        "Name": "any-host-based-license-configuration",
        "Values": [
          "true"
        ]
      }
    ]
  },
  {
    "Type": "AWS::ResourceGroups::Generic",
    "Parameters": [
      {
        "Name": "allowed-resource-types",
        "Values": [
          "AWS::EC2::Host"
        ]
      },
      {
        "Name": "deletion-protection",
        "Values": [
          "UNLESS_EMPTY"
        ]
      }
    ]
  }
]

allowed-host-families

Dieser Parameter gibt an, welche Instanztypfamilien von Instanzen verwendet werden können, die Mitglieder dieser Gruppe sind.

Datentyp von Werten: Ein Array von String-Werten.

Zulässige Werte: Bei jedem Wert muss es sich um eine gültige Amazon-EC2-Instance-Typ-Familienkennung handeln C4, z. B.M5,P3dn, oderR5d.

Required: No

Das folgende Beispielkonfigurationselement gibt an, dass gestartete Instances nur Mitglieder der C5- oder M5-Instance-Typfamilien sein können.

[
  {
    "Type": "AWS::EC2::HostManagement",
    "Parameters": [
      {
        "Name": "allowed-host-families",
        "Values": [
          "c5",
          "m5"
        ]
      },
      {
        "Name": "any-host-based-license-configuration",
        "Values": [
          "true"
        ]
      }
    ]
  },
  {
    "Type": "AWS::ResourceGroups::Generic",
    "Parameters": [
      {
        "Name": "allowed-resource-types",
        "Values": [
          "AWS::EC2::Host"
        ]
      },
      {
        "Name": "deletion-protection",
        "Values": [
          "UNLESS_EMPTY"
        ]
      }
    ]
  }
]

allowed-host-based-license-configurations

Dieser Parameter gibt die Amazon Resource Name (ARN) -Pfade einer oder mehrerer core/socket basierter Lizenzkonfigurationen an, die Sie auf Mitglieder der Gruppe anwenden möchten.

Datentyp von Werten: Ein Array von ARNs.

Zulässige Werte: Bei jedem Wert muss es sich um einen gültigen ARN für die License Manager-Konfiguration handeln.

Erforderlich: Bedingt. Sie müssen entweder diesen Parameter oderany-host-based-license-configuration, aber nicht beide, angeben. Sie schließen sich gegenseitig aus.

Das folgende Beispielkonfigurationselement gibt an, dass Gruppenmitglieder die beiden angegebenen License Manager-Konfigurationen verwenden können.

[
  {
    "Type": "AWS::EC2::HostManagement",
    "Parameters": [
      {
        "Name": "allowed-host-based-license-configurations",
        "Values": [
          "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111",
          "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-8a786a26f50ba416eb658EXAMPLE2222"
        ]
      }
    ]
  },
  {
    "Type": "AWS::ResourceGroups::Generic",
    "Parameters": [
      {
        "Name": "allowed-resource-types",
        "Values": [
          "AWS::EC2::Host"
        ]
      },
      {
        "Name": "deletion-protection",
        "Values": [
          "UNLESS_EMPTY"
        ]
      }
    ]
  }
]

any-host-based-license-configuration

Dieser Parameter gibt an, dass Sie Ihrer Gruppe keine bestimmte Lizenzkonfiguration zuordnen möchten. In diesem Fall sind alle core/socket basierten Lizenzkonfigurationen für Ihre Mitglieder Ihrer Hostressourcengruppe verfügbar. Verwenden Sie diese Einstellung, wenn Sie über eine unbegrenzte Anzahl von Lizenzen verfügen und die Host-Auslastung optimieren möchten.

Datentyp der Werte: Boolean

Zulässige Werte: „true“ oder „false“ (muss in Kleinbuchstaben geschrieben werden).

Erforderlich: Bedingt. Sie müssen entweder diesen Parameter oderallowed-host-based-license-configurations, aber nicht beide, angeben. Sie schließen sich gegenseitig aus.

Das folgende Beispielkonfigurationselement gibt an, dass Gruppenmitglieder jede core/socket basierte Lizenzkonfiguration verwenden können.

[
  {
    "Type": "AWS::EC2::HostManagement",
    "Parameters": [
      {
        "Name": "any-host-based-license-configuration",
        "Values": [
          "true"
        ]
      }
    ]
  },
  {
    "Type": "AWS::ResourceGroups::Generic",
    "Parameters": [
      {
        "Name": "allowed-resource-types",
        "Values": [
          "AWS::EC2::Host"
        ]
      },
      {
        "Name": "deletion-protection",
        "Values": [
          "UNLESS_EMPTY"
        ]
      }
    ]
  }
]

Die Mitglieder der Gruppe bestehen nur aus Ressourcen der Typen, die von der Netzwerk-Firewall unterstützt werden.

Die Gruppe muss eine tagbasierte Abfrage enthalten, um die Gruppenmitgliedschaft zu verwalten. Alle Ressourcen unterstützter Typen mit Stichwörtern, die der Abfrage entsprechen, sind automatisch Mitglieder der Gruppe.

Für diesen Konfigurationstyp werden keine Parameters unterstützt.

Um eine Ressourcengruppe dieses Konfigurationstyps zu löschen, kann von keiner Netzwerk-Firewall-Regelgruppe darauf verwiesen werden.