Bicep リソース定義
dynamoDBTables リソースの種類は、次をターゲットとする操作と共にデプロイできます。
-
リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。
Microsoft.AwsConnector/dynamoDBTables リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.AwsConnector/dynamoDBTables@2024-12-01' = {
location: 'string'
name: 'string'
properties: {
arn: 'string'
awsAccountId: 'string'
awsProperties: {
arn: 'string'
attributeDefinitions: [
{
attributeName: 'string'
attributeType: 'string'
}
]
billingMode: 'string'
contributorInsightsSpecification: {
enabled: bool
}
deletionProtectionEnabled: bool
globalSecondaryIndexes: [
{
contributorInsightsSpecification: {
enabled: bool
}
indexName: 'string'
keySchema: [
{
attributeName: 'string'
keyType: 'string'
}
]
projection: {
nonKeyAttributes: [
'string'
]
projectionType: 'string'
}
provisionedThroughput: {
readCapacityUnits: int
writeCapacityUnits: int
}
}
]
importSourceSpecification: {
inputCompressionType: 'string'
inputFormat: 'string'
inputFormatOptions: {
csv: {
delimiter: 'string'
headerList: [
'string'
]
}
}
s3BucketSource: {
s3Bucket: 'string'
s3BucketOwner: 'string'
s3KeyPrefix: 'string'
}
}
keySchema: [
{
attributeName: 'string'
keyType: 'string'
}
]
kinesisStreamSpecification: {
approximateCreationDateTimePrecision: 'string'
streamArn: 'string'
}
localSecondaryIndexes: [
{
indexName: 'string'
keySchema: [
{
attributeName: 'string'
keyType: 'string'
}
]
projection: {
nonKeyAttributes: [
'string'
]
projectionType: 'string'
}
}
]
pointInTimeRecoverySpecification: {
pointInTimeRecoveryEnabled: bool
}
provisionedThroughput: {
readCapacityUnits: int
writeCapacityUnits: int
}
resourcePolicy: {
policyDocument: any(...)
}
sseSpecification: {
kmsMasterKeyId: 'string'
sseEnabled: bool
sseType: 'string'
}
streamArn: 'string'
streamSpecification: {
resourcePolicy: {
policyDocument: any(...)
}
streamViewType: 'string'
}
tableClass: 'string'
tableName: 'string'
tags: [
{
key: 'string'
value: 'string'
}
]
timeToLiveSpecification: {
attributeName: 'string'
enabled: bool
}
}
awsRegion: 'string'
awsSourceSchema: 'string'
awsTags: {
{customized property}: 'string'
}
publicCloudConnectorsResourceId: 'string'
publicCloudResourceName: 'string'
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
Microsoft.AwsConnector/dynamoDBTables
名前 |
形容 |
価値 |
場所 |
リソースが存在する地理的な場所 |
string (必須) |
名前 |
リソース名 |
糸
制約: パターン = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必須) |
プロパティ |
このリソースのリソース固有のプロパティ。 |
DynamoDBTableProperties の |
タグ |
リソース タグ |
タグ名と値のディクショナリ。 テンプレート の タグを参照してください |
属性定義
名前 |
形容 |
価値 |
attributeName (属性名) |
属性の名前。 |
糸 |
属性タイプ |
属性のデータ型。ここで、 + S - 属性は String + N 型です。属性は Number + B 型です。属性は Binary 型です |
糸 |
AwsDynamoDBTableプロパティ
名前 |
形容 |
価値 |
ARN |
プロパティ arn |
糸 |
attributeDefinitions (属性定義) |
テーブルとインデックスのキー スキーマを記述する属性の一覧。 このプロパティは、DDB テーブルを作成するために必要です。 更新が必要: いくつかの中断. 既存の AttributeDefinition を編集した場合の置換。 |
AttributeDefinition[] の |
ビリングモード |
読み取りと書き込みのスループットに対して課金される方法と、容量を管理する方法を指定します。 有効な値には、 + PROVISIONED - 予測可能なワークロードに PROVISIONED を使用することをお勧めします。 は、課金モードをプロビジョニング モード設定します。
+
PAY_PER_REQUEST - 予測できないワークロードには PAY_PER_REQUEST を使用することをお勧めします。 、課金モードをオンデマンド モードのに設定します。 指定しない場合、既定値は PROVISIONED です。 |
糸 |
contributorInsights仕様 |
指定したテーブルに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 |
寄稿者インサイト仕様 |
deletionProtection有効 |
テーブルが削除から保護されているかどうかを判断します。 有効にすると、どのユーザーまたはプロセスもテーブルを削除できません。 この設定は、既定では無効になっています。 詳細については、「開発者ガイドの削除保護 の使用 を参照してください。 |
ブール (bool) |
globalSecondaryインデックス |
テーブルに作成されるグローバル セカンダリ インデックス。 最大 20 個のグローバル セカンダリ インデックスを作成できます。 新しいグローバル セカンダリ インデックスを含むようにテーブルを更新すると、CFNlong によってインデックスの作成が開始され、スタックの更新が続行されます。 テーブルのサイズによってはバックフィル フェーズに時間がかかる可能性があるため、CFNlong はインデックスの作成が完了するまで待機しません。 インデックスの状態が ACTIVE されるまで、インデックスを使用したり、テーブルを更新したりすることはできません。 DynamoDB DescribeTable コマンドを使用して、状態を追跡できます。 更新中にインデックスを追加または削除する場合は、他のリソースを更新しないことをお勧めします。 スタックの更新に失敗し、新しいインデックスの追加中にロールバックされた場合は、インデックスを手動で削除する必要があります。 更新プログラムはサポートされていません。 例外は次のとおりです。+ 共同作成者分析情報の仕様またはグローバル セカンダリ インデックスのプロビジョニング済みスループット値を更新する場合は、中断することなくテーブルを更新できます。 + 1 つのグローバル セカンダリ インデックスを中断せずに削除または追加できます。 同じ更新 (インデックスの論理 ID の変更など) で両方を実行すると、更新は失敗します。 |
GlobalSecondaryIndex[] |
importSourceSpecification (英語) |
S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。
ImportSourceSpecification プロパティを指定し、StreamSpecification 、TableClass プロパティ、または DeletionProtectionEnabled プロパティを指定する場合、IAM エンティティの作成/更新スタックには UpdateTable アクセス許可が必要です。 S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。 |
ImportSourceSpecification (英語) |
キースキーマ |
テーブルの主キーを構成する属性を指定します。
KeySchema プロパティの属性は、AttributeDefinitions プロパティでも定義する必要があります。 |
キースキーマ[] |
kinesisStream仕様 |
指定したテーブルの Kinesis データ ストリーム構成。 指定したテーブルの Kinesis データ ストリーム構成。 |
KinesisStreamSpecification (キネシスストリーム仕様) |
localSecondaryインデックス |
テーブルに作成するローカル セカンダリ インデックス。 最大 5 つのローカル セカンダリ インデックスを作成できます。 各インデックスのスコープは、特定のハッシュ キー値です。 各ハッシュ キーのサイズは最大 10 ギガバイトです。 |
LocalSecondaryIndex[] |
pointInTimeRecoverySpecification (ポイントインタイムリカバリ仕様) |
ポイントインタイム リカバリーを有効にするために使用される設定。 ポイントインタイム リカバリーを有効にするために使用される設定。 |
PointInTimeRecovery仕様 |
プロビジョニングされたスループット |
指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニングされたスループット構造の内容の詳細については、「Amazon DynamoDB Table ProvisionedThroughputを参照してください。
BillingMode として PROVISIONED を設定する場合は、このプロパティを指定する必要があります。
BillingMode を PAY_PER_REQUEST として設定した場合、このプロパティを指定することはできません。 指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 |
プロビジョニングされたスループット |
リソースポリシー |
指定したテーブルに追加するアクセス許可を含むリソース ベースのポリシー ドキュメント。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 テーブルの作成時にリソース ベースのポリシーをアタッチすると、ポリシーの作成 厳密に一貫性のあるになります。 リソース ベースのポリシーをアタッチするときに留意する必要がある考慮事項については、「リソース ベースのポリシーに関する考慮事項 を参照してください。 テーブル、インデックス、ストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 CFNshort テンプレートでリソースベースのポリシーを定義する場合、次の考慮事項が適用されます。 + JSON 形式のリソースベースのポリシー ドキュメントでサポートされる最大サイズは 20 KB です。 DDB は、この制限に対してポリシーのサイズを計算するときに空白をカウントします。 + リソースベースのポリシーでは、ドリフト検出サポートされていません。 CFNshort スタック テンプレートの外部でポリシーを更新する場合は、CFNshort スタックを変更で更新する必要があります。 + リソース ベースのポリシーでは、帯域外の変更はサポートされません。 CFNshort テンプレートの外部でポリシーを追加、更新、または削除した場合、テンプレート内のポリシーに変更がない場合、変更は上書きされません。 たとえば、テンプレートにリソースベースのポリシーが含まれているとします。このポリシーは後でテンプレートの外部で更新します。 テンプレート内のポリシーに変更を加えない場合、DDB で更新されたポリシーはテンプレート内のポリシーと同期されません。 逆に、テンプレートにリソースベースのポリシーが含まれていないが、テンプレートの外部にポリシーを追加するとします。 テンプレートに追加しない限り、このポリシーは DDB から削除されません。 テンプレートにポリシーを追加してスタックを更新すると、DDB 内の既存のポリシーがテンプレートで定義されているポリシーと一致するように更新されます。 すべての考慮事項の完全な一覧については、「リソースベースのポリシーに関する考慮事項 を参照してください。 |
リソースポリシー |
sseSpecification (英語) |
サーバー側の暗号化を有効にする設定を指定します。 サーバー側の暗号化を有効にするために使用される設定を表します。 |
SSES仕様 |
ストリームアーン |
プロパティ streamArn |
糸 |
ストリーム仕様 |
テーブルに格納されている項目に対する変更をキャプチャする DDB テーブル ストリームの設定。 DynamoDB のテーブルの DynamoDB Streams 構成を表します。 |
ストリーム仕様 |
テーブルクラス |
新しいテーブルのテーブル クラス。 有効な値は STANDARD と STANDARD_INFREQUENT_ACCESS です。 |
糸 |
テーブル名 |
テーブルの名前。 名前を指定しない場合、CFNlong は一意の物理 ID を生成し、その ID をテーブル名に使用します。 詳細については、「名前の種類の」を参照してください。 名前を指定した場合、このリソースの置き換えを必要とする更新を実行することはできません。 中断を必要としない更新プログラムを実行できます。 リソースを置き換える必要がある場合は、新しい名前を指定します。 |
糸 |
タグ |
このリソースに適用するキーと値のペアの配列。 詳細については、「タグの」を参照してください。 |
タグ自動生成8[] |
timeToLive仕様 |
テーブルの Time to Live (TTL) 設定を指定します。 DynamoDB の制限の詳細については、「Amazon DynamoDB 開発者ガイド」の「Amazon DynamoDB の 制限」を参照してください。 指定したテーブルの Time to Live (TTL) を有効または無効にするために使用される設定を表します。 |
TimeToLive仕様 |
寄稿者インサイト仕様
名前 |
形容 |
価値 |
有効 |
CloudWatch Contributor Insights を有効 (true) または無効 (false) にするかどうかを示します。 |
ブール (bool) |
CSVファイル
名前 |
形容 |
価値 |
デリミタ |
インポートする CSV ファイル内の項目を区切る区切り記号。 |
糸 |
ヘッダーリスト |
インポートするすべてのソース CSV ファイルの共通ヘッダーを指定するために使用されるヘッダーの一覧。 このフィールドを指定すると、各 CSV ファイルの最初の行がヘッダーではなくデータとして扱われます。 このフィールドが指定されていない場合、各 CSV ファイルの最初の行がヘッダーとして扱われます。 |
文字列[] |
DynamoDBTableProperties (ダイナモDBTableプロパティ)
名前 |
形容 |
価値 |
ARN |
Amazon リソース名 (ARN) |
糸 |
awsAccountId (英語) |
AWS アカウント ID |
糸 |
awsプロパティ |
AWS のプロパティ |
awsDynamoDBTableProperties の |
awsリージョン |
AWS リージョン |
糸 |
awsSourceSchema (英語) |
AWS ソーススキーマ |
糸 |
awsタグ |
AWS タグ |
DynamoDBTablePropertiesAwsタグ |
publicCloudConnectorsリソースID |
パブリック クラウド コネクタのリソース ID |
糸 |
publicCloudResourceName (パブリッククラウドリソース名) |
パブリック クラウド リソース名 |
糸 |
GlobalSecondaryIndex
名前 |
形容 |
価値 |
contributorInsights仕様 |
指定したグローバル セカンダリ インデックスに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 |
寄稿者インサイト仕様 |
インデックス名 |
グローバル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。 |
糸 |
キースキーマ |
グローバル セカンダリ インデックスの完全なキー スキーマ。1 つ以上の属性名とキーの種類のペアで構成されます。+ HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
キースキーマ[] |
投射 |
テーブルからグローバル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 |
プロジェクション |
プロビジョニングされたスループット |
指定したグローバル セカンダリ インデックスのプロビジョニング済みスループット設定を表します。 現在のプロビジョニング済みスループットの最小値と最大値については、Amazon DynamoDB 開発者ガイドの「サービス、アカウント、テーブルクォータの」を参照してください。 指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 |
プロビジョニングされたスループット |
ImportSourceSpecification (英語)
名前 |
形容 |
価値 |
入力圧縮タイプ |
インポートされたテーブルからの入力で使用される圧縮の種類。 |
糸 |
インプットフォーマット |
ソース データの形式。
ImportFormat の有効な値は、CSV 、DYNAMODB_JSON 、または ION です。 |
糸 |
inputFormatOptions (入力フォーマットオプション |
入力の書式設定方法を指定する追加のプロパティ。ターゲット テーブルにインポートされたデータの書式オプション。 CsvOption という 1 つの値があります。 |
InputFormatOptions (入力フォーマットオプション) |
s3バケットソース |
インポートのソースを提供する S3 バケット。 インポートされる S3 バケット。 |
S3バケットソース |
名前 |
形容 |
価値 |
csv |
CSV 形式でインポートされたソース ファイルのオプション。 値は Delimiter と HeaderList です。 CSV 形式でインポートされたソース ファイルのオプション。 値は Delimiter と HeaderList です。 |
csv の |
キースキーマ
名前 |
形容 |
価値 |
attributeName (属性名) |
キー属性の名前。 |
糸 |
キータイプ |
このキー属性が想定するロール: + HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、その ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
糸 |
KinesisStreamSpecification (キネシスストリーム仕様)
名前 |
形容 |
価値 |
approximateCreationDateTimePrecision |
ストリームが作成された時刻と日付の有効桁数。 |
「マイクロ秒」 「ミリ秒」 |
ストリームアーン |
特定の Kinesis データ ストリームの ARN。 長さの制約: 最小長は 37 です。 最大長は 1024 です。 |
糸 |
LocalSecondaryIndex (英語)
名前 |
形容 |
価値 |
インデックス名 |
ローカル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。 |
糸 |
キースキーマ |
属性名とキーの種類の 1 つ以上のペアで構成される、ローカル セカンダリ インデックスの完全なキー スキーマ: + HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
キースキーマ[] |
投射 |
テーブルからローカル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 |
プロジェクション |
PointInTimeRecovery仕様
名前 |
形容 |
価値 |
pointInTimeRecoveryEnabled (ポイントインタイムリカバリ有効) |
テーブルのポイントインタイム リカバリーが有効 (true) か無効 (false) かを示します。 |
ブール (bool) |
投射
名前 |
形容 |
価値 |
nonKeyAttributes (非キー属性) |
インデックスに投影されるキー以外の属性名を表します。 ローカル セカンダリ インデックスの場合、すべてのローカル セカンダリ インデックスで合計される NonKeyAttributes の合計数が 100 を超えないようにする必要があります。 同じ属性を 2 つの異なるインデックスに投影すると、合計を決定するときに 2 つの異なる属性としてカウントされます。 |
文字列[] |
プロジェクションタイプ |
インデックスに投影される属性のセット: + KEYS_ONLY - インデックスと主キーのみがインデックスに投影されます。
+
INCLUDE - KEYS_ONLY で説明されている属性に加えて、セカンダリ インデックスには、指定した他のキー以外の属性が含まれます。
+
ALL - すべてのテーブル属性がインデックスに投影されます。 DynamoDB コンソールを使用する場合、ALL は既定で選択されます。 |
糸 |
プロビジョニングされたスループット
名前 |
形容 |
価値 |
readCapacityUnits(日本語) |
DynamoDB が ThrottlingException を返す前に、1 秒あたりに使用された厳密に一貫性のある読み取りの最大数。 詳細については、Amazon DynamoDB 開発者ガイドの「読み取りおよび書き込み要件 の指定」を参照してください。 読み取り/書き込み容量モードが PAY_PER_REQUEST 場合、値は 0 に設定されます。 |
整数 (int) |
writeCapacityUnits(書き込み容量単位) |
DynamoDB が ThrottlingException を返す前に 1 秒あたりに消費された書き込みの最大数。 詳細については、Amazon DynamoDB 開発者ガイドの「読み取りおよび書き込み要件 の指定」を参照してください。 読み取り/書き込み容量モードが PAY_PER_REQUEST 場合、値は 0 に設定されます。 |
整数 (int) |
リソースポリシー
名前 |
形容 |
価値 |
ポリシードキュメント |
指定した DDB テーブル、インデックス、またはその両方に追加するアクセス許可を含むリソース ベースのポリシー ドキュメント。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 |
任意 |
S3バケットソース
名前 |
形容 |
価値 |
s3バケット |
インポートされる S3 バケット。 |
糸 |
s3バケットオーナー |
インポートされる S3 バケットのアカウント番号。 バケットがリクエスターによって所有されている場合、これは省略可能です。 |
糸 |
s3Keyプレフィックス |
インポートされるすべての S3 オブジェクトによって共有されるキー プレフィックス。 |
糸 |
SSES仕様
名前 |
形容 |
価値 |
kmsMasterKeyId さん |
KMS 暗号化に使用する KMS キー。 キーを指定するには、キー ID、Amazon リソース名 (ARN)、エイリアス名、またはエイリアス ARN を使用します。 このパラメーターは、キーが既定の DynamoDB キー alias/aws/dynamodb と異なる場合にのみ指定する必要があることに注意してください。 |
糸 |
sseEnabled (英語) |
サーバー側の暗号化が AWS マネージド キーまたは AWS 所有キーのどちらを使用して行われるかを示します。 有効 (true) の場合、サーバー側の暗号化の種類は KMS に設定され、AWS マネージド キーが使用されます (KMS 料金が適用されます)。 無効 (false) または指定されていない場合、サーバー側の暗号化は AWS 所有キーに設定されます。 |
ブール (bool) |
sseType (英語) |
サーバー側の暗号化の種類。 サポートされる唯一の値は、 + KMS - KMSlong を使用するサーバー側暗号化です。 キーはアカウントに格納され、KMS によって管理されます (KMS 料金が適用されます)。 |
糸 |
ストリーム仕様
名前 |
形容 |
価値 |
リソースポリシー |
テーブルのストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 テーブル、インデックス、ストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 CFNshort テンプレートでリソースベースのポリシーを定義する場合、次の考慮事項が適用されます。 + JSON 形式のリソースベースのポリシー ドキュメントでサポートされる最大サイズは 20 KB です。 DDB は、この制限に対してポリシーのサイズを計算するときに空白をカウントします。 + リソースベースのポリシーでは、ドリフト検出サポートされていません。 CFNshort スタック テンプレートの外部でポリシーを更新する場合は、CFNshort スタックを変更で更新する必要があります。 + リソース ベースのポリシーでは、帯域外の変更はサポートされません。 CFNshort テンプレートの外部でポリシーを追加、更新、または削除した場合、テンプレート内のポリシーに変更がない場合、変更は上書きされません。 たとえば、テンプレートにリソースベースのポリシーが含まれているとします。このポリシーは後でテンプレートの外部で更新します。 テンプレート内のポリシーに変更を加えない場合、DDB で更新されたポリシーはテンプレート内のポリシーと同期されません。 逆に、テンプレートにリソースベースのポリシーが含まれていないが、テンプレートの外部にポリシーを追加するとします。 テンプレートに追加しない限り、このポリシーは DDB から削除されません。 テンプレートにポリシーを追加してスタックを更新すると、DDB 内の既存のポリシーがテンプレートで定義されているポリシーと一致するように更新されます。 すべての考慮事項の完全な一覧については、「リソースベースのポリシーに関する考慮事項 を参照してください。 |
リソースポリシー |
ストリームビュータイプ |
テーブル内の項目が変更されると、StreamViewType は、このテーブルのストリームに書き込まれる情報を決定します。
StreamViewType の有効な値: + KEYS_ONLY - 変更された項目のキー属性のみがストリームに書き込まれます。
+
NEW_IMAGE - 変更後に表示される項目全体がストリームに書き込まれます。
+
OLD_IMAGE - 変更前に出現したアイテム全体がストリームに書き込まれます。
+
NEW_AND_OLD_IMAGES - 項目の新しい項目イメージと古い項目イメージの両方がストリームに書き込まれます。 |
糸 |
タグ自動生成8
名前 |
形容 |
価値 |
鍵 |
タグのキー。 タグ キーでは大文字と小文字が区別されます。 各 DynamoDB テーブルは、同じキーを持つ最大 1 つのタグのみを持つことができます。 既存のタグ (同じキー) を追加しようとすると、既存のタグ値が新しい値に更新されます。 |
糸 |
価値 |
タグの値。 タグの値は大文字と小文字が区別され、null にすることができます。 |
糸 |
TimeToLive仕様
名前 |
形容 |
価値 |
attributeName (属性名) |
テーブル内の項目の有効期限を格納するために使用される TTL 属性の名前。 + TTL を有効にする場合、または TTL が既に有効になっている場合は、AttributeName プロパティが必要です。 + このプロパティを更新するには、最初に TTL を無効にしてから、新しい属性名で TTL を有効にする必要があります。 |
糸 |
有効 |
テーブルで TTL を有効 (true) または無効 (false) にするかどうかを示します。 |
ブール (bool) |
ARM テンプレート リソース定義
dynamoDBTables リソースの種類は、次をターゲットとする操作と共にデプロイできます。
-
リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。
Microsoft.AwsConnector/dynamoDBTables リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.AwsConnector/dynamoDBTables",
"apiVersion": "2024-12-01",
"name": "string",
"location": "string",
"properties": {
"arn": "string",
"awsAccountId": "string",
"awsProperties": {
"arn": "string",
"attributeDefinitions": [
{
"attributeName": "string",
"attributeType": "string"
}
],
"billingMode": "string",
"contributorInsightsSpecification": {
"enabled": "bool"
},
"deletionProtectionEnabled": "bool",
"globalSecondaryIndexes": [
{
"contributorInsightsSpecification": {
"enabled": "bool"
},
"indexName": "string",
"keySchema": [
{
"attributeName": "string",
"keyType": "string"
}
],
"projection": {
"nonKeyAttributes": [ "string" ],
"projectionType": "string"
},
"provisionedThroughput": {
"readCapacityUnits": "int",
"writeCapacityUnits": "int"
}
}
],
"importSourceSpecification": {
"inputCompressionType": "string",
"inputFormat": "string",
"inputFormatOptions": {
"csv": {
"delimiter": "string",
"headerList": [ "string" ]
}
},
"s3BucketSource": {
"s3Bucket": "string",
"s3BucketOwner": "string",
"s3KeyPrefix": "string"
}
},
"keySchema": [
{
"attributeName": "string",
"keyType": "string"
}
],
"kinesisStreamSpecification": {
"approximateCreationDateTimePrecision": "string",
"streamArn": "string"
},
"localSecondaryIndexes": [
{
"indexName": "string",
"keySchema": [
{
"attributeName": "string",
"keyType": "string"
}
],
"projection": {
"nonKeyAttributes": [ "string" ],
"projectionType": "string"
}
}
],
"pointInTimeRecoverySpecification": {
"pointInTimeRecoveryEnabled": "bool"
},
"provisionedThroughput": {
"readCapacityUnits": "int",
"writeCapacityUnits": "int"
},
"resourcePolicy": {
"policyDocument": {}
},
"sseSpecification": {
"kmsMasterKeyId": "string",
"sseEnabled": "bool",
"sseType": "string"
},
"streamArn": "string",
"streamSpecification": {
"resourcePolicy": {
"policyDocument": {}
},
"streamViewType": "string"
},
"tableClass": "string",
"tableName": "string",
"tags": [
{
"key": "string",
"value": "string"
}
],
"timeToLiveSpecification": {
"attributeName": "string",
"enabled": "bool"
}
},
"awsRegion": "string",
"awsSourceSchema": "string",
"awsTags": {
"{customized property}": "string"
},
"publicCloudConnectorsResourceId": "string",
"publicCloudResourceName": "string"
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
Microsoft.AwsConnector/dynamoDBTables
名前 |
形容 |
価値 |
apiVersion (英語) |
API のバージョン |
'2024-12-01' |
場所 |
リソースが存在する地理的な場所 |
string (必須) |
名前 |
リソース名 |
糸
制約: パターン = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必須) |
プロパティ |
このリソースのリソース固有のプロパティ。 |
DynamoDBTableProperties の |
タグ |
リソース タグ |
タグ名と値のディクショナリ。 テンプレート の タグを参照してください |
種類 |
リソースの種類 |
'Microsoft.AwsConnector/dynamoDBTables' |
属性定義
名前 |
形容 |
価値 |
attributeName (属性名) |
属性の名前。 |
糸 |
属性タイプ |
属性のデータ型。ここで、 + S - 属性は String + N 型です。属性は Number + B 型です。属性は Binary 型です |
糸 |
AwsDynamoDBTableプロパティ
名前 |
形容 |
価値 |
ARN |
プロパティ arn |
糸 |
attributeDefinitions (属性定義) |
テーブルとインデックスのキー スキーマを記述する属性の一覧。 このプロパティは、DDB テーブルを作成するために必要です。 更新が必要: いくつかの中断. 既存の AttributeDefinition を編集した場合の置換。 |
AttributeDefinition[] の |
ビリングモード |
読み取りと書き込みのスループットに対して課金される方法と、容量を管理する方法を指定します。 有効な値には、 + PROVISIONED - 予測可能なワークロードに PROVISIONED を使用することをお勧めします。 は、課金モードをプロビジョニング モード設定します。
+
PAY_PER_REQUEST - 予測できないワークロードには PAY_PER_REQUEST を使用することをお勧めします。 、課金モードをオンデマンド モードのに設定します。 指定しない場合、既定値は PROVISIONED です。 |
糸 |
contributorInsights仕様 |
指定したテーブルに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 |
寄稿者インサイト仕様 |
deletionProtection有効 |
テーブルが削除から保護されているかどうかを判断します。 有効にすると、どのユーザーまたはプロセスもテーブルを削除できません。 この設定は、既定では無効になっています。 詳細については、「開発者ガイドの削除保護 の使用 を参照してください。 |
ブール (bool) |
globalSecondaryインデックス |
テーブルに作成されるグローバル セカンダリ インデックス。 最大 20 個のグローバル セカンダリ インデックスを作成できます。 新しいグローバル セカンダリ インデックスを含むようにテーブルを更新すると、CFNlong によってインデックスの作成が開始され、スタックの更新が続行されます。 テーブルのサイズによってはバックフィル フェーズに時間がかかる可能性があるため、CFNlong はインデックスの作成が完了するまで待機しません。 インデックスの状態が ACTIVE されるまで、インデックスを使用したり、テーブルを更新したりすることはできません。 DynamoDB DescribeTable コマンドを使用して、状態を追跡できます。 更新中にインデックスを追加または削除する場合は、他のリソースを更新しないことをお勧めします。 スタックの更新に失敗し、新しいインデックスの追加中にロールバックされた場合は、インデックスを手動で削除する必要があります。 更新プログラムはサポートされていません。 例外は次のとおりです。+ 共同作成者分析情報の仕様またはグローバル セカンダリ インデックスのプロビジョニング済みスループット値を更新する場合は、中断することなくテーブルを更新できます。 + 1 つのグローバル セカンダリ インデックスを中断せずに削除または追加できます。 同じ更新 (インデックスの論理 ID の変更など) で両方を実行すると、更新は失敗します。 |
GlobalSecondaryIndex[] |
importSourceSpecification (英語) |
S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。
ImportSourceSpecification プロパティを指定し、StreamSpecification 、TableClass プロパティ、または DeletionProtectionEnabled プロパティを指定する場合、IAM エンティティの作成/更新スタックには UpdateTable アクセス許可が必要です。 S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。 |
ImportSourceSpecification (英語) |
キースキーマ |
テーブルの主キーを構成する属性を指定します。
KeySchema プロパティの属性は、AttributeDefinitions プロパティでも定義する必要があります。 |
キースキーマ[] |
kinesisStream仕様 |
指定したテーブルの Kinesis データ ストリーム構成。 指定したテーブルの Kinesis データ ストリーム構成。 |
KinesisStreamSpecification (キネシスストリーム仕様) |
localSecondaryインデックス |
テーブルに作成するローカル セカンダリ インデックス。 最大 5 つのローカル セカンダリ インデックスを作成できます。 各インデックスのスコープは、特定のハッシュ キー値です。 各ハッシュ キーのサイズは最大 10 ギガバイトです。 |
LocalSecondaryIndex[] |
pointInTimeRecoverySpecification (ポイントインタイムリカバリ仕様) |
ポイントインタイム リカバリーを有効にするために使用される設定。 ポイントインタイム リカバリーを有効にするために使用される設定。 |
PointInTimeRecovery仕様 |
プロビジョニングされたスループット |
指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニングされたスループット構造の内容の詳細については、「Amazon DynamoDB Table ProvisionedThroughputを参照してください。
BillingMode として PROVISIONED を設定する場合は、このプロパティを指定する必要があります。
BillingMode を PAY_PER_REQUEST として設定した場合、このプロパティを指定することはできません。 指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 |
プロビジョニングされたスループット |
リソースポリシー |
指定したテーブルに追加するアクセス許可を含むリソース ベースのポリシー ドキュメント。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 テーブルの作成時にリソース ベースのポリシーをアタッチすると、ポリシーの作成 厳密に一貫性のあるになります。 リソース ベースのポリシーをアタッチするときに留意する必要がある考慮事項については、「リソース ベースのポリシーに関する考慮事項 を参照してください。 テーブル、インデックス、ストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 CFNshort テンプレートでリソースベースのポリシーを定義する場合、次の考慮事項が適用されます。 + JSON 形式のリソースベースのポリシー ドキュメントでサポートされる最大サイズは 20 KB です。 DDB は、この制限に対してポリシーのサイズを計算するときに空白をカウントします。 + リソースベースのポリシーでは、ドリフト検出サポートされていません。 CFNshort スタック テンプレートの外部でポリシーを更新する場合は、CFNshort スタックを変更で更新する必要があります。 + リソース ベースのポリシーでは、帯域外の変更はサポートされません。 CFNshort テンプレートの外部でポリシーを追加、更新、または削除した場合、テンプレート内のポリシーに変更がない場合、変更は上書きされません。 たとえば、テンプレートにリソースベースのポリシーが含まれているとします。このポリシーは後でテンプレートの外部で更新します。 テンプレート内のポリシーに変更を加えない場合、DDB で更新されたポリシーはテンプレート内のポリシーと同期されません。 逆に、テンプレートにリソースベースのポリシーが含まれていないが、テンプレートの外部にポリシーを追加するとします。 テンプレートに追加しない限り、このポリシーは DDB から削除されません。 テンプレートにポリシーを追加してスタックを更新すると、DDB 内の既存のポリシーがテンプレートで定義されているポリシーと一致するように更新されます。 すべての考慮事項の完全な一覧については、「リソースベースのポリシーに関する考慮事項 を参照してください。 |
リソースポリシー |
sseSpecification (英語) |
サーバー側の暗号化を有効にする設定を指定します。 サーバー側の暗号化を有効にするために使用される設定を表します。 |
SSES仕様 |
ストリームアーン |
プロパティ streamArn |
糸 |
ストリーム仕様 |
テーブルに格納されている項目に対する変更をキャプチャする DDB テーブル ストリームの設定。 DynamoDB のテーブルの DynamoDB Streams 構成を表します。 |
ストリーム仕様 |
テーブルクラス |
新しいテーブルのテーブル クラス。 有効な値は STANDARD と STANDARD_INFREQUENT_ACCESS です。 |
糸 |
テーブル名 |
テーブルの名前。 名前を指定しない場合、CFNlong は一意の物理 ID を生成し、その ID をテーブル名に使用します。 詳細については、「名前の種類の」を参照してください。 名前を指定した場合、このリソースの置き換えを必要とする更新を実行することはできません。 中断を必要としない更新プログラムを実行できます。 リソースを置き換える必要がある場合は、新しい名前を指定します。 |
糸 |
タグ |
このリソースに適用するキーと値のペアの配列。 詳細については、「タグの」を参照してください。 |
タグ自動生成8[] |
timeToLive仕様 |
テーブルの Time to Live (TTL) 設定を指定します。 DynamoDB の制限の詳細については、「Amazon DynamoDB 開発者ガイド」の「Amazon DynamoDB の 制限」を参照してください。 指定したテーブルの Time to Live (TTL) を有効または無効にするために使用される設定を表します。 |
TimeToLive仕様 |
寄稿者インサイト仕様
名前 |
形容 |
価値 |
有効 |
CloudWatch Contributor Insights を有効 (true) または無効 (false) にするかどうかを示します。 |
ブール (bool) |
CSVファイル
名前 |
形容 |
価値 |
デリミタ |
インポートする CSV ファイル内の項目を区切る区切り記号。 |
糸 |
ヘッダーリスト |
インポートするすべてのソース CSV ファイルの共通ヘッダーを指定するために使用されるヘッダーの一覧。 このフィールドを指定すると、各 CSV ファイルの最初の行がヘッダーではなくデータとして扱われます。 このフィールドが指定されていない場合、各 CSV ファイルの最初の行がヘッダーとして扱われます。 |
文字列[] |
DynamoDBTableProperties (ダイナモDBTableプロパティ)
名前 |
形容 |
価値 |
ARN |
Amazon リソース名 (ARN) |
糸 |
awsAccountId (英語) |
AWS アカウント ID |
糸 |
awsプロパティ |
AWS のプロパティ |
awsDynamoDBTableProperties の |
awsリージョン |
AWS リージョン |
糸 |
awsSourceSchema (英語) |
AWS ソーススキーマ |
糸 |
awsタグ |
AWS タグ |
DynamoDBTablePropertiesAwsタグ |
publicCloudConnectorsリソースID |
パブリック クラウド コネクタのリソース ID |
糸 |
publicCloudResourceName (パブリッククラウドリソース名) |
パブリック クラウド リソース名 |
糸 |
GlobalSecondaryIndex
名前 |
形容 |
価値 |
contributorInsights仕様 |
指定したグローバル セカンダリ インデックスに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 |
寄稿者インサイト仕様 |
インデックス名 |
グローバル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。 |
糸 |
キースキーマ |
グローバル セカンダリ インデックスの完全なキー スキーマ。1 つ以上の属性名とキーの種類のペアで構成されます。+ HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
キースキーマ[] |
投射 |
テーブルからグローバル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 |
プロジェクション |
プロビジョニングされたスループット |
指定したグローバル セカンダリ インデックスのプロビジョニング済みスループット設定を表します。 現在のプロビジョニング済みスループットの最小値と最大値については、Amazon DynamoDB 開発者ガイドの「サービス、アカウント、テーブルクォータの」を参照してください。 指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 |
プロビジョニングされたスループット |
ImportSourceSpecification (英語)
名前 |
形容 |
価値 |
入力圧縮タイプ |
インポートされたテーブルからの入力で使用される圧縮の種類。 |
糸 |
インプットフォーマット |
ソース データの形式。
ImportFormat の有効な値は、CSV 、DYNAMODB_JSON 、または ION です。 |
糸 |
inputFormatOptions (入力フォーマットオプション |
入力の書式設定方法を指定する追加のプロパティ。ターゲット テーブルにインポートされたデータの書式オプション。 CsvOption という 1 つの値があります。 |
InputFormatOptions (入力フォーマットオプション) |
s3バケットソース |
インポートのソースを提供する S3 バケット。 インポートされる S3 バケット。 |
S3バケットソース |
名前 |
形容 |
価値 |
csv |
CSV 形式でインポートされたソース ファイルのオプション。 値は Delimiter と HeaderList です。 CSV 形式でインポートされたソース ファイルのオプション。 値は Delimiter と HeaderList です。 |
csv の |
キースキーマ
名前 |
形容 |
価値 |
attributeName (属性名) |
キー属性の名前。 |
糸 |
キータイプ |
このキー属性が想定するロール: + HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、その ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
糸 |
KinesisStreamSpecification (キネシスストリーム仕様)
名前 |
形容 |
価値 |
approximateCreationDateTimePrecision |
ストリームが作成された時刻と日付の有効桁数。 |
「マイクロ秒」 「ミリ秒」 |
ストリームアーン |
特定の Kinesis データ ストリームの ARN。 長さの制約: 最小長は 37 です。 最大長は 1024 です。 |
糸 |
LocalSecondaryIndex (英語)
名前 |
形容 |
価値 |
インデックス名 |
ローカル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。 |
糸 |
キースキーマ |
属性名とキーの種類の 1 つ以上のペアで構成される、ローカル セカンダリ インデックスの完全なキー スキーマ: + HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
キースキーマ[] |
投射 |
テーブルからローカル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 |
プロジェクション |
PointInTimeRecovery仕様
名前 |
形容 |
価値 |
pointInTimeRecoveryEnabled (ポイントインタイムリカバリ有効) |
テーブルのポイントインタイム リカバリーが有効 (true) か無効 (false) かを示します。 |
ブール (bool) |
投射
名前 |
形容 |
価値 |
nonKeyAttributes (非キー属性) |
インデックスに投影されるキー以外の属性名を表します。 ローカル セカンダリ インデックスの場合、すべてのローカル セカンダリ インデックスで合計される NonKeyAttributes の合計数が 100 を超えないようにする必要があります。 同じ属性を 2 つの異なるインデックスに投影すると、合計を決定するときに 2 つの異なる属性としてカウントされます。 |
文字列[] |
プロジェクションタイプ |
インデックスに投影される属性のセット: + KEYS_ONLY - インデックスと主キーのみがインデックスに投影されます。
+
INCLUDE - KEYS_ONLY で説明されている属性に加えて、セカンダリ インデックスには、指定した他のキー以外の属性が含まれます。
+
ALL - すべてのテーブル属性がインデックスに投影されます。 DynamoDB コンソールを使用する場合、ALL は既定で選択されます。 |
糸 |
プロビジョニングされたスループット
名前 |
形容 |
価値 |
readCapacityUnits(日本語) |
DynamoDB が ThrottlingException を返す前に、1 秒あたりに使用された厳密に一貫性のある読み取りの最大数。 詳細については、Amazon DynamoDB 開発者ガイドの「読み取りおよび書き込み要件 の指定」を参照してください。 読み取り/書き込み容量モードが PAY_PER_REQUEST 場合、値は 0 に設定されます。 |
整数 (int) |
writeCapacityUnits(書き込み容量単位) |
DynamoDB が ThrottlingException を返す前に 1 秒あたりに消費された書き込みの最大数。 詳細については、Amazon DynamoDB 開発者ガイドの「読み取りおよび書き込み要件 の指定」を参照してください。 読み取り/書き込み容量モードが PAY_PER_REQUEST 場合、値は 0 に設定されます。 |
整数 (int) |
リソースポリシー
名前 |
形容 |
価値 |
ポリシードキュメント |
指定した DDB テーブル、インデックス、またはその両方に追加するアクセス許可を含むリソース ベースのポリシー ドキュメント。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 |
任意 |
S3バケットソース
名前 |
形容 |
価値 |
s3バケット |
インポートされる S3 バケット。 |
糸 |
s3バケットオーナー |
インポートされる S3 バケットのアカウント番号。 バケットがリクエスターによって所有されている場合、これは省略可能です。 |
糸 |
s3Keyプレフィックス |
インポートされるすべての S3 オブジェクトによって共有されるキー プレフィックス。 |
糸 |
SSES仕様
名前 |
形容 |
価値 |
kmsMasterKeyId さん |
KMS 暗号化に使用する KMS キー。 キーを指定するには、キー ID、Amazon リソース名 (ARN)、エイリアス名、またはエイリアス ARN を使用します。 このパラメーターは、キーが既定の DynamoDB キー alias/aws/dynamodb と異なる場合にのみ指定する必要があることに注意してください。 |
糸 |
sseEnabled (英語) |
サーバー側の暗号化が AWS マネージド キーまたは AWS 所有キーのどちらを使用して行われるかを示します。 有効 (true) の場合、サーバー側の暗号化の種類は KMS に設定され、AWS マネージド キーが使用されます (KMS 料金が適用されます)。 無効 (false) または指定されていない場合、サーバー側の暗号化は AWS 所有キーに設定されます。 |
ブール (bool) |
sseType (英語) |
サーバー側の暗号化の種類。 サポートされる唯一の値は、 + KMS - KMSlong を使用するサーバー側暗号化です。 キーはアカウントに格納され、KMS によって管理されます (KMS 料金が適用されます)。 |
糸 |
ストリーム仕様
名前 |
形容 |
価値 |
リソースポリシー |
テーブルのストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 テーブル、インデックス、ストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 CFNshort テンプレートでリソースベースのポリシーを定義する場合、次の考慮事項が適用されます。 + JSON 形式のリソースベースのポリシー ドキュメントでサポートされる最大サイズは 20 KB です。 DDB は、この制限に対してポリシーのサイズを計算するときに空白をカウントします。 + リソースベースのポリシーでは、ドリフト検出サポートされていません。 CFNshort スタック テンプレートの外部でポリシーを更新する場合は、CFNshort スタックを変更で更新する必要があります。 + リソース ベースのポリシーでは、帯域外の変更はサポートされません。 CFNshort テンプレートの外部でポリシーを追加、更新、または削除した場合、テンプレート内のポリシーに変更がない場合、変更は上書きされません。 たとえば、テンプレートにリソースベースのポリシーが含まれているとします。このポリシーは後でテンプレートの外部で更新します。 テンプレート内のポリシーに変更を加えない場合、DDB で更新されたポリシーはテンプレート内のポリシーと同期されません。 逆に、テンプレートにリソースベースのポリシーが含まれていないが、テンプレートの外部にポリシーを追加するとします。 テンプレートに追加しない限り、このポリシーは DDB から削除されません。 テンプレートにポリシーを追加してスタックを更新すると、DDB 内の既存のポリシーがテンプレートで定義されているポリシーと一致するように更新されます。 すべての考慮事項の完全な一覧については、「リソースベースのポリシーに関する考慮事項 を参照してください。 |
リソースポリシー |
ストリームビュータイプ |
テーブル内の項目が変更されると、StreamViewType は、このテーブルのストリームに書き込まれる情報を決定します。
StreamViewType の有効な値: + KEYS_ONLY - 変更された項目のキー属性のみがストリームに書き込まれます。
+
NEW_IMAGE - 変更後に表示される項目全体がストリームに書き込まれます。
+
OLD_IMAGE - 変更前に出現したアイテム全体がストリームに書き込まれます。
+
NEW_AND_OLD_IMAGES - 項目の新しい項目イメージと古い項目イメージの両方がストリームに書き込まれます。 |
糸 |
タグ自動生成8
名前 |
形容 |
価値 |
鍵 |
タグのキー。 タグ キーでは大文字と小文字が区別されます。 各 DynamoDB テーブルは、同じキーを持つ最大 1 つのタグのみを持つことができます。 既存のタグ (同じキー) を追加しようとすると、既存のタグ値が新しい値に更新されます。 |
糸 |
価値 |
タグの値。 タグの値は大文字と小文字が区別され、null にすることができます。 |
糸 |
TimeToLive仕様
名前 |
形容 |
価値 |
attributeName (属性名) |
テーブル内の項目の有効期限を格納するために使用される TTL 属性の名前。 + TTL を有効にする場合、または TTL が既に有効になっている場合は、AttributeName プロパティが必要です。 + このプロパティを更新するには、最初に TTL を無効にしてから、新しい属性名で TTL を有効にする必要があります。 |
糸 |
有効 |
テーブルで TTL を有効 (true) または無効 (false) にするかどうかを示します。 |
ブール (bool) |
使用例
dynamoDBTables リソースの種類は、次をターゲットとする操作と共にデプロイできます。
各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。
Microsoft.AwsConnector/dynamoDBTables リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.AwsConnector/dynamoDBTables@2024-12-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
arn = "string"
awsAccountId = "string"
awsProperties = {
arn = "string"
attributeDefinitions = [
{
attributeName = "string"
attributeType = "string"
}
]
billingMode = "string"
contributorInsightsSpecification = {
enabled = bool
}
deletionProtectionEnabled = bool
globalSecondaryIndexes = [
{
contributorInsightsSpecification = {
enabled = bool
}
indexName = "string"
keySchema = [
{
attributeName = "string"
keyType = "string"
}
]
projection = {
nonKeyAttributes = [
"string"
]
projectionType = "string"
}
provisionedThroughput = {
readCapacityUnits = int
writeCapacityUnits = int
}
}
]
importSourceSpecification = {
inputCompressionType = "string"
inputFormat = "string"
inputFormatOptions = {
csv = {
delimiter = "string"
headerList = [
"string"
]
}
}
s3BucketSource = {
s3Bucket = "string"
s3BucketOwner = "string"
s3KeyPrefix = "string"
}
}
keySchema = [
{
attributeName = "string"
keyType = "string"
}
]
kinesisStreamSpecification = {
approximateCreationDateTimePrecision = "string"
streamArn = "string"
}
localSecondaryIndexes = [
{
indexName = "string"
keySchema = [
{
attributeName = "string"
keyType = "string"
}
]
projection = {
nonKeyAttributes = [
"string"
]
projectionType = "string"
}
}
]
pointInTimeRecoverySpecification = {
pointInTimeRecoveryEnabled = bool
}
provisionedThroughput = {
readCapacityUnits = int
writeCapacityUnits = int
}
resourcePolicy = {
policyDocument = ?
}
sseSpecification = {
kmsMasterKeyId = "string"
sseEnabled = bool
sseType = "string"
}
streamArn = "string"
streamSpecification = {
resourcePolicy = {
policyDocument = ?
}
streamViewType = "string"
}
tableClass = "string"
tableName = "string"
tags = [
{
key = "string"
value = "string"
}
]
timeToLiveSpecification = {
attributeName = "string"
enabled = bool
}
}
awsRegion = "string"
awsSourceSchema = "string"
awsTags = {
{customized property} = "string"
}
publicCloudConnectorsResourceId = "string"
publicCloudResourceName = "string"
}
}
}
プロパティ値
Microsoft.AwsConnector/dynamoDBTables
名前 |
形容 |
価値 |
場所 |
リソースが存在する地理的な場所 |
string (必須) |
名前 |
リソース名 |
糸
制約: パターン = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) (必須) |
プロパティ |
このリソースのリソース固有のプロパティ。 |
DynamoDBTableProperties の |
タグ |
リソース タグ |
タグ名と値のディクショナリ。 |
種類 |
リソースの種類 |
"Microsoft.AwsConnector/dynamoDBTables@2024-12-01" (英語) |
属性定義
名前 |
形容 |
価値 |
attributeName (属性名) |
属性の名前。 |
糸 |
属性タイプ |
属性のデータ型。ここで、 + S - 属性は String + N 型です。属性は Number + B 型です。属性は Binary 型です |
糸 |
AwsDynamoDBTableプロパティ
名前 |
形容 |
価値 |
ARN |
プロパティ arn |
糸 |
attributeDefinitions (属性定義) |
テーブルとインデックスのキー スキーマを記述する属性の一覧。 このプロパティは、DDB テーブルを作成するために必要です。 更新が必要: いくつかの中断. 既存の AttributeDefinition を編集した場合の置換。 |
AttributeDefinition[] の |
ビリングモード |
読み取りと書き込みのスループットに対して課金される方法と、容量を管理する方法を指定します。 有効な値には、 + PROVISIONED - 予測可能なワークロードに PROVISIONED を使用することをお勧めします。 は、課金モードをプロビジョニング モード設定します。
+
PAY_PER_REQUEST - 予測できないワークロードには PAY_PER_REQUEST を使用することをお勧めします。 、課金モードをオンデマンド モードのに設定します。 指定しない場合、既定値は PROVISIONED です。 |
糸 |
contributorInsights仕様 |
指定したテーブルに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 |
寄稿者インサイト仕様 |
deletionProtection有効 |
テーブルが削除から保護されているかどうかを判断します。 有効にすると、どのユーザーまたはプロセスもテーブルを削除できません。 この設定は、既定では無効になっています。 詳細については、「開発者ガイドの削除保護 の使用 を参照してください。 |
ブール (bool) |
globalSecondaryインデックス |
テーブルに作成されるグローバル セカンダリ インデックス。 最大 20 個のグローバル セカンダリ インデックスを作成できます。 新しいグローバル セカンダリ インデックスを含むようにテーブルを更新すると、CFNlong によってインデックスの作成が開始され、スタックの更新が続行されます。 テーブルのサイズによってはバックフィル フェーズに時間がかかる可能性があるため、CFNlong はインデックスの作成が完了するまで待機しません。 インデックスの状態が ACTIVE されるまで、インデックスを使用したり、テーブルを更新したりすることはできません。 DynamoDB DescribeTable コマンドを使用して、状態を追跡できます。 更新中にインデックスを追加または削除する場合は、他のリソースを更新しないことをお勧めします。 スタックの更新に失敗し、新しいインデックスの追加中にロールバックされた場合は、インデックスを手動で削除する必要があります。 更新プログラムはサポートされていません。 例外は次のとおりです。+ 共同作成者分析情報の仕様またはグローバル セカンダリ インデックスのプロビジョニング済みスループット値を更新する場合は、中断することなくテーブルを更新できます。 + 1 つのグローバル セカンダリ インデックスを中断せずに削除または追加できます。 同じ更新 (インデックスの論理 ID の変更など) で両方を実行すると、更新は失敗します。 |
GlobalSecondaryIndex[] |
importSourceSpecification (英語) |
S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。
ImportSourceSpecification プロパティを指定し、StreamSpecification 、TableClass プロパティ、または DeletionProtectionEnabled プロパティを指定する場合、IAM エンティティの作成/更新スタックには UpdateTable アクセス許可が必要です。 S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。 |
ImportSourceSpecification (英語) |
キースキーマ |
テーブルの主キーを構成する属性を指定します。
KeySchema プロパティの属性は、AttributeDefinitions プロパティでも定義する必要があります。 |
キースキーマ[] |
kinesisStream仕様 |
指定したテーブルの Kinesis データ ストリーム構成。 指定したテーブルの Kinesis データ ストリーム構成。 |
KinesisStreamSpecification (キネシスストリーム仕様) |
localSecondaryインデックス |
テーブルに作成するローカル セカンダリ インデックス。 最大 5 つのローカル セカンダリ インデックスを作成できます。 各インデックスのスコープは、特定のハッシュ キー値です。 各ハッシュ キーのサイズは最大 10 ギガバイトです。 |
LocalSecondaryIndex[] |
pointInTimeRecoverySpecification (ポイントインタイムリカバリ仕様) |
ポイントインタイム リカバリーを有効にするために使用される設定。 ポイントインタイム リカバリーを有効にするために使用される設定。 |
PointInTimeRecovery仕様 |
プロビジョニングされたスループット |
指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニングされたスループット構造の内容の詳細については、「Amazon DynamoDB Table ProvisionedThroughputを参照してください。
BillingMode として PROVISIONED を設定する場合は、このプロパティを指定する必要があります。
BillingMode を PAY_PER_REQUEST として設定した場合、このプロパティを指定することはできません。 指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 |
プロビジョニングされたスループット |
リソースポリシー |
指定したテーブルに追加するアクセス許可を含むリソース ベースのポリシー ドキュメント。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 テーブルの作成時にリソース ベースのポリシーをアタッチすると、ポリシーの作成 厳密に一貫性のあるになります。 リソース ベースのポリシーをアタッチするときに留意する必要がある考慮事項については、「リソース ベースのポリシーに関する考慮事項 を参照してください。 テーブル、インデックス、ストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 CFNshort テンプレートでリソースベースのポリシーを定義する場合、次の考慮事項が適用されます。 + JSON 形式のリソースベースのポリシー ドキュメントでサポートされる最大サイズは 20 KB です。 DDB は、この制限に対してポリシーのサイズを計算するときに空白をカウントします。 + リソースベースのポリシーでは、ドリフト検出サポートされていません。 CFNshort スタック テンプレートの外部でポリシーを更新する場合は、CFNshort スタックを変更で更新する必要があります。 + リソース ベースのポリシーでは、帯域外の変更はサポートされません。 CFNshort テンプレートの外部でポリシーを追加、更新、または削除した場合、テンプレート内のポリシーに変更がない場合、変更は上書きされません。 たとえば、テンプレートにリソースベースのポリシーが含まれているとします。このポリシーは後でテンプレートの外部で更新します。 テンプレート内のポリシーに変更を加えない場合、DDB で更新されたポリシーはテンプレート内のポリシーと同期されません。 逆に、テンプレートにリソースベースのポリシーが含まれていないが、テンプレートの外部にポリシーを追加するとします。 テンプレートに追加しない限り、このポリシーは DDB から削除されません。 テンプレートにポリシーを追加してスタックを更新すると、DDB 内の既存のポリシーがテンプレートで定義されているポリシーと一致するように更新されます。 すべての考慮事項の完全な一覧については、「リソースベースのポリシーに関する考慮事項 を参照してください。 |
リソースポリシー |
sseSpecification (英語) |
サーバー側の暗号化を有効にする設定を指定します。 サーバー側の暗号化を有効にするために使用される設定を表します。 |
SSES仕様 |
ストリームアーン |
プロパティ streamArn |
糸 |
ストリーム仕様 |
テーブルに格納されている項目に対する変更をキャプチャする DDB テーブル ストリームの設定。 DynamoDB のテーブルの DynamoDB Streams 構成を表します。 |
ストリーム仕様 |
テーブルクラス |
新しいテーブルのテーブル クラス。 有効な値は STANDARD と STANDARD_INFREQUENT_ACCESS です。 |
糸 |
テーブル名 |
テーブルの名前。 名前を指定しない場合、CFNlong は一意の物理 ID を生成し、その ID をテーブル名に使用します。 詳細については、「名前の種類の」を参照してください。 名前を指定した場合、このリソースの置き換えを必要とする更新を実行することはできません。 中断を必要としない更新プログラムを実行できます。 リソースを置き換える必要がある場合は、新しい名前を指定します。 |
糸 |
タグ |
このリソースに適用するキーと値のペアの配列。 詳細については、「タグの」を参照してください。 |
タグ自動生成8[] |
timeToLive仕様 |
テーブルの Time to Live (TTL) 設定を指定します。 DynamoDB の制限の詳細については、「Amazon DynamoDB 開発者ガイド」の「Amazon DynamoDB の 制限」を参照してください。 指定したテーブルの Time to Live (TTL) を有効または無効にするために使用される設定を表します。 |
TimeToLive仕様 |
寄稿者インサイト仕様
名前 |
形容 |
価値 |
有効 |
CloudWatch Contributor Insights を有効 (true) または無効 (false) にするかどうかを示します。 |
ブール (bool) |
CSVファイル
名前 |
形容 |
価値 |
デリミタ |
インポートする CSV ファイル内の項目を区切る区切り記号。 |
糸 |
ヘッダーリスト |
インポートするすべてのソース CSV ファイルの共通ヘッダーを指定するために使用されるヘッダーの一覧。 このフィールドを指定すると、各 CSV ファイルの最初の行がヘッダーではなくデータとして扱われます。 このフィールドが指定されていない場合、各 CSV ファイルの最初の行がヘッダーとして扱われます。 |
文字列[] |
DynamoDBTableProperties (ダイナモDBTableプロパティ)
名前 |
形容 |
価値 |
ARN |
Amazon リソース名 (ARN) |
糸 |
awsAccountId (英語) |
AWS アカウント ID |
糸 |
awsプロパティ |
AWS のプロパティ |
awsDynamoDBTableProperties の |
awsリージョン |
AWS リージョン |
糸 |
awsSourceSchema (英語) |
AWS ソーススキーマ |
糸 |
awsタグ |
AWS タグ |
DynamoDBTablePropertiesAwsタグ |
publicCloudConnectorsリソースID |
パブリック クラウド コネクタのリソース ID |
糸 |
publicCloudResourceName (パブリッククラウドリソース名) |
パブリック クラウド リソース名 |
糸 |
GlobalSecondaryIndex
名前 |
形容 |
価値 |
contributorInsights仕様 |
指定したグローバル セカンダリ インデックスに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 |
寄稿者インサイト仕様 |
インデックス名 |
グローバル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。 |
糸 |
キースキーマ |
グローバル セカンダリ インデックスの完全なキー スキーマ。1 つ以上の属性名とキーの種類のペアで構成されます。+ HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
キースキーマ[] |
投射 |
テーブルからグローバル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 |
プロジェクション |
プロビジョニングされたスループット |
指定したグローバル セカンダリ インデックスのプロビジョニング済みスループット設定を表します。 現在のプロビジョニング済みスループットの最小値と最大値については、Amazon DynamoDB 開発者ガイドの「サービス、アカウント、テーブルクォータの」を参照してください。 指定したテーブルのスループット。ReadCapacityUnits と WriteCapacityUnits の値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 |
プロビジョニングされたスループット |
ImportSourceSpecification (英語)
名前 |
形容 |
価値 |
入力圧縮タイプ |
インポートされたテーブルからの入力で使用される圧縮の種類。 |
糸 |
インプットフォーマット |
ソース データの形式。
ImportFormat の有効な値は、CSV 、DYNAMODB_JSON 、または ION です。 |
糸 |
inputFormatOptions (入力フォーマットオプション |
入力の書式設定方法を指定する追加のプロパティ。ターゲット テーブルにインポートされたデータの書式オプション。 CsvOption という 1 つの値があります。 |
InputFormatOptions (入力フォーマットオプション) |
s3バケットソース |
インポートのソースを提供する S3 バケット。 インポートされる S3 バケット。 |
S3バケットソース |
名前 |
形容 |
価値 |
csv |
CSV 形式でインポートされたソース ファイルのオプション。 値は Delimiter と HeaderList です。 CSV 形式でインポートされたソース ファイルのオプション。 値は Delimiter と HeaderList です。 |
csv の |
キースキーマ
名前 |
形容 |
価値 |
attributeName (属性名) |
キー属性の名前。 |
糸 |
キータイプ |
このキー属性が想定するロール: + HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、その ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
糸 |
KinesisStreamSpecification (キネシスストリーム仕様)
名前 |
形容 |
価値 |
approximateCreationDateTimePrecision |
ストリームが作成された時刻と日付の有効桁数。 |
「マイクロ秒」 「ミリ秒」 |
ストリームアーン |
特定の Kinesis データ ストリームの ARN。 長さの制約: 最小長は 37 です。 最大長は 1024 です。 |
糸 |
LocalSecondaryIndex (英語)
名前 |
形容 |
価値 |
インデックス名 |
ローカル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。 |
糸 |
キースキーマ |
属性名とキーの種類の 1 つ以上のペアで構成される、ローカル セカンダリ インデックスの完全なキー スキーマ: + HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 |
キースキーマ[] |
投射 |
テーブルからローカル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 |
プロジェクション |
PointInTimeRecovery仕様
名前 |
形容 |
価値 |
pointInTimeRecoveryEnabled (ポイントインタイムリカバリ有効) |
テーブルのポイントインタイム リカバリーが有効 (true) か無効 (false) かを示します。 |
ブール (bool) |
投射
名前 |
形容 |
価値 |
nonKeyAttributes (非キー属性) |
インデックスに投影されるキー以外の属性名を表します。 ローカル セカンダリ インデックスの場合、すべてのローカル セカンダリ インデックスで合計される NonKeyAttributes の合計数が 100 を超えないようにする必要があります。 同じ属性を 2 つの異なるインデックスに投影すると、合計を決定するときに 2 つの異なる属性としてカウントされます。 |
文字列[] |
プロジェクションタイプ |
インデックスに投影される属性のセット: + KEYS_ONLY - インデックスと主キーのみがインデックスに投影されます。
+
INCLUDE - KEYS_ONLY で説明されている属性に加えて、セカンダリ インデックスには、指定した他のキー以外の属性が含まれます。
+
ALL - すべてのテーブル属性がインデックスに投影されます。 DynamoDB コンソールを使用する場合、ALL は既定で選択されます。 |
糸 |
プロビジョニングされたスループット
名前 |
形容 |
価値 |
readCapacityUnits(日本語) |
DynamoDB が ThrottlingException を返す前に、1 秒あたりに使用された厳密に一貫性のある読み取りの最大数。 詳細については、Amazon DynamoDB 開発者ガイドの「読み取りおよび書き込み要件 の指定」を参照してください。 読み取り/書き込み容量モードが PAY_PER_REQUEST 場合、値は 0 に設定されます。 |
整数 (int) |
writeCapacityUnits(書き込み容量単位) |
DynamoDB が ThrottlingException を返す前に 1 秒あたりに消費された書き込みの最大数。 詳細については、Amazon DynamoDB 開発者ガイドの「読み取りおよび書き込み要件 の指定」を参照してください。 読み取り/書き込み容量モードが PAY_PER_REQUEST 場合、値は 0 に設定されます。 |
整数 (int) |
リソースポリシー
名前 |
形容 |
価値 |
ポリシードキュメント |
指定した DDB テーブル、インデックス、またはその両方に追加するアクセス許可を含むリソース ベースのポリシー ドキュメント。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 |
任意 |
S3バケットソース
名前 |
形容 |
価値 |
s3バケット |
インポートされる S3 バケット。 |
糸 |
s3バケットオーナー |
インポートされる S3 バケットのアカウント番号。 バケットがリクエスターによって所有されている場合、これは省略可能です。 |
糸 |
s3Keyプレフィックス |
インポートされるすべての S3 オブジェクトによって共有されるキー プレフィックス。 |
糸 |
SSES仕様
名前 |
形容 |
価値 |
kmsMasterKeyId さん |
KMS 暗号化に使用する KMS キー。 キーを指定するには、キー ID、Amazon リソース名 (ARN)、エイリアス名、またはエイリアス ARN を使用します。 このパラメーターは、キーが既定の DynamoDB キー alias/aws/dynamodb と異なる場合にのみ指定する必要があることに注意してください。 |
糸 |
sseEnabled (英語) |
サーバー側の暗号化が AWS マネージド キーまたは AWS 所有キーのどちらを使用して行われるかを示します。 有効 (true) の場合、サーバー側の暗号化の種類は KMS に設定され、AWS マネージド キーが使用されます (KMS 料金が適用されます)。 無効 (false) または指定されていない場合、サーバー側の暗号化は AWS 所有キーに設定されます。 |
ブール (bool) |
sseType (英語) |
サーバー側の暗号化の種類。 サポートされる唯一の値は、 + KMS - KMSlong を使用するサーバー側暗号化です。 キーはアカウントに格納され、KMS によって管理されます (KMS 料金が適用されます)。 |
糸 |
ストリーム仕様
名前 |
形容 |
価値 |
リソースポリシー |
テーブルのストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 テーブル、インデックス、ストリームなど、DDB リソースのアクセス許可を含むリソース ベースのポリシー ドキュメントを作成または更新します。 リソースベースのポリシーを使用すると、各リソースにアクセスできるユーザーと、各リソースに対して実行できるアクションを指定することで、アクセス許可を定義できます。 CFNshort テンプレートでは、ポリシーを JSON または YAML 形式で指定できます。これは、CFNshort が DDB に送信する前に YAML を JSON に変換するためです。 リソース ベースのポリシーの詳細については、「リソース ベースのポリシーを使用した とリソース ベースのポリシーの例 を参照してください。 CFNshort テンプレートでリソースベースのポリシーを定義する場合、次の考慮事項が適用されます。 + JSON 形式のリソースベースのポリシー ドキュメントでサポートされる最大サイズは 20 KB です。 DDB は、この制限に対してポリシーのサイズを計算するときに空白をカウントします。 + リソースベースのポリシーでは、ドリフト検出サポートされていません。 CFNshort スタック テンプレートの外部でポリシーを更新する場合は、CFNshort スタックを変更で更新する必要があります。 + リソース ベースのポリシーでは、帯域外の変更はサポートされません。 CFNshort テンプレートの外部でポリシーを追加、更新、または削除した場合、テンプレート内のポリシーに変更がない場合、変更は上書きされません。 たとえば、テンプレートにリソースベースのポリシーが含まれているとします。このポリシーは後でテンプレートの外部で更新します。 テンプレート内のポリシーに変更を加えない場合、DDB で更新されたポリシーはテンプレート内のポリシーと同期されません。 逆に、テンプレートにリソースベースのポリシーが含まれていないが、テンプレートの外部にポリシーを追加するとします。 テンプレートに追加しない限り、このポリシーは DDB から削除されません。 テンプレートにポリシーを追加してスタックを更新すると、DDB 内の既存のポリシーがテンプレートで定義されているポリシーと一致するように更新されます。 すべての考慮事項の完全な一覧については、「リソースベースのポリシーに関する考慮事項 を参照してください。 |
リソースポリシー |
ストリームビュータイプ |
テーブル内の項目が変更されると、StreamViewType は、このテーブルのストリームに書き込まれる情報を決定します。
StreamViewType の有効な値: + KEYS_ONLY - 変更された項目のキー属性のみがストリームに書き込まれます。
+
NEW_IMAGE - 変更後に表示される項目全体がストリームに書き込まれます。
+
OLD_IMAGE - 変更前に出現したアイテム全体がストリームに書き込まれます。
+
NEW_AND_OLD_IMAGES - 項目の新しい項目イメージと古い項目イメージの両方がストリームに書き込まれます。 |
糸 |
タグ自動生成8
名前 |
形容 |
価値 |
鍵 |
タグのキー。 タグ キーでは大文字と小文字が区別されます。 各 DynamoDB テーブルは、同じキーを持つ最大 1 つのタグのみを持つことができます。 既存のタグ (同じキー) を追加しようとすると、既存のタグ値が新しい値に更新されます。 |
糸 |
価値 |
タグの値。 タグの値は大文字と小文字が区別され、null にすることができます。 |
糸 |
TimeToLive仕様
名前 |
形容 |
価値 |
attributeName (属性名) |
テーブル内の項目の有効期限を格納するために使用される TTL 属性の名前。 + TTL を有効にする場合、または TTL が既に有効になっている場合は、AttributeName プロパティが必要です。 + このプロパティを更新するには、最初に TTL を無効にしてから、新しい属性名で TTL を有効にする必要があります。 |
糸 |
有効 |
テーブルで TTL を有効 (true) または無効 (false) にするかどうかを示します。 |
ブール (bool) |