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.
# Parameter der Amazon-ECS-Servicedefinition
Eine Servicedefinition legt fest, wie der Amazon-ECS-Service ausgeführt werden soll. Die folgenden Parameter können in einer Servicedefinition angegeben werden.
## Starttyp
`launchType`
Typ: Zeichenfolge
Zulässige Werte: `EC2` \$1 `FARGATE` \$1 `EXTERNAL`
Erforderlich: Nein
Der Starttyp, der für die Ausführung Ihres Service verwendet wird. Ist kein Starttyp angegeben, wird standardmäßig `capacityProviderStrategy` verwendet.
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
Wenn eine `launchType` angegeben ist, muss der `capacityProviderStrategy`-Parameter weggelassen werden.
## Kapazitätsanbieter-Strategie
`capacityProviderStrategy`
Typ: Array von -Objekten
Erforderlich: Nein
Die Kapazitätsanbieter-Strategie, die für den Service verwendet werden soll.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
Eine Kapazitätsanbieter-Strategie besteht aus einem oder mehreren Kapazitätsanbietern sowie dem ihnen zuzuweisenden `base`- und `weight`-Wert. Ein Kapazitätsanbieter muss dem Cluster zugeordnet sein, um in einer Kapazitätsanbieter-Strategie verwendet werden zu können. Die PutClusterCapacityProviders API wird verwendet, um einen Kapazitätsanbieter mit einem Cluster zu verknüpfen. Es können nur Kapazitätsanbieter mit dem Status `ACTIVE` oder `UPDATING` verwendet werden.
Wenn eine `capacityProviderStrategy` angegeben ist, muss der `launchType`-Parameter weggelassen werden. Wenn keine `capacityProviderStrategy` oder kein `launchType` angegeben ist, wird die `defaultCapacityProviderStrategy` für den Cluster verwendet.
Wenn Sie einen Kapazitätsanbieter angeben wollen, der eine Auto-Scaling-Gruppe verwendet, muss der Kapazitätsanbieter bereits erstellt sein. Neue Kapazitätsanbieter können mit dem CreateCapacityProvider API-Vorgang erstellt werden.
Um einen AWS Fargate-Kapazitätsanbieter zu verwenden, geben Sie entweder den `FARGATE` oder den `FARGATE_SPOT` Kapazitätsanbieter an. Die AWS Fargate-Kapazitätsanbieter sind für alle Konten verfügbar und müssen nur mit einem Cluster verknüpft werden, um verwendet zu werden.
Die PutClusterCapacityProviders API-Operation wird verwendet, um die Liste der verfügbaren Kapazitätsanbieter für einen Cluster zu aktualisieren, nachdem der Cluster erstellt wurde.
`capacityProvider`
Typ: Zeichenfolge
Erforderlich: Ja
Der Kurzname oder vollständige Amazon-Ressourcenname (ARN) des Kapazitätsanbieters.
`weight`
Typ: Ganzzahl
Gültiger Bereich: Ganzzahlen zwischen 0 und 1.000.
Erforderlich: Nein
Der Gewichtungswert gibt den relativen Prozentsatz der Gesamtzahl der gestarteten Aufgaben an, die den angegebenen Kapazitätsanbieter verwenden.
Nehmen Sie beispielsweise an, Sie haben eine Strategie, die zwei Kapazitätsanbieter enthält und beide eine Gewichtung von einem haben. Wenn die Basis zufrieden ist, werden die Aufgaben gleichmäßig auf die beiden Kapazitätsanbieter aufgeteilt. Unter Verwendung derselben Logik nehmen Sie an, dass Sie für *capacityProviderA* ein Gewicht von 1 und für *capacityProviderB* ein Gewicht von 4 angeben. Dann wird für jede Aufgabe, die mit *capacityProviderA* ausgeführt wird, vier Aufgaben mit *capacityProviderB* ausgeführt.
`base`
Typ: Ganzzahl
Gültiger Bereich: Ganzzahlen zwischen 0 und 100.000.
Erforderlich: Nein
Der Basiswert gibt an, wie viele Aufgaben mindestens mit dem angegebenen Kapazitätsanbieter ausgeführt werden sollen. In einer Kapazitätsanbieter-Strategie kann nur für einen Kapazitätsanbieter ein Basiswert festgelegt werden.
## Aufgabendefinition
`taskDefinition`
Typ: Zeichenfolge
Erforderlich: Nein
`family` und `revision` (`family:revision`) oder der vollständige Amazon-Ressourcenname (ARN) der Aufgabendefinition, die in Ihrem Service ausgeführt werden soll. Wenn keine `revision` angegeben ist, wird die neueste `ACTIVE`-Revision der angegebenen Familie verwendet.
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
Eine Aufgabendefinition muss angegeben werden, wenn der Rolling-Update (`ECS`)-Bereitstellungs-Controller verwendet wird.
## Plattform-Betriebssystem
`platformFamily`
Typ: Zeichenfolge
Required: Conditional
Standard: Linux
Dieser Parameter ist für Amazon-ECS-Services erforderlich, die auf Fargate gehostet werden.
Dieser Parameter wird für Amazon-ECS-Services ignoriert, die in Amazon EC2 gehostet werden.
Das Betriebssystem auf den Containern, auf denen der Service ausgeführt wird. Die gültigen Werte sind `LINUX`, `WINDOWS_SERVER_2019_FULL`, `WINDOWS_SERVER_2019_CORE`, `WINDOWS_SERVER_2022_FULL` und `WINDOWS_SERVER_2022_CORE`.
Der `platformFamily`-Wert für jede Aufgabe, die Sie für den Service angeben, muss mit dem `platformFamily`-Wert des Services übereinstimmen. Zum Beispiel: Wenn Sie `platformFamily` auf `WINDOWS_SERVER_2019_FULL` festlegen, muss der `platformFamily`-Wert für alle Aufgaben `WINDOWS_SERVER_2019_FULL` sein.
## Version der Plattform
`platformVersion`
Typ: Zeichenfolge
Erforderlich: Nein
Die Plattformversion, auf der Ihre Aufgaben im Service ausgeführt werden. Eine Plattformversion ist nur für Aufgaben mit dem Starttyp Fargate vorgesehen. Ist kein solcher angegeben, wird standardmäßig die neueste Version (`LATEST`) verwendet.
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
AWS Fargate-Plattformversionen werden verwendet, um auf eine bestimmte Laufzeitumgebung für die Fargate-Task-Infrastruktur zu verweisen. Bei der Angabe der `LATEST`-Plattformversion bei Ausführung einer Aufgabe oder beim Erstellen eines Service erhalten Sie die aktuellste Plattformversion, die für Ihre Aufgaben zur Verfügung steht. Wenn Sie Ihren Service skalieren, erhalten diese Aufgaben die Plattformversion, die in der aktuellen Bereitstellung des Service angegeben wurde. Weitere Informationen finden Sie unter [Fargate-Plattformversionen für Amazon ECS](platform-fargate.md).
Plattformversionen werden nicht für Aufgaben angegeben, die den Starttyp EC2 verwenden.
## Cluster
`cluster`
Typ: Zeichenfolge
Erforderlich: Nein
Die Kurzbezeichnung oder der vollständige Amazon-Ressourcenname (ARN) des Clusters, auf dem Sie Ihren Service ausführen. Wenn Sie keinen Cluster angeben, wird der `default`-Cluster verwendet.
## Service-Name
`serviceName`
Typ: Zeichenfolge
Erforderlich: Ja
Der Name Ihres Service. Bis zu 255 Buchstaben (Groß- und Kleinbuchstaben), Zahlen, Bindestriche und Unterstriche sind zulässig. Servicenamen in einem Cluster müssen eindeutig sein. Sie können jedoch ähnlich benannte Services in mehreren Clustern innerhalb einer Region oder in mehreren Regionen haben.
## Einplanungsstrategie
`schedulingStrategy`
Typ: Zeichenfolge
Zulässige Werte: `REPLICA` \$1 `DAEMON`
Erforderlich: Nein
Die Einplanungsstrategie, die verwendet werden soll. Wenn keine Einplanungsstrategie angegeben wird, wird die `REPLICA`-Strategie verwendet. Weitere Informationen finden Sie unter [Amazon-ECS-Dienstleistungen](ecs_services.md).
Es gibt zwei Strategien für Service-Scheduler:
+ `REPLICA`: Die Replica-Einplanungsstrategie platziert und die gewünschte Anzahl von Aufgaben in Ihrem Cluster und behält sie bei. Standardmäßig verteilt der Service-Scheduler Aufgaben über Availability Zones. Mit Aufgabenplatzierungsstrategien und -bedingungen können Sie festlegen, wie Aufgaben platziert und beendet werden. Weitere Informationen finden Sie unter [Planungsstrategie für Replikate](ecs_service-options.md#service_scheduler_replica).
+ `DAEMON`: Die Daemon-Einplanungsstrategie stellt genau eine Aufgabe auf jeder aktiven Container-Instance bereit, die alle von Ihnen in Ihrem Cluster angegebenen Platzierungsbedingungen für die Aufgaben erfüllt. Bei Verwendung dieser Strategie ist es nicht erforderlich, eine gewünschte Anzahl von Aufgaben oder eine Aufgabenplatzierungsstrategie anzugeben oder Auto-Scaling-Richtlinien zu verwenden. Weitere Informationen finden Sie unter [Planungsstrategie für Daemon](ecs_service-options.md#service_scheduler_daemon).
**Anmerkung**
Fargate-Aufgaben unterstützen die `DAEMON`-Einplanungsstrategie nicht.
## Gewünschte Anzahl
`desiredCount`
Typ: Ganzzahl
Erforderlich: Nein
Die Anzahl der Instanziierungen der angegebenen Aufgabendefinition, die in Ihrem Service platziert und ausgeführt werden sollen.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
Dieser Parameter ist erforderlich, wenn die `REPLICA`-Einplanungsstrategie verwendet wird. Wenn der Service die `DAEMON`-Einplanungsstrategie verwendet, ist dieser Parameter optional.
Wenn Sie Service-Auto-Scaling verwenden und einen aktuell ausgeführten Service aktualisieren, bei dem `desiredCount` weniger als die Anzahl der aktuell ausgeführten Aufgaben ist, wird der Service auf den angegebenen `desiredCount` herunterskaliert.
## Bereitstellungskonfiguration
`deploymentConfiguration`
Typ: Objekt
Erforderlich: Nein
Optionale Bereitstellungsparameter zur Steuerung, wie viele Aufgaben während der Bereitstellung ausgeführt werden, und zur Steuerung der Reihenfolge beim Starten oder Stoppen von Aufgaben.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
`maximumPercent`
Typ: Ganzzahl
Erforderlich: Nein
Wenn ein Service den Bereitstellungstyp der fortlaufenden Aktualisierung (`ECS`) verwendet, stellt der `maximumPercent`-Parameter eine Obergrenze für die Anzahl der Aufgaben Ihres Services dar, die während einer Bereitstellung im `RUNNING`-, `STOPPING`- oder `PENDING`-Status zulässig sind. Es wird als Prozentsatz des `desiredCount` ausgedrückt, der auf den nächsten ganzen Wert abgerundet wird. Mithilfe dieses Parameters können Sie die Größe der Verteilungsstapel definieren. Wenn Ihr Service beispielsweise den Service Scheduler `REPLICA` verwendet und einen `desiredCount` von vier Aufgaben und einen `maximumPercent`-Wert von 200 % hat, startet der Scheduler vier neue Aufgaben, bevor er die vier alten Aufgaben stoppt. Voraussetzung dafür ist, dass die dafür erforderlichen Cluster-Ressourcen zur Verfügung stehen. Der `maximumPercent`-Standardwert für einen Service mit dem `REPLICA`-Service-Scheduler beträgt 200 %.
Der Amazon ECS Scheduler verwendet diesen Parameter, um fehlerhafte Aufgaben zu ersetzen, indem er zuerst Ersatzaufgaben startet und dann die fehlerhaften Aufgaben anhält, sofern Cluster-Ressourcen für das Starten von Ersatzaufgaben verfügbar sind. Weitere Informationen dazu, wie der Scheduler fehlerhafte Aufgaben ersetzt, finden Sie unter [Amazon-ECS-Dienstleistungen](ecs_services.md).
Wenn Ihr Service den Service-Scheduler-Typ `DAEMON` verwendet, sollte `maximumPercent` bei 100 % verbleiben. Dies ist der Standardwert.
Die maximale Anzahl von Aufgaben während einer Bereitstellung ist die `desiredCount` multipliziert mit dem `maximumPercent`/100, abgerundet auf die nächste ganze Zahl.
Wenn ein Service entweder den Blau/Grün-Bereitstellungstyp (`CODE_DEPLOY`) oder den `EXTERNAL`-Bereitstellungstyp verwendet und Aufgaben ausführt, die den EC2-Starttyp verwenden, ist der Wert für den **maximalen Prozentsatz** auf den Standardwert gesetzt. Dieser Wert wird verwendet, um die untere und obere Grenze für die Anzahl der Aufgaben im Service zu definieren, die im Status `RUNNING` verbleiben, während sich die Container-Instances im Status `DRAINING` befinden.
Sie können keinen benutzerdefinierten `maximumPercent`-Wert für einen Service angeben, der entweder den Blau/Grün-Bereitstellungstyp (`CODE_DEPLOY`) oder den `EXTERNAL`-Bereitstellungstyp verwendet und Aufgaben hat, die EC2 verwenden.
Wenn der Service entweder den Blau/Grün-Bereitstellungstyp (`CODE_DEPLOY`) oder den `EXTERNAL`-Bereitstellungstyp verwendet und die Aufgaben im Service Fargate verwenden, wird der maximale Prozentwert nicht verwendet. Der Wert wird trotzdem in der Beschreibung des Services zurückgegeben.
`minimumHealthyPercent`
Typ: Ganzzahl
Erforderlich: Nein
Wenn ein Service den Bereitstellungstyp der fortlaufenden Aktualisierung (`ECS`) verwendet, stellt der `minimumHealthyPercent` eine Untergrenze für die Anzahl der Aufgaben Ihres Service dar, die während einer Bereitstellung im `RUNNING`-Status bleiben müssen. Dies wird als Prozentsatz des `desiredCount` ausgedrückt, der auf den nächsten ganzen Wert abgerundet wird. Sie können diesen Parameter verwenden, um die Bereitstellung ohne zusätzliche Cluster-Kapazität durchzuführen.
Wenn ein Service beispielsweise eine `desiredCount` von vier Aufgaben und einen `minimumHealthyPercent` von 50 % und einen `maximumPercent` von 100 % hat, stoppt der Service Scheduler zwei vorhandene Aufgaben, um Cluster-Kapazität freizugeben, bevor er zwei neue Aufgaben startet.
Wenn Aufgaben fehlerhaft sind und der Amazon ECS-Scheduler `maximumPercent` nicht in der Lage ist, Ersatzaufgaben zu starten, stoppt der Scheduler die fehlerhaften Aufgaben one-by-one — und verwendet dabei die `minimumHealthyPercent` als Einschränkung —, um Kapazitäten für die Ausführung von Ersatzaufgaben freizugeben. Weitere Informationen dazu, wie der Scheduler fehlerhafte Aufgaben ersetzt, finden Sie unter [Amazon-ECS-Dienstleistungen](ecs_services.md).
Bei Services, die *keinen* Load Balancer verwenden, ist Folgendes zu beachten:
+ Ein Service gilt als fehlerfrei, wenn alle entscheidenden Container innerhalb der Aufgaben im Service ihre Zustandsprüfungen bestehen.
+ Wenn für eine Aufgabe keine wesentlichen Container mit einer Zustandsprüfung definiert sind, wartet der Service-Scheduler 40 Sekunden, nachdem eine Aufgabe den `RUNNING`-Status erreicht hat, bevor die Aufgabe auf den minimalen fehlerfreien Gesamtprozentsatz angerechnet wird.
+ Wenn für eine Aufgabe ein oder mehrere wesentliche Container mit einer Zustandsprüfung definiert sind, wartet der Service-Scheduler, bis die Aufgabe einen fehlerfreien Status erreicht, bevor er sie auf den minimalen fehlerfreien Gesamtprozentsatz anrechnet. Eine Aufgabe gilt als fehlerfrei, wenn alle entscheidenden Container innerhalb der Aufgabe ihre Zustandsprüfungen bestanden haben. Wie lange der Service-Scheduler warten kann, wird durch die Einstellungen für die Zustandsprüfung der Container bestimmt. Weitere Informationen finden Sie unter [Gesundheitscheck](task_definition_parameters.md#container_definition_healthcheck).
Bei Services, die einen Load Balancer *verwenden*, ist Folgendes zu beachten:
+ Wenn für eine Aufgabe keine wesentlichen Container mit einer Zustandsprüfung definiert sind, wartet der Service-Scheduler, bis die Zustandsprüfung der Load Balancer-Zielgruppe einen fehlerfreien Status zurückgibt, bevor er die Aufgabe auf den Mindestprozentsatz für den fehlerfreien Zustand anrechnet.
+ Wenn für eine Aufgabe ein wesentlicher Container mit einer Zustandsprüfung definiert ist, wartet der Service-Scheduler darauf, dass sowohl die Aufgabe einen fehlerfreien Status erreicht als auch die Zustandsprüfung der Load-Balancer-Zielgruppe einen fehlerfreien Status zurückgibt, bevor er die Aufgabe auf den Mindestprozentsatz an fehlerfreien Aufgaben anrechnet.
Der Standardwert für einen Replica-Service für `minimumHealthyPercent` ist 100 %. Der `minimumHealthyPercent` Standardwert für einen Service, der den `DAEMON` Serviceplan verwendet, ist 0% für die AWS CLI, die und die AWS SDKs und 50% für die APIs . AWS-Managementkonsole
Die Mindestanzahl fehlerfreier Aufgaben während einer Bereitstellung ist die `desiredCount` multipliziert mit dem `minimumHealthyPercent`/100, aufgerundet auf die nächste ganze Zahl.
Wenn ein Service entweder den Blau/Grün-Bereitstellungstyp (`CODE_DEPLOY`) oder den `EXTERNAL`-Bereitstellungstyp verwendet und Aufgaben ausführt, die EC2 verwenden, ist der **minimale fehlerfreie Prozentsatz** auf den Standardwert gesetzt. Dieser Wert wird verwendet, um die untere Grenze für die Anzahl der Aufgaben im Service zu definieren, die im Status `RUNNING` verbleiben, während sich die Container-Instances im Status `DRAINING` befinden.
Sie können keinen benutzerdefinierten `maximumPercent`-Wert für einen Service angeben, der entweder den Blau/Grün-Bereitstellungstyp (`CODE_DEPLOY`) oder den `EXTERNAL`-Bereitstellungstyp verwendet und Aufgaben hat, die EC2 verwenden.
Wenn ein Service entweder den Blau/Grün-Bereitstellungstyp (`CODE_DEPLOY`) oder den `EXTERNAL`-Bereitstellungstyp verwendet und Aufgaben ausführt, die Fargate verwenden, wird der minimale fehlerfreie Prozentsatz nicht verwendet, obwohl er bei der Beschreibung Ihres Service zurückgegeben wird.
## Bereitstellungscontroller
`deploymentController`
Typ: Objekt
Erforderlich: Nein
Der für den Service zu verwendende Bereitstellungs-Controller. Wenn kein Bereitstellungs-Controller angegeben wird, wird der `ECS`-Controller verwendet. Weitere Informationen finden Sie unter [Amazon-ECS-Dienstleistungen](ecs_services.md).
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
`type`
Typ: Zeichenfolge
Zulässige Werte: `ECS` \$1 `CODE_DEPLOY` \$1 `EXTERNAL`
Erforderlich: Ja
Der zu verwendende Controller-Typ der Bereitstellung. Es sind drei Bereitstellungs-Controller-Typen verfügbar:
`ECS`
Der Amazon ECS Deployment Controller unterstützt mehrere Bereitstellungsstrategien: fortlaufende Updates, blue/green, linear, and canary. The rolling update deployment type involves replacing the current running version of the container with the latest version. Blue/green Bereitstellungen schaffen eine neue Umgebung und verlagern den Datenverkehr auf einmal. Lineare Bereitstellungen verlagern den Verkehr schrittweise in gleichen prozentualen Schritten. Bei Bereitstellungen auf Canary wird zunächst ein kleiner Prozentsatz des Datenverkehrs und dann der restliche Verkehr verlagert. Die Anzahl von Containern, die von Amazon ECS während einer fortlaufenden Aktualisierung zum Service hinzugefügt oder daraus entfernt werden, wird durch Anpassen der minimal und maximal zulässigen Anzahl fehlerfreier Aufgaben während einer Service-Bereitstellung wie unter [deploymentConfiguration](#deploymentConfiguration) angegeben gesteuert.
`CODE_DEPLOY`
Der Bereitstellungstyp blue/green (`CODE_DEPLOY`) verwendet das blue/green Bereitstellungsmodell Powered by CodeDeploy, mit dem Sie eine neue Bereitstellung eines Dienstes überprüfen können, bevor Sie Produktionsdatenverkehr an diesen senden.
`EXTERNAL`
Verwenden Sie den externen Bereitstellungstyp, wenn Sie einen beliebigen Drittanbieter-Bereitstellungs-Controller für die vollständige Kontrolle über den Bereitstellungsprozess für einen Amazon-ECS-Service verwenden möchten.
## Platzierung von Aufgaben
`placementConstraints`
Typ: Array von -Objekten
Erforderlich: Nein
Ein Array von Platzierungseinschränkungsobjekten, die für Aufgaben in Ihrem Service verwendet werden sollen. Sie können maximal zehn Einschränkungen pro Aufgabe festlegen. Das Limit enthält Einschränkungen in der Aufgabendefinition und solche, die während der Laufzeit festgelegt werden. Wenn Sie Fargate verwenden, werden keine Platzierungsbeschränkungen für Aufgaben unterstützt.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
`type`
Typ: Zeichenfolge
Erforderlich: Nein
Der Typ der Einschränkung. Um sicherzustellen, dass die einzelnen Aufgaben in einer bestimmten Gruppe auf einer anderen Container-Instance ausgeführt werden, verwenden Sie `distinctInstance`. Verwenden Sie `memberOf`, um die Auswahl auf eine Gruppe gültiger Kandidaten zu beschränken. Der Wert `distinctInstance` wird in Aufgabendefinitionen nicht unterstützt.
`expression`
Typ: Zeichenfolge
Erforderlich: Nein
Ein Ausdruck in Cluster-Abfragesprache, der auf die Einschränkung anzuwenden ist. Sie können keinen Ausdruck angeben, wenn der Einschränkungstyp `distinctInstance` lautet. Weitere Informationen finden Sie unter [Ausdrücke erstellen, um Container-Instances für Amazon-ECS-Aufgaben zu definieren](cluster-query-language.md).
`placementStrategy`
Typ: Array von -Objekten
Erforderlich: Nein
Die Platzierungsstrategieobjekte, die für Aufgaben in Ihrem Service verwendet werden sollen. Sie können maximal vier Strategieregeln pro Service festlegen.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
`type`
Typ: Zeichenfolge
Zulässige Werte: `random` \$1 `spread` \$1 `binpack`
Erforderlich: Nein
Der Typ der Platzierungsstrategie. Die `random`-Platzierungsstrategie platziert zufällig Aufgaben in verfügbaren Kandidaten. Die `spread`-Platzierungsstrategie verteilt die Platzierungen anhand der `field`-Parameter gleichmäßig auf die verfügbaren Kandidaten. Die `binpack`-Strategie platziert Aufgaben in verfügbaren Kandidaten, die mindestens über die im `field`-Parameter festgelegte Ressourcenmenge verfügen. Wenn Sie beispielsweise den Arbeitsspeicher verringern, wird eine Aufgabe auf der Instance mit dem geringsten verbleibenden Arbeitsspeicher platziert, der aber noch ausreicht, um die Aufgabe auszuführen.
`field`
Typ: Zeichenfolge
Erforderlich: Nein
Das Feld zur Anwendung der Platzierungsstrategie. Gültige Werte für die `spread`-Platzierungsstrategie sind `instanceId` (oder `host` mit denselben Auswirkungen) oder jedes weitere Plattform- oder benutzerdefiniertes Attribut, das auf ein Container-Instance angewendet wird, z. B. `attribute:ecs.availability-zone`. Für die `binpack`-Placement-Strategie gültige Werte sind `cpu` und `memory`. Für die `random`-Placement-Strategie wird dieses Feld nicht verwendet.
## Tags (Markierungen)
`tags`
Typ: Array von -Objekten
Erforderlich: Nein
Die Metadaten, die Sie auf den Service anwenden, um die Kategorisierung und Organisation zu erleichtern. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen. Wenn ein Service gelöscht wird, werden auch die Tags gelöscht. Es können maximal 50 Tags auf den Service angewendet werden. Weitere Informationen finden Sie unter [Markieren von Amazon-ECS-Ressourcen](ecs-using-tags.md).
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
`key`
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Erforderlich: Nein
Ein Teil eines Schlüssel-Wert-Paares, aus dem ein Tag besteht. Ein Schlüssel ist eine allgemeine Bezeichnung, die wie eine Kategorie für spezifischere Tag-Werte fungiert.
`value`
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.
Erforderlich: Nein
Der optionale Teil eines Schlüssel-Wert-Paares, aus dem ein Tag besteht. Ein Wert fungiert als Deskriptor in einer Tag-Kategorie (Schlüssel).
`enableECSManagedTags`
Typ: Boolescher Wert
Zulässige Werte: `true` \$1 `false`
Erforderlich: Nein
Gibt an, ob von Amazon ECS Managed Tags für Aufgaben im Service verwendet werden sollen. Der Standardwert ist `false`, wenn kein Wert angegeben wird. Weitere Informationen finden Sie unter [Verwenden von Tags für die Fakturierung](ecs-using-tags.md#tag-resources-for-billing).
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
`propagateTags`
Typ: Zeichenfolge
Zulässige Werte: `TASK_DEFINITION` \$1 `SERVICE`
Erforderlich: Nein
Gibt an, ob die Tags von der Aufgabendefinition oder dem Service in die Aufgaben in dem Service kopiert werden sollen. Wenn kein Wert angegeben wird, werden die Tags nicht kopiert. Tags können nur während der Serviceerstellung in die Aufgaben in dem Service kopiert werden. Wenn Sie Tags nach der Service- oder Aufgabenerstellung einer Aufgabe hinzufügen möchten, verwenden Sie die API-Aktion `TagResource`.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
## Netzwerkkonfiguration
`networkConfiguration`
Typ: Objekt
Erforderlich: Nein
Die Netzwerkkonfiguration für den Service. Dieser Parameter ist für Aufgabendefinitionen erforderlich, die den Netzwerkmodus `awsvpc` verwenden, um ihre eigene Elastic-Network-Schnittstelle zu empfangen. Für andere Netzwerkmodus wird er nicht unterstützt. Wenn Sie Fargate verwenden, ist der Netzwerkmodus `awsvpc` erforderlich. Weitere Informationen über Netzwerke für EC2 finden Sie unter [Netzwerkoptionen für Amazon-ECS-Aufgaben für EC2](task-networking.md). Weitere Informationen über Netzwerke für Fargate finden Sie unter [Netzwerkoptionen für Amazon-ECS-Aufgaben für Fargate](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/fargate-task-networking.html).
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
`awsvpcConfiguration`
Typ: Objekt
Erforderlich: Nein
Ein Objekt, das die Subnetze und Sicherheitsgruppen für eine Aufgabe oder einen Service darstellt.
`subnets`
Typ: Zeichenfolgen-Array
Erforderlich: Ja
Die Subnetze, die der Aufgabe oder dem Service zugeordnet sind. Es gibt ein Limit von 16 Subnetzen, die gemäß `awsvpcConfiguration` festgelegt werden können.
`securityGroups`
Typ: Zeichenfolgen-Array
Erforderlich: Nein
Die Sicherheitsgruppen, die der Aufgabe oder dem Service zugeordnet sind. Wenn Sie keine Sicherheitsgruppe angeben, wird die Standardsicherheitsgruppe für die VPC verwendet. Es gibt ein Limit von fünf Sicherheitsgruppen, die basierend auf `awsvpcConfiguration` festgelegt werden können.
`assignPublicIP`
Typ: Zeichenfolge
Zulässige Werte: `ENABLED` \$1 `DISABLED`
Erforderlich: Nein
Gibt an, ob die Elastic-Network-Schnittstelle eine öffentliche IP-Adresse erhält. Wenn kein Wert angegeben wird, wird der Standardwert `DISABLED` verwendet.
`healthCheckGracePeriodSeconds`
Typ: Ganzzahl
Erforderlich: Nein
Der Zeitraum in Sekunden, in dem der Amazon-ECS-Service-Scheduler fehlerhafte Elastic-Load-Balancing-, VPC-Lattice- und Container-Zustandsprüfungen ignoriert, nachdem eine Aufgabe erstmals gestartet wurde. Wenn Sie keine Übergangsfrist für die Zustandsprüfung angeben, wird der Standardwert 0 verwendet. Wenn Sie keine der Zustandsprüfungen verwenden, wird `healthCheckGracePeriodSeconds` nicht verwendet.
Wenn die Aufgaben Ihres Services eine Weile brauchen, bis sie gestartet sind und reagieren, können Sie eine Wartefrist für die Zustandsprüfung von bis zu 2.147.483.647 Sekunden (etwa 69 Jahre) festlegen. Während dieser Zeit ignoriert Amazon ECS Service Scheduler den Status der Zustandsprüfung. Diese Frist kann verhindern, dass der Service-Scheduler Aufgaben als ungesund markiert und stoppt, bevor sie ausreichend Zeit zum Initialisieren bekommen haben.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
`loadBalancers`
Typ: Array von -Objekten
Erforderlich: Nein
Ein Load Balancer-Objekt, das den Load Balancer angibt, der mit Ihrem Service verwendet werden soll. Für Services, die einen Application Load Balancer oder einen Network Load Balancer verwenden, gibt es ein Limit von fünf Zielgruppen, die Sie an einen Service anfügen können.
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
Nachdem Sie einen Dienst erstellt haben, kann die Load Balancer-Konfiguration von AWS-Managementkonsole nicht mehr geändert werden. Sie können den AWS Copilot AWS CLI oder das SDK verwenden AWS CloudFormation, um die Load Balancer-Konfiguration nur für den `ECS` Rolling Deployment Controller zu ändern, nicht für AWS CodeDeploy blau/grün oder extern. Wenn Sie eine Konfiguration für den Load Balancer hinzufügen, aktualisieren oder entfernen, startet Amazon ECS eine neue Bereitstellung mit der aktualisierten Konfiguration Elastic Load Balancing. Dies führt dazu, dass sich Aufgaben bei Load Balancern registrieren und von diesen abmelden. Wir empfehlen, dass Sie dies in einer Testumgebung überprüfen, bevor Sie die Konfiguration Elastic Load Balancing Balancing aktualisieren. Informationen zum Ändern der Konfiguration finden Sie [UpdateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html)in der *Amazon Elastic Container Service API-Referenz*.
Für Application Load Balancers und Network Load Balancers muss dieses Objekt den Zielgruppen-ARN des Load Balancers, den Namen des Containers (wie in der Containerdefinition angegeben) sowie den Container-Port enthalten, auf den vom Load Balancer aus zugegriffen werden soll. Wenn eine Aufgabe von diesem Service auf eine Container-Instance gesetzt wird, wird die Kombination aus Container-Instance und Port als Ziel in der hier angegebenen Zielgruppe registriert.
`targetGroupArn`
Typ: Zeichenfolge
Erforderlich: Nein
Der vollständige Amazon-Ressourcenname (ARN) der Elastic-Load-Balancing-Zielgruppe die einem Service angefügt sind.
Ein Zielgruppen-ARN wird nur bei Verwendung eines Application Load Balancers oder eines Network Load Balancers angegeben.
`loadBalancerName`
Typ: Zeichenfolge
Erforderlich: Nein
Der Name des Load Balancer, der dem Service zugeordnet werden soll.
Wenn Sie einen Application Load Balancer oder einen Network Load Balancer verwenden, lassen Sie den Load-Balancer-Name-Parameter weg.
`containerName`
Typ: Zeichenfolge
Erforderlich: Nein
Der Name des Containers (wie in der Containerdefinition angegeben), der mit dem Load Balancer verknüpft werden soll.
`containerPort`
Typ: Ganzzahl
Erforderlich: Nein
Der Port auf dem Container, der mit dem Load Balancer verknüpft werden soll. Dieser Port muss einem `containerPort` in der Aufgabendefinition entsprechen, die von den Aufgaben im Service verwendet wird. Für Aufgaben, die EC2 verwenden, muss die Container-Instance eingehenden Datenverkehr auf dem `hostPort` der Port-Zuweisung zulassen.
`role`
Typ: Zeichenfolge
Erforderlich: Nein
Der Kurzname oder vollständige ARM der IAM-Rolle, die es Amazon ECS ermöglicht, Aufrufe in Ihrem Namen an Ihren Load Balancer vorzunehmen. Dieser Parameter ist nur zulässig, wenn Sie einen Load Balancer mit einer einzelnen Zielgruppe für Ihren Service verwenden und Ihre Aufgabendefinition nicht den Netzwerkmodus `awsvpc` verwendet. Wenn Sie den `role`-Parameter festlegen, müssen Sie auch ein Load Balancer-Objekt mit dem `loadBalancers`-Parameter angeben.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
Wenn Ihre festgelegte Rolle einen anderen Pfad als `/` aufweist, müssen Sie entweder den vollständigen Rollen-ARN angeben (empfohlen) oder ein Präfix mit dem Pfad vor dem Rollennamen verwenden. Wenn beispielsweise ein Rolle mit dem Namen `bar` den Pfad `/foo/` aufweist, würden Sie `/foo/bar` als Rollennamen angeben. Weitere Informationen finden Sie unter [Anzeigenamen und Pfade](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-friendly-names) im *IAM-Benutzerhandbuch*.
Wenn Ihr Konto bereits über die servicegebundene Rolle für den Amazon ECS Service verfügt, wird diese Rolle standardmäßig für Ihren Service verwendet, es sei denn, Sie geben hier eine Rolle an. Die servicegebundene Rolle ist erforderlich, wenn Ihre Aufgabendefinition den Netzwerkmodus awsvpc verwendet. In diesem Fall sollten Sie hier keine Rolle angeben. Weitere Informationen finden Sie unter [Verwendung von serviceverknüpften Rollen für Amazon ECS](using-service-linked-roles.md).
`serviceConnectConfiguration`
Typ: Objekt
Erforderlich: Nein
Die Konfiguration für diesen Service, um Services zu erkennen und eine Verbindung zu ihnen herzustellen sowie von anderen Services innerhalb eines Namespace erkannt und verbunden zu werden.
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
Weitere Informationen finden Sie unter [Verwenden von Service Connect, um Amazon-ECS-Services mit Kurznamen zu verbinden](service-connect.md).
`enabled`
Typ: Boolescher Wert
Erforderlich: Ja
Gibt an, ob Service Connect mit diesem Service verwendet werden soll.
`namespace`
Typ: Zeichenfolge
Erforderlich: Nein
Der Kurzname oder der vollständige Amazon Resource Name (ARN) des AWS Cloud Map Namespaces zur Verwendung mit Service Connect. Der Namespace muss sich in derselben AWS-Region befinden wie der Amazon-ECS-Service und der Cluster. Der Typ des Namespace hat keine Auswirkungen auf Service Connect. Weitere Informationen zu finden Sie AWS Cloud Map unter [Working with Services](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *AWS Cloud Map Developer Guide*.
`services`
Typ: Array von -Objekten
Erforderlich: Nein
Ein Array von Service-Connect-Serviceobjekten. Dies sind Namen und Aliase (auch als Endpunkte bezeichnet), die von anderen Amazon-ECS-Services verwendet werden, um eine Verbindung zu diesem Service herzustellen.
Dieses Feld ist für einen „Client“-Amazon-ECS-Service, der nur Mitglied eines Namespace ist, nicht erforderlich, um eine Verbindung zu anderen Services innerhalb des Namespace herzustellen. Ein Beispiel ist eine Frontend-Anwendung, die eingehende Anfragen entweder von einem Load Balancer, der dem Service angefügt ist, oder auf andere Weise akzeptiert.
Ein Objekt wählt einen Port aus der Aufgabendefinition aus, weist dem AWS Cloud Map Dienst einen Namen und eine Reihe von Aliasen (auch als Endpunkte bezeichnet) und Ports zu, über die Client-Anwendungen auf diesen Dienst verweisen können.
`portName`
Typ: Zeichenfolge
Erforderlich: Ja
Der `portName` muss mit dem `name` einer der `portMappings` aus allen Containern in der Aufgabendefinition dieses Amazon-ECS-Service übereinstimmen.
`discoveryName`
Typ: Zeichenfolge
Erforderlich: Nein
Das `discoveryName` ist der Name des neuen AWS Cloud Map Service, den Amazon ECS für diesen Amazon ECS-Service erstellt. Dieser muss innerhalb des AWS Cloud Map -Namespace eindeutig sein.
Wenn dieses Feld nicht angegeben ist, wird `portName` verwendet.
`clientAliases`
Typ: Array von -Objekten
Erforderlich: Nein
Die Liste der Client-Aliase für diesen Service-Connect-Service. Sie verwenden diese, um Namen zuzuweisen, die von Client-Anwendungen verwendet werden können. Die maximale Anzahl von Client-Aliasen, die Sie in dieser Liste haben können, ist 1.
Jeder Alias („Endpunkt“) ist ein DNS-Name und eine Portnummer, die andere Amazon-ECS-Services („Clients“) verwenden können, um eine Verbindung zu diesem Service herzustellen.
Jede Kombination aus Name und Port muss innerhalb des Namespace eindeutig sein.
Diese Namen werden innerhalb jeder Aufgabe des Client-Services konfiguriert, nicht in AWS Cloud Map. DNS-Anfragen zum Auflösen dieser Namen verlassen die Aufgabe nicht und werden nicht auf das Kontingent von DNS-Anfragen pro Sekunde pro Schnittstelle für elastische Netzwerke angerechnet.
`port`
Typ: Ganzzahl
Erforderlich: Ja
Die Überwachungsportnummer für den Service-Connect-Proxy. Dieser Port ist in allen Aufgaben innerhalb desselben Namespace verfügbar.
Um zu vermeiden, dass Ihre Anwendungen in Amazon-ECS-Client-Services geändert werden, stellen Sie diesen auf denselben Port ein, den die Client-Anwendung standardmäßig verwendet.
`dnsName`
Typ: Zeichenfolge
Erforderlich: Nein
Der `dnsName` ist der Name, den Sie in den Anwendungen von Client-Aufgaben verwenden, um eine Verbindung zu diesem Service herzustellen. Der Name muss eine gültige DNS-Kennzeichnung sein.
Wenn dieses Feld nicht angegeben ist, ist der Standardwert das `discoveryName.namespace`. Wenn der `discoveryName` nicht angegeben ist, wird der `portName` aus der Aufgabendefinition verwendet.
Um zu vermeiden, dass Ihre Anwendungen in Amazon-ECS-Client-Services geändert werden, stellen Sie diesen auf denselben Namen ein, den die Client-Anwendung standardmäßig verwendet. Einige gängige Namen sind beispielsweise `database`, `db` oder der Name einer Datenbank in Kleinbuchstaben, wie z. B. `mysql` oder `redis`.
`ingressPortOverride`
Typ: Ganzzahl
Erforderlich: Nein
(Optional) Die Portnummer, die der Service-Connect-Proxy überwachen soll.
Verwenden Sie den Wert dieses Feldes, um den Proxy für den Datenverkehr an der Portnummer zu umgehen, die in der Aufgabendefinition dieser Anwendung unter dem Namen `portMapping` angegeben ist. Verwenden Sie diesen dann in Ihren Amazon-VPC-Sicherheitsgruppen, um den Datenverkehr in den Proxy für diesen Amazon-ECS-Service zuzulassen.
Im `awsvpc`-Modus ist der Standardwert die Container-Portnummer, die in der Aufgabendefinition dieser Anwendung im benannten `portMapping` angegeben ist. Im `bridge`-Modus ist der Standardwert der dynamische flüchtige Port des Service-Connect-Proxys.
`logConfiguration`
Typ: [LogConfiguration](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html)Objekt
Erforderlich: Nein
Dies definiert, wo die Service-Connect-Proxyprotokolle veröffentlicht werden. Verwenden Sie die Protokolle zum Debuggen bei unerwarteten Ereignissen. Diese Konfiguration legt den `logConfiguration`-Parameter im Service-Connect-Proxy-Container in jeder Aufgabe in diesem Amazon-ECS-Service fest. Der Proxy-Container ist nicht in der Aufgabendefinition angegeben.
Wir empfehlen, dieselbe Protokollkonfiguration wie die Anwendungscontainer der Aufgabendefinition für diesen Amazon-ECS-Service zu verwenden. Für FireLens ist dies die Protokollkonfiguration des Anwendungscontainers. Es ist nicht der FireLens Log-Router-Container, der das `fluentd ` Container-Image `fluent-bit` oder verwendet.
`accessLogConfiguration`
Typ: [ServiceConnectAccessLogConfiguration](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_LogConfiguration.html)Objekt
Erforderlich: Nein
Die Konfiguration für die Service Connect-Zugriffsprotokollierung, einschließlich des Protokollformats und ob die Protokolle Abfragezeichenfolgen enthalten sollen. In den Zugriffsprotokollen werden detaillierte Informationen über Anfragen an Ihren Service erfasst, darunter Anforderungsmuster, Antwortcode und Zeitdaten. Um Zugriffsprotokolle zu aktivieren, müssen Sie auch a `logConfiguration` in der angeben`serviceConnectConfiguration`.
`serviceRegistries`
Typ: Array von -Objekten
Erforderlich: Nein
Die Details der Serviceerkennungskonfiguration für Ihren Service. Weitere Informationen finden Sie unter [Die Serviceerkennung verwenden, um Amazon-ECS-Services mithilfe von DNS-Namen zu verbinden](service-discovery.md).
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
`registryArn`
Typ: Zeichenfolge
Erforderlich: Nein
Der Amazon-Ressourcenname (ARN) der Serviceregistrierung. Die derzeit unterstützte Dienstregistrierung ist AWS Cloud Map. Weitere Informationen finden Sie unter [Arbeiten mit Services](https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html) im *AWS Cloud Map -Entwicklerhandbuch*.
`port`
Typ: Ganzzahl
Erforderlich: Nein
Der Port-Wert, der verwendet wird, wenn Ihr Service zur Serviceerkennung einen SRV-Datensatz angegeben hat. Dieses Feld ist erforderlich, wenn der `awsvpc`-Netzwerkmodus und SRV-Datensätze verwendet werden.
`containerName`
Typ: Zeichenfolge
Erforderlich: Nein
Der Container-Namen-Wert, der für Ihren Service zur Serviceerkennung verwendet werden soll. Dieser Wert wird in der Aufgabendefinition festgelegt. Wenn die Aufgabendefinition, die Ihre Serviceaufgabe angibt, den Netzwerkmodus `bridge` oder `host` verwendet, müssen Sie eine Kombination aus `containerName` und `containerPort` aus der Aufgabendefinition angeben. Wenn die Aufgabendefinition, die Ihre Serviceaufgabe angibt, den Netzwerkmodus `awsvpc` verwendet und ein SRV-DNS-Datensatz verwendet wird, müssen Sie entweder eine Kombination aus `containerName` und `containerPort` angeben, oder einen `port`-Wert, aber nicht beides.
`containerPort`
Typ: Ganzzahl
Erforderlich: Nein
Der Portwert, der für Ihren Service zur Serviceerkennung verwendet werden soll. Dieser Wert wird in der Aufgabendefinition festgelegt. Wenn die Aufgabendefinition, die Ihre Serviceaufgabe angibt, den Netzwerkmodus `bridge` oder `host` verwendet, müssen Sie eine Kombination aus `containerName` und `containerPort` aus der Aufgabendefinition angeben. Wenn die Aufgabendefinition, die Ihre Serviceaufgabe angibt, den Netzwerkmodus `awsvpc` verwendet und ein SRV-DNS-Datensatz verwendet wird, müssen Sie entweder eine Kombination aus `containerName` und `containerPort` angeben, oder einen `port`-Wert, aber nicht beides.
## Client-Token
`clientToken`
Typ: Zeichenfolge
Erforderlich: Nein
Der eindeutige Bezeichner, bei dem die Groß- und Kleinschreibung beachtet werden muss, um die Idempotenz der Anfrage sicherzustellen. Er kann bis zu 32 ASCII-Zeichen lang sein.
## Neuausgleich der Availability Zone
`availabilityZoneRebalancing`
Typ: Zeichenfolge
Erforderlich: Nein
Gibt an, ob der Service Availability-Zone-Neuausgleich verwendet. Die gültigen Werte sind `ENABLED` und `DISABLED`.
Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.
Standardverhalten:
+ Für neue Services: Wenn kein Wert angegeben wird, lautet der Standardwert `DISABLED`.
+ Für bestehende Services: Wenn kein Wert angegeben ist, setzt Amazon ECS den Wert standardmäßig auf den vorhandenen Wert. Wenn zuvor kein Wert festgelegt wurde, setzt Amazon ECS den Wert auf `DISABLED`.
Weitere Informationen über Availability-Zone-Neuausgleich finden Sie unter [Ausgleichen eines Amazon-ECS-Service über Availability Zones hinweg](service-rebalancing.md).
## Volume-Konfigurationen
`volumeConfigurations`
Typ: Objekt
Erforderlich: Nein
Die Konfiguration, die zur Erstellung von Volumes für Aufgaben verwendet wird, die vom Service verwaltet werden. Nur Volumes, die in der Aufgabendefinition als `configuredAtLaunch` markiert sind, können mithilfe dieses Objekts konfiguriert werden.
Wenn Sie einen Service aktualisieren, löst dieser Parameter eine neue Servicebereitstellung aus.
Dieses Objekt ist erforderlich, um Amazon-EBS-Volumes an Aufgaben anzuhängen, die von einem Service verwaltet werden. Weitere Informationen finden Sie unter [Amazon-EBS-Volumes mit Amazon ECS verwenden](ebs-volumes.md).
`name`
Typ: Zeichenfolge
Erforderlich: Ja
Der Name eines Volumes, das bei der Erstellung oder Aktualisierung eines Service konfiguriert wird. Bis zu 255 Buchstaben (Groß- und Kleinbuchstaben), Ziffern, Unterstriche (`_`) und Bindestriche (`-`) sind erlaubt. Dieser Wert muss mit dem in der Aufgabendefinition angegebenen Volume-Namen übereinstimmen.
`managedEBSVolume`
Typ: Objekt
Erforderlich: Nein
Die Volume-Konfiguration, die für die Erstellung von Amazon-EBS-Volumes verwendet wird, die an Aufgaben angehängt werden, die von einem Service verwaltet werden, wenn der Service erstellt oder aktualisiert wird. Pro Aufgabe wird ein Volume angehängt.
`encrypted`
Typ: Boolesch
Erforderlich: Nein
Zulässige Werte: `true`\$1`false`
Gibt an, ob einzelne Amazon-EBS-Volumes verschlüsselt werden. Wenn Sie die Amazon EBS-Verschlüsselung standardmäßig für eine bestimmte AWS-Region Person aktiviert haben, diesen Parameter AWS-Konto aber auf setzen`false`, wird dieser Parameter überschrieben und die Volumes werden mit dem standardmäßig für die Verschlüsselung angegebenen KMS-Schlüssel verschlüsselt. Weitere Informationen über die standardmäßige Verschlüsselung in Amazon EBS finden Sie unter [Amazon-EBS-Verschlüsselung standardmäßig aktivieren](https://docs.aws.amazon.com/ebs/latest/userguide/encryption-by-default.html) im *Amazon-EBS-Benutzerhandbuch*. Weitere Informationen zur Verschlüsselung von Amazon-EBS-Volumes, die an Amazon-ECS-Aufgaben angehängt sind, finden Sie unter [Verschlüsseln von Daten, die in Amazon-EBS-Volumes gespeichert sind, die Amazon-ECS-Aufgaben angehängt sind](ebs-kms-encryption.md).
`kmsKeyId`
Typ: Zeichenfolge
Erforderlich: Nein
Die Kennung des AWS Key Management Service (AWS KMS) -Schlüssels, der für die Amazon EBS-Verschlüsselung verwendet werden soll. Wenn `kmsKeyId` angegeben ist, muss der verschlüsselte Status `true` sein.
Der mit diesem Parameter angegebene Schlüssel überschreibt den Amazon-EBS-Standardschlüssel oder einen beliebigen KMS-Schlüssel auf Cluster-Ebene für Amazon ECS Managed Storage Encryption, den Sie möglicherweise angegeben haben. Weitere Informationen finden Sie unter [Verschlüsseln von Daten, die in Amazon-EBS-Volumes gespeichert sind, die Amazon-ECS-Aufgaben angehängt sind](ebs-kms-encryption.md).
Sie können den KMS mit einer der Folgenden angeben:
+ **Schlüssel-ID** – Zum Beispiel `1234abcd-12ab-34cd-56ef-1234567890ab`.
+ **Schlüssel-Alias** – Zum Beispiel `alias/ExampleAlias`.
+ **Schlüssel-ARN** – Zum Beispiel `arn:aws:kms:us-east-1:012345678910:key/1234abcd-12ab-34cd-56ef-1234567890ab`.
+ **Alias-ARN** – Zum Beispiel `arn:aws:kms:us-east-1:012345678910:alias/ExampleAlias`.
AWS authentifiziert den KMS-Schlüssel asynchron. Wenn Sie also IDs, Aliase oder ARNs angeben, die nicht gültig sind, kann es so wirken, als würde die Aktion abgeschlossen, aber schlussendlich schlägt sie fehl. Weitere Informationen finden Sie unter [Fehlerbehebung bei Amazon-EBS-Volume-Anhängen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/troubleshoot-ebs-volumes.html).
`volumeType`
Typ: Zeichenfolge
Erforderlich: Nein
Gültige Werte: `gp2` \$1 `gp3` \$1 \$1 `io1` \$1 `io2` \$1 `sc1` `st1` `standard`
Typ des Amazon-EBS-Volumes. Weitere Informationen über Volume-Typen finden Sie unter [Amazon-EBS-Volume-Typen](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html) im *Amazon-EBS-Benutzerhandbuch*. Der Standard-Volume-Typ ist `gp3`.
Der `standard`-Volume-Typ wird für Fargate-Aufgaben nicht unterstützt.
`sizeInGiB`
Typ: Ganzzahl
Erforderlich: Nein
Gültiger Bereich: Ganzzahlen zwischen 1 und 16 384
Die Größe des EBS-Volumes in Gibibyte (GiB). Wenn Sie keine Snapshot-ID angeben, um ein Volume für das Anhängen zu konfigurieren, müssen Sie einen Größenwert angeben. Wenn Sie ein Volume für das Anhängen mithilfe eines Snapshots konfigurieren, ist der Standardwert die Snapshot-Größe. Sie können eine Volume-Größe angeben, die gleich oder größer als die Snapshot-Größe ist.
Für Volume-Typen `gp2` und `gp3` liegt der gültige Bereich zwischen 1 und 16 384.
Für Volume-Typen `io1` und `io2` liegt der gültige Bereich zwischen 4 und 16 384.
Für Volume-Typen `st1` und `sc1` liegt der gültige Bereich zwischen 125 und 16 384.
Für den Volume-Typ `standard` liegt der gültige Bereich zwischen 1 und 1 024.
`snapshotId`
Typ: Zeichenfolge
Erforderlich: Nein
Die ID des Snapshots eines vorhandenen Amazon-EBS-Volumes, den Amazon ECS verwendet, um neue Volumes zum Anhängen zu erstellen. Sie müssen entweder `snapshotId` oder `sizeInGiB` angeben.
`volumeInitializationRate`
Typ: Ganzzahl
Erforderlich: Nein
Die Geschwindigkeit in MiB/s, mit der Daten aus einem Snapshot eines vorhandenen Amazon-EBS-Volumes abgerufen werden, um neue Volumes für den Anhang zu erstellen. Diese Eigenschaft kann nur angegeben werden, wenn Sie eine `snapshotId` angeben. Weitere Informationen zu dieser Volume-Initialisierungsrate, einschließlich der Bandbreite der unterstützten Initialisierungsraten, finden Sie unter [Amazon-EBS-Volumes initialisieren](https://docs.aws.amazon.com/ebs/latest/userguide/initalize-volume.html) im *Amazon-EBS-Benutzerhandbuch*.
`iops`
Typ: Ganzzahl
Erforderlich: Nein
Die Anzahl der I/O Operationen pro Sekunde (IOPS). Im Fall von `gp3`-, `io1`- und `io2`-Volumes stellt dieser Wert die Anzahl der IOPS dar, die für das Volume bereitgestellt werden. Bei `gp2` Volumes steht dieser Wert für die Ausgangsleistung des Volumes und für die Rate, mit der das Volume I/O Credits für das Bursting sammelt. Dieser Parameter ist für `io1`- und `io2`-Volumes erforderlich. Dieser Parameter wird für `gp2`-, `st1`-, `sc1`- und `standard`-Volumes nicht unterstützt.
Für `gp3`-Volumes liegt der gültige Wertebereich zwischen 3 000 und 16 000.
Für `io1`-Volumes liegt der gültige Wertebereich zwischen 100 und 64 000.
Für `io2`-Volumes liegt der gültige Wertebereich zwischen 100 und 64 000.
`throughput`
Typ: Ganzzahl
Erforderlich: Nein
Der Durchsatz, der für die Volumes bereitgestellt werden muss, die mit Aufgaben verknüpft sind, die von einem Service verwaltet werden.
Dieser Parameter wird nur für `gp3`-Volumes unterstützt.
`roleArn`
Typ: Zeichenfolge
Erforderlich: Ja
Der Amazon Resource ARN (ARN) der Infrastrukturrolle AWS Identity and Access Management (IAM), die Amazon ECS-Berechtigungen zur Verwaltung von Amazon EBS-Ressourcen für Ihre Aufgaben bereitstellt. Weitere Informationen finden Sie unter [IAM-Rolle für die Amazon-ECS-Infrastruktur](infrastructure_IAM_role.md).
`tagSpecifications`
Typ: Objekt
Erforderlich: Nein
Die Spezifikation für Tags, die auf jedes Amazon-EBS-Volume angewendet werden sollen.
`resourceType`
Typ: Zeichenfolge
Erforderlich: Ja
Zulässige Werte: `volume`
Der Typ der Ressource, die bei der Erstellung markiert werden soll.
`tags`
Typ: Array von -Objekten
Erforderlich: Nein
Die Metadaten, die Sie auf Volumes anwenden, um die Kategorisierung und Organisation zu erleichtern. Jeder Tag besteht aus einem Schlüssel und einem optionalen Wert, die beide von Ihnen bestimmt sind. `AmazonECSCreated` und `AmazonECSManaged` sind reservierte Tags, die von Amazon ECS in Ihrem Namen hinzugefügt werden, sodass Sie maximal 48 eigene Tags angeben können. Wenn ein Volume gelöscht wird, werden auch die Tags gelöscht. Weitere Informationen finden Sie unter [Markieren von Amazon-ECS-Ressourcen](ecs-using-tags.md).
`key`
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Erforderlich: Nein
Ein Teil eines Schlüssel-Wert-Paares, aus dem ein Tag besteht. Ein Schlüssel ist eine allgemeine Bezeichnung, die wie eine Kategorie für spezifischere Tag-Werte fungiert.
`value`
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.
Erforderlich: Nein
Der optionale Teil eines Schlüssel-Wert-Paares, aus dem ein Tag besteht. Ein Wert fungiert als Deskriptor in einer Tag-Kategorie (Schlüssel).
`propagateTags`
Typ: Zeichenfolge
Zulässige Werte: `TASK_DEFINITION` \$1 `SERVICE` \$1 `NONE`
Erforderlich: Nein
Gibt an, ob die Tags von der Aufgabendefinition oder dem Service in ein neues Volume kopiert werden sollen. Wenn `NONE` angegeben wird oder kein Wert angegeben wird, werden die Tags nicht kopiert.
`fileSystemType`
Typ: Zeichenfolge
Erforderlich: Nein
Gültige Werte: `xfs` \$1 \$1 \$1 `ext3` `ext4` `NTFS`
Der Typ des Dateisystems auf einem Volume. Der Dateisystemtyp des Volumes bestimmt, wie Daten auf dem Volume gespeichert und abgerufen werden. Für Volumes, die aus einem Snapshot erstellt wurden, müssen Sie denselben Dateisystemtyp angeben, den das Volume bei der Erstellung des Snapshots verwendet hat. Wenn der Dateisystemtyp nicht übereinstimmt, kann die Aufgabe nicht gestartet werden.
Die gültigen Werte für Linux sind `xfs`, ext3 und `, and ext4`. Die Standardeinstellung für Volumes, die an Linux-Aufgaben angehängt sind, ist `XFS`.
Die gültigen Werte für Windows sind `NTFS`. Die Standardeinstellung für Volumes, die an Windows-Aufgaben angehängt sind, ist `NTFS`.