API Gateway：建立REST API並添加介面

執行個體外API

1. 登入雲原生API Gateway控制台。

2. 單擊左側導覽列API，並在頂部功能表列選擇地區。

3. 單擊创建API。

4. 單擊REST API卡片中的创建，在建立REST API面板中配置相關參數，單擊確認。

   配置項	說明
   API名称	自訂建立的API名稱，API名稱必須全域唯一。
   Base Path	API的基本路徑，訪問具體介面時，完整路徑為http(s)://{網域名稱}/{BasePath}/{介面Path}。
   版本管理	是否啟用API版本管理能力，不同版本的API視為獨立的API，它們具有相同的API名稱，但API的其他基本資料和介面資訊可以不同。訪問時需要指定版本標識符。 開啟版本管理功能後，需要配置使用方式。 說明 選擇使用方式為Query時，需要配置參數項添加Query。 選擇使用方式為Header時，需要配置參數項添加Header。
   使用方式	支援Path、Query、Header三種方式。 使用Path時，需要完整訪問路徑為：/API基本路徑/版本號碼/介面路徑。 使用Query時，完整訪問路徑為：/API基本路徑/介面路徑，請求參數中需要配置參數項添加Query為版本號碼。 使用Header時，完整訪問路徑為：/API基本路徑/介面路徑，要求標頭中需要配置參數項添加Header為版本號碼。
   描述	填寫API的相關描述。
   资源组	選擇目標資源群組。您可單擊右側的创建资源组。

單擊创建API。

1. 單擊REST API卡片中的创建，在建立REST API面板中配置相關參數，單擊確認。

   配置項	說明
   API名称	自訂建立的API名稱，API名稱必須全域唯一。
   Base Path	API的基本路徑，訪問具體介面時，完整路徑為http(s)://{網域名稱}/{BasePath}/{介面Path}。
   版本管理	是否啟用API版本管理能力，不同版本的API視為獨立的API，它們具有相同的API名稱，但API的其他基本資料和介面資訊可以不同。訪問時需要指定版本標識符。 開啟版本管理功能後，需要配置使用方式。 說明 選擇使用方式為Query時，需要配置參數項添加Query。 選擇使用方式為Header時，需要配置參數項添加Header。
   使用方式	支援Path、Query、Header三種方式。 使用Path時，需要完整訪問路徑為：/API基本路徑/版本號碼/介面路徑。 使用Query時，完整訪問路徑為：/API基本路徑/介面路徑，請求參數中需要配置參數項添加Query為版本號碼。 使用Header時，完整訪問路徑為：/API基本路徑/介面路徑，要求標頭中需要配置參數項添加Header為版本號碼。
   描述	填寫API的相關描述。
   资源组	選擇目標資源群組。您可單擊右側的创建资源组。

執行個體內API

1. 登入雲原生API Gateway控制台。

2. 單擊左側導覽列實例，並在頂部功能表列選擇地區。

3. 在實例頁面，單擊目標实例 ID進入概览頁面。然後單擊左側導覽列API，並單擊创建API。

4. 單擊REST API卡片中的创建，在创建HTTP API面板中配置相關參數，單擊確認。

   配置項	說明
   API名称	自訂建立的API名稱，API名稱必須全域唯一。
   域名	選擇API需要匹配的網域名稱，支援選擇多個網域名稱。 如果您需要建立新的網域名稱，可以直接單擊添加網域名稱，在面板中進行建立。
   Base Path	API的基本路徑，訪問具體介面時，完整路徑為http(s)://{網域名稱}/{BasePath}/{介面Path}。
   版本管理	是否啟用API版本管理能力，不同版本的API視為獨立的API，它們具有相同的API名稱，但API的其他基本資料和介面資訊可以不同。訪問時需要指定版本標識符。 開啟版本管理功能後，需要配置使用方式。 說明 選擇使用方式為Query時，需要配置參數項添加Query。 選擇使用方式為Header時，需要配置參數項添加Header。
   使用方式	支援Path、Query、Header三種方式。 使用Path時，需要完整訪問路徑為：/API基本路徑/版本號碼/介面路徑。 使用Query時，完整訪問路徑為：/API基本路徑/介面路徑，請求參數中需要配置參數項添加Query為版本號碼。 使用Header時，完整訪問路徑為：/API基本路徑/介面路徑，要求標頭中需要配置參數項添加Header為版本號碼。
   描述	填寫API的相關描述。
   资源组	選擇目標資源群組。您可單擊右側的创建资源组。
   使用场景	選擇當前介面的使用情境。 基礎情境：单服务。 灰階情境：按比例（多服务）、按内容（多服务）、标签路由（按比例）。 說明 涉及權重的目標服務流量比例總和要求為100%。
   后端服务	關聯該網關/VPC下的後端服務。若該網關下無後端服務，可單擊建立服務建立。 重要 在建立服務時，服務連接埠資訊可能不會立即顯示。您需要展開服務名稱的下拉式清單並單擊刷新。由於連接埠資訊同步是非同步進行的，可能需要稍等片刻才能載入並顯示完整的服務連接埠資訊。

