Operation: PutItem | X4Documentation

Mit der Operation PutItem des Amazon S3 DynamoDB Connectors platzieren Sie ein Element in einer Tabelle.

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

Parameter

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

Hinweis:

Für die Operation PutItem gibt es keine Einschränkungen für Elementnamen. Die Attribute name, value und type sind jedoch erforderlich.

<?xml version="1.0" encoding="UTF-8"?>
<RootElement>
	<Item>
		<Attribute name="..Name of PartionKey.." type="..Type of Partition.." value="..Value of PartitionKey.."/>
		<Attribute name="..Name of SortKey.." type="..Type of Sort.." value="..Value of SortKey.."/>
		<Attribute name="..Attribute Name.." type="..Attribute Type.." value="..Attribute Value.."/>
	</Item>
</RootElement>

Output

Der Adapter platziert das definierte Element in der gewünschten Tabelle.