DescribeDisksFullStatus - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Consulta as informações de status completo de um ou mais dispositivos de armazenamento em bloco.

Descrição da operação

As informações de status completo de um dispositivo de armazenamento em bloco incluem o status do ciclo de vida do armazenamento em bloco (Status), o status de integridade do armazenamento em bloco (HealthStatus) e o tipo de evento do armazenamento em bloco (EventType).
Como o horário de publicação, o horário de execução agendado e o horário de execução real dos eventos relacionados ao armazenamento em bloco são os mesmos, você pode especificar um período de tempo (EventTime.Start a EventTime.End) para consultar todos os eventos históricos ocorridos durante esse período. Você pode consultar eventos históricos de, no máximo, os últimos sete dias.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:DescribeDisksFullStatus

list

Disco.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

Disco.

acs:ecs:{#regionId}:{#accountId}:disk/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do dispositivo de armazenamento em bloco. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
Status	string	Não	O status do ciclo de vida do dispositivo de armazenamento em bloco. Para mais informações, consulte Estados do disco. Valores válidos: In_use: em uso. Available: a ser anexado. Attaching: sendo anexado. Detaching: sendo desanexado. Creating: sendo criado. ReIniting: sendo inicializado.	Available
HealthStatus	string	Não	O status de integridade do dispositivo de armazenamento em bloco. Valores válidos: Impaired: temporariamente ilegível e não gravável. Warning: serviço degradado. Initializing: sendo inicializado. InsufficientData: dados insuficientes. NotApplicable: não aplicável.	Warning
EventType	string	Não	O tipo de evento do dispositivo de armazenamento em bloco. Valores válidos: Degraded: o desempenho do armazenamento em bloco está degradado. SeverelyDegraded: o desempenho do armazenamento em bloco está severamente degradado. Stalled: o desempenho do armazenamento em bloco está severamente impactado. ErrorDetected: um disco local está danificado.	Stalled
EventTime.Start	string	Não	O início do intervalo de tempo durante o qual os eventos serão consultados. Especifique o horário no padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. O horário deve estar em UTC.	2018-05-06T02:43:10Z
EventTime.End	string	Não	O fim do intervalo de tempo durante o qual os eventos serão consultados. Especifique o horário no padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. O horário deve estar em UTC.	2018-05-08T02:48:52Z
PageNumber	integer	Não	O número da página do resultado da consulta. Valores válidos: inteiros positivos. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valores válidos: 1 a 100. Valor padrão: 10.	10
DiskId	array	Não	O ID do armazenamento em bloco. Valores válidos de N: 1 a 100.	d-bp67acfmxazb4p****
	string	Não	O ID do armazenamento em bloco. Valores válidos de N: 1 a 100.	d-bp67acfmxazb4p****
EventId	array	Não	O ID do evento. Valores válidos de N: 1 a 100.	e-bp67acfmxazb4p****
	string	Não	O ID do evento. Valores válidos de N: 1 a 100.	e-bp67acfmxazb4p****
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o recurso de armazenamento em bloco pertence. Ao usar este parâmetro para filtrar recursos, a contagem de recursos não pode exceder 1.000.	rg-aek2kkmhmhs****
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag anexada ao recurso de armazenamento em bloco. N especifica que você pode definir uma ou mais chaves de tag. O valor de N neste parâmetro corresponde ao valor de N no parâmetro Tag.N.Value para formar um par chave-valor. Valores válidos de N: 1 a 20. Se você usar uma única tag para filtrar recursos, a contagem de recursos com essa tag não pode exceder 1.000. Se você usar várias tags para filtrar recursos, a contagem de recursos anexados a todas as tags especificadas não pode exceder 1.000.	TestKey
Value	string	Não	O valor da tag anexada ao recurso de armazenamento em bloco. N especifica que você pode definir um ou mais valores de tag. O valor de N neste parâmetro corresponde ao valor de N no parâmetro Tag.N.Key para formar um par chave-valor. Valores válidos de N: 1 a 20.	TestValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PageSize	integer	O número de entradas por página.	10
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumber	integer	O número da página.	1
TotalCount	integer	O número total de entradas de status completo.	2
DiskFullStatusSet	object
DiskFullStatusType	array<object>	A matriz de entradas de status completo do armazenamento em bloco.
	array<object>
DiskId	string	O ID do armazenamento em bloco.	d-bp67acfmxazb4p****
InstanceId	string	O ID da instância.	i-bp67acfmxazb4p****
Device	string	O nome do dispositivo do dispositivo de armazenamento em bloco anexado a uma instância, como /dev/xvdb. Este parâmetro tem um valor apenas quando o parâmetro Status está definido como In_use. O valor está vazio para outros status. Nota Este parâmetro será descontinuado. Para melhorar a compatibilidade do código, não use este parâmetro.	null
DiskEventSet	object
DiskEventType	array<object>	A matriz de eventos do armazenamento em bloco.
	array<object>
EventId	string	O ID do evento do armazenamento em bloco.	e-bp67acfmxazb4p****
EventEndTime	string	O horário em que o evento terminou. O horário é exibido em UTC no formato ISO 8601.	2018-05-06T02:48:52Z
EventTime	string	O horário em que o evento ocorreu. O horário é exibido em UTC no formato ISO 8601.	2018-05-08T02:43:10Z
ImpactLevel	string	O nível de impacto.	100
EventType	object	O tipo de evento.
Name	string	O nome do tipo de evento. Valores válidos: Degraded: o desempenho do armazenamento em bloco está degradado. SeverelyDegraded: o desempenho do armazenamento em bloco está severamente degradado. Stalled: o desempenho do armazenamento em bloco está severamente impactado. ErrorDetected: um disco local está danificado.	Stalled
Code	integer	O código do tipo de evento.	7
Status	object	O status do ciclo de vida do dispositivo de armazenamento em bloco.
Name	string	O nome do status do ciclo de vida do armazenamento em bloco.	Available
Code	integer	O código de status do status do ciclo de vida do armazenamento em bloco.	129
HealthStatus	object	O status de integridade do dispositivo de armazenamento em bloco.
Name	string	O nome do status de integridade do armazenamento em bloco.	Impaired
Code	integer	O código de status do status de integridade do armazenamento em bloco.	128

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 2,
  "DiskFullStatusSet": {
    "DiskFullStatusType": [
      {
        "DiskId": "d-bp67acfmxazb4p****",
        "InstanceId": "i-bp67acfmxazb4p****",
        "Device": "null",
        "DiskEventSet": {
          "DiskEventType": [
            {
              "EventId": "e-bp67acfmxazb4p****",
              "EventEndTime": "2018-05-06T02:48:52Z",
              "EventTime": "2018-05-08T02:43:10Z",
              "ImpactLevel": "100",
              "EventType": {
                "Name": "Stalled",
                "Code": 7
              }
            }
          ]
        },
        "Status": {
          "Name": "Available",
          "Code": 129
        },
        "HealthStatus": {
          "Name": "Impaired",
          "Code": 128
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
403	InvalidParameter	%s
403	DiskIdLimitExceeded	%s	O número de valores de DiskId especificados não pode exceder 100.
403	EventIdLimitExceeded	%s
403	InvalidParameter.TimeEndBeforeStart	%s	Os parâmetros especificados são inválidos. Verifique se a hora de término é anterior à hora de início.
403	OperationDenied.NotInWhiteList	%s	Esta operação é inválida. Adicione sua conta à lista de permissões primeiro.
403	TooManyDiskEvent.DiskIdRequired	%s	Muitas solicitações foram feitas para este ID de recurso. Tente novamente mais tarde.
404	MissingParameter	%s

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.