Amazon 資源名稱 (ARN) - AWS Identity and Access Management
ARN 格式查詢資源的 ARN 格式ARN 中的路徑

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon 資源名稱 (ARN)

Amazon 資源名稱 (ARN) 可以唯一識別 AWS 資源。當您需要明確指定所有資源 (例如 IAM 政策 AWS、Amazon 關聯式資料庫服務 (Amazon RDS) 標籤和 API 呼叫中的資源時，我們需要 ARN。

ARN 格式

以下是 ARN 的一般格式。特定格式視資源而定。若要使用 ARN，請以資源特定資訊取代斜體文字。請注意，有些資源的 ARN 會省略區域、帳戶 ID 或同時省略區域和帳戶 ID。

arn:partition:service:region:account-id:resource-id
arn:partition:service:region:account-id:resource-type/resource-id
arn:partition:service:region:account-id:resource-type:resource-id
partition

資源所在的分割區。分區是一組區 AWS 域。每個 AWS 帳戶的範圍是一個分區。

以下是支援的分割區：

  • aws- AWS 地區

  • aws-cn - 中國區域

  • aws-us-gov - AWS GovCloud (US) 區域

service

識別 AWS 產品的服務命名空間。

region

區域代碼。例如，請為美國東部 (俄亥俄) 指定 us-east-2。如需區域代碼清單，請參閱 AWS 一般參考 中的區域端點。

account-id

擁有資源的 AWS 帳號識別碼 (不含連字號)。例如 123456789012。

resource-type

資源類型。例如，虛擬私有雲端 (VPC) 的 vpc。

resource-id

資源識別碼。這是資源名稱、資源 ID 或資源路徑。某些資源識別碼包括父項資源 (sub-resource-type/父資源/子資源) 或限定元，例如版本 (資源類型:資源:資源名稱:限定符)。

範例
IAM 使用者

arn:aws:iam::123456789012:user/johndoe

SNS 主題

阿姆斯特丹:符號:我們-東部-1: example-sns-topic-name

VPC

arn:aws:ec2:us-east-1:123456789012:vpc/vpc-0e9801d129EXAMPLE

查詢資源的 ARN 格式

ARN 的確切格式取決於服務和資源類型。有些資源 ARN 可能包含路徑、變數或萬用字元。若要查詢特定 AWS 資源的 ARN 格式，請開啟「服務授權參考」，開啟服務的頁面，然後瀏覽至資源類型表格。

ARN 中的路徑

資源 ARN 可以包含路徑。例如，在 Amazon S3 中，資源識別符是物件名稱，其中包含正斜線 (/) 來形成路徑。同樣地，IAM 使用者名稱和群組名稱可以包含路徑。IAM 路徑僅允許包含英數字元和下列字元：正斜線 (/)、加號 (+)、等號 (=)、逗號 (,)、句點 (.)、at 符號 (@)、底線 (_) 和連字號 (-)。

在路徑中使用萬用字元

路徑可以包含萬用字元，也就是星號 (*)。例如，如果您要編寫 IAM 政策，您可以使用萬用字元指定路徑為 product_1234 的所有 IAM 使用者，如下所示：

arn:aws:iam::123456789012:user/Development/product_1234/*

同樣地，您可以指定 user/* 來代表所有使用者，或指定 group/* 來代表所有群組，如以下範例所示：

"Resource":"arn:aws:iam::123456789012:user/*"
"Resource":"arn:aws:iam::123456789012:group/*"

以下範例顯示的 ARN 是針對其中資源名稱包含路徑的 Amazon S3 儲存貯體：

arn:aws:s3:::my_corporate_bucket/*
arn:aws:s3:::my_corporate_bucket/Development/*
不正確的萬用字元用法

您不能使用 ARN 部分中指定資源類型的萬用字元，例如 IAM ARN 中的 user 詞彙。例如，不允許下列項目。

arn:aws:iam::123456789012:u*   <== not allowed