尋找 RFCs - AMS 進階使用者指南

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

尋找 RFCs

若要使用 AMS 主控台尋找 RFC,請遵循下列步驟。

注意

此程序僅適用於排程RFCs,也就是未使用 ASAP 選項的 RFCs。

  1. 在左側導覽中,按一下 RFCs

    RFCs儀表板隨即開啟。

  2. 捲動清單或使用篩選選項來精簡清單。

    RFC 清單會依篩選條件而變更。

  3. 選擇您想要之 RFC 的主旨連結。

    RFC 詳細資訊頁面會開啟該 RFC,其中包含 RFC ID 等資訊。

  4. 如果儀表板中有許多 RFCs,您可以使用篩選條件選項依 RFC 搜尋:

    • 主旨:建立 RFC 時提供給 RFC 的主旨行或標題 (在 API/CLI 中)。

    • RFC ID:RFC 的識別符。

    • 活動狀態:如果您知道 RFC 狀態,您可以在 AwsOperatorAssigned 之間進行選擇,表示運算子目前正在查看 RFC,AwsActionPending 表示 AMS 運算子必須執行某些動作,然後 RFC 執行才能繼續,或者 CustomerActionPending 表示您需要採取一些動作,才能繼續執行 RFC。

    • 狀態:如果您知道 RFC 狀態,您可以選擇:

      • 已排程:已排程RFCs。

      • 已取消:已取消RFCs。

      • 進行中:RFCs進行中。

      • 成功:成功執行RFCs。

      • 已拒絕:已拒絕RFCs。

      • 編輯:正在編輯RFCs。

      • 失敗:失敗RFCs。

      • 待核准:在 AMS 或您核准之前無法繼續進行RFCs。一般而言,這表示您需要核准 RFC。您會在服務請求清單中收到此服務通知。

    • 變更類型:挑選類別子類別項目操作,然後為您擷取變更類型 ID。

    • 請求的開始時間請求的結束時間:此篩選條件選項可讓您選擇之前或之後,然後輸入日期和選擇性的時間 (hh:mm 和時區)。此篩選條件只會在排程 RFCs (非 ASAP RFCs上成功運作。

    • 狀態已排程已取消進行中成功已拒絕編輯失敗

    • 主旨:您使用給定 RFC 的 API/CLI 建立 RFC 的主旨 (或標題)。

    • 變更類型 ID:使用與 RFC 一起提交的變更類型識別符。

    搜尋可讓您新增篩選條件,如下列螢幕擷取畫面所示。

    Search or filter options including Subject, RFC ID, Activity state, and various time-related fields.
  5. 按一下您想要之 RFC 的主旨連結。

    RFC 詳細資訊頁面會開啟該 RFC,其中包含 RFC ID 等資訊。

您可以使用多個篩選條件來尋找 RFC。

若要檢查變更類型版本,請使用下列命令:

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
注意

您可以將任何CreateRfc參數與任何 RFC 搭配使用,無論它們是否為變更類型結構描述的一部分。例如,若要在 RFC 狀態變更時取得通知,請將此行新增至請求的 --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" RFC 參數部分 (而非執行參數)。如需所有 CreateRfc 參數的清單,請參閱 AMS 變更管理 API 參考

如果您不記下 RFC ID,且稍後需要找到它,您可以使用 AMS 變更管理 (CM) 系統來搜尋它,並使用篩選條件或查詢縮小結果範圍。

  1. CM API ListRfcSummaries 操作具有篩選條件。您可以根據邏輯 AND 操作中的 AttributeValue組合,或根據 AttributeCondition和 來篩選結果Values

    RFC 篩選
    屬性 有效值 有效條件 預設條件 備註

    ActualEndTime

    任何代表 ISO8601 日期時間的字串 (例如,「20170101T000000Z」)

    之前、之後、之間

    Before 或 After 條件只接受值欄位中的一個值。介於條件在值欄位中必須剛好有兩個值,其中第一個值應代表在第二個值之前發生的日期

    ActualStartTime

    任何代表 ISO8601 日期時間的字串 (例如,「20170101T000000Z」)

    之前、之後、之間

    Before 或 After 條件只接受值欄位中的一個值。介於條件在值欄位中必須剛好有兩個值,其中第一個值應代表在第二個值之前發生的日期

    AutomationStatusId

    手動、自動化

    等於

    等於

    只有兩個自動化狀態

    ChangeTypeId

    任何有效的變更類型 ID;例如 ct-123h45t6uz7jl

    等於

    等於

    尋找變更類型或 CSIO

    ChangeTypeVersion

    任何有效的變更類型 ID;例如 1.0

    等於

    等於

    尋找變更類型或 CSIO

    CreatedBy

    任何字串 (長度上限為 2048 個字元)

    包含

    包含

    RFC 的 CreatedBy 欄位包含建立它的使用者的 ARN

    CreatedTime

    任何代表 ISO8601 日期時間的字串 (例如,「20170101T000000Z」)

    之前、之後、之間

    Before 或 After 條件只接受值欄位中的一個值。介於條件在值欄位中必須剛好有兩個值,其中第一個值應代表在第二個值之前發生的日期

    LastModifiedTime

    任何代表 ISO8601 日期時間的字串 (例如,「20170101T000000Z」)

    之前、之後、之間

    Before 或 After 條件只接受值欄位中的一個值。介於條件在值欄位中必須剛好有兩個值,其中第一個值應代表在第二個值之前發生的日期

    LastSubmittedTime

    任何代表 ISO8601 日期時間的字串 (例如,「20170101T000000Z」)

    之前、之後、之間

    Before 或 After 條件只接受值欄位中的一個值。介於條件在值欄位中必須剛好有兩個值,其中第一個值應代表在第二個值之前發生的日期

    RequestedEndTime

    任何代表 ISO8601 日期時間的字串 (例如,「20170101T000000Z」)

    之前、之後、之間

    Before 或 After 條件只接受值欄位中的一個值。介於條件在值欄位中必須剛好有兩個值,其中第一個值應代表在第二個值之前發生的日期

    RequestedStartTime

    任何代表 ISO8601 日期時間的字串 (例如,「20170101T000000Z」)

    之前、之後、之間

    Before 或 After 條件只接受值欄位中的一個值。介於條件在值欄位中必須剛好有兩個值,其中第一個值應代表在第二個值之前發生的日期

    RfcStatusId

    已取消、編輯、失敗、InProgress、 PendingApproval、已拒絕、已排程、成功

    等於

    等於

    在 AMS 主控台重新整理 RFC 清單或執行 GetRfc

    標題

    任何有效的 RFC 標題

    包含

    包含

    不支援每個個別欄位中的規則表達式。不區分大小寫的搜尋

    範例:

    若要尋找與 SQS 相關的所有 RFCs IDs (其中 SQS 包含在 CT 的項目部分),您可以使用此命令:

    list-rfc-summaries --query 'RfcSummaries[?contains(Item.Name,`SQS`)].[Category.Id,Subcategory.Id,Type.Id,Item.Id,RfcId]' --output table

    這會傳回如下內容:

    ---------------------------------------------------------------------------- | ListRfcSummaries | +----------+--------------------------------+-------+-------+----------------+ |Deployment| Advanced Stack Components |SQS |Create |ct-123h45t6uz7jl| |Management| Monitoring & Notification |SQS |Update |ct-123h45t6uz7jl| +----------+--------------------------------+-------+-------+----------------+

    另一個適用於 的篩選條件list-rfc-summariesAutomationStatusId,用於尋找自動化或手動RFCs:

    aws amscm list-rfc-summaries --filter Attribute=AutomationStatusId,Value=Automated

    另一個適用於 的篩選條件list-rfc-summariesTitle(主控台中的主旨):

    Attribute=Title,Value=RFC-TITLE

    JSON 中傳回 RFCs的新請求結構範例,其中:

    • (標題包含「Windows 2012」或「Amazon Linux」) 和

    • (RfcStatusId EQUALS "Success" 或 "InProgress") 和

    • (20170101T000000Z <= RequestedStartTime <= 20170103T000000Z) AND (ActualEndTime <= 20170103T000000Z)

    { "Filters": [ { "Attribute": "Title", "Values": ["Windows 2012", "Amazon Linux"], "Condition": "Contains" }, { "Attribute": "RfcStatusId", "Values": ["Success", "InProgress"], "Condition": "Equals" }, { "Attribute": "RequestedStartTime", "Values": ["20170101T000000Z", "20170103T000000Z"], "Condition": "Between" }, { "Attribute": "ActualEndTime", "Values": ["20170103T000000Z"], "Condition": "Before" } ] }
    注意

    使用更進階的 Filters,AMS 打算在即將發行的版本中棄用下列欄位:

    • 值:值欄位是篩選條件欄位的一部分。使用支援更進階功能的值欄位。

    • RequestedEndTimeRange:在支援更進階功能的篩選條件欄位中使用 RequestedEndTime

    • RequestedStartTimeRange:在支援更進階功能的篩選條件欄位中使用 RequestedStartTime。

    如需有關使用 CLI 查詢的資訊,請參閱如何使用 --query Option 篩選輸出和查詢語言參考 JMESPath Specification

  2. 如果您使用的是 AMS 主控台:

    前往 RFCs清單頁面。如有需要,您可以篩選 RFC 主體,這是您在建立 RFC Title時輸入的內容。

注意

此程序僅適用於排定的 RFCs,也就是未使用 ASAP 選項的 RFCs。