次の方法で共有


Microsoft.AwsConnector ダイナモDBTables

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 プロパティを指定し、StreamSpecificationTableClass プロパティ、または DeletionProtectionEnabled プロパティを指定する場合、IAM エンティティの作成/更新スタックには UpdateTable アクセス許可が必要です。 S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。 ImportSourceSpecification (英語)
キースキーマ テーブルの主キーを構成する属性を指定します。 KeySchema プロパティの属性は、AttributeDefinitions プロパティでも定義する必要があります。 キースキーマ[]
kinesisStream仕様 指定したテーブルの Kinesis データ ストリーム構成。 指定したテーブルの Kinesis データ ストリーム構成。 KinesisStreamSpecification (キネシスストリーム仕様)
localSecondaryインデックス テーブルに作成するローカル セカンダリ インデックス。 最大 5 つのローカル セカンダリ インデックスを作成できます。 各インデックスのスコープは、特定のハッシュ キー値です。 各ハッシュ キーのサイズは最大 10 ギガバイトです。 LocalSecondaryIndex[]
pointInTimeRecoverySpecification (ポイントインタイムリカバリ仕様) ポイントインタイム リカバリーを有効にするために使用される設定。 ポイントインタイム リカバリーを有効にするために使用される設定。 PointInTimeRecovery仕様
プロビジョニングされたスループット 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニングされたスループット構造の内容の詳細については、「Amazon DynamoDB Table ProvisionedThroughputを参照してください。 BillingModeとして PROVISIONED を設定する場合は、このプロパティを指定する必要があります。 BillingModePAY_PER_REQUESTとして設定した場合、このプロパティを指定することはできません。 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「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 構成を表します。 ストリーム仕様
テーブルクラス 新しいテーブルのテーブル クラス。 有効な値は STANDARDSTANDARD_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 (パブリッククラウドリソース名) パブリック クラウド リソース名

DynamoDBTablePropertiesAwsタグ

名前 形容 価値

GlobalSecondaryIndex

名前 形容 価値
contributorInsights仕様 指定したグローバル セカンダリ インデックスに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 寄稿者インサイト仕様
インデックス名 グローバル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。
キースキーマ グローバル セカンダリ インデックスの完全なキー スキーマ。1 つ以上の属性名とキーの種類のペアで構成されます。+ HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 キースキーマ[]
投射 テーブルからグローバル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 プロジェクション
プロビジョニングされたスループット 指定したグローバル セカンダリ インデックスのプロビジョニング済みスループット設定を表します。 現在のプロビジョニング済みスループットの最小値と最大値については、Amazon DynamoDB 開発者ガイドの「サービス、アカウント、テーブルクォータの」を参照してください。 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 プロビジョニングされたスループット

ImportSourceSpecification (英語)

