查詢一塊或多塊磁碟的全部狀態資訊。

描述

  • 磁碟的全部狀態資訊包含磁碟生命週期（Status），磁碟健康狀態（HealthStatus）和磁碟事件類型（EventType）。

  • 由於磁碟相關 事件的發布時間、事件的計劃執行時間 以及 事件的實際執行時間 相同，如果指定一段時間 [EventTime.Start, EventTime.End]，則可以查詢這段時間中發生過的所有曆史事件。目前，您最多可以查詢最近一周的曆史事件。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：DescribeDisksFullStatus
RegionId String 是 磁碟所在地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
DiskId.N String 否 磁碟 ID，N 的取值範圍：[1, 100]。
EventId.N String 否 事件 ID，N 的取值範圍：[1, 100]。
Status String 否 指定磁碟的生命週期狀態，參閱 雲端碟狀態表。取值範圍：
  • In_use：使用中
  • Available：待掛載
  • Attaching：掛載中
  • Detaching：卸載中
  • Creating：建立中
  • ReIniting：初始化中
HealthStatus String 否 指定磁碟的健康狀態。取值範圍：
  • Impaired：暫時性不可讀寫
  • Warning：服務降級
  • Initializing：初始化中
  • InsufficientData：資料不足
  • NotApplicable：不適用
EventType String 否 指定磁碟的事件類型。取值範圍：
  • Degraded：磁碟效能降級
  • SeverelyDegraded：磁碟效能嚴重降級
  • Stalled：磁碟效能受到嚴重影響
EventTime.Start String 否 查詢事件發生時間的開始時間。按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
EventTime.End String 否 查詢事件發生時間的結束時間。按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。結束時間必須晚於開始時間。
PageNumber Integer 否 查詢結果的頁碼。取值範圍：正整數

預設值：1
PageSize Integer 否 查詢結果的分頁大小。取值範圍：[1, 100]

預設值：10

返回參數

名稱 類型 描述
TotalCount Integer ECS 執行個體狀態總個數
PageNumber Integer ECS 執行個體列表頁碼
PageSize Integer 每頁大小
DiskFullStatusSet Array of DiskFullStatusType 磁碟全狀態數組
資料類型 DiskFullStatusType
名稱 類型 描述
DiskId String 磁碟 ID
DiskEventSet Array of DiskEventType 磁碟事件數目組
Status.Code Integer 磁碟生命週期狀態碼
Status.Name String 磁碟生命週期狀態名稱
HealthStatus.Code Integer 磁碟健康狀態碼
HealthStatus.Name String 磁碟健康狀態名稱
資料類型 DiskEventType
名稱 類型 描述
EventId String 磁碟事件 ID
EventType.Code Integer 事件類型代碼
EventType.Name String 事件類型名稱
EventTime String 事件發生時間。按照 ISO8601 標準表示，並使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。
EventEndTime String 事件結束時間。按照 ISO8601 標準表示，並使用 UTC 時間。格式為 YYYY-MM-DDTHH:mm:ssZ。

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=DescribeDisksFullStatus
&RegionId=cn-hangzhou
&<公共請求參數>
正常返回樣本

XML 格式

<DescribeDisksFullStatusResponse>
    <DiskFullStatusSet>
        <DiskFullStatusType>
            <DiskEventSet>
                <DiskEventType>
                    <EventId>e-event1</EventId>
                    <EventType>
                        <Code>7</Code>
                        <Name>Stalled</Name>
                    </EventType>
                    <EventTime>2018-05-08T02:43:10Z</EventTime>
                </DiskEventType>
            </DiskEventSet>
            <DiskId>d-disk1</DiskId>
            <HealthStatus>
                <Code>128</Code>
                <Name>Impaired</Name>
            </HealthStatus>
            <Status>
                <Code>129</Code>
                <Name>Available</Name>
            </Status>
        </DiskFullStatusType>
        <DiskFullStatusType>
            <DiskEventSet>
                <DiskEventType>
                    <EventId>e-event2</EventId>
                    <EventType>
                        <Code>1</Code>
                        <Name>Degraded</Name>
                    </EventType>
                    <EventTime>2018-05-06T02:43:10Z</EventTime>
                    <EventEndTime>2018-05-06T02:48:52Z</EventEndTime>
                </DiskEventType>
            </DiskEventSet>
            <DiskId>d-disk2</DiskId>
            <HealthStatus>
                <Code>64</Code>
                <Name>Warning</Name>
            </HealthStatus>
            <Status>
                <Code>0</Code>
                <Name>Ok</Name>
            </Status>
        </DiskFullStatusType>
    </DiskFullStatusSet>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <RequestId>1A8B4B27-8B2D-XXXX-XXXX-0F64DBE4C211</RequestId>
    <TotalCount>2</TotalCount>
</DescribeDisksFullStatusResponse>
JSON 格式 
{
    "DiskFullStatusSet": {
        "DiskFullStatusType": [
            {
                "DiskEventSet": {
                    "DiskEventType": [
                        {
                            "EventId": "e-event1",
                            "EventType": {
                                "Code": "7",
                                "Name": "Stalled"
                            },
                            "EventTime": "2018-05-08T02:43:10Z"
                        }
                    ]
                },
                "DiskId": "d-disk1",
                "HealthStatus": {
                    "Code": 128,
                    "Name": "Impaired"
                },
                "Status": {
                    "Code": 129,
                    "Name": "Available"
                }
            },
            {
                "DiskEventSet": {
                    "DiskEventType": [
                        {
                            "EventId": "e-event2",
                            "EventType": {
                                "Code": "1",
                                "Name": "Degraded"
                            },
                            "EventTime": "2018-05-06T02:43:10Z",
                            "EventEndTime": "2018-05-06T02:48:52Z"
                        }
                    ]
                },
                "DiskId": "d-disk2",
                "HealthStatus": {
                    "Code": 0,
                    "Name": "Ok"
                },
                "Status": {
                    "Code": 129,
                    "Name": "Available"
                }
            }
        ]
    },
    "PageNumber": 1,
    "PageSize": 10,
    "RequestId": "1A8B4B27-8B2D-XXXX-XXXX-0F64DBE4C211",
    "TotalCount": 2
}
異常返回樣本

XML 格式

<Error>
    <RequestId>C38E0D94-C18B-44F3-8C05-6E35BE334086</RequestId>
    <HostId>ecs.aliyuncs.com</HostId>
    <Code>MissingParameter</Code>
    <Message>The input parameter that is mandatory for processing this request is not supplied.</Message>
</Error>
JSON 格式 
{
    "RequestId": "1A8B4B27-8B2D-XXXX-XXXX-0F64DBE4C211",
    "HostId": "ecs.aliyuncs.com"
    "Code": "MissingParameter"
    "Message": "The input parameter that is mandatory for processing this request is not supplied."
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidParameter The Parameter provided is not valid. 403 請求參數不合法。
InvalidParameter.LengthExceeded The Parameter provided exceeds maximum length. 403 參數 EventId.N 中 N 的指定範圍只能為 [1, 100]。
InvalidParameter.TooManyDiskId The diskIds provided is out of bounds [1,100]. 403 指定的參數值超出了合法範圍。
InvalidParameter.TimeEndBeforeStart The event time end should be after event time start. 403 指定的事件時間篩選條件不合法，結束時間必須晚於開始時間。
MissingParameter The input parameter that is mandatory for processing this request is not supplied. 403 輸入的參數缺少必填項。
InternalError The request processing has failed due to some unknown error,exception or failure. 500 內部錯誤。