Parameter der Amazon-ECS-Servicedefinition

launchType

Typ: Zeichenfolge

Zulässige Werte: EC2 | FARGATE | 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.

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 einem Cluster zugeordnet 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.

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.

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, die auf Amazon gehostet werden, ignoriert EC2.

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.

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.

Anmerkung

Plattformversionen werden nicht für Aufgaben angegeben, die den Starttyp EC2 verwenden.

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.

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.

schedulingStrategy

Typ: Zeichenfolge

Zulässige Werte: REPLICA | 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.

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

Anmerkung
Fargate-Aufgaben unterstützen die DAEMON-Einplanungsstrategie nicht.

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.

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.

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 Dienst entweder den Typ Blau/Grün (CODE_DEPLOY) oder EXTERNAL Bereitstellungstypen und Aufgaben verwendet, die den EC2 Starttyp verwenden, wird der maximale Prozentwert auf den Standardwert festgelegt. 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.

Anmerkung

Sie können keinen benutzerdefinierten maximumPercent Wert für einen Dienst angeben, der entweder den Typ Blau/Grün (CODE_DEPLOY) oder den EXTERNAL Bereitstellungstyp verwendet und Aufgaben hat, die den verwenden. EC2

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 irgendwelche 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 — unter Verwendung der 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.

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.

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 Dienst entweder den Typ Blau/Grün (CODE_DEPLOY) oder den EXTERNAL Bereitstellungstyp verwendet und Aufgaben ausführt EC2, die den verwenden, wird der Mindestwert für den fehlerfreien Zustand auf den Standardwert festgelegt. 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.

Anmerkung

Sie können keinen benutzerdefinierten maximumPercent Wert für einen Dienst angeben, der entweder den Typ Blau/Grün (CODE_DEPLOY) oder den EXTERNAL Bereitstellungstyp verwendet und Aufgaben hat, die den verwenden. EC2

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.

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.

Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.

type

Typ: Zeichenfolge

Zulässige Werte: ECS | CODE_DEPLOY | 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 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.

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.

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

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.

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

Zulässige Werte: true | 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.

Wenn Sie einen Service aktualisieren, löst dieser Parameter keine neue Servicebereitstellung aus.

propagateTags

Typ: Zeichenfolge

Zulässige Werte: TASK_DEFINITION | 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.

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 unterNetzwerkoptionen für Amazon ECS-Aufgaben für EC2. Weitere Informationen über Netzwerke für Fargate finden Sie unter Netzwerkoptionen für Amazon-ECS-Aufgaben für Fargate.

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 | 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 ELB-, VPC Lattice- und Container-Zustandsprüfungen ignoriert, nachdem eine Aufgabe zum ersten Mal gestartet wurde. Wenn Sie keinen Wert für die Nachfrist für die Integritätsprüfung angeben, wird der Standardwert 0 verwendet. Wenn Sie keinen der Zustandschecks verwenden, healthCheckGracePeriodSeconds wird er nicht verwendet.

Wenn es eine Weile dauert, bis die Aufgaben Ihres Dienstes gestartet und beantwortet werden, können Sie eine Übergangszeit für die Integritätsprü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 blau/grün oder extern. AWS CodeDeploy 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 ELB-Konfiguration aktualisieren. Informationen zum Ändern der Konfiguration finden Sie UpdateServicein 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 ELB-Zielgruppe, die mit einem Service verknüpft ist.

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 dies verwenden EC2, muss die Container-Instance eingehenden Datenverkehr über das hostPort Port-Mapping 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 im IAM-Benutzerhandbuch.

Wichtig

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.

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 Sie Service Connect, um Amazon ECS-Services mit Kurznamen zu verbinden.

enabled

Typ: Boolesch

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

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

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

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.

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

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.

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 Ausgleich eines Amazon ECS-Service über mehrere Availability Zones.

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.

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

Gültige Werte: true|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 setzenfalse, 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 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.

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.

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.

Wichtig

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.

volumeType

Typ: Zeichenfolge

Erforderlich: Nein

Gültige Werte: gp2 | gp3 | | io1 | io2 | sc1 st1 standard

Typ des Amazon-EBS-Volumes. Weitere Informationen über Volume-Typen finden Sie unter Amazon-EBS-Volume-Typen im Amazon-EBS-Benutzerhandbuch. Der Standard-Volume-Typ ist gp3.

Anmerkung

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

Wichtig

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.

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.

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

Art des Starts

Kapazitätsanbieter-Strategie

Aufgabendefinition

Plattform-Betriebssystem

Version der Plattform

Anmerkung

Cluster

Service-Name

Einplanungsstrategie

Anmerkung

Gewünschte Anzahl

Bereitstellungskonfiguration

Anmerkung

Anmerkung

Deployment Controller

Platzierung von Aufgaben

Tags (Markierungen)

Netzwerkkonfiguration

Wichtig

Client-Token

Neuausgleich der Availability Zone

Volume-Konfigurationen

Wichtig

Anmerkung

Wichtig