Operation: UpdateItem | X4Documentation

Mit der Operation UpdateItem des Amazon S3 DynamoDB Connectors aktualisieren Sie ein spezifisches Element in einer Tabelle.

Weitere Informationen zu anderen Operationen des Amazon S3 DynamoDB Connectors finden Sie unter Amazon S3 DynamoDB Connector.

Parameter

`keyID`	✳️ Dieser Parameter ist erforderlich für diese Operation. Zugangsschlüssel-ID für Anfragen an AWS (Amazon Web Services) Hinweis: Die Zugangsdaten werden über Parameter an den Adapter gesendet. Dabei gibt es verschiedene Konfigurationsmöglichkeiten. Weitere Informationen finden Sie unter Zugangsdaten einrichten. Mögliche Werte: Beliebige Zeichenkette mit der Zugangsschlüssel-ID, z. B. `AKIAIOSFODNN7EXAMPLE`
`secretKey`	✳️ Dieser Parameter ist erforderlich für diese Operation. Geheimer Zugangsschlüssel für Anfragen an AWS Hinweis: Die Zugangsdaten werden über Parameter an den Adapter gesendet. Dabei gibt es verschiedene Konfigurationsmöglichkeiten. Weitere Informationen finden Sie unter Zugangsdaten einrichten. Mögliche Werte: Beliebige Zeichenkette mit der geheimen Zugangsschlüssel, z. B. `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`
`region`	✳️ Dieser Parameter ist erforderlich für diese Operation. Region der Domains Hinweis: Buckets, die in einer bestimmten Region erstellt wurden, können nicht von einer anderen Region aus aufgerufen werden. Weitere Informationen finden Sie unter Regionen und Endpoints. Mögliche Werte: Beliebige Zeichenkette mit dem Namen der Region, z. B. `us-east-2`
`tableName`	✳️ Dieser Parameter ist erforderlich für diese Operation. Tabellen-Name Mögliche Werte: Zeichenkette mit dem Tabellen-Namen nach folgenden Namensregeln: Alle Namen müssen UTF-8-kodiert sein Die Groß- und Kleinschreibung muss beachtet werden Tabellennamen und Indexnamen müssen zwischen 3 und 255 Zeichen lang sein und dürfen nur folgende Zeichen enthalten: `a-z` `A-Z` `0-9` `_` (Unterstrich) `-` (Bindestrich) `.` (Punkt) Attributnamen müssen zwischen 1 und 255 Zeichen lang sein.
`partitionKey`, `partitionType` und `partitionKeyValue`	✳️ Die Parameter `partitionKey` und `partitionKeyValue` sind erforderlich für diese Operation. Elemente des Tabellen-Primärschlüssels Mögliche Werte: `PartitionKey`: Name des Partitionsschlüssels `PartitionType`: Partitionstyp S: Das Attribut ist eine Zeichenkette N: Das Attribut ist eine Zahl B: Das Attribut ist vom Typ Binär `PartitionKeyValue`: Wert des Elements
`sortKey`, `sortType` und `sortKeyValue`	Elemente des Tabellen-Primärschlüssels Mögliche Werte: `SortKey`: Name des Sortierschlüssels `SortType`: Sortiertyp S: Das Attribut ist eine Zeichenkette N: Das Attribut ist eine Zahl B: Das Attribut ist vom Typ Binär `SortKeyValue`: Wert des Elements
`readCapacityUnits`, `writeCapacitiyUnits`	Read/Write Capacity Units Mögliche Werte: Integer Capacity Units
`consistentRead`	DynamoDB verwendet Eventually Consistent Reads, sofern nichts anderes angeben ist. Leseoperationen wie `GetItem` und `Query` liefern einen ConsistentRead-Parameter. Wenn dieser Parameter auf `true` gesetzt ist, verwendet DynamoDB während des Betriebs Strongly Consistent Reads.

Statuswerte

`1`	Die Operation wurde erfolgreich ausgeführt
`0`	Die Operation wurde nicht vollständig ausgeführt, es ist aber kein Fehler aufgetreten.
`-1`	Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Input

Der Adapter erwartet eine vordefinierte XML-Struktur als Input.

Die folgenden Actions stehen für die Operation UpdateItem zur Verfügung:

ADD	Fügt ein neues Attribut im Element hinzu.
PUT	Aktualisiert den Wert des Attribut im angegebenen Element.
DELETE	Löscht das Attribut aus dem Element.

<?xml version="1.0" encoding="UTF-8"?>
<Input>
	<Item>
		<Attribute name="ID" type="N" value="5"
			action="ADD|PUT|DELETE"></Attribute>
		<Attribute name="Name" type="S" value="Luis"
			action="ADD|PUT|DELETE"></Attribute>
		<Attribute name="Surname" type="S" value="Delgado"
		action="ADD|PUT|DELETE"></Attribute>
	</Item>
</Input>

Output

Der Adapter aktualisiert das spezifische Element in der gewünschten Tabelle.