執行個體外API

1. 登入雲原生API Gateway控制台。

2. 單擊左側導覽列API，並在頂部功能表列選擇地區。

3. 單擊创建API。

4. 單擊REST API卡片中的匯入，在基于OpenAPI创建文件面板中配置相關參數，單擊预检并创建。

   配置項	說明
   API名称	自訂建立的API名稱，API名稱必須全域唯一。
   上传方式	支援本地文件與OSS文件导入。 說明 本地檔案與OSS檔案匯入中的檔案均符合OpenAPI規範。
   OpenAPI文件	在選擇本地檔案時配置，支援選擇檔案或粘貼常值內容，限制檔案大小在30M內。
   Region选择	在選擇OSS檔案匯入時配置，選擇地區，以便選擇其OSS資源。
   OSS Bucket	在選擇OSS檔案匯入時配置，選擇OSS Bucket，暫不支援無地區屬性的Bucket。
   版本管理	是否啟用API版本管理能力，不同版本的API視為獨立的API，它們具有相同的API名稱，但API的其他基本資料和介面資訊可以不同。訪問時需要指定版本標識符。 開啟版本管理功能後，需要配置使用方式。 說明 選擇使用方式為Query時，需要配置參數項添加Query。 選擇使用方式為Header時，需要配置參數項添加Header。
   使用方式	支援Path、Query、Header三種方式。 使用Path時，需要完整訪問路徑為：/API基本路徑/版本號碼/介面路徑。 使用Query時，完整訪問路徑為：/API基本路徑/介面路徑，請求參數中需要配置參數項添加Query為版本號碼。 使用Header時，完整訪問路徑為：/API基本路徑/介面路徑，要求標頭中需要配置參數項添加Header為版本號碼。
   描述	填寫API的相關描述。
   资源组	選擇目標資源群組。您可單擊右側的创建资源组。

執行個體內API

1. 登入雲原生API Gateway控制台。

2. 單擊左側導覽列實例，並在頂部功能表列選擇地區。

3. 在實例頁面，單擊目標实例 ID進入概览頁面。然後單擊左側導覽列API，並單擊创建API。

4. 單擊REST API卡片中的匯入。在基于OpenAPI创建文件面板中配置相關參數，單擊预检并创建。

   配置項	說明
   API名称	自訂建立的API名稱，API名稱必須全域唯一。
   域名	選擇API需要匹配的網域名稱，支援選擇多個網域名稱。 如果您需要建立新的網域名稱，可以直接單擊添加網域名稱，在面板中進行建立。
   上传方式	支援本地文件與OSS文件导入。 說明 本地檔案與OSS檔案匯入中的檔案均符合OpenAPI規範。
   OpenAPI文件	在選擇本地檔案時配置，支援選擇檔案或粘貼常值內容，限制檔案大小在30M內。
   Region选择	在選擇OSS檔案匯入時配置，選擇地區，以便選擇其OSS資源。
   OSS Bucket	在選擇OSS檔案匯入時配置，選擇OSS Bucket，暫不支援無地區屬性的Bucket。
   版本管理	是否啟用API版本管理能力，不同版本的API視為獨立的API，它們具有相同的API名稱，但API的其他基本資料和介面資訊可以不同。訪問時需要指定版本標識符。 開啟版本管理功能後，需要配置使用方式。 說明 選擇使用方式為Query時，需要配置參數項添加Query。 選擇使用方式為Header時，需要配置參數項添加Header。
   使用方式	支援Path、Query、Header三種方式。 使用Path時，需要完整訪問路徑為：/API基本路徑/版本號碼/介面路徑。 使用Query時，完整訪問路徑為：/API基本路徑/介面路徑，請求參數中需要配置參數項添加Query為版本號碼。 使用Header時，完整訪問路徑為：/API基本路徑/介面路徑，要求標頭中需要配置參數項添加Header為版本號碼。
   描述	填寫API的相關描述。
   资源组	選擇目標資源群組。您可單擊右側的创建资源组。
   使用场景	選擇當前介面的使用情境。 基礎情境：单服务。 灰階情境：按比例（多服务）、按内容（多服务）、标签路由（按比例）。 說明 涉及權重的目標服務流量比例總和要求為100%。
   后端服务	關聯該網關/VPC下的後端服務。若該網關下無後端服務，可單擊建立服務建立。 重要 在建立服務時，服務連接埠資訊可能不會立即顯示。您需要展開服務名稱的下拉式清單並單擊刷新。由於連接埠資訊同步是非同步進行的，可能需要稍等片刻才能載入並顯示完整的服務連接埠資訊。