ModifyFlowLogAttribute - Virtual Private Cloud

呼叫 ModifyFlowLogAttribute 介面編輯流日誌的名稱和描述。

介面說明

ModifyFlowLogAttribute 介面屬於非同步介面，即系統會返回一個請求 ID，但該流日誌尚未修改成功，系統背景的修改任務仍在進行。您可以呼叫 DescribeFlowLogs 查詢流日誌的修改狀態：
- 當流日誌處於 Modifying 狀態時，表示流日誌正在修改中。
- 當流日誌處於 Active 或者 Inactive 狀態時，表示流日誌修改成功。
ModifyFlowLogAttribute 介面不支援並發修改同一個流日誌的屬性。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:ModifyFlowLogAttribute

update

*FlowLog

acs:vpc:{#regionId}:{#accountId}:flowlog/{#FlowLogId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	流日誌所屬的地域 ID。您可以透過呼叫 DescribeRegions 介面取得地域 ID。	cn-qingdao
FlowLogId	string	是	流日誌 ID。	fl-m5e8vhz2t21sel1nq****
FlowLogName	string	否	要修改的流日誌名稱。名稱長度為 1～128 個字元，不能以 `http://` 或 `https://` 開頭。	myFlowlog
Description	string	否	要修改的流日誌描述。描述長度為 1～256 個字元，不能以 `http://` 或 `https://` 開頭。	This is my Flowlog.
AggregationInterval	integer	否	要修改的流日誌的取樣間隔。單位：分鐘。取值：1、5、10。	1
IpVersion	string	否	流日誌採集流量的 IP 位址類型。	IPv4

返回參數

名稱	類型	描述	樣本值
	object	請求 ID。
Success	string	操作是否成功。取值： true：操作成功。 false：操作失敗。	true
RequestId	string	請求 ID。	F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1

樣本

正常返回樣本

JSON格式

{
  "Success": "true",
  "RequestId": "F7DDDC17-FA06-4AC2-8F35-59D2470FCFC1"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	IncorrectBusinessStatus.FlowLog	The business status of flowLog is incorrect.	目前業務狀態不支援建立流日誌執行個體。
400	InvalidInstanceId	Instance does not exist.	網卡執行個體不存在。
400	ProjectOrLogstoreNotExist	The specified project or logstore does not exist.	指定的專案或 Logstore 不存在。
400	SourceProjectNotExist	The Source Project or logstore does not exist.	SLS 來源專案或日誌庫不存在。
400	Unauthorized	This api does not support sub user or role.	此 API 不支援子使用者或角色。
400	InvalidInstanceId.NotFound	The specfied instance is not existed.
400	RuleExist	The rule has already existed.
400	InvalidHdMonitorStatus	Current instance status is not valid for this action.
400	FlowLogNumberOverLimit	This user has reached the maximum instance number of flowlog.
400	InvalidTrafficType.NotFound	Invalid traffic type.
400	IncorrectStatus.flowlog	Invalid flowlog status.	FlowLog 狀態無效，無法停止。
400	InvalidName.Malformed	The specified name is not valid.
400	IllegalParam.AggregationInterval	The param of aggregationInterval is illegal.	取樣間隔參數輸入不合法。
400	Forbidden.OperateManagedFlowLog	Authentication is failed for operate managed flowlog.	操作託管的流日誌，驗證失敗。
400	UnsupportedFeature.IpVersion	The ipversion type is not supported.	輸入的 ipVersion 不支援。
400	IllegalParam.IpVersion	The parameter of IpVersion is illegal.
400	OperationDenied.NisTrafficAnalyzerAggregationIntervalMismatch	The sampling interval of the FlowLog is greater than the sampling interval of the NIS Traffic Analyzer.	FlowLog 的取樣間隔大於 NIS 流量分析器的取樣間隔。
400	OperationDenied.NisTrafficAnalyzerNotActive	The specified NIS Traffic Analyzer is not enabled.	指定的 NIS 流量分析器處於未啟用狀態。
400	OperationDenied.NisTrafficAnalyzerNotFound	The specified NIS Traffic Analyzer does not exist.	指定的 NIS 流量分析器不存在。
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	未知錯誤，請重試操作，若錯誤仍然存在，請提交工單處理。
400	OperationDenied.InvalidInstanceDeliverScope	When modifying the delivery purpose of the FlowLog instance or starting and stopping NIS traffic analysis, you specify the type of delivery that is not allowed.	在修改 FlowLog 執行個體的投遞目的地或啟停 NIS 流量分析時，指定了不被允許的投遞類型。
400	IllegalParam.LogFormat	The specified parameter of LogFormat is invalid.	指定的 LogFormat 參數無效。
400	OperationDenied.UnsupportedField	LogFormat contains unsupported fields.	LogFormat 包含了不支援的欄位。
400	UnsupportedFeature.LogFormat	The ability to customize subscription fields for flow logs is not yet available, so stay tuned.	流日誌自訂訂閱欄位的功能尚未開放，敬請期待。
400	UnsupportedFeature.LogFormatNisTrafficAnalyze	The flow log for which NIS traffic analysis is enabled does not support custom subscription fields.	開啟了 NIS 流量分析的流日誌，暫不支援自訂訂閱欄位。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。