翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用したリソースの特定 AWS Cloud Control API
すべてのリソースタイプには、プライマリ識別子として定義されるプロパティがあります。このプロパティの値は、特定の AWS アカウント および 内のそのタイプのリソースごとに一意である必要があります AWS リージョン。例えば、多くのリソースタイプには、そのタイプのリソースごとに一意でなければならない Name プロパティがあります。場合によっては、プライマリ識別子は、複数のプロパティの組み合わせ (これらが組み合わさって一意の識別子になる) として定義されます。このプライマリ識別子をリソースタイプと組み合わせて使用することで、update-resource や delete-resource などのリソースオペレーションを実行するリソースを正確に指定できます。
また、リソースタイプの中には、そのタイプのリソースを一意に識別するためにも使用できるセカンダリ識別子を定義するものもあります。
どのリソースプロパティ (またはプロパティの組み合わせ) がリソースタイプのプライマリ識別子であるかを判断するには、リソースタイプスキーマの primaryIdentifier 属性を参照してください。このスキーマには、定義されているセカンダリ識別子も含まれています。詳細については、「リソースタイプのスキーマの表示」を参照してください。
リソースのプライマリ識別子の取得
Cloud Control API コマンドを使用して、特定のリソースの識別子値を見つけることができます。以下の各コマンドは、指定されたリソースのプライマリ識別子が含まれる ProgressEvent オブジェクトを返します。
-
cancel-resource-request -
create-resource -
get-resource-request-status -
list-resource-requests
リソースのプライマリ識別子の使用
Cloud Control API コマンドを使用する場合は、リソーススキーマで、リソースタイプに定義されたプライマリ識別子または任意のセカンダリ識別子を指定できます。識別子は 1 つだけ指定できます。プライマリ識別子は文字列または として指定できますJSON。セカンダリ識別子は として指定する必要がありますJSON。
複合プライマリ識別子 (つまり、連結された複数のリソースプロパティで構成されたもの) の場合、プライマリ識別子を文字列として指定するには、プロパティ値を | で区切り、プライマリ識別子の定義で指定されている順序でリストします。
例えば、 リソースのプライマリ識別子は次のように定義されます。
"primaryIdentifier": [ "/properties/DatabaseName", "/properties/TableName" ]
そのため、 リソースのプライマリ識別子を文字列として指定するには、次の形式を使用します。
DatabaseName|TableName
例えば、データベース名が MyDatabase で、テーブル名が MyTable のデータベースであれば、MyDatabase|MyTable と指定します。
として指定された複合識別子の場合JSON、次の例に示すように、プロパティの順序は必要ありません。
{ "TableName": "MyTable", "DatabaseName": "MyDatabase" }
リソース識別子の詳細については、「 CloudFormation Command Line Interface User Move for Extension Development」の「primaryidentifier」を参照してください。
