DescribeDisksFullStatus - Elastic Compute Service

描述

磁碟的全部狀態資訊包含磁碟生命週期（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	內部錯誤。