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

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

使用共用config和credentials檔案全域設定 AWS SDKs和工具

共用 AWS config 和 credentials 檔案是最常見的方式，您可以將身分驗證和組態指定給 AWS SDK 或工具。

共用 config和 credentials 檔案包含一組設定檔。設定檔是一組組態設定，以鍵值對表示，供 AWS SDKs、 AWS Command Line Interface (AWS CLI) 和其他工具使用。組態值會連接至設定檔，以便在使用該設定檔時設定 SDK/工具的某些層面。這些檔案是「共用」，因為這些值會影響使用者本機環境上的任何應用程式、程序或SDKs。

共用config和credentials檔案都是純文字檔案，僅包含 ASCII 字元 (UTF-8 編碼）。它們採用通常稱為 INI 檔案的形式。

描述檔

共用 config和 credentials 檔案內的設定與特定設定檔相關聯。您可以在 檔案中定義多個設定檔，以建立不同的設定組態，以套用至不同的開發環境。

[default] 若未指定特定具名設定檔，設定檔會包含 SDK 或工具操作所使用的值。您也可以建立個別的設定檔，以便依名稱明確參考。每個設定檔都可以根據您的應用程式和案例使用不同的設定和值。

設定具名設定檔

[default] 設定檔和多個具名設定檔可以存在於同一個檔案中。使用下列設定來選取 SDK 或工具在執行程式碼時使用的設定檔設定。使用 時，也可以在程式碼內或每個命令內選取設定檔 AWS CLI。

透過設定下列其中一項來設定此功能：

組態檔案格式

config 檔案會分成數個區段。區段是具名的設定集合，且會持續到發生其他區段定義列為止。

config 檔案是使用下列格式的純文字檔案：

區段類型

區段定義是將名稱套用至設定集合的行。區段定義列以方形括號 ([) 開頭和結尾]。在括號內，有區段類型識別符和區段的自訂名稱。您可以使用字母、數字、連字號 ( ) - 和底線 ( _ )，但不能使用空格。

區段類型：default

範例區段定義列： [default]

[default] 是唯一不需要profile區段識別碼的設定檔。

下列範例顯示具有[default]設定檔的基本config檔案。它會設定 region設定。此行之後直到遇到另一個區段定義為止的所有設定，都是此設定檔的一部分。

[default]
#Full line comment, this text is ignored.
region = us-east-2

區段類型：profile

範例區段定義列： [profile dev]

profile 區段定義列是具名的組態群組，您可以套用至不同的開發案例。若要進一步了解具名設定檔，請參閱設定檔上的上一節。

下列範例顯示具有profile區段定義列和名為 之設定檔config的檔案foo。此行之後直到遇到另一個區段定義為止的所有設定，都是此具名設定檔的一部分。

[profile foo]
...settings...

有些設定有自己的巢狀子集群組，例如下列範例中s3的設定和子集。以一個或多個空格縮排子集，將子集與群組建立關聯。

[profile test]
region = us-west-2
s3 =
    max_concurrent_requests=10
    max_queue_size=1000

區段類型：sso-session

範例區段定義列： [sso-session my-sso]

sso-session 區段定義列會命名一組設定，您用來設定設定檔以使用 解析 AWS 登入資料 AWS IAM Identity Center。如需設定單一登入身分驗證的詳細資訊，請參閱使用 IAM Identity Center 驗證 AWS SDK 和工具。描述檔由索引鍵/值對連結到sso-session區段，其中 sso-session 是索引鍵，而sso-session區段的名稱是 值，例如 sso-session = <name-of-sso-session-section>。

下列範例會設定設定檔，使用來自 "my-sso" 的字符，取得 "111122223333" 帳戶中 "SampleRole" IAM 角色的短期 AWS 憑證。profile 區段中的「my-sso」sso-session區段是使用 sso-session金鑰以名稱參考。

[profile dev]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole

[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://my-sso-portal.awsapps.com/start

區段類型：services

範例區段定義列： [services dev]

services 區段定義列會為設定 AWS 服務 請求自訂端點的設定群組命名。描述檔由索引鍵值對連結到services區段，其中 services是索引鍵，而services區段的名稱是 值，例如 services = <name-of-services-section>。

services 區段會依<SERVICE> = 行進一步分成子區段，其中 <SERVICE>是 AWS 服務 識別符索引鍵。 AWS 服務 識別符是以 API 模型的 為基礎serviceId，方法是將所有空格替換為底線，並縮小所有字母大小寫。如需要在 services 區段中使用的所有服務識別碼金鑰的清單，請參閱 服務特定端點的識別符。服務識別碼金鑰後面接續巢狀化設定，每個設定獨佔一列並縮排兩個空格。

下列範例使用 services定義來設定端點，以用於僅對 服務提出的 Amazon DynamoDB 請求。在 "local-dynamodb" services 區段中，會使用 services金鑰，依名稱參考 profile區段。 AWS 服務 識別符索引鍵為 dynamodb。 Amazon DynamoDB 服務子區段從行 開始dynamodb = 。任何緊接著縮排的列都包含在該子區段中，並適用於該服務。

[profile dev]
services = local-dynamodb

[services local-dynamodb]
dynamodb = 
  endpoint_url = http://localhost:8000

如需自訂端點組態的詳細資訊，請參閱服務特定的端點。

登入資料檔案格式

檔案的規則credentials通常與config檔案的規則相同，但設定檔區段開頭不是 一詞profile。在方括號之間僅使用描述檔名稱本身。下列範例顯示名為 的設定檔區段credentials檔案foo。

[foo]
...credential settings...

只有下列被視為「秘密」或敏感的設定才能存放在 credentials 檔案中：aws_access_key_idaws_secret_access_key、 和 aws_session_token。雖然這些設定也可以放在共用config檔案中，但我們建議您將這些敏感值保留在單獨的credentials檔案中。如此一來，您可以視需要為每個檔案提供個別的許可。

下列範例顯示具有[default]設定檔的基本credentials檔案。它會設定 aws_access_key_idaws_secret_access_key、 和 aws_session_token 全域設定。

[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

無論您是否在 credentials 檔案中使用具名設定檔或「default」，此處的任何設定都會與使用相同設定檔名稱之config檔案中的任何設定合併。如果兩個檔案中都有共用相同名稱之設定檔的憑證，則憑證檔案中的金鑰具有高優先順序。