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

EFS S

亞馬遜 EFS API 是一種以 HTTP (RFC 2616) 為基礎的網路通訊協定。對於每個 API 呼叫，您都會向您要管理檔案系統的區域特定 Amazon EFS API 端點發出 HTTP 請求。AWS 區域此 API 會將 JSON (RFC 4627) 文件用於 HTTP 請求/回應內文。

亞馬遜 EFS API 是一種 RPC 模型。在此模型中有一組固定的操作，且每個操作的語法無須任何事先互動即會對用戶端公開。在下一節中，您可以找到使用抽象 RPC 表示法的每個 API 操作的說明。每個操作都有一個操作名稱，此名稱不會顯示在線路上。每個操作的主題都會指定映射至 HTTP 請求元素。

指定請求對應的特定 Amazon EFS 作業是由請求的方法 (GET、PUT、POST 或 DELETE) 以及要求 URI 符合哪些各種模式的組合來決定。如果作業是 PUT 或 POST，Amazon EFS 會從要求 URI 路徑區段、查詢參數和要求主體中的 JSON 物件擷取呼叫引數。

API 端點

API 端點是在 API 呼叫之 HTTP URI 中做為主機的 DNS 名稱。這些 API 端點特定於AWS 區域並採用以下形式。

elasticfilesystem.aws-region.amazonaws.com

例如，美國西部 (奧勒岡) 區域的 Amazon EFS API 端點如下。

elasticfilesystem.us-west-2.amazonaws.com

如需 Amazon EFS 支援的AWS 區域清單 (您可以在其中建立和管理檔案系統)，請參閱中的 Amazon Elastic File System AWS 一般參考。

區域特定的 API 端點定義了您進行 API 呼叫時可存取的 Amazon EFS 資源範圍。例如，當您使用上述端點呼叫DescribeFileSystems作業時，您會取得在您帳戶中建立的美國西部 (奧勒岡) 區域中的檔案系統清單。

API 版本

要用於呼叫的 API 版本會以請求 URI 的第一個路徑區段來識別，且其形式為 ISO 8601 日期。如需範例，請參閱 CreateFileSystem。

文件說明的是 API 2015-02-01 版。

相關主題

以下章節提供 API 操作的說明、如何建立用於請求身分驗證的簽章，以及如何使用 IAM 政策將許可授予給這些 API 操作。

使用亞馬遜 EFS 的查詢 API 請求率

Amazon EFS API 請求會針對每個區域進AWS 帳戶行限制，以協助提升服務效能。所有 Amazon EFS API 呼叫一起呼叫 (無論是來自應用程式AWS CLI、或 Amazon EFS 主控台) 都不得超過允許的 API 請求率上限。最大 API 請求率可能會有所不同AWS 區域。發出的 API 請求歸因於基礎AWS 帳戶。

如果 API 請求超過其類別的 API 請求率，該請求將傳回 ThrottlingException 錯誤碼。若要避免發生這種錯誤，請確保您的應用程式不會過度頻繁地重試 API 請求。您可以謹慎使用輪詢以及使用指數退避重試，以避免此錯誤。

輪詢

您的應用程式可能需要重複呼叫 API 操作，以查看狀態的更新。在您開始輪詢前，請設定請求時間讓請求可能完成。當您開始輪詢時，請在連續的請求之間使用適當的休眠間隔。為了獲得最佳結果，請使用較長的休眠間隔。

重試或批次處理

您的應用程式可能需要在 API 請求失敗後重試，或處理多個資源 (例如，所有 Amazon EFS 檔案系統)。若要降低 API 請求的速率，請在連續的請求之間使用適當的休眠間隔。為了獲得最佳結果，請使用較長或可變的休眠間隔。

計算

當您需要輪詢或重試 API 請求時，建議您使用指數退避演算法來計算 API 呼叫之間的休眠間隔。指數退避的背後概念是，對於連續錯誤回應，讓重試之間的等待時間漸進拉長。如需詳細資訊和此演算法的實作範例，請參閱中AWS的錯誤重試和指數輪詢Amazon Web Services 一般參考。