DescribeDomainPathData - - Centre de documentation Alibaba Cloud

Consulte les données de surveillance par répertoire, y compris le trafic et le nombre de visites.

Description de l'opération

Cette opération est disponible uniquement pour les utilisateurs sur liste blanche (dont la bande passante de pointe du nom de domaine est supérieure ou égale à 10 Gbit/s). Pour en faire la demande, soumettez un ticket. Si vous êtes éligible, la configuration sera effectuée en arrière-plan.
Limite de fréquence par utilisateur : 6 000 appels par minute.
Actuellement, les statistiques de bande passante au niveau du répertoire ne peuvent être activées que pour des noms de domaine spécifiques sous un compte, et non pour tous les noms de domaine.
La taille moyenne de tous les fichiers sous le nom de domaine doit être supérieure à 1 Mo.
Le nombre de répertoires pour chaque nom de domaine ne peut pas dépasser 100. Si le nombre de répertoires dépasse 100, la précision des données diminue et les résultats de requête peuvent être inexacts.
Si vous ne spécifiez pas StartTime et EndTime, le système interroge par défaut les données des 24 dernières heures. Vous pouvez également spécifier une heure de début et une heure de fin pour interroger les données dans une plage horaire spécifique. Les deux paramètres doivent être spécifiés en même temps.
Vous pouvez interroger les données des 30 derniers jours au maximum.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

cdn:DescribeDomainPathData

get

*Domaine.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
PageNumber	integer	Non	Le numéro de page. Les pages commencent à 1.	1
PageSize	integer	Non	Le nombre d'entrées par page. Valeurs valides : tout nombre entier de 1 à 1000.	20
Path	string	Non	Le chemin. Il doit commencer par une barre oblique (/). Si vous ne spécifiez pas ce paramètre, tous les chemins sont interrogés. Si le chemin est un répertoire, il doit se terminer par une barre oblique (/). Remarque La correspondance approximative n'est pas prise en charge pour les informations de chemin. Vous devez spécifier la profondeur du répertoire pour la requête, et elle ne peut être définie que sur une valeur fixe. Par exemple, si vous la définissez sur un répertoire de premier niveau /path/, le système collecte les statistiques de bande passante spécifiquement pour le répertoire de premier niveau.	/path/
StartTime	string	Non	L'heure de début. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Exemple : 2016-10-20T04:00:00Z.	2016-10-20T04:00:00Z
EndTime	string	Non	L'heure de fin. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. L'intervalle entre l'heure de début et l'heure de fin doit être inférieur à 30 jours. Exemple : 2016-10-21T04:00:00Z.	2016-10-21T04:00:00Z
DomainName	string	Oui	Le nom de domaine accéléré. Remarque Un seul nom de domaine est pris en charge pour chaque requête.	example.com

Éléments de réponse

Élément	Type	Description	Exemple
	object
EndTime	string	L'heure de fin. L'heure suit la norme ISO 8601 et est en UTC.	2017-09-30T17:00:00Z
StartTime	string	L'heure de début. L'heure suit la norme ISO 8601 et est en UTC.	2017-09-30T16:00:00Z
PageSize	integer	Le nombre d'entrées par page.	20
PageNumber	integer	Le numéro de page actuel. Les pages commencent à 1.	1
TotalCount	integer	Le nombre total d'entrées de données de bande passante de chemin.	2
DomainName	string	Le nom de domaine accéléré.	example.com
DataInterval	string	L'intervalle de temps. Unité : secondes.	300
PathDataPerInterval	object
UsageData	array<object>	La liste des données de bande passante de chemin.
	object
Path	string	Le chemin.	/path/
Time	string	L'horodatage. L'heure suit la norme ISO 8601 et est en UTC.	2017-09-30T16:00:00Z
Acc	integer	Le nombre de visites.	10
Traffic	integer	Le trafic. Unité : octets.	346
RequestId	string	L'identifiant de la requête.	DE81639B-DAC1-4C76-AB72-F34B836837D5

Exemples

JSON format

{
  "EndTime": "2017-09-30T17:00:00Z",
  "StartTime": "2017-09-30T16:00:00Z",
  "PageSize": 20,
  "PageNumber": 1,
  "TotalCount": 2,
  "DomainName": "example.com",
  "DataInterval": "300",
  "PathDataPerInterval": {
    "UsageData": [
      {
        "Path": "/path/",
        "Time": "2017-09-30T16:00:00Z",
        "Acc": 10,
        "Traffic": 346
      }
    ]
  },
  "RequestId": "DE81639B-DAC1-4C76-AB72-F34B836837D5"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	InvalidPageSize.Malformed	PageSize must be of type Integer
400	InvalidPageSize.ExceedsMaximum	PageSize should be less than or equal to 1000
400	InvalidPageSize.ExceedsMinimum	PageSize should be greater than or equal to 1
400	InvalidPath.Malformed	Path must be of type String
400	InvalidStartTime.Malformed	StartTime must be of type String
400	InvalidEndTime.Malformed	EndTime must be of type String
400	InvalidDomainName.Malformed	DomainName must be of type String
400	MissingParameter	DomainName is required
400	InvalidDomainName.TooShort	DomainName should be at least 1 chars long
400	InvalidPageNumber.Malformed	PageNumber must be of type Integer
400	InvalidPageNumber.ExceedsMinimum	PageNumber should be greater than or equal to 1
400	InvalidTime.OverRange	Specified StartTime or EndTime is over range

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.