翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon での標準アクセス許可モードの開始方法 QLDB

このセクションを使用して、Amazon の標準アクセス許可モードを開始しますQLDB。このセクションでは、 AWS Identity and Access Management （IAM) の PartiQL アクションと のテーブルリソースで ID ベースのポリシーを記述する際に役立つリファレンステーブルを提供しますQLDB。また、 でアクセス許可ポリシーを作成するための step-by-stepチュートリアルとIAM、 でテーブルを検索ARNし、テーブルタグを作成する手順も含まれていますQLDB。

STANDARD アクセス許可モード

QLDB は台帳リソースのSTANDARDアクセス許可モードをサポートするようになりました。標準アクセス許可モードでは、台帳、テーブル、および PartiQL コマンドをより詳細なレベルでアクセスコントロールすることができます。デフォルトでは、このモードは、台帳内の任意のテーブルで、任意の PartiQL コマンドを実行するすべてのリクエストを拒否します。

標準モードでコマンドを許可するには、特定のテーブルリソースと PartiQL アクションIAMのアクセス許可ポリシーを で作成する必要があります。これは、台帳のSendCommandAPIアクセス許可に追加されます。このモードでポリシーを容易にするために、 は PartiQL コマンドの一連のIAMアクションと、QLDBテーブルの Amazon リソースネーム (ARNs) QLDBを導入しました。QLDB データオブジェクトモデルの詳細については、「」を参照してくださいAmazon の主要な概念と用語 QLDB。

PartiQL アクセス許可のリファレンス

次の表に、各 QLDB PartiQL コマンド、コマンドを実行するために に許可を付与する必要がある対応するIAMアクション、および に許可を付与できる AWS リソースを示します。ポリシーの Action フィールドでアクションを指定し、ポリシーの Resource フィールドでリソースの値を指定します。

これらの PartiQL コマンドへのアクセス許可を付与するIAMポリシードキュメントの例については、クイックスタートチュートリアル: アクセス許可ポリシーの作成「」または「」を参照してくださいAmazon のアイデンティティベースのポリシーの例 QLDB。

テーブル ID と の検索 ARN

テーブル ID を見つけるには、 を使用する AWS Management Console か、テーブル information_schema.user_tables をクエリします。コンソールでテーブルの詳細を表示する、または、このシステムカタログテーブルのクエリを実行するには、システムカタログリソースに対する SELECT アクセス許可が必要です。例えば、Vehicle テーブルのテーブル ID を検索するには、次のステートメントを実行できます。

SELECT * FROM information_schema.user_tables
WHERE name = 'Vehicle'

このクエリは、次の例のような形式で結果を返します。

{
    tableId: "Au1EiThbt8s0z9wM26REZN",
    name: "Vehicle",
    indexes: [
        { indexId: "Djg2nt0yIs2GY0T29Kud1z", expr: "[VIN]", status: "ONLINE" },
        { indexId: "4tPW3fUhaVhDinRgKRLhGU", expr: "[LicensePlateNumber]", status: "BUILDING" }
    ],
    status: "ACTIVE"
}

テーブルで PartiQL ステートメントを実行するアクセス許可を付与するには、次のARN形式でテーブルリソースを指定します。

arn:aws:qldb:${region}:${account-id}:ledger/${ledger-name}/table/${table-id}

以下は、テーブル ID ARNのテーブルの例ですAu1EiThbt8s0z9wM26REZN。

arn:aws:qldb:us-east-1:123456789012:ledger/myExampleLedger/table/Au1EiThbt8s0z9wM26REZN

テーブルのタグ付け

テーブルリソースにタグ付けすることができます。既存のテーブルのタグを管理するには、 AWS Management Console または APIオペレーション TagResource、、UntagResourceおよび を使用しますListTagsForResource。詳細については、「Amazon QLDBリソースのタグ付け」を参照してください。

QLDB コンソールを使用するかCREATE TABLEPartiQL ステートメントで指定することで、テーブルの作成中にテーブルタグを定義することもできます。次の例では、Vehicle という名前のテーブルをタグ environment=production を付けて作成します。

CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'production'}`)

作成時にテーブルにタグを付けるには、qldb:PartiQLCreateTable および qldb:TagResource アクションの両方にアクセスする必要があります。

作成時にリソースにタグ付けすることで、リソース作成後にカスタムタグ付けスクリプトを実行する必要がなくなります。テーブルにタグを付けると、それらのタグに基づいてテーブルへのアクセスを制御できます。例えば、特定のタグを持つテーブルにのみフルアクセスを付与できます。JSON ポリシーの例については、「」を参照してくださいテーブルタグに基づくすべてのアクションへのフルアクセス。

クイックスタートチュートリアル: アクセス許可ポリシーの作成

このチュートリアルでは、アクセス許可モードで Amazon QLDB台帳IAMの でアクセスSTANDARD許可ポリシーを作成する手順を説明します。その後、ユーザー、グループ、またはロールに権限を割り当てることができます。

PartiQL コマンドとテーブルリソースへのアクセス許可を付与するIAMポリシードキュメントの例については、「」を参照してくださいAmazon のアイデンティティベースのポリシーの例 QLDB。

前提条件

作業を始める前に、次の操作を実行してください。

読み取り専用ポリシーの作成

JSON ポリシーエディタを使用して、標準アクセス許可モードで台帳内のすべてのテーブルの読み取り専用ポリシーを作成するには、以下を実行します。

フルアクセスポリシーの作成

標準アクセス許可モードでQLDB台帳内のすべてのテーブルのフルアクセスポリシーを作成するには、以下を実行します。

特定のテーブルの読み取り専用ポリシーの作成

標準アクセス許可モードでQLDB台帳内の特定のテーブルの読み取り専用アクセスポリシーを作成するには、次の手順を実行します。

権限の割り当て

アクセスQLDB許可ポリシーを作成したら、次のようにアクセス許可を割り当てます。

アクセス権限を付与するには、ユーザー、グループ、またはロールにアクセス許可を追加します。