名前 形容 価値
入力圧縮タイプ インポートされたテーブルからの入力で使用される圧縮の種類。
インプットフォーマット ソース データの形式。 ImportFormat の有効な値は、CSVDYNAMODB_JSON、または IONです。
inputFormatOptions (入力フォーマットオプション 入力の書式設定方法を指定する追加のプロパティ。ターゲット テーブルにインポートされたデータの書式オプション。 CsvOption という 1 つの値があります。 InputFormatOptions (入力フォーマットオプション)
s3バケットソース インポートのソースを提供する S3 バケット。 インポートされる S3 バケット。 S3バケットソース

InputFormatOptions (入力フォーマットオプション)

名前 形容 価値
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 プロパティを指定し、StreamSpecificationTableClass プロパティ、または DeletionProtectionEnabled プロパティを指定する場合、IAM エンティティの作成/更新スタックには UpdateTable アクセス許可が必要です。 S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。 ImportSourceSpecification (英語)
キースキーマ テーブルの主キーを構成する属性を指定します。 KeySchema プロパティの属性は、AttributeDefinitions プロパティでも定義する必要があります。 キースキーマ[]
kinesisStream仕様 指定したテーブルの Kinesis データ ストリーム構成。 指定したテーブルの Kinesis データ ストリーム構成。 KinesisStreamSpecification (キネシスストリーム仕様)
localSecondaryインデックス テーブルに作成するローカル セカンダリ インデックス。 最大 5 つのローカル セカンダリ インデックスを作成できます。 各インデックスのスコープは、特定のハッシュ キー値です。 各ハッシュ キーのサイズは最大 10 ギガバイトです。 LocalSecondaryIndex[]
pointInTimeRecoverySpecification (ポイントインタイムリカバリ仕様) ポイントインタイム リカバリーを有効にするために使用される設定。 ポイントインタイム リカバリーを有効にするために使用される設定。 PointInTimeRecovery仕様
プロビジョニングされたスループット 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニングされたスループット構造の内容の詳細については、「Amazon DynamoDB Table ProvisionedThroughputを参照してください。 BillingModeとして PROVISIONED を設定する場合は、このプロパティを指定する必要があります。 BillingModePAY_PER_REQUESTとして設定した場合、このプロパティを指定することはできません。 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「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 構成を表します。 ストリーム仕様
テーブルクラス 新しいテーブルのテーブル クラス。 有効な値は STANDARDSTANDARD_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 (パブリッククラウドリソース名) パブリック クラウド リソース名

DynamoDBTablePropertiesAwsタグ

名前 形容 価値

GlobalSecondaryIndex

名前 形容 価値
contributorInsights仕様 指定したグローバル セカンダリ インデックスに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 寄稿者インサイト仕様
インデックス名 グローバル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。
キースキーマ グローバル セカンダリ インデックスの完全なキー スキーマ。1 つ以上の属性名とキーの種類のペアで構成されます。+ HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 キースキーマ[]
投射 テーブルからグローバル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 プロジェクション
プロビジョニングされたスループット 指定したグローバル セカンダリ インデックスのプロビジョニング済みスループット設定を表します。 現在のプロビジョニング済みスループットの最小値と最大値については、Amazon DynamoDB 開発者ガイドの「サービス、アカウント、テーブルクォータの」を参照してください。 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 プロビジョニングされたスループット

ImportSourceSpecification (英語)

名前 形容 価値
入力圧縮タイプ インポートされたテーブルからの入力で使用される圧縮の種類。
インプットフォーマット ソース データの形式。 ImportFormat の有効な値は、CSVDYNAMODB_JSON、または IONです。
inputFormatOptions (入力フォーマットオプション 入力の書式設定方法を指定する追加のプロパティ。ターゲット テーブルにインポートされたデータの書式オプション。 CsvOption という 1 つの値があります。 InputFormatOptions (入力フォーマットオプション)
s3バケットソース インポートのソースを提供する S3 バケット。 インポートされる S3 バケット。 S3バケットソース

InputFormatOptions (入力フォーマットオプション)

名前 形容 価値
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)

追跡リソースタグ

名前 形容 価値

使用例

Terraform (AzAPI プロバイダー) リソース定義

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 プロパティを指定し、StreamSpecificationTableClass プロパティ、または DeletionProtectionEnabled プロパティを指定する場合、IAM エンティティの作成/更新スタックには UpdateTable アクセス許可が必要です。 S3 バケット ソースからテーブルにインポートされるデータのプロパティを指定します。 ImportSourceSpecification (英語)
キースキーマ テーブルの主キーを構成する属性を指定します。 KeySchema プロパティの属性は、AttributeDefinitions プロパティでも定義する必要があります。 キースキーマ[]
kinesisStream仕様 指定したテーブルの Kinesis データ ストリーム構成。 指定したテーブルの Kinesis データ ストリーム構成。 KinesisStreamSpecification (キネシスストリーム仕様)
localSecondaryインデックス テーブルに作成するローカル セカンダリ インデックス。 最大 5 つのローカル セカンダリ インデックスを作成できます。 各インデックスのスコープは、特定のハッシュ キー値です。 各ハッシュ キーのサイズは最大 10 ギガバイトです。 LocalSecondaryIndex[]
pointInTimeRecoverySpecification (ポイントインタイムリカバリ仕様) ポイントインタイム リカバリーを有効にするために使用される設定。 ポイントインタイム リカバリーを有効にするために使用される設定。 PointInTimeRecovery仕様
プロビジョニングされたスループット 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニングされたスループット構造の内容の詳細については、「Amazon DynamoDB Table ProvisionedThroughputを参照してください。 BillingModeとして PROVISIONED を設定する場合は、このプロパティを指定する必要があります。 BillingModePAY_PER_REQUESTとして設定した場合、このプロパティを指定することはできません。 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「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 構成を表します。 ストリーム仕様
テーブルクラス 新しいテーブルのテーブル クラス。 有効な値は STANDARDSTANDARD_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 (パブリッククラウドリソース名) パブリック クラウド リソース名

DynamoDBTablePropertiesAwsタグ

名前 形容 価値

GlobalSecondaryIndex

名前 形容 価値
contributorInsights仕様 指定したグローバル セカンダリ インデックスに対して CloudWatch Contributor Insights を有効または無効にするために使用される設定。 CloudWatch Contributor Insights を有効または無効にするために使用される設定。 寄稿者インサイト仕様
インデックス名 グローバル セカンダリ インデックスの名前。 この名前は、このテーブルの他のすべてのインデックス間で一意である必要があります。
キースキーマ グローバル セカンダリ インデックスの完全なキー スキーマ。1 つ以上の属性名とキーの種類のペアで構成されます。+ HASH - パーティション キー + RANGE - 並べ替えキー 項目のパーティション キーは、ハッシュ属性とも呼ばれます。 "ハッシュ属性" という用語は、DynamoDB が内部ハッシュ関数を使用して、パーティション キーの値に基づいてパーティション間でデータ項目を均等に分散することに由来します。 項目の並べ替えキーは、範囲属性とも呼ばれます。 "range attribute" という用語は、DynamoDB が同じパーティション キーを持つ項目を物理的に一緒に格納する方法から、並べ替えキーの値で並べ替えられた順序で派生します。 キースキーマ[]
投射 テーブルからグローバル セカンダリ インデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 テーブルからインデックスにコピー (投影) される属性を表します。 これらは、主キー属性とインデックス キー属性に加えて、自動的に投影されます。 プロジェクション
プロビジョニングされたスループット 指定したグローバル セカンダリ インデックスのプロビジョニング済みスループット設定を表します。 現在のプロビジョニング済みスループットの最小値と最大値については、Amazon DynamoDB 開発者ガイドの「サービス、アカウント、テーブルクォータの」を参照してください。 指定したテーブルのスループット。ReadCapacityUnitsWriteCapacityUnitsの値で構成されます。 プロビジョニング済みスループット構造の内容の詳細については、「Table ProvisionedThroughput」を参照してください。 プロビジョニングされたスループット

ImportSourceSpecification (英語)

名前 形容 価値
入力圧縮タイプ インポートされたテーブルからの入力で使用される圧縮の種類。
インプットフォーマット ソース データの形式。 ImportFormat の有効な値は、CSVDYNAMODB_JSON、または IONです。
inputFormatOptions (入力フォーマットオプション 入力の書式設定方法を指定する追加のプロパティ。ターゲット テーブルにインポートされたデータの書式オプション。 CsvOption という 1 つの値があります。 InputFormatOptions (入力フォーマットオプション)
s3バケットソース インポートのソースを提供する S3 バケット。 インポートされる S3 バケット。 S3バケットソース

InputFormatOptions (入力フォーマットオプション)

名前 形容 価値
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)

追跡リソースタグ

名前 形容 価値