DescribeDcdnDomainRealTimeSrcBpsData - Edge Security Acceleration - Centro de documentación de Alibaba Cloud

Consulta los datos de ancho de banda de retorno al origen en tiempo real de un nombre de dominio.

Descripción de la operación

La frecuencia máxima de invocación por usuario es de 10 invocaciones por segundo.
Si no especifica StartTime y EndTime, la operación devuelve los datos de la última hora de forma predeterminada. Si especifica StartTime y EndTime, la operación devuelve los datos dentro del intervalo de tiempo especificado.

Granularidad de tiempo de las marcas de tiempo de los datos devueltos

Según el intervalo de tiempo entre StartTime y EndTime, se devuelven diferentes granularidades de marcas de tiempo de los datos. El intervalo de tiempo correspondiente de los datos históricos que se pueden consultar y la latencia de los datos son los siguientes:

Granularidad de tiempo	Intervalo de tiempo máximo por consulta	Intervalo de tiempo de datos históricos que se pueden consultar	Latencia de datos
1 minuto	1 hora	7 días	5 minutos
5 minutos	3 días	93 días	15 minutos
1 hora	31 días	186 días	Generalmente de 3 a 4 horas

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dcdn:DescribeDcdnDomainRealTimeSrcBpsData

get

*Domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DomainName	string	Sí	El nombre de dominio acelerado. Separe varios nombres de dominio con comas (,).	example.com
StartTime	string	No	La hora de inicio de los datos que se van a recuperar. Especifique la hora en formato ISO 8601 yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.	2015-12-10T20:00:00Z
EndTime	string	No	La hora de fin de los datos que se van a recuperar. Especifique la hora en formato ISO 8601 yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. La hora de fin debe ser posterior a la hora de inicio.	2015-12-10T20:01:00Z

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
EndTime	string	La hora de fin. La hora sigue el estándar ISO 8601 en formato yyyy-MM-ddTHH:mm:ssZ. La hora está en UTC.	2015-12-10T20:01:00Z
StartTime	string	La hora de inicio. La hora sigue el estándar ISO 8601 en formato yyyy-MM-ddTHH:mm:ssZ. La hora está en UTC.	2015-12-10T20:00:00Z
RequestId	string	El ID de la solicitud.	7CBCD6AD-B016-42E5-AE0B-B3731DE8F755
DomainName	string	El nombre de dominio acelerado.	example.com
DataInterval	string	El intervalo de tiempo entre dos registros consecutivos. Unidad: segundos. Según el intervalo de tiempo máximo por consulta, este parámetro devuelve un valor fijo de 60 (1 minuto), 300 (5 minutos) o 3600 (1 hora). Para obtener más información, consulte la sección Granularidad de tiempo de las marcas de tiempo de los datos devueltos.	60
RealTimeSrcBpsDataPerInterval	object
DataModule	array<object>	Los datos de ancho de banda de retorno al origen recopilados en cada intervalo de tiempo. Unidad: bit/s.
	object
Value	string	Los datos de uso detallados.	0
TimeStamp	string	La hora de inicio del intervalo de tiempo. La hora sigue el estándar ISO 8601 en formato yyyy-MM-ddTHH:mm:ssZ. La hora está en UTC.	2015-12-10T20:01:00Z

Ejemplos

Respuesta exitosa

JSON Formato

{
  "EndTime": "2015-12-10T20:01:00Z",
  "StartTime": "2015-12-10T20:00:00Z",
  "RequestId": "7CBCD6AD-B016-42E5-AE0B-B3731DE8F755",
  "DomainName": "example.com",
  "DataInterval": "60",
  "RealTimeSrcBpsDataPerInterval": {
    "DataModule": [
      {
        "Value": "0",
        "TimeStamp": "2015-12-10T20:01:00Z"
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingTimeParameter	The StartTime and EndTime must be both specified.	Especifique tanto la hora de inicio como la hora de finalización.
400	InvalidStartTime.Malformed	The specified StartTime parameter is invalid.	Especifique un formato de hora de inicio válido. El formato de fecha sigue el estándar ISO 8601 y utiliza la hora UTC en el formato: yyyy-MM-ddTHH:mm:ssZ.
400	InvalidEndTime.Malformed	The specified EndTime is invalid.	Proporcione un formato de hora de finalización válido. El formato de fecha sigue el estándar ISO 8601 y utiliza UTC. El formato es yyyy-MM-ddTHH:mm:ssZ.
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	La hora de finalización es anterior a la hora de inicio. Verifique la configuración de hora.
400	InvalidStartTime.ValueNotSupported	The specified StartTime is invalid.	La hora de inicio no es compatible. Especifique una hora de inicio válida.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.