DescribeCdnDomainLogs - CDN - Centro de documentación de Alibaba Cloud

Consulta las URL de descarga de registros sin conexión para un nombre de dominio.

Descripción de la operación

Si no especifica StartTime y EndTime, esta operación consulta los datos de las últimas 24 horas de forma predeterminada. Si especifica StartTime y EndTime, esta operación consulta los datos dentro del intervalo de tiempo especificado.
La granularidad de tiempo de los datos consultados es de una hora.
El límite de frecuencia para un solo usuario es de 100 llamadas por segundo.
Solo puede consultar registros del último mes. El intervalo de tiempo entre la hora de inicio y la hora actual no puede superar los 31 días.

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

cdn:DescribeCdnDomainLogs

get

*Domain.

acs:cdn:*:{#accountId}:domain/{#DomainName}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DomainName	string	Sí	El nombre de dominio. Solo se admite un único nombre de dominio.	example.com
PageSize	integer	No	El número de entradas por página. Valor predeterminado: 300. Valor máximo: 1000. Valores válidos: 1 a 1000.	300
PageNumber	integer	No	El número de página. Valores válidos: cualquier número entero mayor que 1.	2
StartTime	string	No	La hora de inicio de los registros a consultar. Especifique la hora en el estándar ISO 8601 con el formato yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.	2017-12-21T08:00:00Z
EndTime	string	No	La hora de fin de los registros a consultar. Especifique la hora en el estándar ISO 8601 con el formato yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC. Nota La hora de fin debe ser posterior a la hora de inicio.	2017-12-22T08:00:00Z

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8
DomainLogDetails	object
DomainLogDetail	array<object>	La lista de objetos DomainLogDetail.
	array<object>
LogCount	integer	El número total de entradas devueltas en la página actual.	10
DomainName	string	El nombre de dominio acelerado.	example.com
LogInfos	object
LogInfoDetail	array<object>	La lista de objetos LogInfoDetail.
	object
EndTime	string	La hora de fin. La hora está en el estándar ISO 8601 y en UTC.	2015-05-23T14:00:00Z
LogSize	integer	El tamaño del registro.	258
StartTime	string	La hora de inicio. La hora está en el estándar ISO 8601 y en UTC.	2015-05-23T13:00:00Z
LogName	string	El nombre del registro.	demo.aliyundoc.com_2015_05_23_2100_2200.gz
LogPath	string	La ruta del registro.	guide.aliyundoc.com-hangzhou.xxx
PageInfos	object	Los datos de PageInfoDetail.
PageIndex	integer	El número de página de los datos devueltos.	1
PageSize	integer	El tamaño de página.	20
Total	integer	El número total de entradas.	20

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "DomainLogDetails": {
    "DomainLogDetail": [
      {
        "LogCount": 10,
        "DomainName": "example.com",
        "LogInfos": {
          "LogInfoDetail": [
            {
              "EndTime": "2015-05-23T14:00:00Z",
              "LogSize": 258,
              "StartTime": "2015-05-23T13:00:00Z",
              "LogName": "demo.aliyundoc.com_2015_05_23_2100_2200.gz",
              "LogPath": "guide.aliyundoc.com-hangzhou.xxx"
            }
          ]
        },
        "PageInfos": {
          "PageIndex": 1,
          "PageSize": 20,
          "Total": 20
        }
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidStartTime.Malformed	Specified StartTime is malformed.	El formato de la hora de inicio no es válido. Consulte la documentación de la API para conocer el formato de fecha correcto.
400	InvalidEndTime.Malformed	Specified EndTime is malformed.	El formato de la hora de finalización no es válido.
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.
400	InvalidEndTime.Mismatch	The specified EndTime is earlier than the StartTime.	Compruebe si la configuración de hora es correcta. La hora de finalización no puede ser anterior ni igual a la hora de inicio.

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.