'1.0',
'info' => [
'style' => 'RPC',
'product' => 'Cms',
'version' => '2019-01-01',
],
'directories' => [
[
'id' => 184857,
'title' => '应用分组',
'type' => 'directory',
'children' => [
[
'id' => 59483,
'title' => '管理应用分组',
'type' => 'directory',
'children' => [
'CreateMonitorGroup',
'ModifyMonitorGroup',
'DeleteMonitorGroup',
'DescribeMonitorGroups',
'CreateMonitorGroupInstances',
'ModifyMonitorGroupInstances',
'DescribeMonitorGroupInstances',
'DescribeMonitorGroupDynamicRules',
'DescribeMonitorGroupInstanceAttribute',
'DeleteMonitorGroupDynamicRule',
'DeleteMonitorGroupInstances',
'DescribeMonitorGroupCategories',
'PutMonitorGroupDynamicRule',
'CreateGroupMonitoringAgentProcess',
'ModifyGroupMonitoringAgentProcess',
'DeleteGroupMonitoringAgentProcess',
'DescribeGroupMonitoringAgentProcess',
'CreateMonitorGroupNotifyPolicy',
'DeleteMonitorGroupNotifyPolicy',
'DescribeMonitorGroupNotifyPolicyList',
],
],
[
'id' => 59517,
'title' => '标签',
'type' => 'directory',
'children' => [
'AddTags',
'CreateDynamicTagGroup',
'DeleteDynamicTagGroup',
'DescribeTagValueList',
'DescribeTagKeyList',
'DescribeProductResourceTagKeyList',
'DescribeDynamicTagRuleList',
'RemoveTags',
],
],
[
'id' => 59436,
'title' => '可用性监控',
'type' => 'directory',
'children' => [
'CreateHostAvailability',
'DeleteHostAvailability',
'EnableHostAvailability',
'DisableHostAvailability',
'ModifyHostAvailability',
'DescribeUnhealthyHostAvailability',
'DescribeHostAvailabilityList',
],
],
],
],
[
'id' => 59416,
'title' => '主机监控',
'type' => 'directory',
'children' => [
'InstallMonitoringAgent',
'DescribeMonitoringAgentHosts',
'DescribeMonitoringAgentAccessKey',
'DescribeMonitoringAgentConfig',
'DescribeMonitoringAgentStatuses',
'ModifyHostInfo',
'DescribeMonitoringConfig',
'PutMonitoringConfig',
'UninstallMonitoringAgent',
'CreateMonitoringAgentProcess',
'CreateMonitorAgentProcess',
'DescribeMonitoringAgentProcesses',
'DeleteMonitoringAgentProcess',
],
],
[
'id' => 184858,
'title' => '事件中心',
'type' => 'directory',
'children' => [
[
'id' => 59447,
'title' => '系统事件',
'type' => 'directory',
'children' => [
'DescribeSystemEventHistogram',
'DescribeSystemEventMetaList',
'DescribeSystemEventAttribute',
'DescribeSystemEventCount',
'DescribeMonitorResourceQuotaAttribute',
'SendDryRunSystemEvent',
],
],
[
'id' => 59478,
'title' => '自定义事件',
'type' => 'directory',
'children' => [
'DescribeCustomEventCount',
'DescribeCustomEventHistogram',
'DescribeCustomEventAttribute',
'PutCustomEvent',
],
],
],
],
[
'id' => 59473,
'title' => '自定义监控',
'type' => 'directory',
'children' => [
'PutCustomMetric',
'PutCustomMetricRule',
'DescribeCustomMetricList',
'DeleteCustomMetric',
],
],
[
'id' => 59526,
'title' => '日志监控',
'type' => 'directory',
'children' => [
'PutLogMonitor',
'DeleteLogMonitor',
'DescribeLogMonitorList',
'DescribeLogMonitorAttribute',
],
],
[
'id' => 184946,
'title' => '站点监控',
'type' => 'directory',
'children' => [
'CreateMonitorGroupByResourceGroupId',
'CreateSiteMonitor',
'CreateInstantSiteMonitor',
'BatchCreateInstantSiteMonitor',
'DeleteSiteMonitors',
'DisableSiteMonitors',
'ModifySiteMonitor',
'EnableSiteMonitors',
'DescribeSiteMonitorQuota',
'DescribeSiteMonitorAttribute',
'DescribeSiteMonitorISPCityList',
'DescribeSiteMonitorData',
'DescribeSiteMonitorStatistics',
'DescribeSiteMonitorList',
'DescribeSiteMonitorLog',
],
],
[
'id' => 59386,
'title' => '云产品监控',
'type' => 'directory',
'children' => [
'DescribeMetricLast',
'DescribeMetricList',
'DescribeMetricData',
'DescribeMetricMetaList',
'DescribeProjectMeta',
'DeleteExporterOutput',
'DeleteExporterRule',
'DescribeExporterOutputList',
'DescribeExporterRuleList',
'DescribeMetricTop',
'PutExporterOutput',
'PutExporterRule',
],
],
[
'id' => 184862,
'title' => '报警服务',
'type' => 'directory',
'children' => [
[
'id' => 184895,
'title' => '报警历史',
'type' => 'directory',
'children' => [
'DescribeAlertHistoryList',
'DescribeAlertLogCount',
'DescribeAlertLogList',
'DescribeAlertLogHistogram',
],
],
[
'id' => 184896,
'title' => '一键报警',
'type' => 'directory',
'children' => [
'DescribeProductsOfActiveMetricRule',
'DescribeActiveMetricRuleList',
'EnableActiveMetricRule',
'DisableActiveMetricRule',
],
],
[
'id' => 59454,
'title' => '报警模板',
'type' => 'directory',
'children' => [
'CreateMetricRuleTemplate',
'DeleteMetricRuleTemplate',
'ModifyMetricRuleTemplate',
'DescribeMetricRuleTemplateAttribute',
'DescribeMetricRuleTemplateList',
'ApplyMetricRuleTemplate',
],
],
[
'id' => 59396,
'title' => '阈值报警规则',
'type' => 'directory',
'children' => [
'DescribeMetricRuleList',
'CreateGroupMetricRules',
'CreateMetricRuleResources',
'DeleteMetricRuleTargets',
'DeleteMetricRules',
'DeleteMetricRuleResources',
'EnableMetricRules',
'DisableMetricRules',
'DescribeMetricRuleTargets',
'DescribeMetricRuleCount',
'DescribeAlertingMetricRuleResources',
'PutMetricRuleTargets',
'PutResourceMetricRule',
'PutResourceMetricRules',
'PutGroupMetricRule',
],
],
[
'id' => 59461,
'title' => '事件报警规则',
'type' => 'directory',
'children' => [
'DeleteEventRuleTargets',
'DeleteEventRules',
'EnableEventRules',
'DisableEventRules',
'DescribeEventRuleAttribute',
'DescribeEventRuleList',
'DescribeEventRuleTargetList',
'PutEventRuleTargets',
'PutEventRule',
'PutCustomEventRule',
],
],
[
'id' => 184863,
'title' => '报警黑名单',
'type' => 'directory',
'children' => [
'CreateMetricRuleBlackList',
'ModifyMetricRuleBlackList',
'DeleteMetricRuleBlackList',
'DescribeMetricRuleBlackList',
'EnableMetricRuleBlackList',
],
],
[
'id' => 59428,
'title' => '报警联系人',
'type' => 'directory',
'children' => [
'DeleteContactGroup',
'DeleteContact',
'DescribeContactListByContactGroup',
'DescribeContactGroupList',
'DescribeContactList',
'PutContact',
'PutContactGroup',
],
],
],
],
[
'id' => 166246,
'title' => '企业云监控',
'type' => 'directory',
'children' => [
'CreateHybridMonitorNamespace',
'ModifyHybridMonitorNamespace',
'DeleteHybridMonitorNamespace',
'DescribeHybridMonitorNamespaceList',
'CreateHybridMonitorTask',
'ModifyHybridMonitorTask',
'DeleteHybridMonitorTask',
'DescribeHybridMonitorTaskList',
'PutHybridMonitorMetricData',
'DescribeHybridMonitorDataList',
'CreateHybridMonitorSLSGroup',
'ModifyHybridMonitorSLSGroup',
'DeleteHybridMonitorSLSGroup',
'DescribeHybridMonitorSLSGroup',
'Cursor',
'BatchExport',
],
],
[
'id' => 313480,
'title' => '其他',
'type' => 'directory',
'children' => [
'DescribeSyntheticProbeList',
],
],
],
'components' => [
'schemas' => [
'AlertEvent' => [
'title' => 'A short description of struct',
'description' => '报警事件',
'type' => 'object',
'properties' => [
'TraceId' => [
'title' => '事件跟踪id',
'type' => 'string',
],
'DeDupId' => [
'title' => '事件排重id',
'type' => 'string',
],
'AlertStatus' => [
'title' => '报警状态',
'type' => 'string',
],
'Source' => [
'title' => '报警来源',
'type' => 'string',
],
'Severity' => [
'title' => '严重级别',
'type' => 'string',
],
'ResourceInfo' => [
'title' => '报警资源',
'type' => 'object',
],
'CustomLabels' => [
'title' => '自定义标签',
'type' => 'object',
],
'Details' => [
'title' => '详细信息',
'type' => 'string',
],
'AlertName' => [
'title' => '报警名称',
'type' => 'string',
],
'RuleName' => [
'title' => '规则名称',
'type' => 'string',
],
'EventName' => [
'title' => '事件名称',
'type' => 'string',
],
'Summary' => [
'title' => '描述',
'type' => 'string',
],
'UserId' => [
'title' => '用户id',
'type' => 'string',
],
'Timestamp' => [
'title' => '时间戳',
'type' => 'integer',
'format' => 'int64',
],
'Expression' => [
'title' => '表达式',
'type' => 'string',
],
'Metrics' => [
'title' => '指标列表',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'MetricNameEn' => [
'title' => '英文指标名',
'type' => 'string',
],
'Unit' => [
'title' => '单位',
'type' => 'string',
],
'MetricName' => [
'title' => '指标名',
'type' => 'string',
],
'Threshold' => [
'title' => '阈值',
'type' => 'string',
],
'UnitFactor' => [
'title' => '单位系数',
'type' => 'number',
'format' => 'float',
],
'Operator' => [
'title' => '比较方法',
'type' => 'string',
],
'CurValue' => [
'title' => '当前值',
'type' => 'string',
],
'Statistics' => [
'title' => '统计方法',
'type' => 'string',
],
'MetricNameZh' => [
'title' => '中文指标名',
'type' => 'string',
],
],
],
],
'Content' => [
'title' => 'event raw content',
'type' => 'string',
],
'EventType' => [
'title' => 'event type',
'type' => 'string',
],
'Product' => [
'title' => 'product',
'type' => 'string',
],
'Arn' => [
'title' => 'arn',
'type' => 'string',
],
],
],
'AlertStrategyRelation' => [
'title' => 'A short description of struct',
'description' => '报警通知策略关联对象',
'type' => 'object',
'properties' => [
'AlertName' => [
'title' => '报警规则名',
'type' => 'string',
],
'StrategyUuid' => [
'title' => '通知策略uuid',
'type' => 'string',
],
],
],
'Dimension' => [
'title' => 'Dimension',
'description' => '监控项维度信息。',
'type' => 'object',
'properties' => [
'Label' => [
'title' => 'Dimension label',
'description' => '监控项维度的名称。',
'type' => 'string',
'example' => 'instanceId',
],
'Value' => [
'title' => 'Dimension value',
'description' => '监控项维度的值。',
'type' => 'string',
'example' => 'i-dferwret*****',
],
],
],
'EscalationRule' => [
'title' => '升级规则',
'type' => 'object',
'properties' => [
'Name' => [
'title' => '名称',
'type' => 'string',
'required' => true,
],
'Description' => [
'title' => '描述',
'type' => 'string',
],
'Uuid' => [
'title' => 'UUID',
'type' => 'string',
],
'UserId' => [
'title' => '用户id',
'type' => 'string',
'required' => false,
],
'CreateTime' => [
'title' => '创建时间',
'type' => 'string',
],
'UpdateTime' => [
'title' => '更新时间',
'type' => 'string',
],
'Escalations' => [
'title' => '升级设置',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'EscalateMin' => [
'title' => '升级分钟数',
'type' => 'integer',
'format' => 'int64',
],
'ContactGroups' => [
'title' => '联系组列表',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'ContactGroupsByLevel' => [
'title' => '自定义级别联系组',
'type' => 'object',
'properties' => [
'Critical' => [
'title' => 'critical',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Error' => [
'title' => 'error',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Warning' => [
'title' => 'warning',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Info' => [
'title' => 'info',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Resolve' => [
'title' => 'resolve',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
],
],
'BackupContactGroups' => [
'title' => '备份联系组列表',
'type' => 'array',
'items' => [
'type' => 'string',
'example' => '联系组',
],
],
],
],
'required' => true,
'maxItems' => 6,
],
],
],
'Incident' => [
'title' => 'A short description of struct',
'description' => '报警 Incident',
'type' => 'object',
'properties' => [
'IncidentId' => [
'title' => 'Incident UUID',
'type' => 'string',
],
'GroupingId' => [
'title' => '分组合并的id',
'type' => 'string',
],
'GroupingKey' => [
'title' => '合并原始key',
'type' => 'string',
],
'GroupingData' => [
'title' => '合并原始数据',
'type' => 'object',
],
'UserId' => [
'title' => '用户id',
'type' => 'string',
],
'Severity' => [
'title' => '严重程度',
'type' => 'string',
],
'StartTime' => [
'title' => '开始时间',
'type' => 'integer',
'format' => 'int64',
],
'EndTime' => [
'title' => '结束时间',
'type' => 'integer',
'format' => 'int64',
],
'ActionTime' => [
'title' => '最近操作时间',
'type' => 'integer',
'format' => 'int64',
],
'IncidentStatus' => [
'title' => '报警状态',
'type' => 'string',
],
'AlertCount' => [
'title' => '报警次数',
'type' => 'integer',
'format' => 'int64',
],
'StrategyUuid' => [
'title' => '通知策略uuid',
'type' => 'string',
],
],
],
'Matcher' => [
'title' => 'mathcer',
'description' => '监控项的维度。',
'type' => 'object',
'properties' => [
'Value' => [
'title' => 'value',
'description' => '监控项维度(dimension)的值。',
'type' => 'string',
'example' => 'instanceId',
],
'Label' => [
'title' => 'label',
'description' => '监控项维度(dimension)的名称。',
'type' => 'string',
'example' => 'i-fewrewr*****',
],
'Operator' => [
'title' => 'operator',
'description' => '监控项维度(dimension)匹配的方式,目前只支持EQUALS。默认EQUALS。',
'type' => 'string',
'example' => 'EQUALS',
],
],
],
'MetricStat' => [
'title' => '查询数据点',
'description' => 'BatchExport查询的数据。',
'type' => 'object',
'properties' => [
'Namespace' => [
'title' => 'namespace',
'description' => '云产品的数据命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'Metric' => [
'title' => 'metric',
'description' => '云产品的监控项名称。',
'type' => 'string',
'example' => 'cpu_idle',
],
'Period' => [
'title' => 'period',
'description' => '监控项的时间间隔。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '60',
],
'Timestamp' => [
'title' => 'timestamp',
'description' => '监控数据的时间戳(单位:毫秒)',
'type' => 'integer',
'format' => 'int64',
'example' => '1641454680000',
],
'Dimensions' => [
'title' => 'dimensions',
'description' => '用于标识监控对象(实例)的Dimension信息。',
'type' => 'array',
'items' => [
'description' => '用于标识监控对象(实例)的Dimension信息。',
'$ref' => '#/components/schemas/Dimension',
],
],
'Associated' => [
'title' => 'associated',
'description' => '监控对象(实例)的附加信息。',
'type' => 'object',
'additionalProperties' => [
'description' => '监控对象(实例)的附加信息。',
'type' => 'string',
'example' => '{"group":"test****", "name":"Alice"}',
],
],
'Measurements' => [
'title' => 'measurements',
'description' => '指标的测量值(默认多值模式)。',
'type' => 'object',
'additionalProperties' => [
'description' => '指标的测量值(默认多值模式)。',
'type' => 'any',
'example' => '{"Average":60,"Maximum":85}',
],
],
'LogTime' => [
'title' => 'logTime',
'description' => '监控数据的记录时间(单位:毫秒),对于非原始数据(聚合后的数据),LogTime为空(NULL)。',
'type' => 'integer',
'format' => 'int64',
'example' => '1683686550073',
],
],
],
'MigrationJob' => [
'title' => 'MigrationJob',
'type' => 'object',
'properties' => [
'Uuid' => [
'title' => 'UUID',
'type' => 'string',
],
'CreateTime' => [
'title' => '创建时间',
'type' => 'string',
],
'UpdateTime' => [
'title' => '更新时间',
'type' => 'string',
],
'RuleNames' => [
'title' => '规则列表',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Detail' => [
'title' => '迁移结果详情',
'type' => 'string',
],
'JobStatus' => [
'title' => '任务状态',
'type' => 'string',
],
'Source' => [
'title' => '迁移源',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Rule' => [
'title' => '规则list',
'type' => 'object',
'properties' => [
'Name' => [
'title' => 'name',
'type' => 'string',
],
'KeywordFilter' => [
'title' => 'keywordFilter',
'type' => 'object',
'properties' => [
'Relation' => [
'title' => 'relation',
'type' => 'string',
],
'Keywords' => [
'title' => 'keywords',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
],
],
'PrimaryFilters' => [
'title' => 'primaryFilters',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Field' => [
'title' => 'field',
'type' => 'string',
],
'OpType' => [
'title' => 'opType',
'type' => 'string',
],
'Value' => [
'title' => 'value',
'type' => 'string',
],
],
],
],
],
],
'Targets' => [
'title' => '事件规则目标',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => [
'title' => 'type',
'type' => 'string',
],
'Content' => [
'title' => 'Content',
'type' => 'object',
'properties' => [
'Level' => [
'title' => 'level',
'type' => 'string',
],
'Group' => [
'title' => 'group',
'type' => 'string',
],
'Method' => [
'title' => 'method',
'type' => 'string',
],
'Url' => [
'title' => 'url',
'type' => 'string',
],
'Region' => [
'title' => 'region',
'type' => 'string',
],
'ResourcePath' => [
'title' => 'resourcePath',
'type' => 'string',
],
],
],
],
],
],
],
],
],
'Plan' => [
'title' => '迁移计划',
'type' => 'object',
'properties' => [
'Subscriptions' => [
'title' => '订阅列表',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Name' => [
'title' => '订阅名称',
'type' => 'string',
],
'StrategyUuid' => [
'title' => '通知配置Uuid',
'type' => 'string',
],
'Conditions' => [
'title' => '条件列表',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Field' => [
'title' => 'field',
'type' => 'string',
],
'Op' => [
'title' => 'op',
'type' => 'string',
],
'Value' => [
'title' => 'value',
'type' => 'string',
],
],
],
],
],
],
],
'Strategies' => [
'title' => 'strategies',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'EscalationSetting' => [
'title' => 'escalation',
'type' => 'object',
'properties' => [
'escalationUuid' => [
'title' => 'escalationUuid',
'type' => 'string',
],
],
],
'Name' => [
'title' => 'name',
'type' => 'string',
],
'PushingSetting' => [
'title' => 'pushingSetting',
'type' => 'object',
'properties' => [
'TargetUuids' => [
'title' => 'targetUuids',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
],
],
],
],
],
'Escalations' => [
'title' => '通知配置',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Uuid' => [
'title' => '通知配置Uuid',
'type' => 'string',
],
'Name' => [
'title' => 'name',
'type' => 'string',
],
'Escalations' => [
'title' => 'Escalations',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Groups' => [
'title' => 'groups',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'LevelGroups' => [
'title' => 'level groups',
'type' => 'object',
'properties' => [
'Critical' => [
'title' => 'critical groups',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Warning' => [
'title' => 'warning groups',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Info' => [
'title' => 'info groups',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
'Resolved' => [
'title' => 'resolved groups',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
],
],
],
],
],
],
],
],
'Targets' => [
'title' => '事件规则目标',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => [
'title' => '类型',
'type' => 'string',
],
'Name' => [
'title' => 'name',
'type' => 'string',
],
'Uuid' => [
'title' => 'uuid',
'type' => 'string',
],
'HttpRequestTarget' => [
'title' => 'httpRequestTarget',
'type' => 'object',
'properties' => [
'Method' => [
'title' => 'method',
'type' => 'string',
],
'Url' => [
'title' => 'url',
'type' => 'string',
],
'ContentType' => [
'title' => 'contenttype',
'type' => 'string',
],
],
],
'Arn' => [
'title' => 'arn',
'type' => 'string',
],
],
],
],
'Contacts' => [
'title' => 'contacts',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Name' => [
'title' => 'contact',
'type' => 'string',
],
'Channels' => [
'title' => 'channels',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => [
'title' => 'type',
'type' => 'string',
],
'Value' => [
'title' => 'value',
'type' => 'string',
],
'Level' => [
'title' => 'level',
'type' => 'integer',
'format' => 'int64',
],
],
],
],
],
],
],
'Groups' => [
'title' => 'groups',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Name' => [
'title' => 'name',
'type' => 'string',
],
'Contacts' => [
'title' => 'contacts',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
],
],
],
'RuleNames' => [
'title' => 'RuleNames',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
],
],
],
],
'NotificationStrategy' => [
'title' => '通知策略',
'type' => 'object',
'properties' => [
'Name' => [
'title' => '名称',
'type' => 'string',
'required' => true,
],
'Description' => [
'title' => '描述',
'type' => 'string',
],
'Uuid' => [
'title' => 'UUID',
'type' => 'string',
],
'UserId' => [
'title' => '用户id',
'type' => 'string',
],
'CreateTime' => [
'title' => '创建时间',
'type' => 'string',
],
'UpdateTime' => [
'title' => '更新时间',
'type' => 'string',
],
'FilterSetting' => [
'title' => '过滤设置',
'type' => 'object',
'properties' => [
'WhiteList' => [
'title' => '白名单',
'type' => 'array',
'items' => [
'title' => '白名单',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Field' => [
'title' => '过滤字段',
'type' => 'string',
'required' => true,
],
'Op' => [
'title' => '过滤类型',
'type' => 'string',
'required' => true,
],
'Value' => [
'title' => '过滤数据',
'type' => 'string',
'required' => true,
],
],
],
],
'required' => false,
'maxItems' => 10,
],
'BlackList' => [
'title' => '黑名单',
'type' => 'array',
'items' => [
'title' => '黑名单',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Field' => [
'title' => '过滤字段',
'type' => 'string',
'required' => true,
],
'Op' => [
'title' => '过滤类型',
'type' => 'string',
'required' => true,
],
'Value' => [
'title' => '过滤数据',
'type' => 'string',
'required' => true,
],
],
],
],
'maxItems' => 10,
],
],
],
'GroupingSetting' => [
'title' => '合并设置',
'type' => 'object',
'properties' => [
'GroupingItems' => [
'title' => '合并项目',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => [
'title' => '合并类型',
'type' => 'string',
],
'Keys' => [
'title' => '合并keys',
'type' => 'array',
'items' => [
'type' => 'string',
],
],
],
],
'maxItems' => 10,
],
'SilenceSec' => [
'title' => '沉默秒数',
'type' => 'integer',
'format' => 'int32',
],
'PeriodMin' => [
'title' => '检查周期分钟数',
'type' => 'integer',
'format' => 'int32',
],
'Times' => [
'title' => '触发次数',
'type' => 'integer',
'format' => 'int32',
],
'EnableRawAlertDispatching' => [
'title' => '是否开启原始报警数据直接转发',
'type' => 'boolean',
],
],
],
'EscalationSetting' => [
'title' => '升级设置',
'type' => 'object',
'properties' => [
'Range' => [
'title' => '数据范围',
'type' => 'string',
'required' => false,
],
'EscalationLevel' => [
'title' => '升级最低级别',
'type' => 'string',
'required' => false,
],
'EscalationUuid' => [
'title' => '升级规则uuid',
'type' => 'string',
'required' => false,
],
'AutoResolveMin' => [
'title' => '自动恢复分钟数',
'type' => 'integer',
'format' => 'int64',
],
'RetriggerMin' => [
'title' => '重复触发报警分钟数',
'type' => 'integer',
'format' => 'int64',
],
'CustomChannels' => [
'title' => '自定义通知策略',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ChannelType' => [
'title' => '渠道类型',
'type' => 'string',
'required' => true,
],
'TemplateUuid' => [
'title' => '通知模板uuid',
'type' => 'string',
],
'Severities' => [
'title' => '严重程度列表',
'type' => 'array',
'items' => [
'type' => 'string',
'required' => false,
'example' => '严重程度',
],
],
],
],
'maxItems' => 20,
],
],
],
'PushingSetting' => [
'title' => '推送设置',
'type' => 'object',
'properties' => [
'TemplateUuid' => [
'title' => '模板uuid',
'type' => 'string',
'required' => false,
],
'Range' => [
'title' => '数据范围',
'type' => 'string',
'required' => false,
],
'TargetUuids' => [
'title' => '推送目标uuid列表',
'type' => 'array',
'items' => [
'type' => 'string',
'example' => '推送目标uuid',
],
'required' => false,
'maxItems' => 20,
],
'PushingDataFormat' => [
'title' => '推送消息格式',
'type' => 'string',
],
],
],
'RouteSetting' => [
'title' => '路由设置',
'type' => 'object',
'properties' => [
'Routes' => [
'title' => '路由分支列表',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Conditions' => [
'title' => '路由条件',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Field' => [
'title' => '字段',
'type' => 'string',
],
'Op' => [
'title' => '比较符',
'type' => 'string',
],
'Value' => [
'title' => '比较值',
'type' => 'string',
],
],
],
],
'EscalationUuid' => [
'title' => '路由通知配置',
'type' => 'string',
],
],
],
],
],
],
'Product' => [
'title' => '归属产品',
'type' => 'string',
],
],
],
'NotificationTemplate' => [
'title' => '通知模板',
'type' => 'object',
'properties' => [
'Name' => [
'title' => '名称',
'type' => 'string',
'required' => true,
],
'Description' => [
'title' => '描述',
'type' => 'string',
],
'Uuid' => [
'title' => 'UUID',
'type' => 'string',
],
'UserId' => [
'title' => '用户id',
'type' => 'string',
],
'CreateTime' => [
'title' => '创建时间',
'type' => 'string',
],
'UpdateTime' => [
'title' => '更新时间',
'type' => 'string',
],
'Type' => [
'title' => '模板类型',
'type' => 'string',
'example' => 'DATA, SMS, ONCALL, MAIL, DING, WEIXIN, FEISHU, SLACK',
],
'WraperType' => [
'title' => '封装类型',
'type' => 'string',
'example' => 'TEXT, MARKDOWN,CARD',
],
'ZhTitle' => [
'title' => '中文标题',
'type' => 'string',
'example' => '报警通知 $.alertName',
],
'EnTitle' => [
'title' => '英文标题',
'type' => 'string',
'example' => 'Alarm $.alertName',
],
'ZhContent' => [
'title' => '中文内容',
'type' => 'string',
'example' => '报警 $.alertName',
],
'EnContent' => [
'title' => '英文内容',
'type' => 'string',
'example' => 'Alarm $.alertName',
],
'ZhItemContent' => [
'title' => '中文单条关联报警模板格式',
'type' => 'string',
'example' => '报警 $.alertName',
],
'EnItemContent' => [
'title' => '英文关联报警模板格式',
'type' => 'string',
'example' => 'Alarm $.alertName',
],
],
],
'PushingTarget' => [
'title' => 'PushingTarget',
'type' => 'object',
'properties' => [
'Type' => [
'title' => '渠道类型',
'type' => 'string',
],
'Description' => [
'title' => '描述',
'type' => 'string',
],
'Uuid' => [
'title' => 'UUID',
'type' => 'string',
],
'UserId' => [
'title' => '用户id',
'type' => 'string',
'required' => false,
],
'CreateTime' => [
'title' => '创建时间',
'type' => 'string',
],
'UpdateTime' => [
'title' => '更新时间',
'type' => 'string',
],
'TemplateUuid' => [
'title' => 'template Uuid',
'type' => 'string',
],
'HttpRequestTarget' => [
'title' => 'http请求设置',
'type' => 'object',
'properties' => [
'EncryptTimestampKey' => [
'type' => 'string',
],
'EncryptString' => [
'title' => '签名混淆字符串',
'type' => 'string',
],
'ContentType' => [
'title' => 'content Type',
'type' => 'string',
],
'EncryptSignatureKey' => [
'type' => 'string',
],
'Headers' => [
'title' => 'http 请求header',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Value' => [
'title' => 'value',
'type' => 'string',
],
'Key' => [
'title' => 'key',
'type' => 'string',
],
],
],
'maxItems' => 10,
],
'Method' => [
'title' => 'http方法',
'type' => 'string',
],
'Url' => [
'title' => 'url',
'type' => 'string',
],
],
],
'Range' => [
'title' => '生效范围',
'type' => 'string',
],
'Arn' => [
'title' => 'ARN',
'type' => 'string',
],
'Name' => [
'title' => '名称',
'type' => 'string',
'required' => true,
],
],
],
'Subscription' => [
'title' => '报警订阅',
'type' => 'object',
'properties' => [
'Name' => [
'title' => '名称',
'type' => 'string',
'required' => true,
],
'Description' => [
'title' => '描述',
'type' => 'string',
],
'Uuid' => [
'title' => 'UUID',
'type' => 'string',
],
'CreateTime' => [
'title' => '创建时间',
'type' => 'string',
],
'UpdateTime' => [
'title' => '更新时间',
'type' => 'string',
],
'StrategyUuid' => [
'title' => '通知策略id',
'type' => 'string',
],
'Conditions' => [
'title' => '订阅条件',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Field' => [
'title' => '字段',
'type' => 'string',
],
'Operator' => [
'title' => '比较符',
'type' => 'string',
],
'Value' => [
'title' => '值',
'type' => 'string',
],
],
],
'maxItems' => 10,
],
'Relation' => [
'title' => '条件间关系',
'type' => 'string',
],
'Enabled' => [
'title' => '是否启用',
'type' => 'boolean',
],
'Product' => [
'title' => '归属产品',
'type' => 'string',
],
],
],
],
],
'apis' => [
'CreateMonitorGroup' => [
'summary' => '调用CreateMonitorGroup接口创建应用分组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupName',
'in' => 'query',
'schema' => [
'description' => '应用分组名称。',
'type' => 'string',
'required' => true,
'example' => 'ECS_Group',
],
],
[
'name' => 'ContactGroups',
'in' => 'query',
'schema' => [
'description' => '报警联系组。应用分组的报警通知会发送给该报警联系组中的报警联系人。'."\n"
."\n"
.'> 报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见[PutContact](~~PutContact~~)和[PutContactGroup](~~PutContactGroup~~)。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Alert_Group',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '83C89BA6-ABD4-4398-A175-83E86C47A001',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '1234567',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'InvalidClientTokenId',
'errorMessage' => 'not allow this operation.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
412 => [
[
'errorCode' => 'ResourcesOverLimit',
'errorMessage' => 'Resources over limit.',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"83C89BA6-ABD4-4398-A175-83E86C47A001\\",\\n \\"GroupId\\": 1234567,\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t83C89BA6-ABD4-4398-A175-83E86C47A001\\n\\t200\\n\\ttrue\\n\\t1234567\\n\\t","errorExample":""}]',
'title' => '创建应用分组',
'description' => '本文将提供一个示例,创建应用分组`ECS_Group`。',
'requestParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyMonitorGroup' => [
'summary' => '调用ModifyMonitorGroup接口修改应用分组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '123456',
],
],
[
'name' => 'GroupName',
'in' => 'query',
'schema' => [
'description' => '应用分组名称。',
'type' => 'string',
'required' => false,
'example' => 'ecs_group',
],
],
[
'name' => 'ContactGroups',
'in' => 'query',
'schema' => [
'description' => '报警联系人组。',
'type' => 'string',
'required' => false,
'example' => 'alarm_ecs_group',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C85A2870-5DF4-4269-BC50-ECB5E4591A80',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"C85A2870-5DF4-4269-BC50-ECB5E4591A80\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '修改应用分组',
],
'DeleteMonitorGroup' => [
'summary' => '调用DeleteMonitorGroup接口删除指定的应用分组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123456',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CA35B3AE-4FFD-4A33-AE67-67EF68711EFA',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
'Group' => [
'description' => '被删除应用分组列表。',
'type' => 'object',
'properties' => [
'GroupName' => [
'description' => '应用分组名称。',
'type' => 'string',
'example' => 'ECS_test',
],
'ContactGroups' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactGroup' => [
'description' => '报警联系组。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Name' => [
'description' => '报警联系组名称。',
'type' => 'string',
'example' => 'ECS_Group',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
[
'errorCode' => 'InvalidClientTokenId',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"CA35B3AE-4FFD-4A33-AE67-67EF68711EFA\\",\\n \\"Success\\": true,\\n \\"Group\\": {\\n \\"GroupName\\": \\"ECS_test\\",\\n \\"ContactGroups\\": {\\n \\"ContactGroup\\": [\\n {\\n \\"Name\\": \\"ECS_Group\\"\\n }\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t\\n\\t\\t\\tECS_test\\n\\t\\t\\t\\n\\t\\t\\t\\t\\n\\t\\t\\t\\t\\tECS_Group\\n\\t\\t\\t\\t\\n\\t\\t\\t\\n\\t\\t\\n\\t\\tEFB8C3EC-3460-4EC9-8603-A9FE9D0A6C2C\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '删除指定的应用分组',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitorGroups' => [
'summary' => '调用DescribeMonitorGroups接口查询应用分组列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'SelectContactGroups',
'in' => 'query',
'schema' => [
'description' => '返回结果中是否需要包含报警联系组。取值:'."\n"
.'- true:是。'."\n"
.'- false:否。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:30。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '30',
],
],
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '搜索关键字。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '资源实例ID。该参数用于查询指定实例所在的应用分组。',
'type' => 'string',
'required' => false,
'example' => 'i-abcdefgh12****',
],
],
[
'name' => 'GroupName',
'in' => 'query',
'schema' => [
'description' => '应用分组名称。',
'type' => 'string',
'required' => false,
'example' => 'testGroup124',
],
],
[
'name' => 'IncludeTemplateHistory',
'in' => 'query',
'schema' => [
'description' => '返回结果是否包含已应用到应用分组的报警模板历史。取值:'."\n"
.'- true:是。'."\n"
.'- false:否。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
'default' => 'true',
],
],
[
'name' => 'Type',
'in' => 'query',
'schema' => [
'description' => '应用分组类型。取值:'."\n"
.'- custom:自建的应用分组。'."\n"
.'- ehpc_cluster:从EHPC集群同步的应用分组。'."\n"
.'- kubernetes:从容器服务Kubernetes版同步的应用分组。',
'type' => 'string',
'required' => false,
'example' => 'custom',
'enum' => [
'custom',
'ehpc_cluster',
'kubernetes',
'tag',
'aone_group',
'resMgr',
'ess',
],
],
],
[
'name' => 'DynamicTagRuleId',
'in' => 'query',
'schema' => [
'description' => '智能标签规则ID。',
'type' => 'string',
'required' => false,
'example' => '6b882d9a-5117-42e2-9d0c-4749a0c6****',
],
],
[
'name' => 'GroupFounderTagKey',
'in' => 'query',
'schema' => [
'description' => '通过智能标签创建应用分组的标签键。',
'type' => 'string',
'required' => false,
'example' => 'GroupKey1',
],
],
[
'name' => 'GroupFounderTagValue',
'in' => 'query',
'schema' => [
'description' => '通过智能标签创建应用分组的标签值。',
'type' => 'string',
'required' => false,
'example' => 'GroupValue1',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。多个应用分组ID之间用半角逗号(,)分隔。',
'type' => 'string',
'required' => false,
'example' => '92****',
],
],
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '应用分组的标签。',
'type' => 'array',
'items' => [
'description' => '应用分组的标签。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '应用分组的标签键。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'tagKey1',
],
'Value' => [
'description' => '应用分组的标签值。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'tagValue1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 5,
],
],
[
'name' => 'Types',
'in' => 'query',
'schema' => [
'description' => '应用分组类型。取值:'."\n"
."\n"
.'- custom:自建的应用分组。'."\n"
.'- ehpc_cluster:从EHPC集群同步的应用分组。'."\n"
.'- kubernetes:从容器服务Kubernetes版同步的应用分组。'."\n"
.'- tag:通过标签自动创建的应用分组。'."\n"
.'- resMgr:通过资源组创建的应用分组。'."\n"
.'- ess:从弹性伸缩ESS同步的应用分组。',
'type' => 'string',
'required' => false,
'example' => 'custom',
],
],
],
'responses' => [
200 => [
'headers' => [],
'schema' => [
'description' => '返回结果。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'F02B299A-D374-4595-9F55-7534D604F132',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '分页时每页显示的数据行数。',
'type' => 'integer',
'format' => 'int32',
'example' => '30',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'Resources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '关联资源。',
'type' => 'array',
'items' => [
'description' => '关联资源。',
'type' => 'object',
'properties' => [
'Type' => [
'description' => '应用分组类型。取值:'."\n"
.'- custom:自建的应用分组。'."\n"
.'- ehpc_cluster:从EHPC集群同步的应用分组。'."\n"
.'- kubernetes:从容器服务Kubernetes版同步的应用分组。',
'type' => 'string',
'example' => 'custom',
],
'GroupFounderTagValue' => [
'description' => '通过智能标签创建应用分组的标签值。',
'type' => 'string',
'example' => 'GroupValue1',
],
'BindUrl' => [
'description' => '从容器服务Kubernetes版同步过来的URL地址。',
'type' => 'string',
'example' => 'https://aliyun.com',
],
'GroupName' => [
'description' => '应用分组名称。',
'type' => 'string',
'example' => 'test123',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '12345',
],
'ServiceId' => [
'description' => '阿里云服务ID。',
'type' => 'string',
'example' => '49****',
],
'DynamicTagRuleId' => [
'description' => '智能标签规则ID。',
'type' => 'string',
'example' => '6b882d9a-5117-42e2-9d0c-4749a0c6****',
],
'GmtCreate' => [
'description' => '创建应用分组的时间戳。单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1603181891000',
],
'GroupFounderTagKey' => [
'description' => '通过智能标签创建应用分组的标签键。',
'type' => 'string',
'example' => 'GroupKey1',
],
'GmtModified' => [
'description' => '修改应用分组的时间戳。单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1603181891000',
],
'ContactGroups' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactGroup' => [
'description' => '报警联系组。',
'type' => 'array',
'items' => [
'description' => '报警联系组',
'type' => 'object',
'properties' => [
'Name' => [
'description' => '报警联系组名称。',
'type' => 'string',
'example' => 'CloudMonitor',
],
],
],
],
],
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '应用分组绑定的标签列表。',
'type' => 'array',
'items' => [
'description' => '应用分组绑定的标签列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '应用分组的标签键。',
'type' => 'string',
'example' => 'tagKey1',
],
'Value' => [
'description' => '应用分组的标签值。',
'type' => 'string',
'example' => 'tagValue1',
],
],
],
],
],
],
'TemplateIds' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TemplateId' => [
'description' => '模板ID。',
'type' => 'array',
'items' => [
'description' => '应用分组应用过的报警模板。',
'type' => 'string',
'example' => '92****',
],
],
],
],
'ResourceGroupId' => [
'description' => '资源ID。',
'type' => 'string',
'example' => 'rg-aek2hopjh*******',
],
'TemplateInfos' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TemplateInfo' => [
'description' => '模版信息。',
'type' => 'array',
'items' => [
'description' => '模版信息。',
'type' => 'object',
'properties' => [
'EffectTime' => [
'description' => '生效时间',
'type' => 'integer',
'format' => 'int64',
'example' => '1603181891000',
],
'TemplateId' => [
'description' => '模板ID。',
'type' => 'string',
'example' => '123***',
],
'Ver' => [
'description' => '版本。',
'type' => 'string',
'example' => '0',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F02B299A-D374-4595-9F55-7534D604F132\\",\\n \\"Success\\": true,\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 30,\\n \\"Total\\": 10,\\n \\"Resources\\": {\\n \\"Resource\\": [\\n {\\n \\"Type\\": \\"custom\\",\\n \\"GroupFounderTagValue\\": \\"GroupValue1\\",\\n \\"BindUrl\\": \\"https://aliyun.com\\",\\n \\"GroupName\\": \\"test123\\",\\n \\"GroupId\\": 12345,\\n \\"ServiceId\\": \\"49****\\",\\n \\"DynamicTagRuleId\\": \\"6b882d9a-5117-42e2-9d0c-4749a0c6****\\",\\n \\"GmtCreate\\": 1603181891000,\\n \\"GroupFounderTagKey\\": \\"GroupKey1\\",\\n \\"GmtModified\\": 1603181891000,\\n \\"ContactGroups\\": {\\n \\"ContactGroup\\": [\\n {\\n \\"Name\\": \\"CloudMonitor\\"\\n }\\n ]\\n },\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"tagKey1\\",\\n \\"Value\\": \\"tagValue1\\"\\n }\\n ]\\n },\\n \\"TemplateIds\\": {\\n \\"TemplateId\\": [\\n \\"92****\\"\\n ]\\n },\\n \\"ResourceGroupId\\": \\"rg-aek2hopjh*******\\",\\n \\"TemplateInfos\\": {\\n \\"TemplateInfo\\": [\\n {\\n \\"EffectTime\\": 1603181891000,\\n \\"TemplateId\\": \\"123***\\",\\n \\"Ver\\": \\"0\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n F02B299A-D374-4595-9F55-7534D604F132\\n 30\\n 1\\n 2\\n \\n \\n testGroup124\\n \\n \\n CloudMonitor\\n \\n \\n custom\\n 1603181891000\\n 1603181891000\\n 1204\\n 001\\n \\n 92****\\n \\n \\n \\n tagKey1\\n tagValue1\\n \\n \\n 7301****\\n \\n \\n test123\\n \\n \\n CloudMonitor\\n \\n \\n tag\\n 1603181891000\\n 6b882d9a-5117-42e2-9d0c-4749a0c6****\\n 1603181891000\\n GroupKey1\\n GroupValue1\\n \\n \\n \\n \\n 92****\\n \\n \\n 200\\n true\\n","errorExample":""}]',
'title' => '查询应用分组列表',
'description' => '本文将提供一个示例,查询当前账号的应用分组列表。返回结果显示当前账号存在两个应用分组`testGroup124`和`test123`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateMonitorGroupInstances' => [
'summary' => '调用CreateMonitorGroupInstances接口添加指定资源到指定应用分组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '3607****',
],
],
[
'name' => 'Instances',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '实例列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'InstanceName' => [
'description' => '实例名称。',
'type' => 'string',
'required' => true,
'example' => 'test-instance-ecs',
],
'Category' => [
'description' => '云服务名称缩写。'."\n"
."\n"
.'关于如何获取云服务名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
'InstanceId' => [
'description' => '实例ID。',
'type' => 'string',
'required' => true,
'example' => 'i-2ze26xj5wwy12****',
],
'RegionId' => [
'description' => '实例所在地域。',
'type' => 'string',
'required' => true,
'example' => ' cn-hangzhou',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 2000,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '1BC69FEB-56CD-4555-A0E2-02536A24A946',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'InvalidClientTokenId',
'errorMessage' => 'not allow this operation.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => 'ResourcesOverLimit',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"1BC69FEB-56CD-4555-A0E2-02536A24A946\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 1BC69FEB-56CD-4555-A0E2-02536A24A946\\n true\\n 200\\n","errorExample":""}]',
'title' => '添加指定资源到指定应用分组',
'description' => '一个应用分组中,一个云服务最多添加3000个资源,单次最多添加1000个资源,应用分组中的总资源数无限制。'."\n"
."\n"
.'本文将提供一个示例,将地域`cn-hangzhou`的云服务器ECS的实例(实例ID为`i-2ze26xj5wwy12****`,实例名称为`test-instance-ecs`)添加到应用分组`3607****`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyMonitorGroupInstances' => [
'summary' => '调用ModifyMonitorGroupInstances接口修改应用分组中的资源。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => true,
'example' => '12345',
],
],
[
'name' => 'Instances',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '实例列表',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'InstanceName' => [
'description' => '实例名称。N的取值范围:1~2000。',
'type' => 'string',
'required' => true,
'example' => 'HostName',
],
'Category' => [
'description' => '资源实例所属的云产品名称或规格。目前支持的产品如下:'."\n"
."\n"
.'- ECS(包括阿里云和非阿里云主机)'."\n"
.'- RDS(云数据库RDS版)'."\n"
.'- ADS(分析型数据库)'."\n"
.'- SLB(负载均衡)'."\n"
.'- VPC(弹性IP)'."\n"
.'- APIGATEWAY(API网关)'."\n"
.'- CDN(内容分发网络)'."\n"
.'- CS(容器服务Swarm版)'."\n"
.'- DCDN(全站加速)'."\n"
.'- DDoS(DDoS防护)'."\n"
.'- EIP(弹性公网IP)'."\n"
.'- ELASTICSEARCH'."\n"
.'- EMR(E-MapReduce)'."\n"
.'- ESS(弹性伸缩)'."\n"
.'- HBASE(云数据库 HBase)'."\n"
.'- IOT_EDGE(IoT边缘计算)'."\n"
.'- K8S_POD(k8s pod)'."\n"
.'- KVSTORE_SHARDING(Redis集群版)'."\n"
.'- KVSTORE_SPLITRW(Redis读写分离版)'."\n"
.'- KVSTORE_STANDARD(Redis标准版)'."\n"
.'- MEMCACHE(云数据库Memcache)'."\n"
.'- MNS(轻量消息队列)(原 MNS)'."\n"
.'- MONGODB(MongoDB 副本实例)'."\n"
.'- MONGODB_CLUSTER(MongoDB集群版本)'."\n"
.'- MONGODB_SHARDING(MongoDB分片集群)'."\n"
.'- MQ_TOPIC(轻量消息队列(原 MNS)TOPIC)'."\n"
.'- OCS(旧版云数据库Memcache)'."\n"
.'- OPENSEARCH(开放搜索)'."\n"
.'- OSS(对象存储OSS)'."\n"
.'- POLARDB(云数据库PolarDB)'."\n"
.'- PETADATA(云数据库HybridDB for MySQL)'."\n"
.'- SHAREBANDWIDTHPACKAGES(共享带宽包)'."\n"
.'- SLS(日志服务)'."\n"
.'- VPN(VPN网关)'."\n"
.'N的取值范围:1~2000。',
'type' => 'string',
'required' => true,
'example' => 'ECS',
],
'InstanceId' => [
'description' => '资源实例ID。N的取值范围:1~2000。',
'type' => 'string',
'required' => true,
'example' => 'i-a2d5q7pm12****',
],
'RegionId' => [
'description' => '地域ID(RegionId)。N的取值范围:1~2000。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 2000,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'FEC7EDB3-9B08-4AC0-A42A-329F5D14B95A',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Parameter invalid.',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'ResourceConflict',
'errorMessage' => '%s',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => 'ResourcesOverLimit',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"FEC7EDB3-9B08-4AC0-A42A-329F5D14B95A\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 02977C39-9E74-430A-B35B-04CFBF0E7F64\\n true\\n 200\\n","errorExample":""}]',
'title' => '修改应用分组中的资源',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitorGroupInstances' => [
'summary' => '调用DescribeMonitorGroupInstances接口查询指定应用分组内包含的资源列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123****',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '云产品名称缩写。N的取值范围为1~200。'."\n"
."\n"
.'> 关于如何获取云产品名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => false,
'example' => 'ecs',
],
],
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '按照实例名称模糊查询。',
'type' => 'string',
'required' => false,
'example' => 'test-s1',
],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => [
'description' => '按照实例ID搜索。',
'type' => 'string',
'required' => false,
'example' => 'i-bp12g4xbl4i0brkn****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '97F2A410-9412-499C-9AD1-76EF7EC02DF2',
],
'Success' => [
'description' => '请求是否成功。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>状态码为200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'success',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '每页记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '12',
],
'Resources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '应用分组资源的描述信息。',
'type' => 'array',
'items' => [
'description' => '应用分组资源的描述信息。',
'type' => 'object',
'properties' => [
'Category' => [
'description' => '产品名称缩写。',
'type' => 'string',
'example' => 'ecs',
],
'InstanceId' => [
'description' => '实例ID,实例的唯一标识。',
'type' => 'string',
'example' => 'i-bp12g4xbl4i0brkn****',
],
'InstanceName' => [
'description' => '实例名称。',
'type' => 'string',
'example' => 'test-s1',
],
'Id' => [
'description' => '资源ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123****',
],
'RegionId' => [
'description' => '实例对应的地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"97F2A410-9412-499C-9AD1-76EF7EC02DF2\\",\\n \\"Success\\": true,\\n \\"Code\\": 200,\\n \\"Message\\": \\"success\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"Total\\": 12,\\n \\"Resources\\": {\\n \\"Resource\\": [\\n {\\n \\"Category\\": \\"ecs\\",\\n \\"InstanceId\\": \\"i-bp12g4xbl4i0brkn****\\",\\n \\"InstanceName\\": \\"test-s1\\",\\n \\"Id\\": 0,\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"1\\n30\\n7670220A-0725-42EE-9252-8200C4F810D9\\ntrue\\n200\\n1\\n\\n \\n ECS\\n i-2ze3w55tr2rcpejp****\\n cn-beijing\\n dynamic_group_1\\n \\n","errorExample":""}]',
'title' => '查询指定应用分组内包含的资源列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitorGroupDynamicRules' => [
'summary' => '调用DescribeMonitorGroupDynamicRules接口查询指定应用分组的动态规则列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => true,
'example' => '123456',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '2170B94A-1576-4D65-900E-2093037CDAF3',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resource' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '关联资源。',
'type' => 'array',
'items' => [
'description' => '关联资源。',
'type' => 'object',
'properties' => [
'Category' => [
'description' => '动态规则对应的云服务类型。取值:'."\n"
."\n"
.'- ecs:云服务器。'."\n"
."\n"
.'- rds:关系型数据库。'."\n"
."\n"
.'- slb:负载均衡。',
'type' => 'string',
'example' => 'ecs',
],
'FilterRelation' => [
'description' => '筛选条件。取值:'."\n"
."\n"
.'- and:应用分组中满足所有报警规则的实例。'."\n"
."\n"
.'- or:应用分组中满足任意报警规则的实例。',
'type' => 'string',
'example' => 'and',
],
'Filters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Filter' => [
'description' => '应用分组的动态规则。',
'type' => 'array',
'items' => [
'description' => '应用分组的动态规则。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '动态规则值。',
'type' => 'string',
'example' => '1',
],
'Function' => [
'description' => '计算方法。取值:'."\n"
."\n"
.'- contains:包含。'."\n"
."\n"
.'- startWith:前缀。'."\n"
."\n"
.'- endWith:后缀。',
'type' => 'string',
'example' => 'contains',
],
'Name' => [
'description' => '实例名称。',
'type' => 'string',
'example' => 'hostName',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"2170B94A-1576-4D65-900E-2093037CDAF3\\",\\n \\"Success\\": true,\\n \\"Resource\\": {\\n \\"Resource\\": [\\n {\\n \\"Category\\": \\"ecs\\",\\n \\"FilterRelation\\": \\"and\\",\\n \\"Filters\\": {\\n \\"Filter\\": [\\n {\\n \\"Value\\": \\"1\\",\\n \\"Function\\": \\"contains\\",\\n \\"Name\\": \\"hostName\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t38D0A8B4-7231-4E3E-A39F-D8CE3E242AC7\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tand\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tcontains\\r\\n\\t\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t\\thostName\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tecs\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询指定应用分组的动态规则列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitorGroupInstanceAttribute' => [
'summary' => '调用DescribeMonitorGroupInstanceAttribute接口查询应用分组的资源详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123456',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页页码。'."\n"
."\n"
.'取值范围:1~1000000000。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。'."\n"
."\n"
.'取值范围:1~1000000000。'."\n"
."\n"
.'默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'Total',
'in' => 'query',
'schema' => [
'description' => '是否返回指定应用分组内的资源总数。取值:'."\n"
."\n"
.'- true(默认值):返回。'."\n"
."\n"
.'- false:不返回。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '云服务名称缩写。'."\n"
."\n"
.'关于如何获取云服务名称缩写,请参见[DescribeProjectMeta](~~2513265~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => false,
'example' => 'ecs',
],
],
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '资源的搜索关键字。',
'type' => 'string',
'required' => false,
'example' => 'portal',
],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => [
'description' => '资源ID。多个资源ID之间用半角逗号(,)分隔,最多支持20个资源。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'i-m5e0k0bexac8tykr****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9FB8EA79-7279-4482-8D6D-3D28EEDD871A',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '总页数。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '12',
],
'Resources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '应用分组关联的资源。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'InstanceName' => [
'description' => '实例名称。',
'type' => 'string',
'example' => 'hostName',
],
'Dimension' => [
'description' => '应用分组关联资源的维度信息。',
'type' => 'string',
'example' => '{"instanceId":"i-m5e0k0bexac8tykr****"}',
],
'Category' => [
'description' => '云产品名称。',
'type' => 'string',
'example' => 'ecs',
],
'InstanceId' => [
'description' => '实例ID。',
'type' => 'string',
'example' => 'i-m5e0k0bexac8tykr****',
],
'NetworkType' => [
'description' => '网络类型。',
'type' => 'string',
'example' => 'vpc',
],
'Desc' => [
'description' => '资源描述信息。',
'type' => 'string',
'example' => 'desc_test',
],
'Tags' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tag' => [
'description' => '资源的标签。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Key' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'instanceNetworkType',
],
'Value' => [
'description' => '标签值。',
'type' => 'string',
'example' => 'VPC',
],
],
],
],
],
],
'Region' => [
'description' => '地域。',
'type' => 'object',
'properties' => [
'AvailabilityZone' => [
'description' => '可用区。',
'type' => 'string',
'example' => 'cn-hangzhou-f',
],
'RegionId' => [
'description' => '地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
],
],
'Vpc' => [
'description' => 'VPC实例的描述信息。',
'type' => 'object',
'properties' => [
'VswitchInstanceId' => [
'description' => 'Vswitch实例ID。',
'type' => 'string',
'example' => 'vsw-2ze36seq79n992****',
],
'VpcInstanceId' => [
'description' => 'VPC实例ID。',
'type' => 'string',
'example' => 'vpc-2zew7etgiceg21****',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"9FB8EA79-7279-4482-8D6D-3D28EEDD871A\\",\\n \\"Success\\": true,\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 2,\\n \\"Total\\": 12,\\n \\"Resources\\": {\\n \\"Resource\\": [\\n {\\n \\"InstanceName\\": \\"hostName\\",\\n \\"Dimension\\": \\"{\\\\\\"instanceId\\\\\\":\\\\\\"i-m5e0k0bexac8tykr****\\\\\\"}\\",\\n \\"Category\\": \\"ecs\\",\\n \\"InstanceId\\": \\"i-m5e0k0bexac8tykr****\\",\\n \\"NetworkType\\": \\"vpc\\",\\n \\"Desc\\": \\"desc_test\\",\\n \\"Tags\\": {\\n \\"Tag\\": [\\n {\\n \\"Key\\": \\"instanceNetworkType\\",\\n \\"Value\\": \\"VPC\\"\\n }\\n ]\\n },\\n \\"Region\\": {\\n \\"AvailabilityZone\\": \\"cn-hangzhou-f\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n },\\n \\"Vpc\\": {\\n \\"VswitchInstanceId\\": \\"vsw-2ze36seq79n992****\\",\\n \\"VpcInstanceId\\": \\"vpc-2zew7etgiceg21****\\"\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t1\\r\\n\\t30\\r\\n\\t7DB8DA3D-EDA6-46F8-9222-70C52416AE7D\\r\\n\\ttrue\\r\\n\\t200\\r\\n\\t1\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tvsw-2ze36seq79n992****\\r\\n\\t\\t\\t\\tvpc-2zew7etgiceg21****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t12345\\r\\n\\t\\t\\t\\t\\taliUid\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t26842\\r\\n\\t\\t\\t\\t\\tbid\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tVPC\\r\\n\\t\\t\\tRDS\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tcn-hangzhou\\r\\n\\t\\t\\t\\tcn-hangzhou-MAZ8(f,g)\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t127067667954****\\r\\n\\t\\t\\ti-m5e0k0bexac8tykr****\\r\\n\\t\\t\\t{\\\\\\"userId\\\\\\":\\\\\\"127067667954****\\\\\\",\\\\\\"instanceId\\\\\\":\\\\\\"rm-bp179a8xfaz4i****\\\\\\"}\\r\\n\\t\\t\\ttest_name\\r\\n\\t\\t\\ttest_name\\r\\n\\t\\t\\r\\n\\t\\r\\n","errorExample":""}]',
'title' => '查询应用分组的资源详情',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteMonitorGroupDynamicRule' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'systemTags' => [
'operationType' => 'delete',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => true,
'example' => '123456',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '动态规则对应的云产品类型,取值:ecs、rds、slb。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ecs',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '56B4516A-EB44-4C66-8854-0393B35F636B',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"56B4516A-EB44-4C66-8854-0393B35F636B\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 56B4516A-EB44-4C66-8854-0393B35F636B\\n true\\n 200\\n","errorExample":""}]',
'title' => '删除指定应用分组的动态规则',
'summary' => '调用DeleteMonitorGroupDynamicRule接口删除指定应用分组的动态规则。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteMonitorGroupInstances' => [
'summary' => '调用DeleteMonitorGroupInstances接口删除应用分组内的资源实例。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123456',
],
],
[
'name' => 'InstanceIdList',
'in' => 'query',
'schema' => [
'description' => '需要删除的实例,多个实例之间用英文逗号分隔开。一次最多能够删除20个。',
'type' => 'string',
'required' => true,
'example' => 'i-a2d5q7pm3f912****,i-a2d5q7pm3f222****',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '云产品名称缩写。'."\n"
."\n"
.'> 关于如何获取云产品名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '5351B0F2-26A9-4BC9-87FF-1B74034D12C3',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:表示成功。'."\n"
.'- false:表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"5351B0F2-26A9-4BC9-87FF-1B74034D12C3\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n C5C6924C-237E-40B2-9510-41BF8F671102\\n true\\n 200\\n","errorExample":""}]',
'title' => '删除应用分组内的资源实例',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitorGroupCategories' => [
'summary' => '调用DescribeMonitorGroupCategories接口查询指定应用分组的资源列表和每个云服务的资源数量。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123456',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9E0347B0-EBC3-4769-A78D-D96F21C6BB52',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'MonitorGroupCategories' => [
'description' => '应用分组中资源的云服务类型。',
'type' => 'object',
'properties' => [
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123456',
],
'MonitorGroupCategory' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'CategoryItem' => [
'description' => '应用分组的云服务类型。',
'type' => 'array',
'items' => [
'description' => '应用分组的云服务类型。',
'type' => 'object',
'properties' => [
'Count' => [
'description' => '云服务的资源数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Category' => [
'description' => '云产品名称缩写。'."\n"
."\n"
.'> 关于如何获取云产品名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'example' => 'ecs',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"9E0347B0-EBC3-4769-A78D-D96F21C6BB52\\",\\n \\"Success\\": true,\\n \\"MonitorGroupCategories\\": {\\n \\"GroupId\\": 123456,\\n \\"MonitorGroupCategory\\": {\\n \\"CategoryItem\\": [\\n {\\n \\"Count\\": 1,\\n \\"Category\\": \\"ecs\\"\\n }\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tB7C9F725-E743-4F2E-81A2-4CC19783DC42\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tECS\\r\\n\\t\\t\\t\\t39\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t123456\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询指定应用分组的资源列表和每个云服务的资源数量',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutMonitorGroupDynamicRule' => [
'summary' => '调用PutMonitorGroupDynamicRule接口创建或修改按照实例名称动态匹配的应用分组,满足匹配规则的所有实例自动添加到该应用分组中。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => true,
'example' => '123456',
],
],
[
'name' => 'GroupRules',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'FilterRelation' => [
'description' => '动态报警规则的组合条件。N的取值范围:1~3。取值:'."\n"
."\n"
.'- and:满足所有报警规则的实例才会自动添加到应用分组。'."\n"
."\n"
.'- or:满足任意报警规则的实例都会自动添加到应用分组。',
'type' => 'string',
'required' => true,
'example' => 'and',
],
'Filters' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '满足报警条件的值。N的取值范围:1~3。',
'type' => 'string',
'required' => true,
'example' => 'nginx',
],
'Name' => [
'description' => '实例匹配的字段名称。N的取值范围:1~3。'."\n"
."\n"
.'目前仅支持主机名,例如:hostName。',
'type' => 'string',
'required' => true,
'example' => 'hostName',
],
'Function' => [
'description' => '实例的过滤条件。N的取值范围:1~3。取值:'."\n"
.'- contains:包含。'."\n"
.'- notContains:不包含。'."\n"
.'- startWith:前缀。'."\n"
.'- endWith:后缀。',
'type' => 'string',
'required' => true,
'example' => 'contains',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 10,
],
'Category' => [
'description' => '动态报警规则的云服务类型。N的取值范围:1~3。取值:'."\n"
."\n"
.'- ecs:云服务器ECS。'."\n"
."\n"
.'- rds:关系型数据库。'."\n"
."\n"
.'- slb:负载均衡。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 50,
],
],
[
'name' => 'IsAsync',
'in' => 'query',
'schema' => [
'description' => '创建动态报警规则的模式。取值:'."\n"
."\n"
.'- true:异步创建。'."\n"
.'- false(默认值):同步创建。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3E73F1AB-D195-438A-BCA7-2F4355789C58',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => 'OverLimit',
'errorMessage' => 'Matched instances count was over limit',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"3E73F1AB-D195-438A-BCA7-2F4355789C58\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t3E73F1AB-D195-438A-BCA7-2F4355789C58\\n\\ttrue\\n\\t200\\n\\t","errorExample":""}]',
'title' => '创建或修改按照实例名称动态匹配的应用分组',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateGroupMonitoringAgentProcess' => [
'summary' => '调用CreateGroupMonitoringAgentProcess接口创建组进程监控。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。'."\n",
'type' => 'string',
'required' => true,
'example' => '3607****',
],
],
[
'name' => 'ProcessName',
'in' => 'query',
'schema' => [
'description' => '进程名称。',
'type' => 'string',
'required' => true,
'example' => 'Process_Java',
],
],
[
'name' => 'MatchExpressFilterRelation',
'in' => 'query',
'schema' => [
'description' => '匹配实例的条件。取值:'."\n"
."\n"
.'- all:全部。'."\n"
.'- and:与。'."\n"
.'- or:或。',
'type' => 'string',
'required' => false,
'example' => 'and',
],
],
[
'name' => 'MatchExpress',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '匹配条件表达式列表。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'array',
'items' => [
'description' => '匹配条件表达式列表。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '匹配实例名称。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'string',
'required' => false,
'example' => 'portalHost',
],
'Name' => [
'description' => '匹配条件的类型。'."\n"
."\n"
.'N的取值范围:1~3。'."\n"
."\n"
.'>目前仅支持Name,即实例名称。',
'type' => 'string',
'required' => false,
'example' => 'name1',
],
'Function' => [
'description' => '匹配条件。取值:'."\n"
.'- all(默认值):全部。'."\n"
.'- startWith:前缀。'."\n"
.'- endWith:后缀。'."\n"
.'- contains:包含。'."\n"
.'- notContains:不包含。'."\n"
.'- equals:相等。'."\n"
."\n"
.'N的取值范围:1~3。'."\n",
'type' => 'string',
'required' => false,
'example' => 'startWith',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 3,
],
],
[
'name' => 'AlertConfig',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '报警规则配置列表。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'array',
'items' => [
'description' => '报警规则配置列表。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'object',
'properties' => [
'SilenceTime' => [
'description' => '通道沉默周期。单位:秒。最小值:3600秒(1小时),默认值:86400秒(1天)。'."\n"
."\n"
.'N的取值范围:1~3。'."\n"
."\n"
.'>当监控数据持续超过报警规则阈值时,每个沉默周期内只发送一次报警通知。',
'type' => 'string',
'required' => false,
'example' => '86400',
'default' => '86400',
],
'ComparisonOperator' => [
'description' => '阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'string',
'required' => true,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Webhook' => [
'description' => '报警回调URL地址。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com',
],
'Times' => [
'description' => '报警级别连续出现次数。默认:3次。'."\n"
."\n"
.'N的取值范围:1~3。'."\n"
."\n"
.'>只有当报警级别连续出现设定的次数且达到报警阈值才会触发报警。',
'type' => 'string',
'required' => true,
'example' => '3',
],
'EscalationsLevel' => [
'description' => '报警级别。取值:'."\n"
.'- critical(默认值):故障。'."\n"
.'- warn:警告。'."\n"
.'- info:信息。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'string',
'required' => true,
'example' => 'warn',
],
'EffectiveInterval' => [
'description' => '报警规则的生效时间段。'."\n"
."\n"
.'N的取值范围:1~3。',
'type' => 'string',
'required' => false,
'example' => '07:00-22:59',
],
'NoEffectiveInterval' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'required' => false,
'example' => '00:00-05:30',
],
'Threshold' => [
'description' => '报警阈值。'."\n"
."\n"
.'N的取值范围:1~3。'."\n"
."\n"
.'单位:个。',
'type' => 'string',
'required' => true,
'example' => '5',
],
'Statistics' => [
'description' => '报警统计方式。'."\n"
."\n"
.'N的取值范围:1~3。'."\n"
."\n"
.'>目前仅支持Average。',
'type' => 'string',
'required' => true,
'example' => 'Average',
],
'TargetList' => [
'description' => '报警触发列表。',
'type' => 'array',
'items' => [
'description' => '报警触发列表。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。'."\n"
."\n"
.'关于如何获取报警触发目标ID,请参见[DescribeMetricRuleTargets](~~121592~~)。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'Arn' => [
'description' => '资源ARN。'."\n"
."\n"
.'关于如何获取资源ARN,请参见[DescribeMetricRuleTargets](~~121592~~)。'."\n"
."\n"
.'资源ARN的格式为`acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message`。例如:`acs:mns:cn-hangzhou:120886317861****:/queues/test123/message`。参数说明如下:'."\n"
."\n"
.'- {云产品缩写}:目前仅支持轻量消息队列(原 MNS)。'."\n"
."\n"
.'- {userId}:阿里云账号ID。'."\n"
."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
."\n"
.'- {资源类型}:接收报警的资源类型。取值:'."\n"
.' '."\n"
.' - **queues**:队列。'."\n"
.' - **topics**:主题。'."\n"
."\n"
.'- {资源名称}:资源名称。'."\n"
."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。'."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。',
'type' => 'string',
'required' => false,
'example' => 'acs:mns:cn-hangzhou:120886317861****:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'required' => false,
'example' => '["INFO", "WARN", "CRITICAL"]',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'required' => false,
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
'required' => false,
],
'required' => false,
],
],
'required' => false,
],
'required' => true,
'maxItems' => 3,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '718FEA81-64C3-4F23-8F90-0531F7489FC1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resource' => [
'description' => '组进程信息。',
'type' => 'object',
'properties' => [
'GroupProcessId' => [
'description' => '组进程ID。',
'type' => 'string',
'example' => '7F2B0024-4F21-48B9-A764-211CEC48****',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"718FEA81-64C3-4F23-8F90-0531F7489FC1\\",\\n \\"Success\\": true,\\n \\"Resource\\": {\\n \\"GroupProcessId\\": \\"7F2B0024-4F21-48B9-A764-211CEC48****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n 718FEA81-64C3-4F23-8F90-0531F7489FC1\\n true\\n \\n 7F2B0024-4F21-48B9-A764-211CEC48****\\n \\n","errorExample":""}]',
'title' => '创建组进程监控',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyGroupMonitoringAgentProcess' => [
'summary' => '调用ModifyGroupMonitoringAgentProcess接口修改应用分组内的进程监控。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'schema' => [
'description' => '应用分组内的进程监控任务ID。',
'type' => 'string',
'required' => true,
'example' => '92E3065F-0980-4E31-9AA0-BA6****',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => true,
'example' => '6780****',
],
],
[
'name' => 'MatchExpressFilterRelation',
'in' => 'query',
'schema' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'required' => false,
'example' => 'and',
],
],
[
'name' => 'AlertConfig',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '报警规则配置列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SilenceTime' => [
'description' => '通道沉默周期。N的取值范围:1~200。'."\n"
."\n"
.'单位:秒。最小值:3600秒(1小时),默认值:86400秒(1天)。'."\n"
.'>当监控数据持续超过报警规则阈值时,每个沉默周期内只发送一次报警通知。',
'type' => 'string',
'required' => false,
'example' => '86400',
],
'ComparisonOperator' => [
'description' => 'Critical级别阈值比较符。N的取值范围:1~200。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'required' => true,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Webhook' => [
'description' => '报警发生时回调指定的URL地址,向URL发送POST请求。N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => 'http://www.aliyun.com',
],
'Times' => [
'description' => '报警级别连续出现次数。N的取值范围:1~200。默认值:3。'."\n"
."\n"
.'>只有当报警级别连续出现设定的次数且达到报警阈值时,才会触发报警。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => '3',
],
'EscalationsLevel' => [
'description' => '报警的级别。N的取值范围:1~200。取值:'."\n"
.'- critical(默认值):故障。'."\n"
.'- warn:警告。'."\n"
.'- info:信息。',
'type' => 'string',
'required' => true,
'example' => 'warn',
],
'EffectiveInterval' => [
'description' => '报警规则的生效时间段。N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => '00:00-22:59',
],
'NoEffectiveInterval' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'required' => false,
'example' => '00:00-05:30',
],
'Threshold' => [
'description' => '报警阈值。N的取值范围:1~200。',
'type' => 'string',
'required' => true,
'example' => '5',
],
'Statistics' => [
'description' => '报警统计方式。N的取值范围:1~200。'."\n"
."\n"
.'>目前仅支持Average。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'TargetList' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。'."\n"
."\n"
.'关于如何获取报警触发目标ID,请参见[DescribeMetricRuleTargets](~~121592~~)。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'Arn' => [
'description' => '资源ARN。'."\n"
."\n"
.'关于如何获取资源ARN,请参见[DescribeMetricRuleTargets](~~121592~~)。'."\n"
."\n"
.'资源ARN的格式为`acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message`。例如:`acs:mns:cn-hangzhou:120886317861****:/queues/test123/message`。参数说明如下:'."\n"
."\n"
.'- {云产品缩写}:目前仅支持轻量消息队列(原 MNS)。'."\n"
."\n"
.'- {userId}:阿里云账号ID。'."\n"
."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
."\n"
.'- {资源类型}:接收报警的资源类型。取值:'."\n"
."\n"
.' - **queues**:队列。'."\n"
.' - **topics**:主题。'."\n"
."\n"
.'- {资源名称}:资源名称。'."\n"
."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。'."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。',
'type' => 'string',
'required' => false,
'example' => 'acs:mns:cn-hangzhou:120886317861****:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'required' => false,
'example' => '["INFO", "WARN", "CRITICAL"]',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'required' => false,
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
'required' => false,
],
'required' => false,
],
],
'required' => false,
],
'required' => true,
'maxItems' => 3,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '7985D471-3FA8-4EE9-8F4B-45C19DF3D36F',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"7985D471-3FA8-4EE9-8F4B-45C19DF3D36F\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t7985D471-3FA8-4EE9-8F4B-45C19DF3D36F\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '修改应用分组内的进程监控',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteGroupMonitoringAgentProcess' => [
'summary' => '调用DeleteGroupMonitoringAgentProcess接口删除组进程监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => true,
'example' => '123456',
],
],
[
'name' => 'Id',
'in' => 'query',
'schema' => [
'description' => '组进程ID。',
'type' => 'string',
'required' => true,
'example' => '48F83746-C817-478C-9B06-7158F56B****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3F6150F9-45C7-43F9-9578-A58B2E726C90',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"3F6150F9-45C7-43F9-9578-A58B2E726C90\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t7985D471-3FA8-4EE9-8F4B-45C19DF3D36F\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '删除组进程监控任务',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeGroupMonitoringAgentProcess' => [
'summary' => '调用DescribeGroupMonitoringAgentProcess接口获取组进程监控任务列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => true,
'example' => '12345',
],
],
[
'name' => 'ProcessName',
'in' => 'query',
'schema' => [
'description' => '进程名称。',
'type' => 'string',
'required' => false,
'example' => 'sshd',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页大小。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
'default' => '30',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回结果。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '7985D471-3FA8-4EE9-8F4B-45C19DF3D36F',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'PageNumber' => [
'description' => '分页码。默认值:1。',
'type' => 'string',
'example' => '1',
],
'PageSize' => [
'description' => '每页显示记录条数。默认值:10。',
'type' => 'string',
'example' => '10',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'string',
'example' => '28',
],
'Processes' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Process' => [
'description' => '进程任务列表。',
'type' => 'array',
'items' => [
'description' => '进程任务。',
'type' => 'object',
'properties' => [
'ProcessName' => [
'description' => '进程名称。',
'type' => 'string',
'example' => 'sshd',
],
'MatchExpressFilterRelation' => [
'description' => '匹配实例的条件。取值:'."\n"
.'- all:全部。'."\n"
.'- and:与。'."\n"
.'- or:或。',
'type' => 'string',
'example' => 'and',
],
'GroupId' => [
'description' => '应用分组的ID。',
'type' => 'string',
'example' => '12345',
],
'Id' => [
'description' => '进程任务的ID。',
'type' => 'string',
'example' => '3F6150F9-45C7-43F9-9578-A58B2E72****',
],
'MatchExpress' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MatchExpress' => [
'description' => '匹配条件。'."\n"
."\n"
.'>只有符合匹配条件的应用分组,实例才能被添加到对应的进程中。',
'type' => 'array',
'items' => [
'description' => '匹配条件。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '匹配实例名称。',
'type' => 'string',
'example' => 'portalHost',
],
'Name' => [
'description' => '匹配条件的类型。'."\n"
."\n"
.'>目前仅支持`name`,即实例名称。',
'type' => 'string',
'example' => 'name',
],
'Function' => [
'description' => '匹配条件。取值:'."\n"
.'- all(默认值):全部。'."\n"
.'- startWith:前缀。'."\n"
.'- endWith:后缀。'."\n"
.'- contains:包含。'."\n"
.'- notContains:不包含。'."\n"
.'- equals:相等。'."\n"
."\n"
.'>对于满足条件的规则,实例会添加对应的进程监控。',
'type' => 'string',
'example' => 'all',
],
],
],
],
],
],
'AlertConfig' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AlertConfig' => [
'description' => '报警规则配置信息。',
'type' => 'array',
'items' => [
'description' => '报警规则配置信息。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Critical级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'SilenceTime' => [
'description' => '通道沉默周期。单位:秒。最短:3600秒(1小时),默认值:86400秒(1天)。'."\n"
.'>当监控数据持续超过报警规则阈值时,每个沉默周期内只发送一次报警通知。',
'type' => 'string',
'example' => '86400',
],
'Webhook' => [
'description' => '报警发生时回调指定的URL地址,向URL发送POST请求。',
'type' => 'string',
'example' => 'http://www.aliyun.com',
],
'Times' => [
'description' => '级别连续出现次数。'."\n"
."\n"
.'>只有当级别连续出现设定的次数且超过阈值时,才会触发报警。',
'type' => 'string',
'example' => '3',
],
'EscalationsLevel' => [
'description' => '报警的级别。取值:'."\n"
.'- critical:故障。'."\n"
.'- warn:警告。'."\n"
.'- info:信息。',
'type' => 'string',
'example' => 'warn',
],
'NoEffectiveInterval' => [
'description' => '报警规则不生效时间段。',
'type' => 'string',
'example' => '00:00-23:59',
],
'EffectiveInterval' => [
'description' => '报警规则的生效时间段。',
'type' => 'string',
'example' => '00:00-23:59',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '5',
],
'Statistics' => [
'description' => '报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
'TargetList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Target' => [
'description' => '报警触发目标列表。',
'type' => 'array',
'items' => [
'description' => '报警触发目标。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。',
'type' => 'string',
'example' => '123',
],
'Arn' => [
'description' => '资源ARN。格式为acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message。例如:acs:mns:cn-hangzhou:120886317861****:/queues/test123/message。参数说明如下:'."\n"
."\n"
.'- {云产品缩写}:目前仅支持轻量消息队列(原 MNS)。'."\n"
.'- {userId}:阿里云账号ID。'."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
.'- {资源类型}:接收报警的资源类型。取值: '."\n"
.' - **queues**:队列。 '."\n"
.' - **topics**:主题。 '."\n"
.'- {资源名称}:资源名称。 '."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。 '."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。',
'type' => 'string',
'example' => 'acs:mns:cn-hangzhou:120886317861****:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'example' => 'CRITICAL',
],
'JsonParmas' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7985D471-3FA8-4EE9-8F4B-45C19DF3D36F\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"PageSize\\": \\"10\\",\\n \\"Total\\": \\"28\\",\\n \\"Processes\\": {\\n \\"Process\\": [\\n {\\n \\"ProcessName\\": \\"sshd\\",\\n \\"MatchExpressFilterRelation\\": \\"and\\",\\n \\"GroupId\\": \\"12345\\",\\n \\"Id\\": \\"3F6150F9-45C7-43F9-9578-A58B2E72****\\",\\n \\"MatchExpress\\": {\\n \\"MatchExpress\\": [\\n {\\n \\"Value\\": \\"portalHost\\",\\n \\"Name\\": \\"name\\",\\n \\"Function\\": \\"all\\"\\n }\\n ]\\n },\\n \\"AlertConfig\\": {\\n \\"AlertConfig\\": [\\n {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"SilenceTime\\": \\"86400\\",\\n \\"Webhook\\": \\"http://www.aliyun.com\\",\\n \\"Times\\": \\"3\\",\\n \\"EscalationsLevel\\": \\"warn\\",\\n \\"NoEffectiveInterval\\": \\"00:00-23:59\\",\\n \\"EffectiveInterval\\": \\"00:00-23:59\\",\\n \\"Threshold\\": \\"5\\",\\n \\"Statistics\\": \\"Average\\",\\n \\"TargetList\\": {\\n \\"Target\\": [\\n {\\n \\"Id\\": \\"123\\",\\n \\"Arn\\": \\"acs:mns:cn-hangzhou:120886317861****:/queues/test/message\\",\\n \\"Level\\": \\"CRITICAL\\",\\n \\"JsonParmas\\": \\"{\\\\\\"customField1\\\\\\":\\\\\\"value1\\\\\\",\\\\\\"customField2\\\\\\":\\\\\\"$.name\\\\\\"}\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t7985D471-3FA8-4EE9-8F4B-45C19DF3D36F\\r\\n\\t\\t10\\r\\n\\t\\t1\\r\\n\\t\\t28\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tsshd\\r\\n\\t\\t\\t\\tand\\r\\n\\t\\t\\t\\t3F6150F9-45C7-43F9-9578-A58B2E72****\\r\\n\\t\\t\\t\\t12345\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tall\\r\\n\\t\\t\\t\\t\\t\\tportalHost\\r\\n\\t\\t\\t\\t\\t\\tname\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\t00:00-23:59\\r\\n\\t\\t\\t\\t\\t\\t86400\\r\\n\\t\\t\\t\\t\\t\\tGreaterThanOrEqualToThreshold\\r\\n\\t\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\t\\thttp://www.aliyun.com\\r\\n\\t\\t\\t\\t\\t\\t00:00-23:59\\r\\n\\t\\t\\t\\t\\t\\twarn\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tall\\r\\n\\t\\t\\t\\t\\t\\tportalHost\\r\\n\\t\\t\\t\\t\\t\\tname\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\t00:00-23:59\\r\\n\\t\\t\\t\\t\\t\\t86400\\r\\n\\t\\t\\t\\t\\t\\tGreaterThanOrEqualToThreshold\\r\\n\\t\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\t\\thttp://www.aliyun.com\\r\\n\\t\\t\\t\\t\\t\\t00:00-23:59\\r\\n\\t\\t\\t\\t\\t\\twarn\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n\\r\\n","errorExample":""}]',
'title' => '获取组进程监控任务列表',
'description' => '组进程监控用于为组内的所有ECS实例或满足条件的ECS实例同时添加一个进程监控并设置报警规则。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateMonitorGroupNotifyPolicy' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'systemTags' => [
'operationType' => 'create',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PolicyType',
'in' => 'query',
'schema' => [
'description' => '暂停通知类型。目前仅支持PauseNotify。',
'type' => 'string',
'required' => true,
'example' => 'PauseNotify',
'enum' => [
'PauseNotify',
],
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => true,
'example' => '7301****',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '暂停通知的开始时间戳。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '1622949300000',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '暂停通知的结束时间戳。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '1623208500000',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '13356BCA-3EC3-4748-A771-2064DA69AEF1',
],
'Result' => [
'description' => '返回创建的结果数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error. ',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"13356BCA-3EC3-4748-A771-2064DA69AEF1\\",\\n \\"Result\\": 1,\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t13356BCA-3EC3-4748-A771-2064DA69AEF1\\n\\t\\t1\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '为应用分组创建暂停报警通知策略',
'summary' => '调用CreateMonitorGroupNotifyPolicy接口为应用分组创建暂停报警通知策略。',
'description' => '在策略的生效期间内,应用分组内发生的所有报警都不再发送通知。'."\n"
.' '."\n"
.'本文将提供一个示例,为应用分组`7301****`创建暂停报警通知策略`PauseNotify`,该应用分组将在`1622949300000`至`1623208500000`(北京时间`2021-06-06 11:15:00`至`2021-06-09 11:15:00`)期间暂停报警。 ',
'requestParamsDescription' => ' ',
'responseParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'extraInfo' => ' ',
],
'DeleteMonitorGroupNotifyPolicy' => [
'summary' => '调用DeleteMonitorGroupNotifyPolicy接口删除暂停指定应用分组报警通知策略。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PolicyType',
'in' => 'query',
'schema' => [
'description' => '暂停通知类型。'."\n"
."\n"
.'目前仅支持PauseNotify。',
'type' => 'string',
'required' => true,
'example' => 'PauseNotify',
'enum' => [
'PauseNotify',
],
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '6780****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'B7AF834D-D38B-4A46-920B-FE974EB7E135',
],
'Result' => [
'description' => '影响行数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error. ',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"B7AF834D-D38B-4A46-920B-FE974EB7E135\\",\\n \\"Result\\": 1,\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 1\\n true\\n 200\\n","errorExample":""}]',
'title' => '删除暂停指定应用分组报警通知策略',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitorGroupNotifyPolicyList' => [
'summary' => '调用DescribeMonitorGroupNotifyPolicyList接口查询应用分组的报警通知暂停策略列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PolicyType',
'in' => 'query',
'schema' => [
'description' => '暂停通知类型。'."\n"
."\n"
.'目前仅支持PauseNotify。',
'type' => 'string',
'required' => true,
'example' => 'PauseNotify',
'enum' => [
'PauseNotify',
],
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页记录条数。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '100',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '6780****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '6072F026-C441-41A6-B114-35A1E8F8FDD3',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '11',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'NotifyPolicyList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'NotifyPolicy' => [
'description' => '暂停通知列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'EndTime' => [
'description' => '结束时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1551761781273',
],
'Type' => [
'description' => '禁用类型。',
'type' => 'string',
'example' => 'PauseNotify',
],
'StartTime' => [
'description' => '开始时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1551761781273',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '6780****',
],
'Id' => [
'description' => '暂停通知ID。',
'type' => 'string',
'example' => '123****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error. ',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"6072F026-C441-41A6-B114-35A1E8F8FDD3\\",\\n \\"Total\\": 11,\\n \\"Success\\": \\"true\\",\\n \\"NotifyPolicyList\\": {\\n \\"NotifyPolicy\\": [\\n {\\n \\"EndTime\\": 1551761781273,\\n \\"Type\\": \\"PauseNotify\\",\\n \\"StartTime\\": 1551761781273,\\n \\"GroupId\\": \\"6780****\\",\\n \\"Id\\": \\"123****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n \\n \\n PauseNotify\\n 1551763581273\\n 123****\\n 1551761781273\\n 6780****\\n \\n \\n true\\n 200\\n 1\\n","errorExample":""}]',
'title' => '查询应用分组的报警通知暂停策略列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'AddTags' => [
'summary' => '调用AddTags接口为指定应用分组绑定标签。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Key' => [
'description' => '标签键。'."\n"
."\n"
.'N的取值范围:1~3。Key的取值范围:1~64个字符。'."\n"
."\n"
.'您可以输入新标签键,也可以使用云监控已存在的标签键。关于如何获取标签键,请参见[DescribeTagKeyList](~~2513189~~)。'."\n"
."\n"
.'> Key不能以`aliyun`和`acs:`开头,且标签键(`Tag.N.Key`)和标签值(`Tag.N.Value`)必须同时设置。',
'type' => 'string',
'required' => true,
'example' => 'key1',
],
'Value' => [
'description' => '标签值。'."\n"
."\n"
.'N的取值范围:1~3。Value的取值范围:1~64个字符。'."\n"
."\n"
.'您可以输入新标签值,也可以使用云监控已存在的标签值。关于如何获取标签值,请参见[DescribeTagValueList](~~2513188~~)。'."\n"
."\n"
.'> Value不能以`aliyun`和`acs:`开头,且标签键(`Tag.N.Key`)和标签值(`Tag.N.Value`)必须同时设置。',
'type' => 'string',
'required' => true,
'example' => 'value1',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 5,
],
],
[
'name' => 'GroupIds',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'N的取值范围:1~20。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~2513168~~)。',
'type' => 'array',
'items' => [
'description' => '应用分组id。',
'type' => 'string',
'required' => false,
'example' => '7301****',
],
'required' => true,
'example' => '7301****',
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'DAE4B115-3847-5438-8709-423627F0A3A3',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"DAE4B115-3847-5438-8709-423627F0A3A3\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tDAE4B115-3847-5438-8709-423627F0A3A3\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '为指定应用分组绑定标签',
'description' => '本文将提供一个示例,为应用分组`7301****`绑定一个标签,其中标签键为`key1`,标签值为`value1`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~315526~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateDynamicTagGroup' => [
'summary' => '调用CreateDynamicTagGroup接口通过标签自动创建应用分组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TagKey',
'in' => 'query',
'schema' => [
'description' => '资源的标签键。'."\n"
."\n"
.'关于如何查询资源的标签键,请参见[DescribeTagKeyList](~~145558~~)。',
'type' => 'string',
'required' => true,
'example' => 'ecs_instance',
],
],
[
'name' => 'ContactGroupList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警联系组。N的取值范围:1~100。应用分组的报警通知会发送给该报警联系组中的报警联系人。'."\n"
."\n"
.'报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见[PutContact](~~114923~~)和[PutContactGroup](~~114929~~)。关于如何获取报警联系组,请参见[DescribeContactGroupList](~~114922~~)。'."\n",
'type' => 'array',
'items' => [
'description' => '报警联系组。N的取值范围:1~100。应用分组的报警通知会发送给该报警联系组中的报警联系人。'."\n"
."\n"
.'报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见[PutContact](~~114923~~)和[PutContactGroup](~~114929~~)。关于如何获取报警联系组,请参见[DescribeContactGroupList](~~114922~~)。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'ECS_Group',
],
'required' => true,
'docRequired' => true,
'example' => 'ECS_Group',
'maxItems' => 10,
],
],
[
'name' => 'MatchExpress',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签生成应用分组的匹配表达式。',
'type' => 'array',
'items' => [
'description' => '标签生成应用分组的匹配表达式。N取值为1~3。',
'type' => 'object',
'properties' => [
'TagValueMatchFunction' => [
'description' => '资源标签值的匹配方法。N的取值为1。取值:'."\n"
.'- contains:包含。'."\n"
.'- startWith:前缀。'."\n"
.'- endWith:后缀。'."\n"
.'- notContains:不包含。'."\n"
.'- equals:等于。'."\n"
.'- all:全部。'."\n"
."\n"
.'> 参数`MatchExpress.N.TagValueMatchFunction`和`MatchExpress.N.TagValue`必须同时设置。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'contains',
],
'TagValue' => [
'description' => '资源标签值。N取值为1。'."\n"
."\n"
.'> 参数`MatchExpress.N.TagValueMatchFunction`和`MatchExpress.N.TagValue`必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'instance',
],
'TagName' => [
'description' => '用来创建分组的Tag的Key。如果包含此Key的资源有多个,那么会根据过滤条件,把符合的资源按相同的Key-Value,添加到相同的分组内。',
'type' => 'string',
'required' => false,
'example' => 'appname',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 3,
],
],
[
'name' => 'TagRegionId',
'in' => 'query',
'schema' => [
'description' => '标签归属的地域ID。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'EnableSubscribeEvent',
'in' => 'query',
'schema' => [
'description' => '应用分组是否开启自动订阅事件通知。当应用分组内资源发生严重和警告级别的事件时,云监控发送报警通知。取值:'."\n"
."\n"
.'- true:开启。'."\n"
."\n"
.'- false(默认值):关闭。'."\n"
."\n",
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'EnableInstallAgent',
'in' => 'query',
'schema' => [
'description' => '应用分组是否开启自动安装云监控插件。云监控自动为应用分组内的主机安装云监控插件。取值:'."\n"
."\n"
.'- true:开启。'."\n"
."\n"
.'- false(默认值):关闭。'."\n"
."\n\n",
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'MatchExpressFilterRelation',
'in' => 'query',
'schema' => [
'description' => '资源标签值的条件表达式之间的关系。取值:'."\n"
."\n"
.'- and(默认值):和。'."\n"
.'- or:或。'."\n",
'type' => 'string',
'required' => false,
'example' => 'and',
'default' => 'and',
],
],
[
'name' => 'TemplateIdList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警模板ID。'."\n"
."\n"
.'关于如何查询报警模板ID,请参见[DescribeMetricRuleTemplateList](~~114982~~)。'."\n",
'type' => 'array',
'items' => [
'description' => '报警模板ID。'."\n"
."\n"
.'关于如何查询报警模板ID,请参见[DescribeMetricRuleTemplateList](~~114982~~)。',
'type' => 'string',
'required' => false,
'example' => '70****',
],
'required' => false,
'example' => '85****',
'maxItems' => 10,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'> 200表示成功。'."\n",
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '84AC6F0B-7945-466A-AA44-99BB5A561F86',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Id' => [
'description' => '标签匹配规则ID。',
'type' => 'string',
'example' => '2534dc0a-e3e5-4ae1-a2fc-75ef166c****',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
429 => [
[
'errorCode' => 'ResourceOverLimit',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"84AC6F0B-7945-466A-AA44-99BB5A561F86\\",\\n \\"Success\\": true,\\n \\"Id\\": \\"2534dc0a-e3e5-4ae1-a2fc-75ef166c****\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t84AC6F0B-7945-466A-AA44-99BB5A561F86\\r\\n\\t2534dc0a-e3e5-4ae1-a2fc-75ef166c****\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '通过标签自动创建应用分组',
'description' => '本接口支持的云服务包括:云服务器ECS、云数据库RDS和负载均衡SLB。'."\n"
."\n"
.'本文将提供一个示例,为绑定了标签键`ecs_instance`的资源自动创建应用分组,应用分组的报警联系组为`ECS_Group`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteDynamicTagGroup' => [
'summary' => '调用DeleteDynamicTagGroup接口删除智能标签规则。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'DynamicTagRuleId',
'in' => 'query',
'schema' => [
'description' => '智能标签规则ID。'."\n"
."\n"
.'关于如何获取智能标签ID,请参见[DescribeDynamicTagRuleList](~~150126~~)。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => '6b882d9a-5117-42e2-9d0c-4749a0c6****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '08AAE67E-77B5-485B-9C79-D7C8C059150A',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"08AAE67E-77B5-485B-9C79-D7C8C059150A\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 08AAE67E-77B5-485B-9C79-D7C8C059150A\\n 200\\n true\\n","errorExample":""}]',
'title' => '删除智能标签规则',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeTagValueList' => [
'summary' => '调用DescribeTagValueList接口查询指定标签键对应的标签值列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1,默认值:1。'."\n"
."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页查询时设置的每页行数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
'default' => '100',
],
],
[
'name' => 'TagKey',
'in' => 'query',
'schema' => [
'description' => '标签键。'."\n"
."\n"
.'关于如何获取标签键,请参见[DescribeTagKeyList](~~145558~~)。',
'type' => 'string',
'required' => true,
'example' => 'tagKey1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'B04B8CF3-4489-432D-83BA-6F128E4F2295',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'TagValues' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TagValue' => [
'description' => '标签值。',
'type' => 'array',
'items' => [
'description' => '标签值。',
'type' => 'string',
'example' => 'si-65d55ff37d6c4b4ea3b3',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"B04B8CF3-4489-432D-83BA-6F128E4F2295\\",\\n \\"Success\\": true,\\n \\"TagValues\\": {\\n \\"TagValue\\": [\\n \\"si-65d55ff37d6c4b4ea3b3\\"\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询指定标签键对应的标签值列表',
],
'DescribeTagKeyList' => [
'summary' => '调用DescribeTagKeyList接口查询标签键列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
'default' => '100',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Specified parameter PageSize is not valid.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'B04B8CF3-4489-432D-83BA-6F128E5F2293',
],
'Success' => [
'description' => '用于标识本次调用是否成功',
'type' => 'boolean',
'example' => 'true',
],
'TagKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TagKey' => [
'description' => '标签键。',
'type' => 'array',
'items' => [
'description' => '标签键。',
'type' => 'string',
'example' => 't0et07752s_',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Specified parameter PageSize is not valid.\\",\\n \\"RequestId\\": \\"B04B8CF3-4489-432D-83BA-6F128E5F2293\\",\\n \\"Success\\": true,\\n \\"TagKeys\\": {\\n \\"TagKey\\": [\\n \\"t0et07752s_\\"\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询标签键列表',
],
'DescribeProductResourceTagKeyList' => [
'summary' => '调用DescribeProductResourceTagKeyList接口获取对应地域下云资源的所有标签键列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '分页游标标识。',
'type' => 'string',
'required' => false,
'example' => 'dbc2826f237e****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The request processing has failed due to some unknown error.',
],
'NextToken' => [
'description' => '下一个查询开始的token。',
'type' => 'string',
'example' => 'dbc2826f237e****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '945ACAA9-89F2-4A62-8913-076FDEDAA8DB',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'TagKeys' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TagKey' => [
'description' => '标签键。',
'type' => 'array',
'items' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'tag_******',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The request processing has failed due to some unknown error.\\",\\n \\"NextToken\\": \\"dbc2826f237e****\\",\\n \\"RequestId\\": \\"945ACAA9-89F2-4A62-8913-076FDEDAA8DB\\",\\n \\"Success\\": true,\\n \\"TagKeys\\": {\\n \\"TagKey\\": [\\n \\"tag_******\\"\\n ]\\n }\\n}","type":"json"}]',
'title' => '获取对应地域下云资源的所有标签键列表',
],
'DescribeDynamicTagRuleList' => [
'summary' => '调用DescribeDynamicTagRuleList接口查询智能标签的规则列表。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'TagRegionId',
'in' => 'query',
'schema' => [
'description' => '标签归属的地域ID。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'TagKey',
'in' => 'query',
'schema' => [
'description' => '标签键。'."\n"
."\n"
.'关于如何获取标签键,请参见[DescribeTagKeyList](~~145558~~)。',
'type' => 'string',
'required' => false,
'example' => 'tagkey1',
],
],
[
'name' => 'TagValue',
'in' => 'query',
'schema' => [
'description' => '标签值。'."\n"
."\n"
.'关于如何获取标签值,请参见[DescribeTagValueList](~~145557~~)。',
'type' => 'string',
'required' => false,
'example' => '*',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:30。',
'type' => 'string',
'required' => false,
'example' => '30',
],
],
[
'name' => 'DynamicTagRuleId',
'in' => 'query',
'schema' => [
'description' => '智能标签规则ID。',
'type' => 'string',
'required' => false,
'example' => '004155fa-15ba-466d-b61a-***********',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回结果。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '0D50523D-8D59-4A61-B58E-E2286ECFB3A9',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'PageSize' => [
'description' => '分页时每页显示的数据行数。',
'type' => 'string',
'example' => '30',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'string',
'example' => '1',
],
'Total' => [
'description' => '标签列表的条目总数。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'TagGroupList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TagGroup' => [
'description' => '应用分组的规则列表。',
'type' => 'array',
'items' => [
'description' => '应用分组的规则。',
'type' => 'object',
'properties' => [
'Status' => [
'description' => '标签同步到应用分组的状态。'."\n"
.'- `RUNNING`:进行中。'."\n"
.'- `FINISH`:已完成。',
'type' => 'string',
'example' => 'FINISH',
],
'MatchExpressFilterRelation' => [
'description' => '条件表达式之间的关系。取值:'."\n"
."\n"
.'- `and`:和。'."\n"
.'- `or`:或。'."\n"
."\n"
.'> 目前仅支持一种组合条件。',
'type' => 'string',
'example' => 'or',
],
'RegionId' => [
'description' => '资源所属的地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'TagKey' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'tagkey1',
],
'DynamicTagRuleId' => [
'description' => '标签规则ID。',
'type' => 'string',
'example' => '1536df65-a719-429d-8813-73cc40d7****',
],
'MatchExpress' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MatchExpress' => [
'description' => '标签生成应用分组的匹配表达式。',
'type' => 'array',
'items' => [
'description' => '标签生成应用分组的匹配表达式。',
'type' => 'object',
'properties' => [
'TagValue' => [
'description' => '标签值。'."\n"
."\n"
.'`TagValue`和`TagValueMatchFunction`配合使用。',
'type' => 'string',
'example' => '*',
],
'TagValueMatchFunction' => [
'description' => '标签值的匹配方法。取值:'."\n"
.'- all:全部。 '."\n"
.'- startWith:前缀。'."\n"
.'- endWith:后缀。'."\n"
.'- contains:包含。'."\n"
.'- notContains:不包含。'."\n"
.'- equals:相等。',
'type' => 'string',
'example' => 'all',
],
'TagKey' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'azone-version',
],
],
],
],
],
],
'TemplateIdList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TemplateIdList' => [
'description' => '报警模板ID列表。',
'type' => 'array',
'items' => [
'description' => '报警模板ID。',
'type' => 'string',
'example' => '71****',
],
],
],
],
'ContactGroupList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactGroupList' => [
'description' => '报警联系组列表。',
'type' => 'array',
'items' => [
'description' => '报警联系组。',
'type' => 'string',
'example' => 'CloudMonitor',
],
],
],
],
'TagValueBlacklist' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TagValueBlacklist' => [
'description' => '动态规则不处理的TagValue。当用户删除动态Tag分组的时候,分组对应的TagValue会添加到黑名单;在之后有新的资源新增此TagValue时,不会创建对应的分组。',
'type' => 'array',
'items' => [
'description' => '某个标签的值。',
'type' => 'string',
'example' => 'test、offline',
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"0D50523D-8D59-4A61-B58E-E2286ECFB3A9\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"PageSize\\": \\"30\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Total\\": 2,\\n \\"TagGroupList\\": {\\n \\"TagGroup\\": [\\n {\\n \\"Status\\": \\"FINISH\\",\\n \\"MatchExpressFilterRelation\\": \\"or\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"TagKey\\": \\"tagkey1\\",\\n \\"DynamicTagRuleId\\": \\"1536df65-a719-429d-8813-73cc40d7****\\",\\n \\"MatchExpress\\": {\\n \\"MatchExpress\\": [\\n {\\n \\"TagValue\\": \\"*\\",\\n \\"TagValueMatchFunction\\": \\"all\\",\\n \\"TagKey\\": \\"azone-version\\"\\n }\\n ]\\n },\\n \\"TemplateIdList\\": {\\n \\"TemplateIdList\\": [\\n \\"71****\\"\\n ]\\n },\\n \\"ContactGroupList\\": {\\n \\"ContactGroupList\\": [\\n \\"CloudMonitor\\"\\n ]\\n },\\n \\"TagValueBlacklist\\": {\\n \\"TagValueBlacklist\\": [\\n \\"test、offline\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t30\\r\\n\\t1\\r\\n\\t2\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tFINISH\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tCloudMonitor\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tor\\r\\n\\t\\t\\t1536df65-a719-429d-8813-73cc40d7****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t71****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\ttagkey1\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\t\\tall\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tcn-hangzhou\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tFINISH\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tCloudMonitor\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tor\\r\\n\\t\\t\\t56e8cebb-b3d7-4a91-9880-78a8c84f****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t71****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\ttagkey1\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\t\\tall\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tcn-hangzhou\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询智能标签的规则列表',
'description' => '本文将提供一个示例,查找标签键`tagkey1`的规则列表。返回结果显示,共有2条规则,规则ID分别为`1536df65-a719-429d-8813-73cc40d7****`和`56e8cebb-b3d7-4a91-9880-78a8c84f****`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'RemoveTags' => [
'summary' => '调用RemoveTags接口删除标签。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Tag',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Key' => [
'description' => '标签键。'."\n"
.'> 标签键(`Tag.N.Key`)和标签值(`Tag.N.Value`)需要同时设置。',
'type' => 'string',
'required' => true,
'example' => 'Key1',
],
'Value' => [
'description' => '标签值。'."\n"
.'> 标签键(`Tag.N.Key`)和标签值(`Tag.N.Value`)需要同时设置。',
'type' => 'string',
'required' => true,
'example' => 'Value1',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 10,
],
],
[
'name' => 'GroupIds',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '应用分组ID。',
'type' => 'array',
'items' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '12345',
],
'required' => true,
'example' => '12345',
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Illegal parameters.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '195390D2-69D0-4D9E-81AA-A7F5BC1B91EB',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Tag' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Tags' => [
'description' => '标签列表。',
'type' => 'array',
'items' => [
'description' => '被删除的标签列表。',
'type' => 'string',
'example' => 'tag1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Illegal parameters.\\",\\n \\"RequestId\\": \\"195390D2-69D0-4D9E-81AA-A7F5BC1B91EB\\",\\n \\"Success\\": true,\\n \\"Tag\\": {\\n \\"Tags\\": [\\n \\"tag1\\"\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\tE15C718E-067E-49D0-86F7-BC7242230091\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '删除标签',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateHostAvailability' => [
'summary' => '调用CreateHostAvailability接口创建可用性监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123456',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '可用性监控任务名称。取值范围:4~100个字符,支持英文字母、数字、下划线(_)和汉字。',
'type' => 'string',
'required' => true,
'example' => 'task1',
],
],
[
'name' => 'TaskScope',
'in' => 'query',
'schema' => [
'description' => '可用性监控任务的探测范围。取值:'."\n"
."\n"
.'- GROUP:表示将当前应用分组内的所有ECS实例作为探测任务的探针。'."\n"
.'- GROUP_SPEC_INSTANCE:表示将当前应用分组内的指定ECS实例作为探测任务的探针。设置该参数时,需要同时设置InstanceList(发起探测的ECS实例列表)。',
'type' => 'string',
'required' => false,
'example' => 'GROUP',
'default' => 'GROUP',
],
],
[
'name' => 'TaskType',
'in' => 'query',
'schema' => [
'description' => '可用性监控任务的探测类型。取值:'."\n"
."\n"
.'- PING'."\n"
.'- TELNET'."\n"
.'- HTTP',
'type' => 'string',
'required' => true,
'example' => 'HTTP',
],
],
[
'name' => 'TaskOption.HttpURI',
'in' => 'query',
'schema' => [
'description' => 'HTTP、Telnet探测类型的探测URI地址。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com'."\n"
.'telnet://127.0.0.1:80',
],
],
[
'name' => 'TaskOption.TelnetOrPingHost',
'in' => 'query',
'schema' => [
'description' => '探测的域名或地址。'."\n"
.'>如果探测任务类型为PING,则需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => 'www.aliyun.com',
],
],
[
'name' => 'TaskOption.HttpResponseCharset',
'in' => 'query',
'schema' => [
'description' => 'HTTP探测类型的响应字符集。'."\n"
."\n"
.'> 仅支持UTF-8。',
'type' => 'string',
'required' => false,
'example' => 'UTF-8',
],
],
[
'name' => 'TaskOption.HttpPostContent',
'in' => 'query',
'schema' => [
'description' => 'HTTP探测类型探测请求的Post内容。',
'type' => 'string',
'required' => false,
'example' => 'params1=paramsValue1',
],
],
[
'name' => 'TaskOption.HttpResponseMatchContent',
'in' => 'query',
'schema' => [
'description' => '匹配响应的内容。',
'type' => 'string',
'required' => false,
'example' => 'ok',
],
],
[
'name' => 'TaskOption.HttpMethod',
'in' => 'query',
'schema' => [
'description' => '探测类型的方法。取值:'."\n"
."\n"
.'- GET'."\n"
.'- POST'."\n"
.'- HEAD'."\n"
."\n"
.'>如果任务的探测类型为HTTP,则需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => 'GET',
],
],
[
'name' => 'TaskOption.HttpNegative',
'in' => 'query',
'schema' => [
'description' => '匹配HTTP响应内容的报警规则。取值:'."\n"
.'- true:如果HTTP响应内容包含设置的报警规则,则报警。'."\n"
.'- false:如果HTTP响应内容不包含设置的报警规则,则报警。'."\n"
."\n"
.'>如果任务的探测类型为HTTP,则该参数生效。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'TaskOption.HttpHeader',
'in' => 'query',
'schema' => [
'description' => 'HTTP请求的Header。格式为`参数名:参数`,多个参数之间用回车符分隔,例如:'."\n"
.'```'."\n"
.'params1:value1'."\n"
.'params2:value2'."\n"
.'```',
'type' => 'string',
'required' => false,
'example' => 'token:testTokenValue',
],
],
[
'name' => 'TaskOption.Interval',
'in' => 'query',
'schema' => [
'description' => '探测频率。单位:秒。取值:15、30、60、120、300、900、1800和3600。'."\n"
."\n"
.'> 仅3.5.1及以上版本的云监控插件支持该参数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '60',
],
],
[
'name' => 'AlertConfig.NotifyType',
'in' => 'query',
'schema' => [
'description' => '报警通知类型。取值:'."\n"
."\n"
.'- 2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 1:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 0:邮件+钉钉机器人。'."\n"
."\n\n"
.'0:邮件+钉钉机器人。'."\n"
."\n"
.'0:邮件+钉钉机器人。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'example' => '0',
],
],
[
'name' => 'AlertConfig.StartTime',
'in' => 'query',
'schema' => [
'description' => '报警生效的开始时间。取值范围:0~23。'."\n"
."\n"
.'例如:`AlertConfig.StartTime`为0,`AlertConfig.EndTime`为22,表示报警生效时间为00:00:00至22:00:00。'."\n"
."\n"
.'>如果报警不在生效时间内,则超过阈值也不会发送报警通知。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '0',
],
],
[
'name' => 'AlertConfig.EndTime',
'in' => 'query',
'schema' => [
'description' => '报警生效的结束时间。取值范围:0~23。'."\n"
."\n"
.'例如:`AlertConfig.StartTime`为0,`AlertConfig.EndTime`为22,表示报警生效时间为00:00:00至22:00:00。'."\n"
."\n"
.'>如果报警不在生效时间内,则超过阈值也不会发送报警通知。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '22',
],
],
[
'name' => 'AlertConfig.SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默时间。单位:秒,默认值:86400(1天)。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '86400',
],
],
[
'name' => 'AlertConfig.WebHook',
'in' => 'query',
'schema' => [
'description' => 'URL回调地址。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com/webhook.json',
],
],
[
'name' => 'AlertConfigEscalationList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '报警的监控项。N的取值范围:1~21。取值:'."\n"
."\n"
.'- HttpStatus:HTTP状态码。'."\n"
.'- HttpLatency:HTTP等待时间。'."\n"
.'- TelnetStatus:Telnet状态码。'."\n"
.'- TelnetLatency:Telnet等待时间。'."\n"
.'- PingLostRate:Ping丢包率。',
'type' => 'string',
'required' => true,
'example' => 'HttpStatus',
],
'Value' => [
'description' => '报警阈值。N的取值范围:1~21。',
'type' => 'string',
'required' => false,
'example' => '90',
],
'Times' => [
'description' => '报警重试次数。N的取值范围:1~21。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Operator' => [
'description' => '报警规则比较符号。N的取值范围:1~21。取值:'."\n"
."\n"
.'- `>`'."\n"
.'- `>=`'."\n"
.'- `<`'."\n"
.'- `<=`'."\n"
.'- `=`',
'type' => 'string',
'required' => false,
'example' => '>',
],
'Aggregate' => [
'description' => '报警统计方法。N的取值范围:1~21。不同监控项的取值如下:'."\n"
."\n"
.'- HttpStatus:Value。'."\n"
.'- HttpLatency:Average。'."\n"
.'- TelnetStatus:Value。'."\n"
.'- TelnetLatency:Average。'."\n"
.'- PingLostRate:Average。'."\n"
."\n"
.'>状态码类的统计方法为原始值(Value),延时时间或丢包率的统计方法为平均值(Average)。',
'type' => 'string',
'required' => false,
'example' => 'Value',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 10,
],
],
[
'name' => 'InstanceList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '发起探测的ECS实例列表。N的取值范围:1~21。'."\n"
."\n"
.'> 当`TaskScope`为`GROUP_SPEC_INSTANCE`时,需要设置该参数。',
'type' => 'array',
'items' => [
'description' => '发起探测的ECS实例列表。N的取值范围:1~21。'."\n"
."\n"
.'> 当`TaskScope`为`GROUP_SPEC_INSTANCE`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'required' => false,
'example' => 'i-absdfkwl321****',
'maxItems' => 1000,
],
],
[
'name' => 'AlertConfigTargetList',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '报警触发目标。',
'type' => 'array',
'items' => [
'description' => '报警触发目标。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'Arn' => [
'description' => '资源ARN。格式为`acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message`。例如:`acs:mns:cn-hangzhou:120886317861****:/queues/test123/message`。参数说明如下:'."\n"
."\n"
.'- {云产品缩写}:目前仅支持轻量消息队列(原 MNS)。'."\n"
."\n"
.'- {userId}:阿里云账号ID。'."\n"
."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
."\n"
.'- {资源类型}`:接收报警的资源类型。取值:'."\n"
."\n"
.' - **queues**:队列。'."\n"
.' - **topics**:主题。'."\n"
."\n"
.'- {资源名称}:资源名称。'."\n"
."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。'."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。',
'type' => 'string',
'required' => false,
'example' => 'acs:mns:cn-hangzhou:120886317861****:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'required' => false,
'example' => '["INFO", "WARN", "CRITICAL"]',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'required' => false,
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'ACBDBB40-DFB6-4F4C-8957-51FFB233969C',
],
'TaskId' => [
'description' => '可用性监控任务ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '12345',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Parameter invalid.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
412 => [
[
'errorCode' => 'ResouceOverLimit',
'errorMessage' => 'The task over limit',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"ACBDBB40-DFB6-4F4C-8957-51FFB233969C\\",\\n \\"TaskId\\": 12345,\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t12345\\n\\tCDA78493-F10F-485F-98AD-B4C0B40AB225\\n\\t200\\n\\ttrue\\n","errorExample":""}]',
'title' => '创建可用性监控任务',
'description' => '本文将提供一个示例,在应用分组`123456`中创建探测类型为`HTTP`的可用性监控任务`task1`,通过邮件和钉钉机器人给您发送报警。'."\n"
."\n",
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteHostAvailability' => [
'summary' => '调用DeleteHostAvailability接口删除可用性监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '任务id。',
'type' => 'array',
'items' => [
'description' => '任务id。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '12456',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '57C782E6-B235-4842-AD2B-DB94961761EB',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"57C782E6-B235-4842-AD2B-DB94961761EB\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '删除可用性监控任务',
],
'EnableHostAvailability' => [
'summary' => '调用EnableHostAvailability接口启用指定可用性监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '可用性监控任务ID。',
'type' => 'array',
'items' => [
'description' => '可用性监控任务ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '123456',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'User not authorized to operate on the specified resource.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'ACBDBB40-DFB6-4F4C-8957-51FFB233969C',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"User not authorized to operate on the specified resource.\\",\\n \\"RequestId\\": \\"ACBDBB40-DFB6-4F4C-8957-51FFB233969C\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '启用指定可用性监控任务',
],
'DisableHostAvailability' => [
'summary' => '调用DisableHostAvailability接口禁用指定可用性监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '可用性监控任务ID。',
'type' => 'array',
'items' => [
'description' => '可用性监控任务ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '12345',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'User not authorized to operate on the specified resource.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'ACBDBB40-DFB6-4F4C-8957-51FFB233969C',
],
'Success' => [
'description' => '操作是否成功。取值:-true:成功。-false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"User not authorized to operate on the specified resource.\\",\\n \\"RequestId\\": \\"ACBDBB40-DFB6-4F4C-8957-51FFB233969C\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '禁用指定可用性监控任务',
],
'ModifyHostAvailability' => [
'summary' => '调用ModifyHostAvailability接口修改可用性监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123456',
],
],
[
'name' => 'Id',
'in' => 'query',
'schema' => [
'description' => '可用性监控任务ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '12345',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '可用性监控任务名称。',
'type' => 'string',
'required' => true,
'example' => 'task2',
],
],
[
'name' => 'TaskScope',
'in' => 'query',
'schema' => [
'description' => '可用性监控任务的探测范围。取值:'."\n"
."\n"
.'- GROUP:表示将当前应用分组内的所有ECS实例作为探测任务的探针。'."\n"
.'- GROUP_SPEC_INSTANCE:表示将当前应用分组内的指定ECS实例作为探测任务的探针。设置该参数时,需要同时设置InstanceList(发起探测的ECS实例列表)。',
'type' => 'string',
'required' => false,
'example' => 'GROUP',
'default' => 'GROUP',
],
],
[
'name' => 'TaskOption.HttpURI',
'in' => 'query',
'schema' => [
'description' => 'HTTP、Telnet探测类型的探测URI地址。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com'."\n"
.'telnet://127.0.0.1:80',
],
],
[
'name' => 'TaskOption.TelnetOrPingHost',
'in' => 'query',
'schema' => [
'description' => '探测的域名或地址。'."\n"
."\n"
.'>如果探测任务类型为PING,则需要设置该参数。关于探测任务类型的设置方法,请参见[CreateHostAvailability](~~115317~~)。',
'type' => 'string',
'required' => false,
'example' => 'www.aliyun.com',
],
],
[
'name' => 'TaskOption.HttpResponseCharset',
'in' => 'query',
'schema' => [
'description' => 'HTTP探测类型的响应字符集。'."\n"
."\n"
.'> 仅支持UTF-8。',
'type' => 'string',
'required' => false,
'example' => 'UTF-8',
],
],
[
'name' => 'TaskOption.HttpPostContent',
'in' => 'query',
'schema' => [
'description' => 'HTTP探测类型探测请求的Post内容。',
'type' => 'string',
'required' => false,
'example' => 'params1=value1',
],
],
[
'name' => 'TaskOption.HttpResponseMatchContent',
'in' => 'query',
'schema' => [
'description' => 'HTTP探测类型探测响应的Post内容。',
'type' => 'string',
'required' => false,
'example' => 'ok',
],
],
[
'name' => 'TaskOption.HttpMethod',
'in' => 'query',
'schema' => [
'description' => '探测类型的方法。取值:'."\n"
."\n"
.'- GET'."\n"
.'- POST'."\n"
.'- HEAD'."\n"
."\n"
.'>如果探测任务类型为HTTP,则需要设置该参数。关于探测任务类型的设置方法,请参见[CreateHostAvailability](~~115317~~)。',
'type' => 'string',
'required' => false,
'example' => 'GET',
],
],
[
'name' => 'TaskOption.HttpNegative',
'in' => 'query',
'schema' => [
'description' => '匹配HTTP响应内容的报警规则。取值:'."\n"
.'- true:如果HTTP响应内容包含设置的报警规则,则报警。'."\n"
.'- false:如果HTTP响应内容不包含设置的报警规则,则报警。'."\n"
."\n"
.'>如果探测任务类型为HTTP,则需要设置该参数。关于探测任务类型的设置方法,请参见[CreateHostAvailability](~~115317~~)。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'TaskOption.HttpHeader',
'in' => 'query',
'schema' => [
'description' => 'HTTP请求的Header。格式为`参数名:参数`,多个参数之间用回车符分隔,例如:'."\n"
.'```'."\n"
.'params1:value1'."\n"
.'params2:value2'."\n"
.'```',
'type' => 'string',
'required' => false,
'example' => 'params1:value1',
],
],
[
'name' => 'TaskOption.Interval',
'in' => 'query',
'schema' => [
'description' => '探测频率。单位:秒。取值:15、30、60、120、300、900、1800和3600。'."\n"
."\n"
.'> 仅3.5.1及以上版本的云监控插件支持该参数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '60',
],
],
[
'name' => 'AlertConfig.NotifyType',
'in' => 'query',
'schema' => [
'description' => '报警通知类型。取值:'."\n"
."\n"
.'- 2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 1:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 0:邮件+钉钉机器人。'."\n"
."\n\n"
.'0:邮件+钉钉机器人。'."\n"
."\n"
.'0:邮件+钉钉机器人。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => true,
'example' => '0',
],
],
[
'name' => 'AlertConfig.StartTime',
'in' => 'query',
'schema' => [
'description' => '报警生效的开始时间。取值范围:0~23。'."\n"
."\n"
.'例如:`AlertConfig.StartTime`为0,`AlertConfig.EndTime`为22,表示报警生效时间为00:00:00至22:00:00。'."\n"
."\n"
.'>如果报警不在生效时间内,则超过阈值也不会发送报警通知。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '0',
],
],
[
'name' => 'AlertConfig.EndTime',
'in' => 'query',
'schema' => [
'description' => '报警生效的结束时间。取值范围:0~23。'."\n"
."\n"
.'例如:`AlertConfig.StartTime`为0,`AlertConfig.EndTime`为22,表示报警生效时间为00:00:00至22:00:00。'."\n"
."\n"
.'>如果报警不在生效时间内,则超过阈值也不会发送报警通知。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '22',
],
],
[
'name' => 'AlertConfig.SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默时间。单位:秒,默认值:86400(1天)。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '86400',
],
],
[
'name' => 'AlertConfig.WebHook',
'in' => 'query',
'schema' => [
'description' => 'URL回调地址。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com/webhook.json',
],
],
[
'name' => 'AlertConfigEscalationList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警配置列表。',
'type' => 'array',
'items' => [
'description' => '报警配置列表。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '报警的监控项。N的取值范围:1~21。取值:'."\n"
."\n"
.'- HttpStatus:HTTP状态码。'."\n"
.'- HttpLatency:HTTP等待时间。'."\n"
.'- TelnetStatus:TELNET状态码。'."\n"
.'- TelnetLatency:TELNET等待时间。'."\n"
.'- PingLostRate:PING丢包率。',
'type' => 'string',
'required' => true,
'example' => 'HttpStatus',
],
'Value' => [
'description' => '报警阈值。N的取值范围:1~21。',
'type' => 'string',
'required' => false,
'example' => '3',
],
'Times' => [
'description' => '报警重试次数。N的取值范围:1~21。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Operator' => [
'description' => '报警规则比较符号。N的取值范围:1~21。取值:'."\n"
."\n"
.'- `>`'."\n"
.'- `>=`'."\n"
.'- `<`'."\n"
.'- `<=`'."\n"
.'- `=`',
'type' => 'string',
'required' => false,
'example' => '>',
],
'Aggregate' => [
'description' => '报警统计方法。N的取值范围:1~21。不同监控项的统计方法取值如下:'."\n"
."\n"
.'- HttpStatus:Value。'."\n"
.'- HttpLatency:Average。'."\n"
.'- TelnetStatus:Value。'."\n"
.'- TelnetLatency:Average。'."\n"
.'- PingLostRate:Average。'."\n"
."\n"
.'>状态码类的统计方法为原始值(Value),延时时间或丢包率的统计方法为平均值(Average)。',
'type' => 'string',
'required' => false,
'example' => 'Value',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 10,
],
],
[
'name' => 'InstanceList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '发起探测的ECS实例列表。N的取值范围:1~21。'."\n"
."\n"
.'> 当`TaskScope`为`GROUP_SPEC_INSTANCE`时,需要设置该参数。'."\n"
."\n",
'type' => 'array',
'items' => [
'description' => '发起探测的ECS实例列表。N的取值范围:1~21。'."\n"
."\n"
.'> 当`TaskScope`为`GROUP_SPEC_INSTANCE`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'required' => false,
'example' => 'i-absdfkwl321****',
'maxItems' => 1000,
],
],
[
'name' => 'AlertConfigTargetList',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '报警触发目标。',
'type' => 'array',
'items' => [
'description' => '报警触发目标。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'Arn' => [
'description' => '资源ARN。'."\n"
."\n"
.'格式为`acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message`。例如:`acs:mns:cn-hangzhou:120886317861****:/queues/test123/message`。参数说明如下:'."\n"
."\n"
.'- {云产品缩写}:目前仅支持轻量消息队列(原 MNS)。'."\n"
."\n"
.'- {userId}:阿里云账号ID。'."\n"
."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
."\n"
.'- {资源类型}`:接收报警的资源类型。取值:'."\n"
."\n"
.' - **queues**:队列。'."\n"
.' - **topics**:主题。'."\n"
."\n"
.'- {资源名称}:资源名称。'."\n"
."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。'."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。',
'type' => 'string',
'required' => false,
'example' => 'acs:mns:cn-hangzhou:111:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'required' => false,
'example' => '["INFO", "WARN", "CRITICAL"]',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'required' => false,
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
'required' => false,
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '16E815A3-47E1-4290-87F9-D5C99471FF45',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"16E815A3-47E1-4290-87F9-D5C99471FF45\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t16E815A3-47E1-4290-87F9-D5C99471FF45\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '修改可用性监控任务',
'description' => '本文将提供一个示例,将应用分组`123456`中可用性监控任务`12345`的名称修改为`task2`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeUnhealthyHostAvailability' => [
'summary' => '调用DescribeUnhealthyHostAvailability接口查询探测结果异常的服务器列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '任务id。',
'type' => 'array',
'items' => [
'description' => '任务ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '123***',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'User not authorized to operate on the specified resource.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'ACBDBB40-DFB6-4F4C-8957-51FFB233969C',
],
'Success' => [
'description' => '操作是否成功。取值:-true:成功。-false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'UnhealthyList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'NodeTaskInstance' => [
'description' => '异常的服务器列表信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Id' => [
'description' => '任务ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123******',
],
'InstanceList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'String' => [
'description' => '实例列表。',
'type' => 'array',
'items' => [
'description' => '实例列表。',
'type' => 'string',
'example' => 'i-*****',
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"User not authorized to operate on the specified resource.\\",\\n \\"RequestId\\": \\"ACBDBB40-DFB6-4F4C-8957-51FFB233969C\\",\\n \\"Success\\": true,\\n \\"UnhealthyList\\": {\\n \\"NodeTaskInstance\\": [\\n {\\n \\"Id\\": 0,\\n \\"InstanceList\\": {\\n \\"String\\": [\\n \\"i-*****\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询探测结果异常的服务器列表',
],
'DescribeHostAvailabilityList' => [
'summary' => '调用DescribeHostAvailabilityList接口查询可用性监控任务列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'schema' => [
'description' => '单个可用性监控任务ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '123456',
],
],
[
'name' => 'Ids',
'in' => 'query',
'schema' => [
'description' => '多个可用性监控任务ID。多个可用性监控任务ID之间用半角逗号(,)分隔。',
'type' => 'string',
'required' => false,
'example' => '123456,345678',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '可用性监控任务名称。',
'type' => 'string',
'required' => false,
'example' => 'ecs_instance',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '12345',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '4A288E86-45C3-4858-9DB0-6D85B10BD92A',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'TaskList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'NodeTaskConfig' => [
'description' => '可用性监控任务列表。',
'type' => 'array',
'items' => [
'description' => '可用性监控任务列表。',
'type' => 'object',
'properties' => [
'TaskType' => [
'description' => '任务类型。取值:'."\n"
."\n"
.'- PING'."\n"
.'- TELNET'."\n"
.'- HTTP',
'type' => 'string',
'example' => 'HTTP',
],
'GroupName' => [
'description' => '应用分组名称。',
'type' => 'string',
'example' => 'Group_ECS',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '12345',
],
'TaskName' => [
'description' => '可用性监控任务名称。',
'type' => 'string',
'example' => 'ecs_instance',
],
'Disabled' => [
'description' => '可用性监控任务是否禁用。取值:'."\n"
."\n"
.'- true:禁用。'."\n"
."\n"
.'- false:启用。',
'type' => 'boolean',
'example' => 'false',
],
'TaskScope' => [
'description' => '可用性监控任务的探测范围。取值:'."\n"
."\n"
.'- GROUP:表示将当前应用分组内的所有ECS实例作为探测任务的探针。'."\n"
.'- GROUP_SPEC_INSTANCE:表示将当前应用分组内的指定ECS实例作为探测任务的探针。',
'type' => 'string',
'example' => 'GROUP',
],
'Id' => [
'description' => '可用性监控任务ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123456',
],
'Instances' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Instance' => [
'description' => '发起探测的ECS实例列表。',
'type' => 'array',
'items' => [
'description' => '发起探测的ECS实例列表。',
'type' => 'string',
'example' => 'i-abcdefgh12****',
],
],
],
],
'TaskOption' => [
'description' => '可用性监控任务的参数选项。',
'type' => 'object',
'properties' => [
'HttpMethod' => [
'description' => '探测类型的方法。取值:'."\n"
."\n"
.'- GET'."\n"
.'- POST'."\n"
.'- HEAD',
'type' => 'string',
'example' => 'GET',
],
'Interval' => [
'description' => '探测频率。单位:秒。 ',
'type' => 'integer',
'format' => 'int32',
'example' => '60',
],
'HttpURI' => [
'description' => 'HTTP探测类型的探测URI地址。',
'type' => 'string',
'example' => 'https://www.aliyun.com',
],
'TelnetOrPingHost' => [
'description' => '探测的域名或地址。',
'type' => 'string',
'example' => 'ssh.aliyun.com',
],
'HttpResponseCharset' => [
'description' => 'HTTP探测类型的响应字符集。',
'type' => 'string',
'example' => 'UTF-8',
],
'HttpPostContent' => [
'description' => 'HTTP探测类型探测请求的Post内容。',
'type' => 'string',
'example' => 'params1=paramsValue1',
],
'HttpNegative' => [
'description' => '匹配HTTP响应内容的报警规则。取值:'."\n"
.'- true:如果HTTP响应内容包含设置的报警规则,则报警。'."\n"
.'- false:如果HTTP响应内容不包含设置的报警规则,则报警。',
'type' => 'boolean',
'example' => 'true',
],
'HttpKeyword' => [
'description' => 'HTTP探测类型匹配响应内容。',
'type' => 'string',
'example' => 'OK',
],
],
],
'AlertConfig' => [
'description' => '报警规则配置。',
'type' => 'object',
'properties' => [
'SilenceTime' => [
'description' => '通道沉默时间。单位:秒。默认值:86400。',
'type' => 'integer',
'format' => 'int32',
'example' => '86400',
],
'EndTime' => [
'description' => '报警生效的结束时间。取值范围:0~23。'."\n"
."\n"
.'例如:`AlertConfig.StartTime`为0,`AlertConfig.EndTime`为22,表示报警生效时间为00:00:00至22:00:00。'."\n"
."\n"
.'>如果报警不在生效时间内,则超过阈值也不会发送报警通知。',
'type' => 'integer',
'format' => 'int32',
'example' => '22',
],
'StartTime' => [
'description' => '报警生效的开始时间。取值范围:0~23。'."\n"
."\n"
.'例如:`AlertConfig.StartTime`为0,`AlertConfig.EndTime`为22,表示报警生效时间为00:00:00至22:00:00。'."\n"
."\n"
.'>如果报警不在生效时间内,则超过阈值也不会发送报警通知。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'WebHook' => [
'description' => '报警发生回调时的URL地址。'."\n"
."\n"
.'云监控会将报警信息通过POST请求推送到该地址,目前仅支持HTTP协议。',
'type' => 'string',
'example' => 'https://www.aliyun.com',
],
'NotifyType' => [
'description' => '报警通知类型。取值:'."\n"
."\n"
.'- 2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 1:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 0:邮件+钉钉机器人。'."\n"
."\n"
.'- 2:邮件+钉钉机器人。'."\n"
."\n"
.'- 1:邮件+钉钉机器人。'."\n"
."\n"
.'- 0:邮件+钉钉机器人。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'EscalationList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'escalationList' => [
'description' => '报警触发条件。',
'type' => 'array',
'items' => [
'description' => '报警触发条件。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '400',
],
'MetricName' => [
'description' => '报警监控项。取值:'."\n"
."\n"
.'- HttpStatus:HTTP状态码。'."\n"
.'- HttpLatency:HTTP等待时间。'."\n"
.'- TelnetStatus:TELNET状态码。'."\n"
.'- TelnetLatency:TELNET等待时间。'."\n"
.'- PingLostRate:PING丢包率。',
'type' => 'string',
'example' => 'HttpStatus',
],
'Operator' => [
'description' => '报警规则比较符号。取值:'."\n"
."\n"
.'- `>`'."\n"
.'- `>=`'."\n"
.'- `<`'."\n"
.'- `<=`'."\n"
.'- `=`',
'type' => 'string',
'example' => '=',
],
'Times' => [
'description' => '报警周期。即连续几个周期超过阈值。',
'type' => 'string',
'example' => '3',
],
'Aggregate' => [
'description' => '报警统计方法。不同监控项的取值如下:'."\n"
."\n"
.'- Value:HTTP状态码的值。'."\n"
.'- Average:HTTP等待时间的平均值。'."\n"
.'- Value:TELNET状态码的值。'."\n"
.'- TelnetLatency:TELNET等待时间的平均值。'."\n"
.'- Average:PING丢包率的平均值。',
'type' => 'string',
'example' => 'Value',
],
],
],
],
],
],
'TargetList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Target' => [
'description' => '报警目标列表。',
'type' => 'array',
'items' => [
'description' => '报警目标列表。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。',
'type' => 'string',
'example' => '1',
],
'Arn' => [
'description' => 'ARN资源描述。'."\n"
."\n"
.'格式:`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下:'."\n"
."\n"
.'- Service:云服务Code。'."\n"
."\n"
.'- Region:地域ID。'."\n"
."\n"
.'- Account:阿里云账号ID。'."\n"
."\n"
.'- ResourceType:资源类型。'."\n"
."\n"
.'- ResourceId:资源ID。',
'type' => 'string',
'example' => 'acs:mns:cn-hangzhou:17754132319*****:/queues/test/messages',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'example' => 'INFO',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'example' => '{"key1":"value1"}',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"4A288E86-45C3-4858-9DB0-6D85B10BD92A\\",\\n \\"Total\\": 1,\\n \\"Success\\": true,\\n \\"TaskList\\": {\\n \\"NodeTaskConfig\\": [\\n {\\n \\"TaskType\\": \\"HTTP\\",\\n \\"GroupName\\": \\"Group_ECS\\",\\n \\"GroupId\\": 12345,\\n \\"TaskName\\": \\"ecs_instance\\",\\n \\"Disabled\\": false,\\n \\"TaskScope\\": \\"GROUP\\",\\n \\"Id\\": 123456,\\n \\"Instances\\": {\\n \\"Instance\\": [\\n \\"i-abcdefgh12****\\"\\n ]\\n },\\n \\"TaskOption\\": {\\n \\"HttpMethod\\": \\"GET\\",\\n \\"Interval\\": 60,\\n \\"HttpURI\\": \\"https://www.aliyun.com\\",\\n \\"TelnetOrPingHost\\": \\"ssh.aliyun.com\\",\\n \\"HttpResponseCharset\\": \\"UTF-8\\",\\n \\"HttpPostContent\\": \\"params1=paramsValue1\\",\\n \\"HttpNegative\\": true,\\n \\"HttpKeyword\\": \\"OK\\"\\n },\\n \\"AlertConfig\\": {\\n \\"SilenceTime\\": 86400,\\n \\"EndTime\\": 22,\\n \\"StartTime\\": 0,\\n \\"WebHook\\": \\"https://www.aliyun.com\\",\\n \\"NotifyType\\": 1,\\n \\"EscalationList\\": {\\n \\"escalationList\\": [\\n {\\n \\"Value\\": \\"400\\",\\n \\"MetricName\\": \\"HttpStatus\\",\\n \\"Operator\\": \\"=\\",\\n \\"Times\\": \\"3\\",\\n \\"Aggregate\\": \\"Value\\"\\n }\\n ]\\n },\\n \\"TargetList\\": {\\n \\"Target\\": [\\n {\\n \\"Id\\": \\"1\\",\\n \\"Arn\\": \\"acs:mns:cn-hangzhou:17754132319*****:/queues/test/messages\\",\\n \\"Level\\": \\"INFO\\",\\n \\"JsonParams\\": \\"{\\\\\\"key1\\\\\\":\\\\\\"value1\\\\\\"}\\"\\n }\\n ]\\n }\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t4A288E86-45C3-4858-9DB0-6D85B10BD92A\\r\\n\\t1\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tGroup_ECS\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\thttps://aliyun.com\\r\\n\\t\\t\\t\\tGET\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t86400\\r\\n\\t\\t\\t\\t22\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\t=\\r\\n\\t\\t\\t\\t\\t\\tHttpStatus\\r\\n\\t\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\t\\t400\\r\\n\\t\\t\\t\\t\\t\\tValue\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\t=\\r\\n\\t\\t\\t\\t\\t\\tHttpLatency\\r\\n\\t\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\t\\t500\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tecs_instance\\r\\n\\t\\t\\tGROUP\\r\\n\\t\\t\\tHTTP\\r\\n\\t\\t\\t123456\\r\\n\\t\\t\\tfalse\\r\\n\\t\\t\\t12345\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询可用性监控任务列表',
'description' => '本文将提供一个示例,查询当前账号的可用性监控任务列表。返回结果显示,当前账号存在一条可用性监控任务记录`ecs_instance`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'InstallMonitoringAgent' => [
'summary' => '调用InstallMonitoringAgent接口为指定阿里云主机安装云监控插件。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Force',
'in' => 'query',
'schema' => [
'description' => '是否强制安装云监控插件。取值:'."\n"
.'- true(默认值):强制安装。'."\n"
.'- false:不强制安装。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
'default' => 'true',
],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '阿里云主机ID。'."\n"
."\n"
.'N的取值范围:1~10。'."\n"
."\n"
.'> `InstallCommand`和`InstanceIds`必须二选一。',
'type' => 'array',
'items' => [
'description' => '阿里云主机ID。'."\n"
."\n"
.'N的取值范围:1~10。'."\n"
."\n"
.'> `InstallCommand`和`InstanceIds`必须二选一。',
'type' => 'string',
'required' => false,
'example' => 'i-m5e0k0bexac8tykr****',
],
'required' => false,
'example' => 'i-m5e0k0bexac8tykr****',
'maxItems' => 10,
],
],
[
'name' => 'InstallCommand',
'in' => 'query',
'schema' => [
'description' => '为当前阿里云账号下的所有阿里云主机安装云监控插件。取值:'."\n"
."\n"
.'- `onlyInstallNotHasAgent` : 仅为未安装云监控插件的阿里云主机安装最新版本插件。'."\n"
."\n"
.'- `onlyUpgradeAgent`:仅为已安装非最新版本云监控插件的阿里云主机升级插件。'."\n"
."\n"
.'- `installAndUpgrade`:不仅为未安装云监控插件的阿里云主机安装最新版本插件,且为已安装非最新版本云监控插件的阿里云主机升级插件。'."\n"
."\n"
.'> 如果您已设置该参数,参数`InstanceIds`的设置无效。',
'type' => 'string',
'required' => false,
'example' => 'onlyInstallNotHasAgent',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '0BDAF8A8-04DC-5F0C-90E4-724D42C41945',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Parameter invalid.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"0BDAF8A8-04DC-5F0C-90E4-724D42C41945\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t0BDAF8A8-04DC-5F0C-90E4-724D42C41945\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '为指定阿里云主机安装云监控插件',
'description' => '## 前提条件'."\n"
.'请确保阿里云主机已安装云助手。关于如何安装云助手,请参见[云助手概述](~~64601~~)。'."\n"
."\n"
.'## 背景信息'."\n"
.'本接口仅适用于阿里云主机,即ECS实例。'."\n"
.'通过API安装云监控插件的成功率约为95%,如果安装失败,则请手动安装。关于如何安装云监控插件,请参见[安装和卸载C++版本插件](~~183482~~)。'."\n"
."\n"
.'## 使用说明'."\n"
.'本文将提供一个示例,强制为阿里云主机`i-m5e0k0bexac8tykr****`安装最新版本云监控插件。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitoringAgentHosts' => [
'summary' => '调用DescribeMonitoringAgentHosts接口查询所有已安装和未安装云监控插件的主机列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'KeyWord',
'in' => 'query',
'schema' => [
'description' => '模糊搜索关键字。',
'type' => 'string',
'required' => false,
'example' => 'host1',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '主机名称。',
'type' => 'string',
'required' => false,
'example' => 'hostNam1',
],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => [
'description' => '实例ID。',
'type' => 'string',
'required' => false,
'example' => 'i-a3d1q1pm2f9yr29e****',
],
],
[
'name' => 'SerialNumbers',
'in' => 'query',
'schema' => [
'description' => '主机序列号。'."\n"
."\n"
.'每台主机成功安装云监控插件之后会生成一个SerialNumber,具备全局唯一性。非阿里云主机无实例ID,有SerialNumber。'."\n"
."\n"
.'>该参数可用于精准查找监控的任何一台主机。',
'type' => 'string',
'required' => false,
'example' => 'a1ab31a3-1234-40f2-9e95-c8caa8f0****',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。取值:'."\n"
."\n"
.'- 10'."\n"
.'- 20'."\n"
.'- 50'."\n"
.'- 100'."\n"
."\n"
.'>虽然目前阿里云未限制该参数的最大值,但是不建议设置的值过大,可能会导致超时无法正常获取。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'InstanceRegionId',
'in' => 'query',
'schema' => [
'description' => '实例所在的地域。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'AliyunHost',
'in' => 'query',
'schema' => [
'description' => '阿里云主机(ECS)。取值:'."\n"
.'- true(默认值):过滤出所有阿里云主机(ECS)。'."\n"
.'- false:过滤出所有非阿里云主机。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'Status',
'in' => 'query',
'schema' => [
'description' => '主机状态。取值:'."\n"
.'- Running:运行中。'."\n"
.'- Stopped:已停止、未安装或安装失败。',
'type' => 'string',
'required' => false,
'example' => 'Running',
],
],
[
'name' => 'SysomStatus',
'in' => 'query',
'schema' => [
'description' => 'SysOM的开启状态。取值:'."\n"
."\n"
.'- installing:开启中。'."\n"
.'- running:运行中。'."\n"
.'- stopped:已停止。'."\n"
.'- uninstalling:关闭中。',
'type' => 'string',
'required' => false,
'example' => 'running',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回结果。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '63EEBB2A-9E51-41E4-9E83-5DE7F3B292E0',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'PageNumber' => [
'description' => '分页页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '分页大小。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'PageTotal' => [
'description' => '页数。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'Hosts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Host' => [
'description' => '主机列表。',
'type' => 'array',
'items' => [
'description' => '主机。',
'type' => 'object',
'properties' => [
'SerialNumber' => [
'description' => '主机序列号。非阿里云主机无实例ID,有SerialNumber。'."\n"
."\n"
.'>该参数可用于精准查找监控的任何一台主机。',
'type' => 'string',
'example' => 'x12335-6cc8-4a22-9f21-1a00a719****',
],
'NatIp' => [
'description' => 'NAT IP地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'HostName' => [
'description' => '主机名称。',
'type' => 'string',
'example' => 'hostIP',
],
'AliUid' => [
'description' => '阿里云账号ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '103201326074****',
],
'NetworkType' => [
'description' => '网络类型。',
'type' => 'string',
'example' => 'vpc',
],
'InstanceId' => [
'description' => '实例ID。',
'type' => 'string',
'example' => 'i-a2d5q7pm3f9yr212****',
],
'isAliyunHost' => [
'description' => '是否为阿里云主机。取值:'."\n"
."\n"
.'- true:是。'."\n"
."\n"
.'- false:否。',
'type' => 'boolean',
'example' => 'true',
],
'EipAddress' => [
'description' => 'EIP的IP地址。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'AgentVersion' => [
'description' => '插件版本。',
'type' => 'string',
'example' => '3.4.6',
],
'IpGroup' => [
'description' => '主机IP地址。'."\n"
."\n"
.'>多个IP地址之前用半角逗号(,)分隔。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'EipId' => [
'description' => 'EIP的ID。',
'type' => 'string',
'example' => 'eip-bp16i16k9gcezyfrp****',
],
'Region' => [
'description' => '地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'InstanceTypeFamily' => [
'description' => 'ECS实例规格。',
'type' => 'string',
'example' => 'ecs.n4',
],
'OperatingSystem' => [
'description' => '操作系统。',
'type' => 'string',
'example' => 'Linux',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"63EEBB2A-9E51-41E4-9E83-5DE7F3B292E0\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"PageTotal\\": 50,\\n \\"Total\\": 10,\\n \\"Hosts\\": {\\n \\"Host\\": [\\n {\\n \\"SerialNumber\\": \\"x12335-6cc8-4a22-9f21-1a00a719****\\",\\n \\"NatIp\\": \\"192.168.XX.XX\\",\\n \\"HostName\\": \\"hostIP\\",\\n \\"AliUid\\": 0,\\n \\"NetworkType\\": \\"vpc\\",\\n \\"InstanceId\\": \\"i-a2d5q7pm3f9yr212****\\",\\n \\"isAliyunHost\\": true,\\n \\"EipAddress\\": \\"192.168.XX.XX\\",\\n \\"AgentVersion\\": \\"3.4.6\\",\\n \\"IpGroup\\": \\"192.168.XX.XX\\",\\n \\"EipId\\": \\"eip-bp16i16k9gcezyfrp****\\",\\n \\"Region\\": \\"cn-hangzhou\\",\\n \\"InstanceTypeFamily\\": \\"ecs.n4\\",\\n \\"OperatingSystem\\": \\"Linux\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tWindows\\r\\n\\t\\t\\t\\tf0a434f2-632b-4588-95e6-202d4396****\\r\\n\\t\\t\\t\\ttrue\\r\\n\\t\\t\\t\\ti-uf6hm9lnlzsarrc7****\\r\\n\\t\\t\\t\\t3.4.6\\r\\n\\t\\t\\t\\tvpc\\r\\n\\t\\t\\t\\tecs.g6\\r\\n\\t\\t\\t\\tcn-shanghai\\r\\n\\t\\t\\t\\t192.168.XX.XX,192.168.XX.XX\\r\\n\\t\\t\\t\\tiZlzsarrc78****\\r\\n\\t\\t\\t\\t103201326074****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tLinux\\r\\n\\t\\t\\t\\t9c336dc5-1802-4db0-b7a0-2d46ad4f****\\r\\n\\t\\t\\t\\ttrue\\r\\n\\t\\t\\t\\ti-uf6hn19s56zumk9w****\\r\\n\\t\\t\\t\\t3.4.4\\r\\n\\t\\t\\t\\tvpc\\r\\n\\t\\t\\t\\tecs.g5\\r\\n\\t\\t\\t\\tcn-shanghai\\r\\n\\t\\t\\t\\t192.168.XX.XX,192.168.XX.XX\\r\\n\\t\\t\\t\\tlaunch-advisor-2019****\\r\\n\\t\\t\\t\\t103201326074****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t100\\r\\n\\t\\t1\\r\\n\\t\\t1\\r\\n\\t\\t5\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询所有已安装和未安装云监控插件的主机列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitoringAgentAccessKey' => [
'summary' => '调用DescribeMonitoringAgentAccessKey接口查询非阿里云主机安装云监控插件时所需要的AccessKey和AccessSecret。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'AccessKey' => [
'description' => '安装插件需要的AccessKey。',
'type' => 'string',
'example' => 'E7A27f9****',
],
'SecretKey' => [
'description' => '安装插件需要的AccessSecret。',
'type' => 'string',
'example' => 'sBjNOUhLylrxMX-Xv1****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C0F655E9-D793-51E6-BD78-CABBCCFC1047',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"AccessKey\\": \\"E7A27f9****\\",\\n \\"SecretKey\\": \\"sBjNOUhLylrxMX-Xv1****\\",\\n \\"RequestId\\": \\"C0F655E9-D793-51E6-BD78-CABBCCFC1047\\",\\n \\"Success\\": true,\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\"\\n}","errorExample":""},{"type":"xml","example":"\\n sBjNOUhLylrxMX-Xv1****\\n C0F655E9-D793-51E6-BD78-CABBCCFC1047\\n E7A27f9****\\n 200\\n true\\n","errorExample":""}]',
'title' => '查询非阿里云主机安装云监控插件时所需要的AccessKey和AccessSecret',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitoringAgentConfig' => [
'summary' => '调用DescribeMonitoringAgentConfig接口查询云监控插件的配置信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'EnableActiveAlert' => [
'description' => '开通一键告警的云服务。',
'type' => 'string',
'example' => 'redis,rds,ecs',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'E9F4FA2A-54BE-4EF9-9D1D-1A0B1DC86B8D',
],
'AutoInstall' => [
'description' => '现有ECS主机是否自动安装云监控插件。取值:'."\n"
."\n"
.'- true'."\n"
."\n"
.'- false',
'type' => 'boolean',
'example' => 'true',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'EnableInstallAgentNewECS' => [
'description' => '新购ECS主机是否自动安装云监控插件。取值:'."\n"
."\n"
.'- true'."\n"
."\n"
.'- false',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified parameter is not valid.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'The Request is not authorization.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"EnableActiveAlert\\": \\"redis,rds,ecs\\",\\n \\"RequestId\\": \\"E9F4FA2A-54BE-4EF9-9D1D-1A0B1DC86B8D\\",\\n \\"AutoInstall\\": true,\\n \\"Success\\": true,\\n \\"EnableInstallAgentNewECS\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\ttrue\\r\\n\\t\\r\\n\\ttrue\\r\\n\\tB4EB0F95-3181-4E8F-B32E-8C3734E8F88E\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询云监控插件的配置信息',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitoringAgentStatuses' => [
'summary' => '调用DescribeMonitoringAgentStatuses接口查询云监控插件运行状态。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'InstanceIds',
'in' => 'query',
'schema' => [
'description' => 'The instance IDs. Separate multiple instance IDs with commas (,).'."\n",
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'i-hp3dunahluwajv6f****',
],
],
[
'name' => 'HostAvailabilityTaskId',
'in' => 'query',
'schema' => [
'description' => 'The ID of the availability monitoring task.'."\n",
'type' => 'string',
'required' => false,
'example' => '126****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => 'The response parameters.'."\n",
'type' => 'object',
'properties' => [
'Code' => [
'description' => 'The HTTP status code.'."\n"
."\n"
.'> The status code 200 indicates that the request was successful.'."\n",
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => 'The error message.'."\n",
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => 'The request ID.'."\n",
'type' => 'string',
'example' => '6F8371DF-AB81-41B8-9E1B-5493B3FF0E4F',
],
'Success' => [
'description' => 'Indicates whether the request was successful. Valid values:'."\n"
."\n"
.'* true'."\n"
.'* false'."\n",
'type' => 'boolean',
'example' => 'true',
],
'NodeStatusList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'NodeStatus' => [
'description' => 'The host status information.'."\n",
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Status' => [
'description' => 'The status of the CloudMonitor agent. Valid values:'."\n"
."\n"
.'* running: The CloudMonitor agent is running.'."\n"
.'* stopped: The CloudMonitor agent is stopped.'."\n"
.'* installing: The CloudMonitor agent is being installed.'."\n"
.'* install_faild: The CloudMonitor agent fails to be installed.'."\n"
.'* abnormal: The CloudMonitor agent is not properly installed.'."\n"
.'* not_installed: The CloudMonitor agent is not installed.'."\n",
'type' => 'string',
'example' => 'running',
],
'InstanceId' => [
'description' => 'The instance ID.'."\n",
'type' => 'string',
'example' => 'i-hp3dunahluwajv6f****',
],
'AutoInstall' => [
'description' => 'Indicates whether the CloudMonitor agent is automatically installed. Valid values:'."\n"
."\n"
.'* true: The CloudMonitor agent is automatically installed.'."\n"
.'* false: The CloudMonitor agent is not automatically installed.'."\n",
'type' => 'boolean',
'example' => 'true',
],
'OsMonitorStatus' => [
'description' => 'The status of SysOM. Valid values:'."\n"
."\n"
.'* installing: SysOM is being installed.'."\n"
.'* running: SysOM is running.'."\n"
.'* stopped: SysOM is stopped.'."\n"
.'* uninstalling: SysOM is being uninstalled.'."\n",
'type' => 'string',
'example' => 'running',
],
'OsMonitorErrorCode' => [
'description' => 'The error status of SysOM. Valid values:'."\n"
."\n"
.'* `install_fail`: SysOM fails to be installed or an unknown error occurs.'."\n"
.'* `install_assist_invalid`: SysOM fails to be installed because the status of Cloud Assistant is invalid.'."\n"
.'* `install_assist_command_fail`: SysOM fails to be installed because the installation command fails to run.'."\n"
.'* `uninstall_fail`: SysOM fails to be uninstalled or an unknown error occurs.'."\n"
.'* `uninstall_assist_invalid`: SysOM fails to be uninstalled because the status of Cloud Assistant is invalid.'."\n"
.'* `uninstall_assist_command_fail`: SysOM fails to be uninstalled because the uninstallation command fails to run.'."\n",
'type' => 'string',
'example' => 'install_fail',
],
'OsMonitorErrorDetail' => [
'description' => 'The details of the execution error. Valid values:'."\n"
."\n"
.'* `Command.ErrorCode.Fail.Downlaod.REGIN_ID`: Failed to obtain the region ID.'."\n"
.'* `Command.ErrorCode.Fail.Downlaod.SYSAK`: Failed to download the .rpm package of System Analyse Kit (SysAK).'."\n"
.'* `Command.ErrorCode.Fail.Downlaod.CMON_FILE`: Failed to download the CMON file.'."\n"
.'* `Command.ErrorCode.Fail.Downlaod.BTF`: Failed to start SysAK because the BTF file is not found.'."\n"
.'* `Command.ErrorCode.Fail.Start.SYSAK`: Failed to start SysAK due to an unknown error.'."\n",
'type' => 'string',
'example' => 'Command.ErrorCode.Fail.Downlaod.REGIN_ID',
],
'OsMonitorVersion' => [
'description' => 'The SysOM version.'."\n",
'type' => 'string',
'example' => '1.3.0-12',
],
'OsMonitorConfig' => [
'description' => 'Indicates whether the SysAK monitoring feature is enabled.`` Valid values:'."\n"
."\n"
.'* `true`: The SysAK monitoring feature is enabled.'."\n"
.'* `false`: the SysAK monitoring feature is disabled.'."\n",
'type' => 'string',
'example' => '{"sysak":true}',
],
'AgentInstallErrorCode' => [
'description' => 'The error code returned when the CloudMonitor agent is installed. Valid values:'."\n"
.'- Common.Timeout: The installation timed out.'."\n"
.'- Common.SLR: The service-linked role for CloudMonitor is unauthorized.'."\n"
.'- Common.OS: The operating system is not supported.'."\n"
.'- Assist.Invalid: Cloud Assistant is not running.'."\n"
.'- Assist.Invoke: An error occurred when the installation program is started.'."\n"
.'- Assist.Execute: An error occurred when the installation program is running.',
'type' => 'string',
'example' => 'Assist.Invalid',
],
'LoongCollectorVersion' => [
'description' => 'LoongCollector Version',
'type' => 'string',
'example' => '0.1.0',
],
'LoongCollectorStatus' => [
'description' => 'LoongCollector Status',
'type' => 'string',
'enumValueTitles' => [
'running' => '正常',
'stopped' => '停止',
],
'example' => 'running',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"6F8371DF-AB81-41B8-9E1B-5493B3FF0E4F\\",\\n \\"Success\\": true,\\n \\"NodeStatusList\\": {\\n \\"NodeStatus\\": [\\n {\\n \\"Status\\": \\"running\\",\\n \\"InstanceId\\": \\"i-hp3dunahluwajv6f****\\",\\n \\"AutoInstall\\": true,\\n \\"OsMonitorStatus\\": \\"running\\",\\n \\"OsMonitorErrorCode\\": \\"install_fail\\",\\n \\"OsMonitorErrorDetail\\": \\"Command.ErrorCode.Fail.Downlaod.REGIN_ID\\",\\n \\"OsMonitorVersion\\": \\"1.3.0-12\\",\\n \\"OsMonitorConfig\\": \\"{\\\\\\"sysak\\\\\\":true}\\",\\n \\"AgentInstallErrorCode\\": \\"Assist.Invalid\\",\\n \\"LoongCollectorVersion\\": \\"0.1.0\\",\\n \\"LoongCollectorStatus\\": \\"running\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t6F8371DF-AB81-41B8-9E1B-5493B3FF0E4F\\n\\t\\n\\t\\t\\n\\t\\t\\trunning\\n\\t\\t\\ttrue\\n\\t\\t\\ti-hp3dunahluwajv6f****\\n\\t\\t\\n\\t\\n\\t200\\n\\ttrue\\n\\t","errorExample":""}]',
'title' => '查询云监控插件运行状态',
'description' => 'This topic describes how to query the status of the CloudMonitor agent that is installed on the `i-hp3dunahluwajv6f****` instance. The result indicates that the CloudMonitor agent is in the `running` state.'."\n",
'requestParamsDescription' => 'For more information about common request parameters, see [Common parameters](~~199331~~).'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyHostInfo' => [
'summary' => '调用ModifyHostInfo接口修改非阿里云的主机显示信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '实例ID。仅支持非阿里云主机。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'host-R_NSWNV****',
],
],
[
'name' => 'HostName',
'in' => 'query',
'schema' => [
'description' => '主机名称。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'portalHost',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'EBB5215C-44AB-4000-A2D7-48634FDC4F04',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"EBB5215C-44AB-4000-A2D7-48634FDC4F04\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\tEBB5215C-44AB-4000-A2D7-48634FDC4F04\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '修改非阿里云的主机显示信息',
'description' => '****',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitoringConfig' => [
'summary' => '调用DescribeMonitoringConfig接口查询云监控插件的全局配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'F35654DB-0C9D-4FB3-903F-479BA7663061',
],
'AutoInstall' => [
'description' => '现有ECS主机是否自动安装云监控插件。取值:'."\n"
."\n"
.'- true'."\n"
."\n"
.'- false',
'type' => 'boolean',
'example' => 'false',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'EnableInstallAgentNewECS' => [
'description' => '新购ECS主机是否自动安装云监控插件。取值:'."\n"
."\n"
.'- true'."\n"
."\n"
.'- false',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified parameter is not valid.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'The Request is not authorization.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"F35654DB-0C9D-4FB3-903F-479BA7663061\\",\\n \\"AutoInstall\\": false,\\n \\"Success\\": true,\\n \\"EnableInstallAgentNewECS\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tfalse\\r\\n\\ttrue\\r\\n\\tBA76F154-DE3F-442C-94D3-895E7ABC1BDE\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询云监控插件的全局配置',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutMonitoringConfig' => [
'summary' => '调用PutMonitoringConfig接口设置云监控插件的全局配置。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'AutoInstall',
'in' => 'query',
'schema' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'EnableInstallAgentNewECS',
'in' => 'query',
'schema' => [
'description' => '新购ECS主机是否自动安装云监控插件。取值:'."\n"
.'- true(默认值):新购ECS主机自动安装云监控插件。'."\n"
."\n"
.'- false:新购ECS主机不自动安装云监控插件。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Specified parameter EnableInstallAgentNewECS is not valid.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '109C8095-6FAD-4DBB-B013-6ED18CE4C0B1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified parameter is not valid.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'The Request is not authorization.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"Specified parameter EnableInstallAgentNewECS is not valid.\\",\\n \\"RequestId\\": \\"109C8095-6FAD-4DBB-B013-6ED18CE4C0B1\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 109C8095-6FAD-4DBB-B013-6ED18CE4C0B1\\n true\\n 200\\n","errorExample":""}]',
'title' => '设置云监控插件的全局配置',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'UninstallMonitoringAgent' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '非阿里云主机的实例ID。',
'type' => 'string',
'required' => true,
'example' => 'host-****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'Successfully',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '466902B9-2842-40B0-B796-00FE772B6EF3',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
412 => [
[
'errorCode' => 'AgentStateError',
'errorMessage' => 'Expected agent running state is stopped.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successfully\\",\\n \\"RequestId\\": \\"466902B9-2842-40B0-B796-00FE772B6EF3\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 466902B9-2842-40B0-B796-00FE772B6EF3\\n 200\\n Successfully\\n","errorExample":""}]',
'title' => '卸载非阿里云主机的云监控插件',
'summary' => '调用UninstallMonitoringAgent接口卸载非阿里云主机的云监控插件。',
'description' => '> 本接口不适用于阿里云主机的云监控插件。卸载阿里云主机的云监控插件的方法,请参见[安装和卸载插件](~~183482~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateMonitoringAgentProcess' => [
'summary' => '调用CreateMonitoringAgentProcess接口创建进程监控。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'ProcessName',
'in' => 'query',
'schema' => [
'description' => '进程名称。',
'type' => 'string',
'required' => false,
'example' => 'java',
],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '实例ID。',
'type' => 'string',
'required' => true,
'example' => ' i-2ze51wjtwox01r8g****',
],
],
[
'name' => 'ProcessUser',
'in' => 'query',
'schema' => [
'description' => '执行进程的用户。',
'type' => 'string',
'required' => false,
'example' => 'admin',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。'."\n",
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误消息。',
'type' => 'string',
'example' => 'User not authorized to operate on the specified resource.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '0DFCB47D-E7E1-4CBE-A381-8339F7B300EF',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Id' => [
'description' => '进程ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '12345',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"User not authorized to operate on the specified resource.\\",\\n \\"RequestId\\": \\"0DFCB47D-E7E1-4CBE-A381-8339F7B300EF\\",\\n \\"Success\\": true,\\n \\"Id\\": 12345\\n}","errorExample":""},{"type":"xml","example":"\\n 0DFCB47D-E7E1-4CBE-A381-8339F7B300EF\\n 171894\\n true\\n 200\\n","errorExample":""}]',
'title' => '创建进程监控',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateMonitorAgentProcess' => [
'summary' => '调用CreateMonitorAgentProcess接口创建进程监控。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'ProcessName',
'in' => 'query',
'schema' => [
'description' => '进程名称。',
'type' => 'string',
'required' => true,
'example' => 'AliYunDun',
],
],
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '实例ID。',
'type' => 'string',
'required' => true,
'example' => 'i-2ze2d6j5uhg20x47****',
],
],
[
'name' => 'ProcessUser',
'in' => 'query',
'schema' => [
'description' => '执行进程的用户。',
'type' => 'string',
'required' => false,
'example' => 'admin',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'User not authorized to operate on the specified resource.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '971CC023-5A96-452A-BB7C-2483F948BCFD',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Id' => [
'description' => '进程ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123456',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"User not authorized to operate on the specified resource.\\",\\n \\"RequestId\\": \\"971CC023-5A96-452A-BB7C-2483F948BCFD\\",\\n \\"Success\\": true,\\n \\"Id\\": 123456\\n}","errorExample":""},{"type":"xml","example":"\\n 971CC023-5A96-452A-BB7C-2483F948BCFD\\n 123456\\n true\\n 200\\n","errorExample":""}]',
'title' => '创建进程监控',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitoringAgentProcesses' => [
'summary' => '调用DescribeMonitoringAgentProcesses接口查询指定资源的进程数列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '实例ID。',
'type' => 'string',
'required' => true,
'example' => 'i-hp3hl3cx1pbahzy8****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C11C0E85-6862-4F25-8D66-D6A5E0882984',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'NodeProcesses' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'NodeProcess' => [
'description' => '进程信息',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ProcessName' => [
'description' => '进程名称。',
'type' => 'string',
'example' => 'java',
],
'ProcessId' => [
'description' => '进程ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '4550102',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '239708487',
],
'Command' => [
'description' => '命令。',
'type' => 'string',
'example' => '/bin/sh',
],
'ProcessUser' => [
'description' => '进程用户',
'type' => 'string',
'example' => 'admin',
],
'InstanceId' => [
'description' => '实例ID。',
'type' => 'string',
'example' => 'host-gdsmvinvmh6fu',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"C11C0E85-6862-4F25-8D66-D6A5E0882984\\",\\n \\"Success\\": true,\\n \\"NodeProcesses\\": {\\n \\"NodeProcess\\": [\\n {\\n \\"ProcessName\\": \\"java\\",\\n \\"ProcessId\\": 4550102,\\n \\"GroupId\\": \\"239708487\\",\\n \\"Command\\": \\"/bin/sh\\",\\n \\"ProcessUser\\": \\"admin\\",\\n \\"InstanceId\\": \\"host-gdsmvinvmh6fu\\"\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询指定资源的进程数列表',
'description' => '> '."\n"
.'> 调用本接口之前,您需要先调用 CreateMonitoringAgentProcess 接口创建进程数。更多信息,请参见 [CreateMonitoringAgentProcess](~~2513212~~)。'."\n"
."\n"
.'本文将提供一个示例,查询资源i-hp3hl3cx1pbahzy8****的进程数列表。返回结果显示进程数Nginx和HTTP的详细信息。',
],
'DeleteMonitoringAgentProcess' => [
'summary' => '调用DeleteMonitoringAgentProcess接口删除指定主机中的指定进程监控。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'InstanceId',
'in' => 'query',
'schema' => [
'description' => '实例ID。',
'type' => 'string',
'required' => true,
'example' => 'i-KpVny6l****',
],
],
[
'name' => 'ProcessName',
'in' => 'query',
'schema' => [
'description' => '进程名称。'."\n"
."\n"
.'> `ProcessId`和`ProcessName`必须设置一个。',
'type' => 'string',
'required' => false,
'example' => 'http',
],
],
[
'name' => 'ProcessId',
'in' => 'query',
'schema' => [
'description' => '进程ID。'."\n"
."\n"
.'> `ProcessId`和`ProcessName`必须设置一个。',
'type' => 'string',
'required' => false,
'example' => '123****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '971CC023-5A96-452A-BB7C-2483F948BCFD',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"971CC023-5A96-452A-BB7C-2483F948BCFD\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n EBB5215C-44AB-4000-A2D7-48634FDC4F04\\n true\\n 200\\n","errorExample":""}]',
'title' => '删除指定主机中的指定进程监控',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSystemEventHistogram' => [
'summary' => '调用DescribeSystemEventHistogram接口查询系统事件的时段数量分布图(柱状图)。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '产品的名称缩写。'."\n"
.'>关于产品名称缩写的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'OSS',
],
],
[
'name' => 'EventType',
'in' => 'query',
'schema' => [
'description' => '事件类型。'."\n"
.'>关于事件类型的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'Exception',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '事件名称。'."\n"
.'>关于事件名称的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'BucketIngressBandwidth',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '事件级别,取值:'."\n"
."\n"
.'- CRITICAL:严重'."\n"
.'- WARN:警告'."\n"
.'- INFO:信息',
'type' => 'string',
'required' => false,
'example' => 'CRITICAL',
],
],
[
'name' => 'Status',
'in' => 'query',
'schema' => [
'description' => '事件状态。'."\n"
."\n"
.'>关于事件状态的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'normal',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '12345',
],
],
[
'name' => 'SearchKeywords',
'in' => 'query',
'schema' => [
'description' => '搜索事件内容包含的关键字。取值:'."\n"
."\n"
.'- 如果您待搜索事件的内容中包括a和b,可以搜索`a and b`。'."\n"
."\n"
.'- 如果您待搜索事件的内容中包括a或b,可以搜索`a or b`。',
'type' => 'string',
'required' => false,
'example' => 'cms',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552209685596',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552220485596',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '486029C9-53E1-44B4-85A8-16A571A043FD',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'string',
'example' => 'true',
],
'SystemEventHistograms' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SystemEventHistogram' => [
'description' => '事件分段统计详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'EndTime' => [
'description' => '结束时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552225753000',
],
'StartTime' => [
'description' => '开始时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552225770000',
],
'Count' => [
'description' => '事件发生数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '2',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"486029C9-53E1-44B4-85A8-16A571A043FD\\",\\n \\"Success\\": \\"true\\",\\n \\"SystemEventHistograms\\": {\\n \\"SystemEventHistogram\\": [\\n {\\n \\"EndTime\\": 1552225753000,\\n \\"StartTime\\": 1552225770000,\\n \\"Count\\": 2\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\tE38CA81A-A012-4C59-B694-42AAFBE27ED2\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671700000\\r\\n\\t\\t\\t\\t1593671684000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671730000\\r\\n\\t\\t\\t\\t1593671700000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671760000\\r\\n\\t\\t\\t\\t1593671730000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671790000\\r\\n\\t\\t\\t\\t1593671760000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671820000\\r\\n\\t\\t\\t\\t1593671790000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671850000\\r\\n\\t\\t\\t\\t1593671820000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671880000\\r\\n\\t\\t\\t\\t1593671850000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671910000\\r\\n\\t\\t\\t\\t1593671880000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671940000\\r\\n\\t\\t\\t\\t1593671910000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593671970000\\r\\n\\t\\t\\t\\t1593671940000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672000000\\r\\n\\t\\t\\t\\t1593671970000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672030000\\r\\n\\t\\t\\t\\t1593672000000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672060000\\r\\n\\t\\t\\t\\t1593672030000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672090000\\r\\n\\t\\t\\t\\t1593672060000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672120000\\r\\n\\t\\t\\t\\t1593672090000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672150000\\r\\n\\t\\t\\t\\t1593672120000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672180000\\r\\n\\t\\t\\t\\t1593672150000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672210000\\r\\n\\t\\t\\t\\t1593672180000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672240000\\r\\n\\t\\t\\t\\t1593672210000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672270000\\r\\n\\t\\t\\t\\t1593672240000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672300000\\r\\n\\t\\t\\t\\t1593672270000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672330000\\r\\n\\t\\t\\t\\t1593672300000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672360000\\r\\n\\t\\t\\t\\t1593672330000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672390000\\r\\n\\t\\t\\t\\t1593672360000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672420000\\r\\n\\t\\t\\t\\t1593672390000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672450000\\r\\n\\t\\t\\t\\t1593672420000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672480000\\r\\n\\t\\t\\t\\t1593672450000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672510000\\r\\n\\t\\t\\t\\t1593672480000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672540000\\r\\n\\t\\t\\t\\t1593672510000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672570000\\r\\n\\t\\t\\t\\t1593672540000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1593672584000\\r\\n\\t\\t\\t\\t1593672570000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n\\r\\n","errorExample":""}]',
'title' => '查询系统事件的时段数量分布图(柱状图)',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSystemEventMetaList' => [
'summary' => '调用DescribeSystemEventMetaList接口查询系统事件的Meta信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'A6582C8B-E67C-4A19-BC15-EAEFEBDC7995',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Data' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => 'Meta返回信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Status' => [
'description' => '事件状态。',
'type' => 'string',
'example' => 'failed',
],
'EventType' => [
'description' => '事件类型。取值:'."\n"
."\n"
.'- StatusNotification:故障通知。'."\n"
."\n"
.'- Exception:异常。'."\n"
."\n"
.'- Maintenance:运维。',
'type' => 'string',
'example' => 'Exception',
],
'Product' => [
'description' => '产品名称缩写。',
'type' => 'string',
'example' => 'ADS',
],
'NameDesc' => [
'description' => '事件名称的描述信息。',
'type' => 'string',
'example' => '查询失败率高',
],
'NameDesc.En' => [
'description' => '英文事件名称的描述信息。',
'type' => 'string',
'example' => 'High query failure rate.',
],
'Name' => [
'description' => '事件名称。',
'type' => 'string',
'example' => 'SelectFailureRate',
],
'StatusDesc' => [
'description' => '事件状态描述。',
'type' => 'string',
'example' => 'Operation Failed',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- CRITICAL:紧急。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'example' => 'INFO',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"A6582C8B-E67C-4A19-BC15-EAEFEBDC7995\\",\\n \\"Success\\": true,\\n \\"Data\\": {\\n \\"Resource\\": [\\n {\\n \\"Status\\": \\"failed\\",\\n \\"EventType\\": \\"Exception\\",\\n \\"Product\\": \\"ADS\\",\\n \\"NameDesc\\": \\"查询失败率高\\",\\n \\"NameDesc.En\\": \\"High query failure rate.\\",\\n \\"Name\\": \\"SelectFailureRate\\",\\n \\"StatusDesc\\": \\"Operation Failed\\",\\n \\"Level\\": \\"INFO\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t46350DCE-3399-473B-875F-1340DC97186C\\r\\n\\t\\tsuccess\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tFailed\\r\\n\\t\\t\\t\\tOperationFailed\\r\\n\\t\\t\\t\\t插入失败率10%\\r\\n\\t\\t\\t\\tInsertFailureRate\\r\\n\\t\\t\\t\\tException\\r\\n\\t\\t\\t\\tADS\\r\\n\\t\\t\\t\\tCRITICAL\\r\\n\\t\\t\\t\\tInsertFailureRate\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tFailed\\r\\n\\t\\t\\t\\tOptionFailed\\r\\n\\t\\t\\t\\t查询失败率10%\\r\\n\\t\\t\\t\\tSelectFailureRate\\r\\n\\t\\t\\t\\tException\\r\\n\\t\\t\\t\\tADS\\r\\n\\t\\t\\t\\tCRITICAL\\r\\n\\t\\t\\t\\tSelectFailureRate\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tFailed\\r\\n\\t\\t\\t\\tOperation Failed\\r\\n\\t\\t\\t\\t磁盘使用率80%\\r\\n\\t\\t\\t\\tStorageUsage\\r\\n\\t\\t\\t\\tMaintenance\\r\\n\\t\\t\\t\\tADS\\r\\n\\t\\t\\t\\tCRITICAL\\r\\n\\t\\t\\t\\tStorageUsage\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tEightyPercentQuotaExceeded\\r\\n\\t\\t\\t\\t超过Quota 80%事件\\r\\n\\t\\t\\t\\t超过Quota 80%事件\\r\\n\\t\\t\\t\\tEightyPercentQuotaExceeded:Route\\r\\n\\t\\t\\t\\t80%QuotaExceeded\\r\\n\\t\\t\\t\\tCEN\\r\\n\\t\\t\\t\\tWARN\\r\\n\\t\\t\\t\\tEightyPercentQuotaExceeded:Route\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tNinetyEightPercentQuotaExceeded\\r\\n\\t\\t\\t\\t超过Quota 98%事件\\r\\n\\t\\t\\t\\t超过Quota 98%事件\\r\\n\\t\\t\\t\\tNinetyEightPercentQuotaExceeded:Route\\r\\n\\t\\t\\t\\t98%QuotaExceeded\\r\\n\\t\\t\\t\\tCEN\\r\\n\\t\\t\\t\\tWARN\\r\\n\\t\\t\\t\\tNinetyEightPercentQuotaExceeded:Route\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询系统事件的Meta信息',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSystemEventAttribute' => [
'summary' => '调用DescribeSystemEventAttribute接口查询系统事件详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '产品名称缩写。'."\n"
."\n"
.'>关于产品名称缩写的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'oss',
],
],
[
'name' => 'EventType',
'in' => 'query',
'schema' => [
'description' => '事件类型。'."\n"
."\n"
.'>关于事件类型的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'Exception',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '事件名称。'."\n"
."\n"
.'>关于事件名称的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'BucketIngressBandwidth',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '事件级别。取值:'."\n"
."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'required' => false,
'example' => 'CRITICAL',
],
],
[
'name' => 'Status',
'in' => 'query',
'schema' => [
'description' => '事件状态。'."\n"
."\n"
.'>关于事件状态的取值,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'normal',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '12346',
],
],
[
'name' => 'SearchKeywords',
'in' => 'query',
'schema' => [
'description' => '搜索事件内容包含的关键字。取值:'."\n"
."\n"
.'- 如果您待搜索事件的内容中包括a和b,可以搜索`a and b`。'."\n"
."\n"
.'- 如果您待搜索事件的内容中包括a或b,可以搜索`a or b`。'."\n",
'type' => 'string',
'required' => false,
'example' => 'cms',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552199984949',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552221584949',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'取值范围:1~100000000。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。'."\n"
."\n"
.'取值范围:1~100。'."\n"
."\n"
.'默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。当操作成功时,返回`success`;当操作失败时,返回错误信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '60912C8D-B340-4253-ADE7-61ACDFD25CFC',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'string',
'example' => 'true',
],
'SystemEvents' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SystemEvent' => [
'description' => '事件内容详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Status' => [
'description' => '事件状态。',
'type' => 'string',
'example' => 'normal',
],
'Time' => [
'description' => '事件发生的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552199984000',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '12345',
],
'Product' => [
'description' => '产品名称缩写。',
'type' => 'string',
'example' => 'CloudMonitor',
],
'InstanceName' => [
'description' => '实例名称。',
'type' => 'string',
'example' => 'instanceId1',
],
'ResourceId' => [
'description' => '资源ID。',
'type' => 'string',
'example' => 'xxxxx-1',
],
'Name' => [
'description' => '事件名称。',
'type' => 'string',
'example' => 'Agent_Status_Stopped',
],
'Content' => [
'description' => '事件内容详情。',
'type' => 'string',
'example' => '[{"product":"CloudMonitor","content":"{\\"ipGroup\\":\\"112.126.XX.XX,10.163.XX.XX\\",\\"tianjimonVersion\\":\\"1.2.22\\"}","groupId":"176,177,178,179,180,692,120812,1663836,96,2028302","time":"1552209568000","resourceId":"acs:ecs:cn-beijing:173651113438****:instance/i-25k35****","level":"CRITICAL","status":"stopped","instanceName":"cmssiteprobebj-6","name":"Agent_Status_Stopped","regionId":"cn-beijing"}]',
],
'Level' => [
'description' => '事件级别。取值:'."\n"
."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'example' => 'WARN',
],
'RegionId' => [
'description' => '地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'Id' => [
'description' => '事件ID。',
'type' => 'string',
'example' => 'b936efc9-f621-4e8a-a6eb-076be40e****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Parameter invalid.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"60912C8D-B340-4253-ADE7-61ACDFD25CFC\\",\\n \\"Success\\": \\"true\\",\\n \\"SystemEvents\\": {\\n \\"SystemEvent\\": [\\n {\\n \\"Status\\": \\"normal\\",\\n \\"Time\\": 1552199984000,\\n \\"GroupId\\": \\"12345\\",\\n \\"Product\\": \\"CloudMonitor\\",\\n \\"InstanceName\\": \\"instanceId1\\",\\n \\"ResourceId\\": \\"xxxxx-1\\",\\n \\"Name\\": \\"Agent_Status_Stopped\\",\\n \\"Content\\": \\"[{\\\\\\"product\\\\\\":\\\\\\"CloudMonitor\\\\\\",\\\\\\"content\\\\\\":\\\\\\"{\\\\\\\\\\\\\\"ipGroup\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"112.126.XX.XX,10.163.XX.XX\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"tianjimonVersion\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"1.2.22\\\\\\\\\\\\\\"}\\\\\\",\\\\\\"groupId\\\\\\":\\\\\\"176,177,178,179,180,692,120812,1663836,96,2028302\\\\\\",\\\\\\"time\\\\\\":\\\\\\"1552209568000\\\\\\",\\\\\\"resourceId\\\\\\":\\\\\\"acs:ecs:cn-beijing:173651113438****:instance/i-25k35****\\\\\\",\\\\\\"level\\\\\\":\\\\\\"CRITICAL\\\\\\",\\\\\\"status\\\\\\":\\\\\\"stopped\\\\\\",\\\\\\"instanceName\\\\\\":\\\\\\"cmssiteprobebj-6\\\\\\",\\\\\\"name\\\\\\":\\\\\\"Agent_Status_Stopped\\\\\\",\\\\\\"regionId\\\\\\":\\\\\\"cn-beijing\\\\\\"}]\\",\\n \\"Level\\": \\"WARN\\",\\n \\"RegionId\\": \\"cn-hangzhou\\",\\n \\"Id\\": \\"b936efc9-f621-4e8a-a6eb-076be40e****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tnormal\\r\\n\\t\\t\\t\\tinstanceId1\\r\\n\\t\\t\\t\\txxxxx-1\\r\\n\\t\\t\\t\\t[{\\\\\\"product\\\\\\":\\\\\\"CloudMonitor\\\\\\",\\\\\\"content\\\\\\":\\\\\\"{\\\\\\\\\\\\\\"ipGroup\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"112.126.XX.XX,10.163.XX.XX\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"tianjimonVersion\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"1.2.22\\\\\\\\\\\\\\"}\\\\\\",\\\\\\"groupId\\\\\\":\\\\\\"176,177,178,179,180,692,120812,1663836,96,2028302\\\\\\",\\\\\\"time\\\\\\":\\\\\\"1552209568000\\\\\\",\\\\\\"resourceId\\\\\\":\\\\\\"acs:ecs:cn-beijing:173651113438****:instance/i-25k35****\\\\\\",\\\\\\"level\\\\\\":\\\\\\"CRITICAL\\\\\\",\\\\\\"status\\\\\\":\\\\\\"stopped\\\\\\",\\\\\\"instanceName\\\\\\":\\\\\\"cmssiteprobebj-6\\\\\\",\\\\\\"name\\\\\\":\\\\\\"Agent_Status_Stopped\\\\\\",\\\\\\"regionId\\\\\\":\\\\\\"cn-beijing\\\\\\"}]\\r\\n\\t\\t\\t\\tCloudMonitor\\r\\n\\t\\t\\t\\tWARN\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tcn-hangzhou\\r\\n\\t\\t\\t\\tAgent_Status_Stopped\\r\\n\\t\\t\\t\\t12345\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\tsuccess\\r\\n\\t\\t60912C8D-B340-4253-ADE7-61ACDFD25CFC\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询系统事件详情',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSystemEventCount' => [
'summary' => '调用DescribeSystemEventCount接口查询当前账号下各云服务发生事件的数量。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '云服务名称。'."\n"
."\n"
.'调用DescribeSystemEventMetaList接口,获取返回参数`Product`的值,即可获得当前阿里云账号下所有事件的云服务名称。更多信息,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
[
'name' => 'EventType',
'in' => 'query',
'schema' => [
'description' => '事件类型。'."\n"
."\n"
.'调用DescribeSystemEventMetaList接口,获取返回参数`EventType`的值,即可获得当前阿里云账号下所有云服务的事件类型。更多信息,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'StatusNotification',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '事件名称。'."\n"
."\n"
.'调用DescribeSystemEventMetaList接口,获取返回参数`Name`的值,即可获得当前阿里云账号下所有云服务的事件名称。更多信息,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'Instance:StateChange',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '事件级别。取值:'."\n"
."\n"
.'- Critical:严重。'."\n"
."\n"
.'- Warn:警告。'."\n"
."\n"
.'- Info:信息。'."\n"
."\n"
.'调用DescribeSystemEventMetaList接口,获取返回参数`Level`的值,即可获得当前阿里云账号下所有云服务的事件级别。更多信息,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'Info',
],
],
[
'name' => 'Status',
'in' => 'query',
'schema' => [
'description' => '事件状态。'."\n"
."\n"
.'调用DescribeSystemEventMetaList接口,获取返回参数`Status`的值,即可获得当前阿里云账号下所有云服务的事件状态。更多信息,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => false,
'example' => 'Normal',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '17285****',
],
],
[
'name' => 'SearchKeywords',
'in' => 'query',
'schema' => [
'description' => '搜索事件内容包含的关键字。取值:'."\n"
."\n"
.'- 如果您需要搜索事件的内容中包括a和b,则可以搜索`a and b`。'."\n"
."\n"
.'- 如果您需要搜索事件的内容中包括a或b,可以搜索`a or b`。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询事件开始的时间戳。单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1635993541000',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询事件结束的时间戳。单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1635993921000',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。'."\n"
."\n"
.'当请求成功时,返回成功信息;当请求失败时,返回失败原因。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C7A7B776-0ACE-5A93-9B07-DE8008D9CCDF',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'SystemEventCounts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SystemEventCount' => [
'description' => '事件详情。',
'type' => 'array',
'items' => [
'description' => '事件详情。',
'type' => 'object',
'properties' => [
'Status' => [
'description' => '事件状态。',
'type' => 'string',
'example' => 'Normal',
],
'Time' => [
'description' => '事件发生的时间戳。单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1635993751000',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '17285****',
],
'Product' => [
'description' => '事件的云服务名称。',
'type' => 'string',
'example' => 'ECS',
],
'InstanceName' => [
'description' => '实例名称。',
'type' => 'string',
'example' => 'ECS-test',
],
'Num' => [
'description' => '发生事件的数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '3',
],
'ResourceId' => [
'description' => '资源ID。',
'type' => 'string',
'example' => 'i-rj99xc6cptkk64ml****',
],
'Name' => [
'description' => '事件名称。',
'type' => 'string',
'example' => 'Instance:StateChange',
],
'Content' => [
'description' => '事件描述。',
'type' => 'string',
'example' => '实例状态改变通知',
],
'Level' => [
'description' => '事件级别。取值:'."\n"
."\n"
.'- Critical:严重。'."\n"
."\n"
.'- Warn:警告。'."\n"
."\n"
.'- Info:信息。',
'type' => 'string',
'example' => 'Info',
],
'RegionId' => [
'description' => '地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"C7A7B776-0ACE-5A93-9B07-DE8008D9CCDF\\",\\n \\"Success\\": \\"true\\",\\n \\"SystemEventCounts\\": {\\n \\"SystemEventCount\\": [\\n {\\n \\"Status\\": \\"Normal\\",\\n \\"Time\\": 1635993751000,\\n \\"GroupId\\": \\"17285****\\",\\n \\"Product\\": \\"ECS\\",\\n \\"InstanceName\\": \\"ECS-test\\",\\n \\"Num\\": 3,\\n \\"ResourceId\\": \\"i-rj99xc6cptkk64ml****\\",\\n \\"Name\\": \\"Instance:StateChange\\",\\n \\"Content\\": \\"实例状态改变通知\\",\\n \\"Level\\": \\"Info\\",\\n \\"RegionId\\": \\"cn-hangzhou\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccess\\r\\n\\tC7A7B776-0ACE-5A93-9B07-DE8008D9CCDF\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t3\\r\\n\\t\\t\\tECS\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tInstance:StateChange\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询当前账号下各云服务发生事件的数量',
'description' => '### 背景信息'."\n"
.'您可以调用[DescribeSystemEventMetaList](~~114972~~),获取云监控支持的各云服务及其系统事件。'."\n"
.'### 使用说明'."\n"
.'本文将提供一个示例,查询当前账号云服务器`ECS`发生事件的数量,返回结果显示,发生事件的数量共3条。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。'."\n"
."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMonitorResourceQuotaAttribute' => [
'summary' => '调用DescribeMonitorResourceQuotaAttribute接口查询云监控各个资源的配额。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'ShowUsed',
'in' => 'query',
'schema' => [
'description' => '返回值是否包含已使用配额。取值:'."\n"
.'- true(默认值):包含。'."\n"
.'- false:不包含。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
'default' => 'true',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '31BC7201-00F2-47B2-B7B9-6A173076ACE',
],
'ResourceQuota' => [
'description' => '云监控的配额详情。',
'type' => 'object',
'properties' => [
'SuitInfo' => [
'description' => '云监控当前版本。取值:'."\n"
.'- free:免费版。'."\n"
.'- pro:专业版。'."\n"
.'- cms_post:后付费。',
'type' => 'string',
'example' => 'pro',
],
'InstanceId' => [
'description' => '预付费套餐ID。',
'type' => 'string',
'example' => 'cms_edition-cn-n6w20rn****',
],
'ExpireTime' => [
'description' => '套餐到期时间。',
'type' => 'string',
'example' => '2021-02-28',
],
'SiteMonitorEcsProbe' => [
'description' => '站点监控ECS探测点配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '站点监控ECS探测点的总配额。'."\n"
."\n"
.'> 单个站点监控任务能够选择的最大ECS探测点的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'QuotaPackage' => [
'description' => '套餐包内站点监控ECS探测点的配额。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'QuotaUsed' => [
'description' => '套餐包内站点监控ECS探测点的配额使用量。'."\n"
."\n"
.'> 目前已创建的所有站点监控任务的总ECS探测点数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '20',
],
],
],
'SiteMonitorOperatorProbe' => [
'description' => '站点监控运营商探测点配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '站点监控运营商探测点的总配额。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'QuotaPackage' => [
'description' => '套餐包内站点监控运营商探测点的配额。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'QuotaUsed' => [
'description' => '套餐包内站点监控运营商探测点的配额使用量。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
],
],
'SiteMonitorTask' => [
'description' => '站点监控任务配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '站点监控任务的总配额。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '25',
],
'QuotaPackage' => [
'description' => '套餐包内站点监控任务的配额。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '20',
],
'QuotaUsed' => [
'description' => '套餐包内站点监控任务的配额使用量。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '15',
],
],
],
'SiteMonitorBrowser' => [
'description' => '浏览器拨测任务数配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '浏览器拨测任务数的总配额。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'QuotaPackage' => [
'description' => '套餐内浏览器拨测任务数的配额。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'QuotaUsed' => [
'description' => '套餐内浏览器拨测任务数的配额用量。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '15',
],
],
],
'SiteMonitorMobile' => [
'description' => '移动端拨测任务数配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '移动端拨测任务数配额总量。 单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'QuotaPackage' => [
'description' => '套餐内移动端拨测任务数配额。 单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'QuotaUsed' => [
'description' => '套餐内移动端拨测任务数配额用量。 单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '15',
],
],
],
'CustomMonitor' => [
'description' => '自定义监控配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '自定义监控时间序列的总配额。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '1200',
],
'QuotaPackage' => [
'description' => '套餐内自定义监控时间序列的配额。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '1000',
],
'QuotaUsed' => [
'description' => '套餐内自定义监控时间序列的配额用量。单位:个。',
'type' => 'integer',
'format' => 'int32',
'example' => '8',
],
],
],
'EventMonitor' => [
'description' => '事件监控配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '事件监控的总配额。单位:万。',
'type' => 'integer',
'format' => 'int32',
'example' => '55',
],
'QuotaPackage' => [
'description' => '套餐包内事件监控的配额。单位:万。',
'type' => 'integer',
'format' => 'int32',
'example' => '50',
],
'QuotaUsed' => [
'description' => '套餐包内事件监控的配额用量。单位:万。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
],
],
'LogMonitor' => [
'description' => '日志监控配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '日志监控的总配额。单位:MByte/Min。',
'type' => 'integer',
'format' => 'int32',
'example' => '150',
],
'QuotaPackage' => [
'description' => '套餐包内日志监控的配额。单位:MByte/Min。',
'type' => 'integer',
'format' => 'int32',
'example' => '150',
],
'QuotaUsed' => [
'description' => '套餐包内日志监控的配额使用量。单位:MByte/Min。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
],
],
'Api' => [
'description' => 'API配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => 'API总配额。单位:万次。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'QuotaPackage' => [
'description' => '套餐内API的配额。单位:万次。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'QuotaUsed' => [
'description' => '套餐内API的配额用量。单位:次。',
'type' => 'integer',
'format' => 'int32',
'example' => '9987',
],
],
],
'SMS' => [
'description' => '报警短信包配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '报警短信的总配额。单位:条。',
'type' => 'integer',
'format' => 'int32',
'example' => '550',
],
'QuotaPackage' => [
'description' => '报警短信包的配额。单位:条。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'QuotaUsed' => [
'description' => '报警短信包的配额使用量。单位:条。',
'type' => 'integer',
'format' => 'int32',
'example' => '38',
],
],
],
'Phone' => [
'description' => '报警电话包配额。',
'type' => 'object',
'properties' => [
'QuotaLimit' => [
'description' => '报警电话的总配额。单位:通。',
'type' => 'integer',
'format' => 'int32',
'example' => '550',
],
'QuotaPackage' => [
'description' => '报警电话包的配额。单位:通。',
'type' => 'integer',
'format' => 'int32',
'example' => '500',
],
'QuotaUsed' => [
'description' => '报警电话包的配额使用量。单位:通。',
'type' => 'integer',
'format' => 'int32',
'example' => '100',
],
],
],
'EnterpriseQuota' => [
'description' => '企业云监控配额详情。',
'type' => 'object',
'properties' => [
'SuitInfo' => [
'description' => '企业云监控描述。',
'type' => 'string',
'example' => 'ENTERPRISE',
],
'InstanceId' => [
'description' => '企业云监控实例ID。',
'type' => 'string',
'example' => 'cms_enterprise_public_cn-7mz27pd****',
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"31BC7201-00F2-47B2-B7B9-6A173076ACE\\",\\n \\"ResourceQuota\\": {\\n \\"SuitInfo\\": \\"pro\\",\\n \\"InstanceId\\": \\"cms_edition-cn-n6w20rn****\\",\\n \\"ExpireTime\\": \\"2021-02-28\\",\\n \\"SiteMonitorEcsProbe\\": {\\n \\"QuotaLimit\\": 5,\\n \\"QuotaPackage\\": 5,\\n \\"QuotaUsed\\": 20\\n },\\n \\"SiteMonitorOperatorProbe\\": {\\n \\"QuotaLimit\\": 5,\\n \\"QuotaPackage\\": 5,\\n \\"QuotaUsed\\": 0\\n },\\n \\"SiteMonitorTask\\": {\\n \\"QuotaLimit\\": 25,\\n \\"QuotaPackage\\": 20,\\n \\"QuotaUsed\\": 15\\n },\\n \\"SiteMonitorBrowser\\": {\\n \\"QuotaLimit\\": 50,\\n \\"QuotaPackage\\": 50,\\n \\"QuotaUsed\\": 15\\n },\\n \\"SiteMonitorMobile\\": {\\n \\"QuotaLimit\\": 50,\\n \\"QuotaPackage\\": 50,\\n \\"QuotaUsed\\": 15\\n },\\n \\"CustomMonitor\\": {\\n \\"QuotaLimit\\": 1200,\\n \\"QuotaPackage\\": 1000,\\n \\"QuotaUsed\\": 8\\n },\\n \\"EventMonitor\\": {\\n \\"QuotaLimit\\": 55,\\n \\"QuotaPackage\\": 50,\\n \\"QuotaUsed\\": 2\\n },\\n \\"LogMonitor\\": {\\n \\"QuotaLimit\\": 150,\\n \\"QuotaPackage\\": 150,\\n \\"QuotaUsed\\": 80\\n },\\n \\"Api\\": {\\n \\"QuotaLimit\\": 500,\\n \\"QuotaPackage\\": 500,\\n \\"QuotaUsed\\": 9987\\n },\\n \\"SMS\\": {\\n \\"QuotaLimit\\": 550,\\n \\"QuotaPackage\\": 500,\\n \\"QuotaUsed\\": 38\\n },\\n \\"Phone\\": {\\n \\"QuotaLimit\\": 550,\\n \\"QuotaPackage\\": 500,\\n \\"QuotaUsed\\": 100\\n },\\n \\"EnterpriseQuota\\": {\\n \\"SuitInfo\\": \\"ENTERPRISE\\",\\n \\"InstanceId\\": \\"cms_enterprise_public_cn-7mz27pd****\\"\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t1E1961C4-B340-45D7-8CC3-F7D0BF19F2E0\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t5\\r\\n\\t\\t\\t5\\r\\n\\t\\t\\r\\n\\t\\tcms_edition-cn-n6w20rn****\\r\\n\\t\\t\\r\\n\\t\\t\\t100\\r\\n\\t\\t\\t500\\r\\n\\t\\t\\t550\\r\\n\\t\\t\\r\\n\\t\\tpro\\r\\n\\t\\t\\r\\n\\t\\t\\t7\\r\\n\\t\\t\\t20\\r\\n\\t\\t\\t20\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t38\\r\\n\\t\\t\\t500\\r\\n\\t\\t\\t550\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t50\\r\\n\\t\\t\\t50\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t9987\\r\\n\\t\\t\\t500\\r\\n\\t\\t\\t500\\r\\n\\t\\t\\r\\n\\t\\t2021-02-28\\r\\n\\t\\t\\r\\n\\t\\t\\t20\\r\\n\\t\\t\\t5\\r\\n\\t\\t\\t5\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t8\\r\\n\\t\\t\\t1000\\r\\n\\t\\t\\t1200\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t2\\r\\n\\t\\t\\t50\\r\\n\\t\\t\\t55\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\t","errorExample":""}]',
'title' => '查询云监控各个资源的配额',
'requestParamsDescription' => ' 关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'SendDryRunSystemEvent' => [
'summary' => '调用SendDryRunSystemEvent接口调试云资源的系统事件。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '云服务名称。'."\n"
."\n"
.'>事件支持的云服务,详细信息请参见[云服务系统事件](~~167388~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ecs',
],
],
[
'name' => 'EventName',
'in' => 'query',
'schema' => [
'description' => '事件名称。'."\n"
."\n"
.'>详细信息请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'Agent_Status_Stopped',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '123456',
],
],
[
'name' => 'EventContent',
'in' => 'query',
'schema' => [
'description' => '事件内容。'."\n"
."\n"
.'>该参数的取值可以为任意一个合法的JSON,建议JSON中包含关键字值`product`、`resourceId`和`regionId`。'."\n",
'type' => 'string',
'required' => false,
'example' => '{"product":"CloudMonitor","resourceId":"acs:ecs:cn-hongkong:173651113438****:instance/{instanceId}","level":"CRITICAL","instanceName":"instanceName","regionId":"cn-hangzhou","name":"Agent_Status_Stopped","content":{"ipGroup":"0.0.0.0,0.0.0.1","tianjimonVersion":"1.2.11"},"status":"stopped"}',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '486029C9-53E1-44B4-85A8-16A571A043FD',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"486029C9-53E1-44B4-85A8-16A571A043FD\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccess\\r\\n\\t590FB642-5FFE-4AE0-883B-E1323DD20541\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '调试云资源的系统事件',
'description' => '本接口用于调试资源配置的触发逻辑是否符合预期,即通过调用该接口发送一条测试事件,帮助您验证对应的事件触发报警后返回的内容是否符合预期。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeCustomEventCount' => [
'summary' => '调用DescribeCustomEventCount接口查询自定义事件的统计结果。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '事件名称。',
'type' => 'string',
'required' => false,
'example' => 'BABEL_BUY',
],
],
[
'name' => 'EventId',
'in' => 'query',
'schema' => [
'description' => '事件ID。',
'type' => 'string',
'required' => false,
'example' => '123',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '12345',
],
],
[
'name' => 'SearchKeywords',
'in' => 'query',
'schema' => [
'description' => '搜索事件内容包含的关键字。'."\n"
."\n"
.'- 如果您待搜索事件的内容中包括A和B,则可以搜索A和B。'."\n"
.'- 如果您待搜索事件的内容中包括A或B,则可以搜索A或B。',
'type' => 'string',
'required' => false,
'example' => 'cms',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552209685596',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552220485596',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。当请求成功时,返回成功信息;当请求失败时,返回失败原因。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '60912C8D-B340-4253-ADE7-61ACDFD25CFC',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
'CustomEventCounts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'CustomEventCount' => [
'description' => '自定义事件详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Time' => [
'description' => '事件发生的时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552267615000',
],
'Num' => [
'description' => '事件数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '20',
],
'Name' => [
'description' => '事件名称。',
'type' => 'string',
'example' => 'BABEL_BUY',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"60912C8D-B340-4253-ADE7-61ACDFD25CFC\\",\\n \\"Success\\": true,\\n \\"CustomEventCounts\\": {\\n \\"CustomEventCount\\": [\\n {\\n \\"Time\\": 1552267615000,\\n \\"Num\\": 20,\\n \\"Name\\": \\"BABEL_BUY\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t\\n\\t\\t\\t\\n\\t\\t\\t\\tBABEL_BUY\\n\\t\\t\\t\\t\\n\\t\\t\\t\\t20\\n\\t\\t\\t\\n\\t\\t\\n\\t\\tsuccess\\n\\t\\t38D3C270-6799-4461-AA55-7975352140C1\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '查询自定义事件的统计结果',
'description' => '>此API以产品为维度统计每个产品自定义事件的数量。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeCustomEventHistogram' => [
'summary' => '调用DescribeCustomEventHistogram接口查询自定义上报事件的分时段数量分布图。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '事件名称。',
'type' => 'string',
'required' => false,
'example' => 'BucketIngressBandwidth',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '事件级别。取值:'."\n"
.'- CRITICAL:严重'."\n"
.'- WARN:警告'."\n"
.'- INFO:信息',
'type' => 'string',
'required' => false,
'example' => 'CRITICAL',
],
],
[
'name' => 'EventId',
'in' => 'query',
'schema' => [
'description' => '事件ID。',
'type' => 'string',
'required' => false,
'example' => '123',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '12345',
],
],
[
'name' => 'SearchKeywords',
'in' => 'query',
'schema' => [
'description' => '搜索事件内容包含的关键字。'."\n"
."\n"
.'- 如果您待搜索事件的内容中包括A和B,则可以搜索A和B。'."\n"
.'- 如果您待搜索事件的内容中包括A或B,则可以搜索A或B。',
'type' => 'string',
'required' => false,
'example' => 'cms',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552209685596',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552220485596',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。当请求成功时,返回成功信息;当请求失败时,返回失败原因。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '486029C9-53E1-44B4-85A8-16A571A043FD',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'string',
'example' => 'true',
],
'EventHistograms' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'EventHistogram' => [
'description' => '自定义事件统计数据列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'EndTime' => [
'description' => '结束时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552226750000',
],
'StartTime' => [
'description' => '开始时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552226740000',
],
'Count' => [
'description' => '事件发生的数量。',
'type' => 'integer',
'format' => 'int64',
'example' => '3',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"486029C9-53E1-44B4-85A8-16A571A043FD\\",\\n \\"Success\\": \\"true\\",\\n \\"EventHistograms\\": {\\n \\"EventHistogram\\": [\\n {\\n \\"EndTime\\": 1552226750000,\\n \\"StartTime\\": 1552226740000,\\n \\"Count\\": 3\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\tsuccess\\r\\n\\t\\t5977C7EE-E727-4EC4-B756-ECC8CB820CF4\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1596000690000\\r\\n\\t\\t\\t\\t1596000689000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1596000720000\\r\\n\\t\\t\\t\\t1596000690000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1596000930000\\r\\n\\t\\t\\t\\t1596000900000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1596000960000\\r\\n\\t\\t\\t\\t1596000930000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t1596000990000\\r\\n\\t\\t\\t\\t1596000960000\\r\\n\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n\\r\\n","errorExample":""}]',
'title' => '查询自定义上报事件的分时段数量分布图',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeCustomEventAttribute' => [
'summary' => '调用DescribeCustomEventAttribute接口查询自定义事件的详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '事件名称。',
'type' => 'string',
'required' => false,
'example' => 'test123',
],
],
[
'name' => 'EventId',
'in' => 'query',
'schema' => [
'description' => '事件ID。',
'type' => 'string',
'required' => false,
'example' => '123****',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '123****',
],
],
[
'name' => 'SearchKeywords',
'in' => 'query',
'schema' => [
'description' => '搜索事件内容包含的关键字。'."\n"
."\n"
.'- 如果您待搜索事件的内容中包括A和B,则可以搜索A和B。'."\n"
.'- 如果您待搜索事件的内容中包括A或B,则可以搜索A或B。',
'type' => 'string',
'required' => false,
'example' => 'cms',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552224365971',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'required' => false,
'example' => '1552227965971',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页记录条数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '50',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'userId:173651113438**** and name:"BABEL_CHECK"',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '60912C8D-B340-4253-ADE7-61ACDFD25CFC',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'CustomEvents' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'CustomEvent' => [
'description' => '事件详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Time' => [
'description' => '事件发生的时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'string',
'example' => '1552199984000',
],
'Name' => [
'description' => '事件名称。',
'type' => 'string',
'example' => 'BABEL_CHECK',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '12345',
],
'Content' => [
'description' => '上报事件详情。',
'type' => 'string',
'example' => 'requestId:4975A6F3-19AC-4C01-BAD2-034DA07FEBB5, info:{"autoPay":false,"autoUseCoupon":false,"bid":"26842","buyerId":118935342242****,"commodities":[{"aliyunProduceCode":"cms","chargeType":"PREPAY","commodityCode":"cms_call_num","components":[{"componentCode":"phone_count","instanceProperty":[{"code":"phone_count","value":"500"}],"moduleAttrStatus":1}],"duration":6,"free":false,"orderParams":{"aliyunProduceCode":"cms"},"orderType":"BUY","prePayPostCharge":false,"pricingCycle":"Month","quantity":1,"refundSpecCode":"","renewChange":false,"specCode":"cms_call_num","specUpdate":false,"syncToSubscription":false,"upgradeInquireFinancialValue":true}],"fromApp":"commonbuy","orderParams":{"priceCheck":"true"},"payerId":118935342242****,"requestId":"ade3ad32-f58b-45d7-add4-ac542be3d8ec","skipChannel":false,"userId":118935342242****}',
],
'Id' => [
'description' => '事件ID。',
'type' => 'string',
'example' => '123',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"userId:173651113438**** and name:\\\\\\"BABEL_CHECK\\\\\\"\\",\\n \\"RequestId\\": \\"60912C8D-B340-4253-ADE7-61ACDFD25CFC\\",\\n \\"Success\\": \\"true\\",\\n \\"CustomEvents\\": {\\n \\"CustomEvent\\": [\\n {\\n \\"Time\\": \\"1552199984000\\",\\n \\"Name\\": \\"BABEL_CHECK\\",\\n \\"GroupId\\": \\"12345\\",\\n \\"Content\\": \\"requestId:4975A6F3-19AC-4C01-BAD2-034DA07FEBB5, info:{\\\\\\"autoPay\\\\\\":false,\\\\\\"autoUseCoupon\\\\\\":false,\\\\\\"bid\\\\\\":\\\\\\"26842\\\\\\",\\\\\\"buyerId\\\\\\":118935342242****,\\\\\\"commodities\\\\\\":[{\\\\\\"aliyunProduceCode\\\\\\":\\\\\\"cms\\\\\\",\\\\\\"chargeType\\\\\\":\\\\\\"PREPAY\\\\\\",\\\\\\"commodityCode\\\\\\":\\\\\\"cms_call_num\\\\\\",\\\\\\"components\\\\\\":[{\\\\\\"componentCode\\\\\\":\\\\\\"phone_count\\\\\\",\\\\\\"instanceProperty\\\\\\":[{\\\\\\"code\\\\\\":\\\\\\"phone_count\\\\\\",\\\\\\"value\\\\\\":\\\\\\"500\\\\\\"}],\\\\\\"moduleAttrStatus\\\\\\":1}],\\\\\\"duration\\\\\\":6,\\\\\\"free\\\\\\":false,\\\\\\"orderParams\\\\\\":{\\\\\\"aliyunProduceCode\\\\\\":\\\\\\"cms\\\\\\"},\\\\\\"orderType\\\\\\":\\\\\\"BUY\\\\\\",\\\\\\"prePayPostCharge\\\\\\":false,\\\\\\"pricingCycle\\\\\\":\\\\\\"Month\\\\\\",\\\\\\"quantity\\\\\\":1,\\\\\\"refundSpecCode\\\\\\":\\\\\\"\\\\\\",\\\\\\"renewChange\\\\\\":false,\\\\\\"specCode\\\\\\":\\\\\\"cms_call_num\\\\\\",\\\\\\"specUpdate\\\\\\":false,\\\\\\"syncToSubscription\\\\\\":false,\\\\\\"upgradeInquireFinancialValue\\\\\\":true}],\\\\\\"fromApp\\\\\\":\\\\\\"commonbuy\\\\\\",\\\\\\"orderParams\\\\\\":{\\\\\\"priceCheck\\\\\\":\\\\\\"true\\\\\\"},\\\\\\"payerId\\\\\\":118935342242****,\\\\\\"requestId\\\\\\":\\\\\\"ade3ad32-f58b-45d7-add4-ac542be3d8ec\\\\\\",\\\\\\"skipChannel\\\\\\":false,\\\\\\"userId\\\\\\":118935342242****}\\",\\n \\"Id\\": \\"123\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n userId:173651113438**** and name:\\"BABEL_CHECK\\"\\r\\n 194A3F1D-8EA6-4922-BBF2-5F213AC7B648\\r\\n \\r\\n \\r\\n BABEL_CHECK\\r\\n \\r\\n E4407D77-72BA-4818-8644-39D119D7****\\r\\n requestId:BD524A26-A3DA-4133-A863-FF56B335797E, info:{\\"autoPay\\":false,\\"autoUseCoupon\\":false,\\"bid\\":\\"26842\\",\\"buyerId\\":118935342242****,\\"commodities\\":[{\\"aliyunProduceCode\\":\\"cms\\",\\"chargeType\\":\\"PREPAY\\",\\"commodityCode\\":\\"cms_edition\\",\\"components\\":[{\\"componentCode\\":\\"suggest_type\\",\\"instanceProperty\\":[{\\"code\\":\\"suggest_type\\",\\"value\\":\\"pro\\"}],\\"moduleAttrStatus\\":1},{\\"componentCode\\":\\"pay_type\\",\\"instanceProperty\\":[{\\"code\\":\\"pay_type\\",\\"value\\":\\"suggest\\"}],\\"moduleAttrStatus\\":1}],\\"duration\\":1,\\"free\\":false,\\"orderParams\\":{\\"aliyunProduceCode\\":\\"cms\\"},\\"orderType\\":\\"BUY\\",\\"prePayPostCharge\\":false,\\"pricingCycle\\":\\"Month\\",\\"quantity\\":1,\\"refundSpecCode\\":\\"\\",\\"renewChange\\":false,\\"specCode\\":\\"cms_edition\\",\\"specUpdate\\":false,\\"syncToSubscription\\":false,\\"upgradeInquireFinancialValue\\":true}],\\"fromApp\\":\\"commonbuy\\",\\"orderParams\\":{\\"priceCheck\\":\\"true\\"},\\"payerId\\":118935342242****,\\"requestId\\":\\"57d81d14-3c60-468e-b50a-1dfdb1594673\\",\\"skipChannel\\":false,\\"userId\\":118935342242****}\\r\\n 12345\\r\\n \\r\\n \\r\\n BABEL_CHECK\\r\\n \\r\\n D44FAC44-EB81-470A-909D-BD963FF9****\\r\\n requestId:14CC5306-0BAB-464F-B340-CF33AD306510, info:{\\"autoPay\\":false,\\"autoUseCoupon\\":false,\\"bid\\":\\"26842\\",\\"buyerId\\":118935342242****,\\"commodities\\":[{\\"aliyunProduceCode\\":\\"cms\\",\\"chargeType\\":\\"PREPAY\\",\\"commodityCode\\":\\"cms_smspackage\\",\\"components\\":[{\\"componentCode\\":\\"sms_count\\",\\"instanceProperty\\":[{\\"code\\":\\"sms_count\\",\\"value\\":\\"1000\\"}],\\"moduleAttrStatus\\":1}],\\"duration\\":6,\\"free\\":false,\\"orderParams\\":{\\"aliyunProduceCode\\":\\"cms\\"},\\"orderType\\":\\"BUY\\",\\"prePayPostCharge\\":false,\\"pricingCycle\\":\\"Month\\",\\"quantity\\":1,\\"refundSpecCode\\":\\"\\",\\"renewChange\\":false,\\"specCode\\":\\"cms_smspackage\\",\\"specUpdate\\":false,\\"syncToSubscription\\":false,\\"upgradeInquireFinancialValue\\":true}],\\"fromApp\\":\\"commonbuy\\",\\"orderParams\\":{\\"priceCheck\\":\\"true\\"},\\"payerId\\":118935342242****,\\"requestId\\":\\"64461412-31f2-4e52-a875-43bf1410bdf0\\",\\"skipChannel\\":false,\\"userId\\":118935342242****}\\r\\n 12345\\r\\n \\r\\n \\r\\n BABEL_CHECK\\r\\n \\r\\n 3AF6FE15-4F6E-459A-96F6-45C74F765209\\r\\n requestId:4975A6F3-19AC-4C01-BAD2-034DA07FEBB5, info:{\\"autoPay\\":false,\\"autoUseCoupon\\":false,\\"bid\\":\\"26842\\",\\"buyerId\\":118935342242****,\\"commodities\\":[{\\"aliyunProduceCode\\":\\"cms\\",\\"chargeType\\":\\"PREPAY\\",\\"commodityCode\\":\\"cms_call_num\\",\\"components\\":[{\\"componentCode\\":\\"phone_count\\",\\"instanceProperty\\":[{\\"code\\":\\"phone_count\\",\\"value\\":\\"500\\"}],\\"moduleAttrStatus\\":1}],\\"duration\\":6,\\"free\\":false,\\"orderParams\\":{\\"aliyunProduceCode\\":\\"cms\\"},\\"orderType\\":\\"BUY\\",\\"prePayPostCharge\\":false,\\"pricingCycle\\":\\"Month\\",\\"quantity\\":1,\\"refundSpecCode\\":\\"\\",\\"renewChange\\":false,\\"specCode\\":\\"cms_call_num\\",\\"specUpdate\\":false,\\"syncToSubscription\\":false,\\"upgradeInquireFinancialValue\\":true}],\\"fromApp\\":\\"commonbuy\\",\\"orderParams\\":{\\"priceCheck\\":\\"true\\"},\\"payerId\\":118935342242****,\\"requestId\\":\\"ade3ad32-f58b-45d7-add4-ac542be3d8ec\\",\\"skipChannel\\":false,\\"userId\\":118935342242****}\\r\\n 12345\\r\\n \\r\\n \\r\\n true\\r\\n 200\\r\\n","errorExample":""}]',
'title' => '查询自定义事件的详情',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutCustomEvent' => [
'summary' => '调用PutCustomEvent接口上报自定义事件的监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'EventInfo',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '事件信息列表。',
'type' => 'array',
'items' => [
'description' => '事件信息列表。',
'type' => 'object',
'properties' => [
'EventName' => [
'description' => '事件名称。N的取值范围:1~50。',
'type' => 'string',
'required' => true,
'example' => 'myEvent',
],
'Time' => [
'description' => '发生事件的时间。'."\n"
."\n"
.'格式:`yyyyMMddTHHmmss.SSSZ`(年月日时分秒.毫秒时区)。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 您还可以输入Unix时间(例如:1552199984000)。单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '20171013T170923.456+0800',
],
'GroupId' => [
'description' => '应用分组ID。N的取值范围:0~50。'."\n"
."\n"
.'默认值:0.0表示上报的事件不属于任何一个应用分组。',
'type' => 'string',
'required' => false,
'example' => '123456',
],
'Content' => [
'description' => '事件内容。N的取值范围:1~50。',
'type' => 'string',
'required' => true,
'example' => 'IOException',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 50,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '131DD9C8-9A32-4428-AD2E-4E3013B6E3A7',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"131DD9C8-9A32-4428-AD2E-4E3013B6E3A7\\"\\n}","errorExample":""},{"type":"xml","example":"success\\n131DD9C8-9A32-4428-AD2E-4E3013B6E3A7\\n200","errorExample":""}]',
'title' => '上报自定义事件的监控数据',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutCustomMetric' => [
'summary' => '调用PutCustomMetric接口上报自定义监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'MetricList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '监控数据列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Type' => [
'description' => '上报数值类型。N的取值范围:1~21。取值:'."\n"
."\n"
.'- 0:原始数据。'."\n"
.'- 1:聚合数据。'."\n"
."\n"
.'>当上报聚合数据时,建议周期为60秒和300秒的数据均上报,否则无法正常查询跨度大于7天的监控数据。',
'type' => 'string',
'required' => true,
'example' => '0',
],
'MetricName' => [
'description' => '监控项名称。N的取值范围:1~21。详情请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'cpu_total',
],
'Time' => [
'description' => '指标发生的时间。N的取值范围:1~21。支持以下两种类型:'."\n"
.'- UTC时间。格式:YYYY-MM-DDThh:mm:ssZ,例如:20171012T132456.888+0800。'."\n"
.'- Long型时间戳。例如:1508136760000。'."\n",
'type' => 'string',
'required' => false,
'example' => '1508136760000',
],
'GroupId' => [
'description' => '应用分组ID。N的取值范围:1~21。'."\n"
."\n"
.'> 如果监控项不属于任何应用分组, 则输入0。',
'type' => 'string',
'required' => true,
'example' => '12345',
],
'Values' => [
'description' => '指标值集合。N的取值范围:1~21。'."\n"
."\n"
.'>如果上报数值的类型为0,则上报的是原始值,云监控会按周期将原始值聚合为多个值,例如:最大、计数、求和等。'."\n",
'type' => 'string',
'required' => true,
'example' => '{"value":10.5}',
],
'Dimensions' => [
'description' => '维度Map,用于查询指定资源的监控数据。N的取值范围:1~21。'."\n"
."\n"
.'格式:key-value键值对形式的集合,常用的key-value集合为:`{"Key":"Value"}`。'."\n"
."\n"
.'Key和Value的长度为1~64个字符,超过64个字符时截取前64个。'."\n"
."\n"
.'Key和Value的取值可包含英文字母、数字、点号(.)、短划线(-)、下划线(_)、正斜线(/)和反斜线(\\)。'."\n"
."\n"
.'>Dimensions传入时需要使用JSON字符串表示该Map对象,必须按顺序传入。 ',
'type' => 'string',
'required' => true,
'example' => '{"sampleName1":"value1","sampleName2":"value2"}',
],
'Period' => [
'description' => '聚合周期。N的取值范围:1~21。单位:秒,取值:60或300。'."\n"
."\n"
.'>如果上报数值的类型为1,则需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request has failed due to a temporary failure of the server.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The request has failed due to a temporary failure of the server.\\",\\n \\"RequestId\\": \\"05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\t75D115CE-5DA8-4647-9073-8F72BB85B6F7\\n\\tsuccess\\n\\t200\\n","errorExample":""}]',
'title' => '上报自定义监控数据',
'description' => '> 推荐您使用企业云监控中的接口[PutHybridMonitorMetricData](~~383455~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutCustomMetricRule' => [
'summary' => '调用PutCustomMetricRule接口创建自定义监控报警规则。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '自定义监控数据所属应用分组ID。'."\n"
."\n"
.'> 0表示上报的自定义监控数据不属于任何一个应用分组。',
'type' => 'string',
'required' => false,
'example' => '7378****',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'> 如果报警规则ID已存在,则表示修改报警规则;如果报警规则ID不存在,则表示创建报警规则。',
'type' => 'string',
'required' => true,
'example' => 'MyRuleId1',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。',
'type' => 'string',
'required' => false,
'example' => 'CpuUsage',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。'."\n"
."\n"
.'> 获取方法请参见[DescribeCustomMetricList](~~115005~~)。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => 'cpu_total',
],
],
[
'name' => 'Resources',
'in' => 'query',
'schema' => [
'description' => '报警规则作用的自定义监控数据。由自定义监控数据所属应用分组ID和监控项所属维度组成。',
'type' => 'string',
'required' => true,
'example' => '[{"groupId":7378****,"dimension":"instanceId=i-hp3543t5e4sudb3s****"}]',
],
],
[
'name' => 'ContactGroups',
'in' => 'query',
'schema' => [
'description' => '报警联系人组。多个联系人组之间用英文逗号(,)分隔。',
'type' => 'string',
'required' => true,
'example' => 'ECS_Group',
],
],
[
'name' => 'Webhook',
'in' => 'query',
'schema' => [
'description' => '报警发生回调时指定的URL地址,向URL发送POST请求。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com',
],
],
[
'name' => 'EffectiveInterval',
'in' => 'query',
'schema' => [
'description' => '报警规则生效的时间范围。取值范围:00:00-23:59。',
'type' => 'string',
'required' => false,
'example' => '00:00-23:59',
],
],
[
'name' => 'SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默周期。单位:秒,默认值:86400(1天)。'."\n"
."\n"
.'> 当监控数据持续超过报警规则阈值时,每个沉默周期内只发送一次报警通知。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '86400',
'default' => '86400',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '自定义监控数据的聚合周期。单位:秒。取值为60或60的整数倍。默认为自定义监控数据的原始上报周期。',
'type' => 'string',
'required' => false,
'example' => '300',
'default' => '300',
],
],
[
'name' => 'EmailSubject',
'in' => 'query',
'schema' => [
'description' => '报警邮件主题。',
'type' => 'string',
'required' => false,
'example' => 'ECS实例',
],
],
[
'name' => 'Threshold',
'in' => 'query',
'schema' => [
'description' => '报警阈值。',
'type' => 'string',
'required' => true,
'example' => '90',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '报警级别。取值:'."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'required' => true,
'example' => 'CRITICAL',
],
],
[
'name' => 'EvaluationCount',
'in' => 'query',
'schema' => [
'description' => '报警重试次数。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'example' => '3',
],
],
[
'name' => 'Statistics',
'in' => 'query',
'schema' => [
'description' => '报警统计方法。',
'type' => 'string',
'required' => true,
'example' => 'Average',
],
],
[
'name' => 'ComparisonOperator',
'in' => 'query',
'schema' => [
'description' => '阈值比较符号。取值:'."\n"
."\n"
.'- `>=`'."\n"
."\n"
.'- `=`'."\n"
."\n"
.'- `<=`'."\n"
."\n"
.'- `>`'."\n"
."\n"
.'- `<`'."\n"
."\n"
.'- `!=`',
'type' => 'string',
'required' => true,
'example' => '>=',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。接口调用成功时,返回为空;接口调用失败时,返回失败原因。',
'type' => 'string',
'example' => 'ComparisonOperator is mandatory for this action.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '65D50468-ECEF-48F1-A6E1-D952E89D9432',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
499 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"ComparisonOperator is mandatory for this action.\\",\\n \\"RequestId\\": \\"65D50468-ECEF-48F1-A6E1-D952E89D9432\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\n\\t200\\n\\ttrue\\n","errorExample":""}]',
'title' => '创建自定义监控报警规则',
'description' => '调用本接口前,请先调用PutCustomMetric接口上报自定义监控数据,详情请参见 [PutCustomMetric](~~115004~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeCustomMetricList' => [
'summary' => '调用DescribeCustomMetricList接口查询上报的自定义监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => false,
'example' => '7378****',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '自定义监控项名称。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
],
[
'name' => 'Dimension',
'in' => 'query',
'schema' => [
'description' => '维度Map,用于查询指定资源的监控数据。'."\n"
.' '."\n",
'type' => 'string',
'required' => false,
'example' => '{sampleName1=value1&sampleName2=value2}',
],
],
[
'name' => 'Md5',
'in' => 'query',
'schema' => [
'description' => '消息摘要算法,可以产生一个128位(16字节)的散列值,用来校验上报的自定义监控数据的唯一性。',
'type' => 'string',
'required' => false,
'example' => '97c25982d9745a231276bff27469****',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:10。',
'type' => 'string',
'required' => false,
'example' => '10',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '1AF425E4-1DEA-54F2-910A-8117C9686140',
],
'Result' => [
'description' => '自定义监控数据查询结果。',
'type' => 'string',
'example' => '{\\"all\\":0,\\"size\\":10,\\"param\\":{\\"metric\\":\\"{\\\\\\"metricName\\\\\\":\\\\\\"cpu_total\\\\\\",\\\\\\"groupId\\\\\\":7378****,\\\\\\"project\\\\\\":\\\\\\"acs_customMetric_120886317861****\\\\\\",\\\\\\"dimension\\\\\\":\\\\\\"sampleName1=value1&sampleName2=value2\\\\\\",\\\\\\"status\\\\\\":1}\\",\\"service\\":\\"metric-center.aliyun-inc.com\\"},\\"page\\":1,\\"list\\":[]}',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"1AF425E4-1DEA-54F2-910A-8117C9686140\\",\\n \\"Result\\": \\"{\\\\\\\\\\\\\\"all\\\\\\\\\\\\\\":0,\\\\\\\\\\\\\\"size\\\\\\\\\\\\\\":10,\\\\\\\\\\\\\\"param\\\\\\\\\\\\\\":{\\\\\\\\\\\\\\"metric\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"{\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"metricName\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"cpu_total\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"groupId\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":7378****,\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"project\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"acs_customMetric_120886317861****\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"dimension\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"sampleName1=value1&sampleName2=value2\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\",\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"status\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\":1}\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"service\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"metric-center.aliyun-inc.com\\\\\\\\\\\\\\"},\\\\\\\\\\\\\\"page\\\\\\\\\\\\\\":1,\\\\\\\\\\\\\\"list\\\\\\\\\\\\\\":[]}\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccess\\r\\n\\t1AF425E4-1DEA-54F2-910A-8117C9686140\\r\\n\\t200\\r\\n\\t{\\\\\\"all\\\\\\":0,\\\\\\"size\\\\\\":10,\\\\\\"param\\\\\\":{\\\\\\"metric\\\\\\":\\\\\\"{\\\\\\\\\\\\\\"metricName\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"cpu_total\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"groupId\\\\\\\\\\\\\\":7378****,\\\\\\\\\\\\\\"project\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"acs_customMetric_120886317861****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"dimension\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"sampleName1=value1&=value2\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"status\\\\\\\\\\\\\\":1}\\\\\\",\\\\\\"service\\\\\\":\\\\\\"metric-center.aliyun-inc.com\\\\\\"},\\\\\\"page\\\\\\":1,\\\\\\"list\\\\\\":[]}\\r\\n\\t","errorExample":""}]',
'title' => '查询上报的自定义监控数据',
'description' => '> 建议您通过DescribeMetricList接口查询监控数据。更多信息,请参见[DescribeMetricList](~~51936~~)。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteCustomMetric' => [
'summary' => '调用DeleteCustomMetric接口删除自定义监控上报数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => true,
'example' => '3607****',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项的名称。',
'type' => 'string',
'required' => true,
'example' => 'AdvanceCredit',
],
],
[
'name' => 'Md5',
'in' => 'query',
'schema' => [
'description' => '消息摘要算法,可以产生一个128位(16字节)的散列值,用来校验上报的自定义监控数据的唯一性。'."\n"
."\n"
.'> 当查询自定义监控项时,会返回`Md5`。'."\n"
."\n\n",
'type' => 'string',
'required' => false,
'example' => '38796C8CFFEB8F89BB2A626C7BD7****',
],
],
[
'name' => 'UUID',
'in' => 'query',
'schema' => [
'description' => '发起请求申请时的UUID。'."\n"
."\n"
.'> 查询自定义监控项时,会返回`UUID`,建议您使用`Md5`。',
'type' => 'string',
'required' => false,
'example' => '5497633c-66c5-4eae-abaa-89db5adb****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\tsuccess\\n\\t\\t05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0\\n\\t\\t200\\n","errorExample":""}]',
'title' => '删除自定义监控上报数据',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutLogMonitor' => [
'summary' => '调用PutLogMonitor接口创建或修改日志监控。',
'methods' => [
'post',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'LogId',
'in' => 'query',
'schema' => [
'description' => '日志监控ID。',
'type' => 'string',
'required' => false,
'example' => '16****',
],
],
[
'name' => 'SlsRegionId',
'in' => 'query',
'schema' => [
'description' => '日志服务中日志项目(Project)所在地域。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'SlsProject',
'in' => 'query',
'schema' => [
'description' => '日志服务中日志项目的名称。',
'type' => 'string',
'required' => true,
'example' => 'test-project',
],
],
[
'name' => 'SlsLogstore',
'in' => 'query',
'schema' => [
'description' => '日志服务中日志库的名称。',
'type' => 'string',
'required' => true,
'example' => 'test-logstore',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。关于云监控支持云服务的监控项,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'cpu_total',
],
],
[
'name' => 'MetricExpress',
'in' => 'query',
'schema' => [
'description' => '扩展字段。 扩展字段为统计方法中的结果提供四则运算的功能。'."\n"
."\n"
.'例如:在统计方法中配置了HTTP状态码请求总数TotalNumber和HTTP状态码大于499的请求数5xxNumber,则可以通过扩展字段计算出服务端的错误率:5xxNumber/TotalNumber*100。'."\n"
."\n"
.'JSON格式:{"extend":{"errorPercent":"5xxNumber/TotalNumber*100"}}。字段说明如下:'."\n"
."\n"
.'- extend:必填字段。'."\n"
."\n"
.'- errorPercent:计算结果生成新字段的别名,您可以根据真实情况自行命名。 '."\n"
."\n"
.'- errorPercent:现有字段的计算表达式。',
'type' => 'string',
'required' => false,
'example' => '{"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '7301****',
],
],
[
'name' => 'ValueFilterRelation',
'in' => 'query',
'schema' => [
'description' => '日志筛选的过滤条件。取值:'."\n"
."\n"
.'- and:和。'."\n"
."\n"
.'- or:或。'."\n"
."\n"
.'> 本参数需要与`ValueFilter.N.Key`配合使用。',
'type' => 'string',
'required' => true,
'example' => 'and',
],
],
[
'name' => 'Tumblingwindows',
'in' => 'query',
'schema' => [
'description' => '预计算窗口时间。单位:秒。云监控将在定义的预计算时间对数据做一次聚合计算。',
'type' => 'string',
'required' => false,
'example' => '60,300',
],
],
[
'name' => 'Unit',
'in' => 'query',
'schema' => [
'description' => '单位。',
'type' => 'string',
'required' => false,
'example' => 'Percent',
],
],
[
'name' => 'Aggregates',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '聚合计算定义。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'FieldName' => [
'description' => '聚合计算原始的字段名称。N的取值范围:1~10。',
'type' => 'string',
'required' => true,
'example' => 'sourceCount',
],
'Function' => [
'description' => '在计算周期内根据选定的统计方法对日志数据进行聚合处理。N的取值范围:1~10。取值:'."\n"
.'- count:计数。'."\n"
.'- sum:求和。'."\n"
.'- avg:平均值。'."\n"
.'- max:最大值。'."\n"
.'- min:最小值。'."\n"
.'- countps:计算统计周期内指定字段求count后的每秒平均值。'."\n"
.'- sumps:计算统计周期内指定字段求sum后的每秒平均值。'."\n"
.'- distinct:去重后计算统计周期内指定字段出现的次数。',
'type' => 'string',
'required' => true,
'example' => 'count',
],
'Alias' => [
'description' => '聚合计算别名。N的取值范围:1~10。',
'type' => 'string',
'required' => true,
'example' => 'Count',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 10,
],
],
[
'name' => 'Groupbys',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '对数据进行空间维度聚合。相当于SQL中的Group By,根据指定的维度,对监控数据进行分组。如果Group By不选择任何维度,则根据聚合方法对全部监控数据进行聚合。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'FieldName' => [
'description' => 'GroupBy字段名称。N的取值范围:1~10。 ',
'type' => 'string',
'required' => false,
'example' => 'cpu',
],
'Alias' => [
'description' => 'GroupBy别名。N的取值范围:1~10。',
'type' => 'string',
'required' => false,
'example' => 'CPUUtilization',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 10,
],
],
[
'name' => 'ValueFilter',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '筛选的过滤规则,配合ValueFilterRelation使用。相当于SQL中的Where条件。如果不填写,则表示对全部数据进行处理。例如:日志中有Level和Error字段,如果需要统计每分钟Error出现的次数,则统计方法可以定义为对Level求和,并且Level=Error。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Key' => [
'description' => '日志匹配的字段名名称。N的取值范围:1~10。',
'type' => 'string',
'required' => false,
'example' => 'lh_source',
],
'Value' => [
'description' => '日志匹配的字段值。N的取值范围:1~10。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
'Operator' => [
'description' => '字段值的匹配方式。N的取值范围:1~10。取值:'."\n"
.'- `contain`:包含。'."\n"
.'- `notContain`:不包含。'."\n"
.'- `>`:大于。'."\n"
.'- `<`:小于。'."\n"
.'- `>=`:大于等于。'."\n"
.'- `<=`:小于等于。',
'type' => 'string',
'required' => false,
'example' => 'contain',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。结果如下:'."\n"
."\n"
.'- 当操作成功时,返回`successful`。'."\n"
."\n"
.'- 当操作失败时,返回错误信息,例如:`alias of aggreate must be set value.`。',
'type' => 'string',
'example' => 'successful',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '91561287-0802-5F9C-9BDE-404C50D41B06',
],
'LogId' => [
'description' => '日志监控ID。',
'type' => 'string',
'example' => '16****',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
[
'errorCode' => 'LimitorError',
'errorMessage' => 'Log monitor limit is not enough',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"RequestId\\": \\"91561287-0802-5F9C-9BDE-404C50D41B06\\",\\n \\"LogId\\": \\"16****\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccessful\\r\\n\\t91561287-0802-5F9C-9BDE-404C50D41B06\\r\\n\\t200\\r\\n\\t16****\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '创建或修改日志监控',
'description' => '本文将提供一个示例,创建一个日志监控`cpu_total`。返回结果显示,创建日志监控成功,日志监控ID为`16****`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteLogMonitor' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'systemTags' => [
'operationType' => 'delete',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'LogId',
'in' => 'query',
'schema' => [
'description' => '日志监控ID。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => true,
'example' => '12345',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'metric not exist.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '42BFFC2B-5E4D-4FDE-BCC6-E91EE33C5967',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"metric not exist.\\",\\n \\"RequestId\\": \\"42BFFC2B-5E4D-4FDE-BCC6-E91EE33C5967\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\tEBB5215C-44AB-4000-A2D7-48634FDC4F04\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '删除日志监控',
'summary' => '调用DeleteLogMonitor接口删除日志监控。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLogMonitorList' => [
'summary' => '调用DescribeLogMonitorList接口获取日志监控列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。默认:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '10',
],
],
[
'name' => 'SearchValue',
'in' => 'query',
'schema' => [
'description' => '监控项搜索。支持模糊搜索。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'test',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'docRequired' => false,
'example' => '123456',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '01E90080-4300-4FAA-B9AE-161956BC350D',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'PageSize' => [
'description' => '分页大小。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'PageNumber' => [
'description' => '当前页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int64',
'example' => '15',
],
'LogMonitorList' => [
'description' => '日志监控列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ValueFilterRelation' => [
'description' => '日志筛选的过滤条件。需要和ValueFilter配合使用。取值:'."\n"
.'- and:表示和的关系。'."\n"
.'- or :表示或的关系。',
'type' => 'string',
'example' => 'and',
],
'SlsLogstore' => [
'description' => '日志服务名称。',
'type' => 'string',
'example' => 'testSlS****',
],
'MetricName' => [
'description' => '监控项名称。详情请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'example' => 'cpu_total',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '12345',
],
'LogId' => [
'description' => '日志监控ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '12345',
],
'SlsRegionId' => [
'description' => '日志服务所在的地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'GmtCreate' => [
'description' => '创建时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的毫秒数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1577766395000',
],
'SlsProject' => [
'description' => '日志Project。',
'type' => 'string',
'example' => 'sls-project-test****',
],
'ValueFilter' => [
'description' => '筛选的过滤规则,配合ValueFilterRelation使用。相当于SQL中的Where条件。'."\n"
.'如果不填写,则表示对全部数据进行处理。例如:日志中有Level和Error字段,如果需要统计每分钟Error出现的次数,则统计方法可以定义为对Level求和,并且Level=Error。'."\n",
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Key' => [
'description' => '日志匹配的字段名称。',
'type' => 'string',
'example' => 'hostName',
],
'Value' => [
'description' => '日志匹配的字段值。',
'type' => 'string',
'example' => 'portal',
],
'Operator' => [
'description' => '字段值的匹配方式。取值:'."\n"
.'- contain:包含。'."\n"
.'- notContain:不包含。'."\n"
.'- `>`:大于。'."\n"
.'- `<`:小于。'."\n"
.'- `>=`:大于等于。'."\n"
.'- `<=`:小于等于。',
'type' => 'string',
'example' => 'contain',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"01E90080-4300-4FAA-B9AE-161956BC350D\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"PageSize\\": 10,\\n \\"PageNumber\\": 1,\\n \\"Total\\": 15,\\n \\"LogMonitorList\\": [\\n {\\n \\"ValueFilterRelation\\": \\"and\\",\\n \\"SlsLogstore\\": \\"testSlS****\\",\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"GroupId\\": 12345,\\n \\"LogId\\": 12345,\\n \\"SlsRegionId\\": \\"cn-hangzhou\\",\\n \\"GmtCreate\\": 1577766395000,\\n \\"SlsProject\\": \\"sls-project-test****\\",\\n \\"ValueFilter\\": [\\n {\\n \\"Key\\": \\"hostName\\",\\n \\"Value\\": \\"portal\\",\\n \\"Operator\\": \\"contain\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\tsuccessful\\r\\n\\t\\tC085617E-7A64-402E-877D-410E86174B0C\\r\\n\\t\\t10\\r\\n\\t\\t2\\r\\n\\t\\t\\r\\n\\t\\t\\tsls-project-test****\\r\\n\\t\\t\\tcpu_total\\r\\n\\t\\t\\t1591175112000\\r\\n\\t\\t\\tand\\r\\n\\t\\t\\t12345\\r\\n\\t\\t\\tcn-hangzhou\\r\\n\\t\\t\\ttestSlS****\\r\\n\\t\\t\\t12345\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tsls-project-test****\\r\\n\\t\\t\\tcpu_total\\r\\n\\t\\t\\t1586826787000\\r\\n\\t\\t\\tand\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t=\\r\\n\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\tlh_source\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t12345\\r\\n\\t\\t\\tcn-hangzhou\\r\\n\\t\\t\\tinternal-alert-history\\r\\n\\t\\t\\t12345\\r\\n\\t\\t\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n\\r\\n","errorExample":""}]',
'title' => '获取日志监控列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeLogMonitorAttribute' => [
'summary' => '调用DescribeLogMonitorAttribute接口获取日志监控详情。',
'methods' => [
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '指标名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cpu_total_******',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C6718537-E673-4A58-8EE1-24B8B38C7AAE',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'LogMonitor' => [
'description' => '日志监控详情。',
'type' => 'object',
'properties' => [
'ValueFilterRelation' => [
'description' => '日志筛选的过滤条件。需要和ValueFilter配合使用。取值:'."\n"
.'- and:和。'."\n"
.'- or:或。',
'type' => 'string',
'example' => 'and',
],
'SlsLogstore' => [
'description' => '日志服务 Logstore名称。',
'type' => 'string',
'example' => 'logstore_******',
],
'MetricName' => [
'description' => '监控项的名称。',
'type' => 'string',
'example' => 'cpu_total_******',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123******',
],
'LogId' => [
'description' => '日志监控ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123******',
],
'MetricExpress' => [
'description' => '指标表达式。',
'type' => 'string',
'example' => '{}',
],
'SlsRegionId' => [
'description' => '日志服务所在的地域id。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'GmtCreate' => [
'description' => '创建时间。'."\n"
."\n"
.'格式为Unix时间戳,即从1970年1月1日开始所经过的秒数。',
'type' => 'integer',
'format' => 'int64',
'example' => '1678440033000',
],
'SlsProject' => [
'description' => '日志服务 Project名称。',
'type' => 'string',
'example' => 'project_******',
],
'Aggregates' => [
'description' => '聚合计算定义。',
'type' => 'array',
'items' => [
'description' => '聚合计算定义。',
'type' => 'object',
'properties' => [
'Max' => [
'description' => '最大值。',
'type' => 'string',
'example' => '0',
],
'Min' => [
'description' => '最小值。',
'type' => 'string',
'example' => '0',
],
'Function' => [
'description' => '统计方法,即在统计周期内计算日志数据的函数方法。取值:'."\n"
.'- count:计数值。'."\n"
.'- sum:求和。'."\n"
.'- avg:平均值。'."\n"
.'- max:最大值。'."\n"
.'- min:最小值。'."\n"
.'- countps:计算统计周期内指定字段求count后的每秒平均值。'."\n"
.'- sumps:计算统计周期内指定字段求sum后的每秒平均值。'."\n"
.'- distinct:去重后计算统计周期内指定字段出现的次数。',
'type' => 'string',
'example' => 'count',
],
'Alias' => [
'description' => '字段别名。',
'type' => 'string',
'example' => 'alias_******',
],
'FieldName' => [
'description' => '日志中原始的字段名。',
'type' => 'string',
'example' => 'field_******',
],
],
],
],
'ValueFilter' => [
'description' => '筛选的过滤规则,配合ValueFilterRelation使用。相当于SQL中的Where条件。'."\n"
."\n"
.'如果不填写,则表示对全部数据进行处理。例如:日志中有Level和Error字段,如果需要统计每分钟Error出现的次数,则统计方法可以定义为对Level求和,并且Level=Error。'."\n",
'type' => 'array',
'items' => [
'description' => '筛选的过滤规则。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => 'key',
'type' => 'string',
'example' => 'key_******',
],
'Value' => [
'description' => 'value',
'type' => 'string',
'example' => 'value_******',
],
'Operator' => [
'description' => '字段值的匹配方式。取值:'."\n"
.'- `contain`:包含。'."\n"
.'- `notContain`:不包含。'."\n"
.'- `>`:大于。'."\n"
.'- `<`:小于。'."\n"
.'- `>=`:大于等于。'."\n"
.'- `<=`:小于等于。',
'type' => 'string',
'example' => 'contain',
],
],
],
],
'Tumblingwindows' => [
'description' => '预计算窗口时间。单位:秒。云监控将在定义的预计算时间对数据做一次聚合计算。',
'type' => 'array',
'items' => [
'description' => '预计算窗口时间。单位:秒。云监控将在定义的预计算时间对数据做一次聚合计算。',
'type' => 'string',
'example' => '60',
],
],
'Groupbys' => [
'description' => '对数据进行空间维度聚合。相当于SQL中的Group By,根据指定的维度,对监控数据进行分组。如果Group By不选择任何维度,则根据聚合方法对全部监控数据进行聚合。',
'type' => 'array',
'items' => [
'description' => 'group by定义',
'type' => 'string',
'example' => 'userId',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"C6718537-E673-4A58-8EE1-24B8B38C7AAE\\",\\n \\"Success\\": true,\\n \\"LogMonitor\\": {\\n \\"ValueFilterRelation\\": \\"and\\",\\n \\"SlsLogstore\\": \\"logstore_******\\",\\n \\"MetricName\\": \\"cpu_total_******\\",\\n \\"GroupId\\": 0,\\n \\"LogId\\": 0,\\n \\"MetricExpress\\": \\"{}\\",\\n \\"SlsRegionId\\": \\"cn-hangzhou\\",\\n \\"GmtCreate\\": 1678440033000,\\n \\"SlsProject\\": \\"project_******\\",\\n \\"Aggregates\\": [\\n {\\n \\"Max\\": \\"0\\",\\n \\"Min\\": \\"0\\",\\n \\"Function\\": \\"count\\",\\n \\"Alias\\": \\"alias_******\\",\\n \\"FieldName\\": \\"field_******\\"\\n }\\n ],\\n \\"ValueFilter\\": [\\n {\\n \\"Key\\": \\"key_******\\",\\n \\"Value\\": \\"value_******\\",\\n \\"Operator\\": \\"contain\\"\\n }\\n ],\\n \\"Tumblingwindows\\": [\\n \\"60\\"\\n ],\\n \\"Groupbys\\": [\\n \\"userId\\"\\n ]\\n }\\n}","type":"json"}]',
'title' => '获取日志监控详情',
],
'CreateMonitorGroupByResourceGroupId' => [
'summary' => '调用CreateMonitorGroupByResourceGroupId接口通过资源组创建应用分组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'EnableSubscribeEvent',
'in' => 'query',
'schema' => [
'description' => '应用分组是否开启自动订阅事件通知。当应用分组内资源发生严重和警告级别的事件时,云监控发送报警通知。取值:'."\n"
."\n"
.'- true:开启。'."\n"
."\n"
.'- false(默认值):关闭。'."\n"
."\n",
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'EnableInstallAgent',
'in' => 'query',
'schema' => [
'description' => '应用分组是否开启自动安装云监控插件。云监控自动为应用分组内的主机安装云监控插件。取值:'."\n"
."\n"
.'- true:开启。'."\n"
."\n"
.'- false(默认值):关闭。'."\n"
."\n",
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'RegionId',
'in' => 'query',
'schema' => [
'description' => '资源组对应的地域ID。'."\n"
."\n"
.'关于如何获取资源组对应的地域ID,请参见[GetResourceGroup](~~158866~~)。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
],
[
'name' => 'ResourceGroupId',
'in' => 'query',
'schema' => [
'description' => '资源组ID。'."\n"
."\n"
.'关于如何获取资源组ID,请参见[ListResourceGroups](~~158855~~)。'."\n",
'type' => 'string',
'required' => true,
'example' => 'rg-acfmw3ty5y7****',
],
],
[
'name' => 'ResourceGroupName',
'in' => 'query',
'schema' => [
'description' => '资源组名称。'."\n"
."\n"
.'关于如何获取资源组名称,请参见[ListResourceGroups](~~158855~~)。'."\n",
'type' => 'string',
'required' => true,
'example' => 'CloudMonitor',
],
],
[
'name' => 'ContactGroupList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警联系组。应用分组的报警通知会发送给该报警联系组中的报警联系人。'."\n"
."\n"
.'报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见[PutContact](~~114923~~)和[PutContactGroup](~~114929~~)。关于如何获取报警联系组,请参见[DescribeContactGroupList](~~114922~~)。',
'type' => 'array',
'items' => [
'description' => '报警联系组。应用分组的报警通知会发送给该报警联系组中的报警联系人。'."\n"
."\n"
.'报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见[PutContact](~~114923~~)和[PutContactGroup](~~114929~~)。关于如何获取报警联系组,请参见[DescribeContactGroupList](~~114922~~)。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Group',
],
'required' => true,
'example' => 'ECS_Group',
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '784CAB3C-F613-5BCE-8469-6DCB29B18A20',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Id' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '3607****',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
4092 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'ResourceGroupId already create group',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"784CAB3C-F613-5BCE-8469-6DCB29B18A20\\",\\n \\"Success\\": true,\\n \\"Id\\": 0\\n}","errorExample":""},{"type":"xml","example":"\\n 784CAB3C-F613-5BCE-8469-6DCB29B18A20\\n 3607****\\n 200\\n true\\n","errorExample":""}]',
'title' => '通过资源组创建应用分组',
'description' => '本文将提供一个示例,为地域`cn-hangzhou`的资源组`CloudMonitor`创建一个应用分组,应用分组的报警联系人组为`ECS_Group`。'."\n"
."\n",
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateSiteMonitor' => [
'summary' => '创建站点监控任务',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'paid',
],
'parameters' => [
[
'name' => 'Address',
'in' => 'query',
'schema' => [
'description' => '监控任务的URL或IP地址。',
'type' => 'string',
'required' => true,
'example' => 'https://www.aliyun.com',
],
],
[
'name' => 'TaskType',
'in' => 'query',
'schema' => [
'description' => '监控任务的监控类型。'."\n"
."\n"
.'目前站点监控任务的类型包括:HTTP(S)、PING、TCP、UDP、DNS、SMTP、POP3、FTP、WEBSOCKET。',
'type' => 'string',
'required' => true,
'example' => 'HTTP',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '监控任务的名称。'."\n"
."\n"
.'长度4~100个字符,取值可包含英文字母、数字、下划线(_)和汉字。',
'type' => 'string',
'required' => true,
'example' => 'HanZhou_ECS1',
],
],
[
'name' => 'Interval',
'in' => 'query',
'schema' => [
'description' => '监控频率。'."\n"
."\n"
.'取值:1分钟、5分钟、15分钟、30分钟和60分钟。'."\n"
."\n"
.'默认值:1分钟。',
'type' => 'string',
'required' => false,
'example' => '1',
'default' => '1',
],
],
[
'name' => 'IspCities',
'in' => 'query',
'schema' => [
'description' => '探针信息。如果该参数取值为空,则系统随机选择3个探测点。'."\n"
."\n"
.'格式为JSONArray,例如:`[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`,分别对应北京、杭州、青岛。'."\n"
."\n"
.'关于如何获取探测点信息,请参见[DescribeSiteMonitorISPCityList](~~115045~~)。',
'type' => 'string',
'required' => false,
'example' => '[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]',
],
],
[
'name' => 'OptionsJson',
'in' => 'query',
'schema' => [
'description' => '监控任务对应协议类型的高级扩展选项。不同监控任务的协议类型对应不同的扩展选项。',
'type' => 'string',
'required' => false,
'example' => '{"time_out":5000}',
],
],
[
'name' => 'AlertIds',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'关于如何获取云监控中已存在的报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent',
],
],
[
'name' => 'AgentGroup',
'in' => 'query',
'schema' => [
'description' => '拨测任务使用的拨测点组。不同的选项对应不同的探测点类型。PC对应PC端,MOBIEL对应移动端,FC对应VPC内网探测。不设置的话默认为PC。',
'type' => 'string',
'required' => false,
'example' => 'PC',
],
],
[
'name' => 'CustomSchedule',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '自定义探测周期。只能选择周一至周日的某个时间段进行探测。',
'type' => 'string',
'required' => false,
'example' => '{"start_hour":0,"end_hour":24, "days":[0], "time_zone":"Local"}',
],
],
[
'name' => 'VpcConfig',
'in' => 'query',
'schema' => [
'description' => '创建vpc内网拨测任务时需要提供的网络信息。需要提供一个JSON,里边必须包含vpcId,vswitchId,securityGroupId和region四个字段。',
'type' => 'string',
'required' => false,
'example' => '{"vpcId": "vpc-xxxxxx", "vswitchId": "vsw-xxxxxx", "securityGroupId": "sg-xxxxxx", "region": "cn-beijing"}',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'Successful',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '68192f5d-0d45-4b98-9724-892813f86c71',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Data' => [
'description' => '监控任务的结果详情。',
'type' => 'object',
'properties' => [
'AttachAlertResult' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Contact' => [
'description' => '关联已有报警规则的结果。',
'type' => 'array',
'items' => [
'description' => '关联已有报警规则的结果。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '关联报警规则的状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '关联报警规则的返回信息。',
'type' => 'string',
'example' => 'successful',
],
'RequestId' => [
'description' => '关联报警规则的请求ID。',
'type' => 'string',
'example' => '5dd33455-4f65-4b0c-9200-33d66f3f340b',
],
'Success' => [
'description' => '关联报警规则是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'RuleId' => [
'description' => '关联报警规则的ID。',
'type' => 'string',
'example' => 'SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent',
],
],
],
],
],
],
],
],
'CreateResultList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'CreateResultList' => [
'description' => '返回结果。'."\n"
."\n"
.'当创建监控任务成功时,有返回结果;当创建监控任务失败时,无返回结果。',
'type' => 'array',
'items' => [
'description' => '返回结果。'."\n"
."\n"
.'当创建监控任务成功时,有返回结果;当创建监控任务失败时,无返回结果。',
'type' => 'object',
'properties' => [
'TaskId' => [
'description' => '监控任务ID。',
'type' => 'string',
'example' => '2c8dbdf9-a3ab-46a1-85a4-f094965e****',
],
'TaskName' => [
'description' => '监控任务名称。',
'type' => 'string',
'example' => 'HanZhou_ECS1',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
[
'errorCode' => 'IllegalAddress',
'errorMessage' => 'Illegal HTTP address',
],
[
'errorCode' => 'OperationError',
'errorMessage' => 'Operation failed',
],
[
'errorCode' => 'TaskNotExists',
'errorMessage' => 'Task does not exist',
],
[
'errorCode' => 'OperatorInvalid',
'errorMessage' => 'Operator invalid',
],
[
'errorCode' => 'NameRepeat',
'errorMessage' => 'Task name repeat',
],
[
'errorCode' => 'CreateAlarmError',
'errorMessage' => 'Create alarm error',
],
[
'errorCode' => 'NameNotExists',
'errorMessage' => 'Task name not exists',
],
[
'errorCode' => 'OperatorCityInvalid',
'errorMessage' => 'Invalid Isp.',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => '%s',
],
[
'errorCode' => 'RestrictedUser',
'errorMessage' => 'The user\'s operation is restricted, please register NAAM product code',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"RequestId\\": \\"68192f5d-0d45-4b98-9724-892813f86c71\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"AttachAlertResult\\": {\\n \\"Contact\\": [\\n {\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"RequestId\\": \\"5dd33455-4f65-4b0c-9200-33d66f3f340b\\",\\n \\"Success\\": \\"true\\",\\n \\"RuleId\\": \\"SystemDefault_acs_ecs_dashboard_InternetOutRate_Percent\\"\\n }\\n ]\\n }\\n },\\n \\"CreateResultList\\": {\\n \\"CreateResultList\\": [\\n {\\n \\"TaskId\\": \\"2c8dbdf9-a3ab-46a1-85a4-f094965e****\\",\\n \\"TaskName\\": \\"HanZhou_ECS1\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccessful\\r\\n\\t68192f5d-0d45-4b98-9724-892813f86c71\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tsuccessful\\r\\n\\t\\t\\t\\t5dd33455-4f65-4b0c-9200-33d66f3f340b\\r\\n\\t\\t\\t\\tSystemDefault_acs_ecs_dashboard_InternetOutRate_Percent\\r\\n\\t\\t\\t\\t200\\r\\n\\t\\t\\t\\ttrue\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t2c8dbdf9-a3ab-46a1-85a4-f094965e****\\r\\n\\t\\t\\tHanZhou_ECS1\\r\\n\\t\\t\\r\\n\\t\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '创建站点监控任务',
'description' => '本文将提供一个示例,创建一个站点监控任务`HanZhou_ECS1`,该监控任务的监控地址为`https://www.aliyun.com`、监控类型为`HTTPS`。',
'requestParamsDescription' => 'TaskType中HTTP(S)、PING、TCP、UDP、DNS、WEBSOCKET、SMTP、POP3和FTP的高级参数的设置方法如下表所示。'."\n"
."\n"
.'- HTTP(S)'."\n"
."\n"
.'|参数 |类型 |描述|'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|http_method |String |HTTP或HTTPS请求方式。支持三种请求方式:GET、POST、HEAD。默认值:GET。 |'."\n"
.'|header |String |换行符(\\n)分隔的自定义HTTP header。
每行Header格式需符合HTTP协议(使用半角冒号分隔的键值)。 |'."\n"
.'|cookie |String |Cookie和HTTP请求标准的写法一致。 |'."\n"
.'|request_content |String |请求内容。支持两种格式:JSON和表单。不提供时,请求中不含正文。 |'."\n"
.'|response_content |String |期望的回应内容。探测时会在HTTP服务器返回的前64个字节进行检查。 |'."\n"
.'|match_rule |String |0:回应中不含response_content时,探测成功。
1:回应中含response_content时,探测成功。 |'."\n"
.'|username |String |如果提供用户名,则会在HTTP请求中携带BasicAuth header。 |'."\n"
.'|password |String |HTTP或HTTPS请求验证密码。 |'."\n"
.'|time_out |int |超时时间。单位:毫秒。默认值:5 。 |'."\n"
.'|max_redirect |int |最大跳转次数。ECS探针默认5次,运营商探针默认2次。
如果需要禁止跳转,则将该参数设置为:0。
取值范围:0~50 。 |'."\n"
."\n"
.' '."\n"
.'- PING'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|failure_rate |文本 |当PING失败率超过该参数时,探测失败,返回610(PingAllFail)或615(PingPartialFail)。
默认值:0.1。 |'."\n"
.'|ping_num |int |PING次数,默认值:10。
取值范围:1~100。 |'."\n"
."\n"
.'- DNS'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|dns_server |string |DNS服务器地址,可以为域名或IP地址。 |'."\n"
.'|dns_type |string |DNS查询类型。取值:A、NS、CNAME、MX、TXT、ANY、AAAA。 |'."\n"
.'|expect_value |string |英文空白符分隔的期望值列表。 |'."\n"
.'|match_rule |string |期望值列表与DNS列表的关系,当不满足指定关系时,探测失败。
空字符串或IN_DNS:期望值列表是DNS列表的子集。
DNS_IN:DNS列表是期望值列表的子集。
EQUAL:DNS列表与期望值列表相等。
ANY:DNS列表与期望值列表有交集(交集不为空)。 |'."\n"
."\n"
.'- FTP'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|port |int |FTP服务器端口号。如果不提供,则使用默认值。FTP默认值:21,FTPS默认值:990。 |'."\n"
.'|username |string |FTP用户名。 如果未提供,则匿名登录。 |'."\n"
.'|password |string |FTP密码。 |'."\n"
."\n"
.'- POP3或SMTP'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|port |int |POP3或SMTP服务器的端口号。POP3默认值:110,POP3S默认值:995,SMTP默认值:25。 |'."\n"
.'|username |string |POP3或SMTP的用户名。POP3或SMTP的用户名和密码必填。 |'."\n"
.'|password |string |POP3或SMTP的密码。POP3或SMTP的用户名和密码必填。 |'."\n"
."\n"
.'- TCP或UDP'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|port |int |TCP或UDP服务器的端口。 |'."\n"
.'|request_content |string |请求内容。当request_format为hex时,request_content内容为十六进制紧凑格式。 |'."\n"
.'|request_format |string |当request_format为其他值时,request_content作为普通字符串发送给TCP或UDP服务器。 |'."\n"
.'|response_content |string |回应内容。当TCP或UDP服务器返回的内容中不含response_content时,探测失败。
当response_format为hex时,response_content中的内容为十六进制紧凑格式。
当response_content为其他值时,response_content为普通字符串。 |'."\n"
."\n"
.'- WEBSOCKET'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|request_content |string |消息内容。 |'."\n"
.'|empty_message |boolean |允许服务端不返回消息或返回空字符串。 |',
],
'CreateInstantSiteMonitor' => [
'summary' => '调用CreateSiteMonitor接口创建一次性探测任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'paid',
],
'parameters' => [
[
'name' => 'Address',
'in' => 'query',
'schema' => [
'description' => '探测任务的URL或IP地址。',
'type' => 'string',
'required' => true,
'example' => 'http://www.aliyun.com',
],
],
[
'name' => 'TaskType',
'in' => 'query',
'schema' => [
'description' => '探测任务的类型。'."\n"
.'目前探测任务的类型包括:HTTP、PING、TCP、UDP和DNS。',
'type' => 'string',
'required' => true,
'example' => 'HTTP',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '探测任务的名称。'."\n"
."\n"
.'长度4~100个字符,取值可包含英文字母、数字、下划线(_)和汉字。'."\n"
."\n\n"
.'长度4~100个字符,取值可包含英文字母、数字和下划线(_)。'."\n"
."\n"
.'长度4~100个字符,取值可包含英文字母、数字和下划线(_)。'."\n",
'type' => 'string',
'required' => true,
'example' => 'task1',
],
],
[
'name' => 'IspCities',
'in' => 'query',
'schema' => [
'description' => '探测点信息。如果该参数取值为空,则系统随机选择3个探测点。'."\n"
."\n"
.'格式为`JSONArray`,例如:[{"city":"546","isp":"465", "type":"IDC"},{"city":"572","isp":"465", "type":"LASTMILE"},{"city":"738","isp":"465"}],分别对应北京、杭州、青岛。'."\n"
."\n"
.'type指示拨测点类型。当AgentGroup为PC时,可选值为IDC和LASTMILE。IDC指的是部署在数据中心的拨测点,LASTMILE指的是部署在网民家里,使用固网的拨测点。type为非必填选项,默认值为IDC。当AgentGroup为MOBILE时,无需填写。'."\n"
."\n"
.'关于如何获取探测点信息,请参见[DescribeSiteMonitorISPCityList](~~115045~~)。'."\n"
."\n"
.'> `IspCities`和`RandomIspCity`必须二选一。',
'type' => 'string',
'required' => false,
'example' => '[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]',
],
],
[
'name' => 'OptionsJson',
'in' => 'query',
'schema' => [
'description' => '探测任务对应协议类型的高级扩展选项。不同探测任务的协议类型对应不同的扩展选项。',
'type' => 'string',
'required' => false,
'example' => '{"time_out":5000}',
],
],
[
'name' => 'RandomIspCity',
'in' => 'query',
'schema' => [
'description' => '探测点的数量。'."\n"
."\n"
.'> - `IspCities`和`RandomIspCity`必须二选一。- 如果您设置了参数`RandomIspCity`,参数`IspCities`自动失效。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
'default' => '0',
],
],
[
'name' => 'AgentGroup',
'in' => 'query',
'schema' => [
'description' => '探测点类型,可选值为PC和MOBILE。PC为固网探测点,MOBILE为移动端探测点。默认值为PC。',
'type' => 'string',
'required' => false,
'example' => 'PC',
'enum' => [
'PC',
'MOBILE',
],
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '68192f5d-0d45-4b98-9724-892813f86c71',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
.'* true:成功。'."\n"
.'* false:失败。',
'type' => 'string',
'example' => 'true',
],
'CreateResultList' => [
'description' => '创建一次性探测任务的结果列表。',
'type' => 'array',
'items' => [
'description' => '创建一次性探测任务的结果列表。',
'type' => 'object',
'properties' => [
'TaskId' => [
'description' => '探测任务ID。',
'type' => 'string',
'example' => '2c8dbdf9-a3ab-46a1-85a4-f094965e****',
],
'TaskName' => [
'description' => '探测任务名称。',
'type' => 'string',
'example' => 'task1',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
[
'errorCode' => 'IllegalAddress',
'errorMessage' => 'Illegal HTTP address',
],
[
'errorCode' => 'OperationError',
'errorMessage' => 'Operation failed',
],
[
'errorCode' => 'TaskNotExists',
'errorMessage' => 'Task does not exist',
],
[
'errorCode' => 'OperatorInvalid',
'errorMessage' => 'Operator invalid',
],
[
'errorCode' => 'OperatorCityInvalid',
'errorMessage' => 'Operator City invalid',
],
[
'errorCode' => 'NameRepeat',
'errorMessage' => 'Task name repeat',
],
[
'errorCode' => 'CreateAlarmError',
'errorMessage' => 'Create alarm error',
],
[
'errorCode' => 'NameNotExists',
'errorMessage' => 'Task name not exists',
],
[
'errorCode' => 'Illegal Task Name',
'errorMessage' => 'The task name of the sitemonitor task is illegal.',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'Forbidden',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"RequestId\\": \\"68192f5d-0d45-4b98-9724-892813f86c71\\",\\n \\"Success\\": \\"true\\",\\n \\"CreateResultList\\": [\\n {\\n \\"TaskId\\": \\"2c8dbdf9-a3ab-46a1-85a4-f094965e****\\",\\n \\"TaskName\\": \\"task1\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccessful\\r\\n\\t68192f5d-0d45-4b98-9724-892813f86c71\\r\\n\\t200\\r\\n\\t\\r\\n\\t\\t2c8dbdf9-a3ab-46a1-85a4-f094965e****\\r\\n\\t\\ttask1\\r\\n\\t\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '创建一次性探测任务',
'description' => '仅开通网络分析与监控的阿里云账号,才能创建一次性探测任务。'."\n"
."\n"
.'本文将提供一个示例,创建一次性探测任务,该探测任务的名称为`task1`,探测地址为`http://www.aliyun.com`,探测类型为`HTTP`,探测点数量为`1`。',
'requestParamsDescription' => '## TaskType的高级参数说明'."\n"
."\n"
.'`TaskType`中HTTP、PING、TCP、UDP和DNS的高级参数的设置方法如下表所示。'."\n"
."\n"
.'- HTTP'."\n"
."\n"
.'|参数 |类型 |描述|'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|http_method |String |HTTP请求方式。支持三种请求方式:GET、POST、HEAD。默认值:GET。 |'."\n"
.'|header |String |换行符(\\n)分隔的自定义HTTP header。
每行Header格式需符合HTTP协议(使用半角冒号分隔的键值)。 |'."\n"
.'|cookie |String |Cookie和HTTP请求标准的写法一致。 |'."\n"
.'|request_content |String |请求内容。支持两种格式:JSON和表单。不提供时,请求中不含正文。 |'."\n"
.'|response_content |String |期望的回应内容。探测时会检查HTTP服务器返回的前64个字节。 |'."\n"
.'|match_rule |String |0:回应中不含response_content时,探测成功。
1:回应中含response_content时,探测成功。 |'."\n"
.'|username |String |如果提供用户名,则会在HTTP请求中携带BasicAuth header。 |'."\n"
.'|password |String |HTTP请求验证密码。 |'."\n"
.'|time_out |int |超时时间。单位:毫秒。默认值:30000。 |'."\n"
.'|max_redirect |int |最大跳转次数。ECS探针默认5次,运营商探针默认2次。
如果需要禁止跳转,则将该参数设置为0。
取值范围:0~50 。 |'."\n"
."\n"
.' '."\n"
.'- PING'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|failure_rate |int |当PING失败率超过该参数时,探测失败,返回610(PingAllFail)或615(PingPartialFail)。
默认值:0.1。 |'."\n"
.'|ping_num |int |PING次数,默认值:20。
取值范围:1~100。 |'."\n"
."\n"
.'- TCP或UDP'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|port |int |TCP或UDP服务器的端口。 |'."\n"
.'|request_content |string |请求内容。当request_format为hex时,request_content内容为十六进制紧凑格式。 |'."\n"
.'|request_format |string |当request_format为其他值时,request_content作为普通字符串发送给TCP或UDP服务器。 |'."\n"
.'|response_content |string |回应内容。当TCP或UDP服务器返回的内容中不含response_content时,探测失败。
当response_format为hex时,response_content中的内容为十六进制紧凑格式。
当response_content为其他值时,response_content为普通字符串。 |'."\n"
."\n"
.'- DNS'."\n"
."\n"
.'|参数 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|dns_server |string |DNS服务器地址,可以为域名或IP地址。 |'."\n"
.'|dns_type |string |DNS查询类型。取值:A、NS、CNAME、MX、TXT、ANY。 |'."\n"
.'|expect_value |string |英文空白符分隔的期望值列表。 |'."\n"
.'|match_rule |string |期望值列表与DNS列表的关系,当不满足指定关系时,探测失败。
空字符串或IN_DNS:期望值列表是DNS列表的子集。
DNS_IN:DNS列表是期望值列表的子集。
EQUAL:DNS列表与期望值列表相等。
ANY:DNS列表与期望值列表有交集(交集不为空)。 |',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'BatchCreateInstantSiteMonitor' => [
'summary' => '调用BatchCreateInstantSiteMonitor接口批量创建站点监控任务。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'TaskList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '站点监控任务列表。'."\n"
."\n"
.'> 至少需要创建一条站点监控任务,且`Address`、`TaskName`和`TaskType`必须设置。',
'type' => 'array',
'items' => [
'description' => '站点监控任务列表。',
'type' => 'object',
'properties' => [
'Address' => [
'description' => '站点监控任务的URL或IP地址。'."\n"
."\n"
.'> 至少需要创建一条站点监控任务,且`Address`、`TaskName`和`TaskType`必须设置。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com',
],
'IspCities' => [
'description' => '探测点信息。如果该参数取值为空,则系统随机选择3个探测点。'."\n"
."\n"
.'格式为`JSONArray`,例如:`[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`,分别对应北京、杭州、青岛。'."\n"
."\n"
.'关于如何获取探测点信息,请参见[DescribeSiteMonitorISPCityList](~~115045~~)。',
'type' => 'string',
'required' => false,
'example' => '[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]',
],
'OptionsJson' => [
'description' => '站点监控任务对应协议类型的高级扩展选项。不同探测任务的协议类型对应不同的扩展选项。',
'type' => 'string',
'required' => false,
'example' => '{"time_out":5000}',
],
'TaskName' => [
'description' => '站点监控任务的名称。'."\n"
."\n"
.'长度4~100个字符,取值可包含英文字母、数字、短划线(_)和汉字。'."\n"
."\n\n"
.'长度4~100个字符,取值可包含英文字母、数字和短划线(_)。'."\n"
."\n"
.'长度4~100个字符,取值可包含英文字母、数字和短划线(_)。'."\n"
."\n"
.'> 至少需要创建一条站点监控任务,且`Address`、`TaskName`和`TaskType`必须设置。'."\n",
'type' => 'string',
'required' => false,
'example' => 'HangZhou_ECS1',
],
'TaskType' => [
'description' => '监控任务的监控类型。'."\n"
."\n"
.'目前站点监控任务的类型包括:HTTP、PING、TCP、UDP、DNS、SMTP、POP3、FTP。'."\n"
."\n"
.'> 至少需要创建一条站点监控任务,且`Address`、`TaskName`和`TaskType`必须设置。',
'type' => 'string',
'required' => false,
'example' => 'HTTP',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 200,
'minItems' => 1,
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => '无。',
'type' => 'object',
'properties' => [
'RequestId' => [
'title' => 'Id of the request',
'description' => '请求ID。',
'type' => 'string',
'example' => '7AE72720-2C96-5446-9F2B-308C7CEDFF1A',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
.'* true:成功。'."\n"
.'* false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Data' => [
'description' => '站点监控任务信息。',
'type' => 'array',
'items' => [
'description' => '站点监控任务信息。',
'type' => 'object',
'properties' => [
'TaskName' => [
'description' => '站点监控任务名称。',
'type' => 'string',
'example' => 'HangZhou_ECS1',
],
'TaskId' => [
'description' => '站点监控任务ID。',
'type' => 'string',
'example' => '679fbe4f-b80b-4706-91b2-5427b43e****',
],
],
],
'example' => '[{"taskName": "HangZhou_ECS1", "taskId": "679fbe4f-b80b-4706-91b2-5427b43e****"}]',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'The parameter is missing or invalid. %s',
],
],
403 => [
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
429 => [
[
'errorCode' => 'ResourceOverLimit',
'errorMessage' => 'The resource has exceeded the limit. %s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"7AE72720-2C96-5446-9F2B-308C7CEDFF1A\\",\\n \\"Message\\": \\"successful\\",\\n \\"Success\\": true,\\n \\"Data\\": [\\n {\\n \\"TaskName\\": \\"HangZhou_ECS1\\",\\n \\"TaskId\\": \\"679fbe4f-b80b-4706-91b2-5427b43e****\\"\\n }\\n ],\\n \\"Code\\": \\"200\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 7AE72720-2C96-5446-9F2B-308C7CEDFF1A\\n successful\\n \\n HangZhou_ECS1\\n 679fbe4f-b80b-4706-91b2-5427b43e****\\n \\n 200\\n true\\n","errorExample":""}]',
'title' => '批量创建站点监控任务',
'description' => '本文将提供一个示例,创建一个站点监控任务`HangZhou_ECS1`,该任务的监控地址为`https://www.aliyun.com`,监控类型为`HTTP`。返回结果显示,创建站点监控任务成功,该站点监控任务的名称为`HangZhou_ECS1`,ID为`679fbe4f-b80b-4706-91b2-5427b43e****`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteSiteMonitors' => [
'summary' => '调用DeleteSiteMonitors接口删除站点监控的探测任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TaskIds',
'in' => 'query',
'schema' => [
'description' => '待删除的任务ID。多个任务ID之间用半角逗号(,)分隔。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '01adacc2-ece5-41b6-afa2-3143ab5d****,43bd1ead-514f-4524-813e-228ce091****',
],
],
[
'name' => 'IsDeleteAlarms',
'in' => 'query',
'schema' => [
'description' => '删除任务的同时是否删除报警规则。取值:'."\n"
."\n"
.'- true(默认值):删除报警规则。'."\n"
."\n"
.'- false:不删除报警规则。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。当请求成功时,返回成功信息;当请求失败时,返回失败原因,例如:`TaskId not found`。',
'type' => 'string',
'example' => '请求成功',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '123BCC5D-8B63-48EA-B747-9A8995BE7AA6',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'string',
'example' => 'true',
],
'Data' => [
'description' => '返回受影响的行数。',
'type' => 'object',
'properties' => [
'count' => [
'description' => '受影响的行数。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
],
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
[
'errorCode' => 'UnauthorizedTasks',
'errorMessage' => 'You are not permitted to operate the specified tasks.',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => 'TaskId not found',
],
[
'errorCode' => 'TaskNotExist',
'errorMessage' => 'The specified task does not exist.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'staticInfo' => [],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"请求成功\\",\\n \\"RequestId\\": \\"123BCC5D-8B63-48EA-B747-9A8995BE7AA6\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"count\\": 0\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t\\n\\t\\t\\t0\\n\\t\\t\\n\\t\\t请求成功\\n\\t\\t123BCC5D-8B63-48EA-B747-9A8995BE7AA6\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '删除站点监控的探测任务',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DisableSiteMonitors' => [
'summary' => '调用DisableSiteMonitors接口禁用一个或多个站点监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TaskIds',
'in' => 'query',
'schema' => [
'description' => '站点监控任务ID。多个ID之间用英文逗号(,)分隔。',
'type' => 'string',
'required' => true,
'example' => '49f7b317-7645-4cc9-94fd-ea42e522****,49f7b317-7645-4cc9-94fd-ea42e522****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3fcd12e7-d387-42ee-b77e-661c775bb17f',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Data' => [
'description' => '站点监控任务影响探测点的记录数。',
'type' => 'object',
'properties' => [
'count' => [
'description' => '探测点的记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
[
'errorCode' => 'UnauthorizedTasks',
'errorMessage' => 'You are not permitted to operate the specified tasks.',
],
],
[
[
'errorCode' => 'TaskNotExist',
'errorMessage' => 'The specified task does not exist.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"RequestId\\": \\"3fcd12e7-d387-42ee-b77e-661c775bb17f\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"count\\": 0\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccessful\\r\\n\\tEC3F33C8-9149-493C-92A8-9B33A9DA951C\\r\\n\\t\\r\\n\\t\\t0\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '禁用一个或多个站点监控任务',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifySiteMonitor' => [
'summary' => '调用ModifySiteMonitor接口修改站点监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'paid',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Address',
'in' => 'query',
'schema' => [
'description' => '监控任务的URL或IP地址。',
'type' => 'string',
'required' => false,
'example' => 'http://www.aliyun.com',
],
],
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '监控任务ID。',
'type' => 'string',
'required' => true,
'example' => '2c8dbdf9-a3ab-46a1-85a4-f094965e****',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '监控任务名称。长度4~100个字符,取值可包含英文字母、数字、下划线(_)和汉字。',
'type' => 'string',
'required' => false,
'example' => 'HanZhou_ECS2',
],
],
[
'name' => 'Interval',
'in' => 'query',
'schema' => [
'description' => '监控频率。取值:1、5、15。单位:分钟。默认值:1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'IspCities',
'in' => 'query',
'schema' => [
'description' => '探针信息。格式为JSONArray,例如:`[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]`,`city`分别对应北京、杭州和青岛。'."\n"
."\n"
.'> 您可以通过DescribeSiteMonitorISPCityList接口获取探测点信息,请参见[DescribeSiteMonitorISPCityList](~~115045~~)。如果该参数取值为空,则系统随机选择3个探测点。',
'type' => 'string',
'required' => false,
'example' => '[{"city":"546","isp":"465"},{"city":"572","isp":"465"},{"city":"738","isp":"465"}]',
],
],
[
'name' => 'OptionsJson',
'in' => 'query',
'schema' => [
'description' => '监控任务对应协议类型的高级扩展选项。不同监控任务的协议类型对应不同的扩展选项。',
'type' => 'string',
'required' => false,
'example' => '{"time_out":5000}',
],
],
[
'name' => 'AlertIds',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。云监控中已存在的报警规则ID,可通过DescribeMetricRuleList接口查询,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => false,
'example' => '49f7c317-7645-4cc9-94fd-ea42e122****',
],
],
[
'name' => 'IntervalUnit',
'in' => 'query',
'schema' => [
'description' => '监控指标的单位。'."\n"
."\n"
.'单位:毫秒(ms)。',
'type' => 'string',
'required' => false,
'example' => 'ms',
],
],
[
'name' => 'CustomSchedule',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '自定义探测周期。只能选择周一至周日的某个时间段进行探测。',
'type' => 'string',
'required' => false,
'example' => '{"start_hour":0,"end_hour":24, "days":[0], "time_zone":"Local"}',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '68192f5d-0d45-4b98-9724-892813f86c71',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Data' => [
'description' => '修改任务结果详情。',
'type' => 'object',
'properties' => [
'count' => [
'description' => '监控任务数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
[
'errorCode' => 'IllegalAddress',
'errorMessage' => 'Illegal HTTP address',
],
[
'errorCode' => 'OperationError',
'errorMessage' => 'Operation failed',
],
[
'errorCode' => 'TaskNotExists',
'errorMessage' => 'Task does not exist',
],
[
'errorCode' => 'OperatorInvalid',
'errorMessage' => '%s',
],
[
'errorCode' => 'NameRepeat',
'errorMessage' => 'Task name repeat',
],
[
'errorCode' => 'CreateAlarmError',
'errorMessage' => 'Create alarm error',
],
[
'errorCode' => 'NameNotExists',
'errorMessage' => 'Task name not exists',
],
[
'errorCode' => 'OperatorCityInvalid',
'errorMessage' => 'Invalid Isp.',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
[
'errorCode' => 'RestrictedUser',
'errorMessage' => 'The user\'s operation is restricted, please register NAAM product code.',
],
[
'errorCode' => 'UnauthorizedTasks',
'errorMessage' => 'You are not permitted to operate the specified tasks.',
],
],
[
[
'errorCode' => 'TaskNotExist',
'errorMessage' => 'The specified task does not exist.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternetServerError',
'errorMessage' => 'System internal error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"RequestId\\": \\"68192f5d-0d45-4b98-9724-892813f86c71\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"count\\": 1\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccessful\\r\\n\\t32E77F32-B86E-4763-A0BB-0311581ABE67\\r\\n\\t\\r\\n\\t\\t1\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '修改站点监控任务',
'requestParamsDescription' => '站点监控支持以下8种任务类型,每种任务类型对应的扩展参数(OptionsJson)如下表所示。 '."\n"
."\n"
.'- HTTP'."\n"
."\n"
.'|名称 |类型 |描述|'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|http_method |String |HTTP请求方式,支持三种:GET、POST、HEAD。默认值:GET。 |'."\n"
.'|header |String |换行符(\\n)分隔的自定义HTTP header。
每行header格式需符合HTTP协议(使用英文冒号分隔的键值)。 |'."\n"
.'|cookie |String |cookie和HTTP请求标准的写法一致。 |'."\n"
.'|request_content |String |请求内容。支持两种格式:JSON和表单。不提供时,请求中不含正文。 |'."\n"
.'|response_content |String |期望的响应内容。探测时会在HTTP服务器返回的前64个字节进行检查。 |'."\n"
.'|match_rule |String |0:响应中不含response_content时,探测成功。
1:响应中含response_content时,探测成功。 |'."\n"
.'|username |String |如果提供username,则会在HTTP请求中携带BasicAuth header。 |'."\n"
.'|password |String |HTTP请求验证密码。 |'."\n"
.'|time_out |int |超时时间。单位:毫秒。默认值:5 。 |'."\n"
.'|max_redirect |int |大跳转次数。ECS探针默认5次,运营商探针默认2次。
如果需要禁止跳转,则将该参数设置为:0。
取值范围:0~50 。 |'."\n"
."\n"
.' '."\n"
.'- PING'."\n"
."\n"
.'|名称 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|failure_rate |int |当PING失败率超过该参数时,探测失败,返回610(PingAllFail)或615(PingPartialFail)。
默认值:0.1。 |'."\n"
.'|ping_num |int |PING次数,默认值:20。
取值范围:1~100。 |'."\n"
."\n"
.'- DNS'."\n"
."\n"
.'|名称 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|dns_server |string |DNS服务器地址,可以为域名或IP地址。 |'."\n"
.'|dns_type |string |DNS查询类型。取值:A、NS、CNAME、MX、TXT、ANY。 |'."\n"
.'|expect_value |string |英文空白符分隔的期望值列表。 |'."\n"
.'|match_rule |string |期望值列表与DNS列表的关系,当不满足指定关系时,探测失败。
空字符串或IN_DNS:期望值列表是DNS列表的子集。
DNS_IN:DNS列表是期望值列表的子集。
EQUAL:DNS列表与期望值列表相等。
ANY:DNS列表与期望值列表有交集(交集不为空)。 |'."\n"
."\n"
.'- FTP'."\n"
."\n"
.'|名称 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|port |int |FTP服务器端口号。如果不提供,则使用默认值。FTP默认值:21,FTPs默认值:990。 |'."\n"
.'|username |string |FTP用户名。 如果未提供,则匿名登录。 |'."\n"
.'|password |string |FTP密码。 |'."\n"
."\n"
.'- POP3/SMTP'."\n"
."\n"
.'|名称 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|port |int |POP3服务器端口号。POP3默认值:110,POP3s默认值:995。 |'."\n"
.'|username |string |POP3/SMTP的用户名。 |'."\n"
.'|password |string |POP3/SMTP的密码 。 |'."\n"
."\n"
.'- TCP/UDP'."\n"
."\n"
.'|名称 |类型 |描述 |'."\n"
.'| ----- | -------------- | ----------- |'."\n"
.'|port |int |TCP/UDP服务器的端口。 |'."\n"
.'|request_content |string |请求内容。当request_format为hex时,request_content内容为十六进制紧凑格式。 |'."\n"
.'|request_format |string |当request_format为其他值时,request_content作为普通字符串发送给TCP/UDP服务器。 |'."\n"
.'|response_content |string |响应内容。当TCP/UDP服务器返回的内容中不含response_content时,探测失败。
当response_format为hex时,response_content中的内容为十六进制紧凑格式。
当response_content为其他值时,response_content为普通字符串。 |'."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'EnableSiteMonitors' => [
'summary' => '调用EnableSiteMonitors接口启用一个或多个站点监控任务。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TaskIds',
'in' => 'query',
'schema' => [
'description' => '站点监控任务ID。多个ID之间用英文逗号(,)分隔。',
'type' => 'string',
'required' => true,
'example' => '49f7b317-7645-4cc9-94fd-ea42e522****,49f7b317-7645-4cc9-94fd-ea42e522****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3fcd12e7-d387-42ee-b77e-661c775bb17f',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Data' => [
'description' => '站点监控任务影响探测点的记录数。',
'type' => 'object',
'properties' => [
'count' => [
'description' => '探测点的记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
[
'errorCode' => 'RestrictedUser',
'errorMessage' => 'The user\'s operation is restricted, please register NAAM product code.',
],
[
'errorCode' => 'UnauthorizedTasks',
'errorMessage' => 'You are not permitted to operate the specified tasks.',
],
],
[
[
'errorCode' => 'TaskNotExist',
'errorMessage' => 'The specified task does not exist.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"RequestId\\": \\"3fcd12e7-d387-42ee-b77e-661c775bb17f\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"count\\": 0\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\tsuccessful\\n\\t7AB49ADD-3276-4161-B9F9-8662CAA800D6\\n\\t\\n\\t\\t0\\n\\t\\n\\t200\\n\\ttrue\\n","errorExample":""}]',
'title' => '启用一个或多个站点监控任务',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSiteMonitorQuota' => [
'summary' => '调用DescribeSiteMonitorQuota接口查询站点监控的配额以及版本。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => '请求成功',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '26860260-76C6-404E-AB7A-EB98D36A6885',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Data' => [
'description' => '配额。',
'type' => 'object',
'properties' => [
'SiteMonitorOperatorQuotaQuota' => [
'description' => '非阿里巴巴探测点配额。默认值:0。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'SecondMonitor' => [
'description' => '是否开启秒级监控。取值:'."\n"
."\n"
.'- true:开启。'."\n"
."\n"
.'- false:关闭。',
'type' => 'boolean',
'example' => 'false',
],
'SiteMonitorQuotaTaskUsed' => [
'description' => '站点监控探测任务配额使用数。',
'type' => 'integer',
'format' => 'int32',
'example' => '6',
],
'SiteMonitorTaskQuota' => [
'description' => '站点监控探测任务配额。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'SiteMonitorVersion' => [
'description' => '站点监控版本。取值:'."\n"
."\n"
.'- V1:老版本。'."\n"
.' '."\n"
.'- V2:新版本。',
'type' => 'string',
'example' => 'V1',
],
'SiteMonitorIdcQuota' => [
'description' => '阿里巴巴探测点配额。免费配额5个。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'staticInfo' => [],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"请求成功\\",\\n \\"RequestId\\": \\"26860260-76C6-404E-AB7A-EB98D36A6885\\",\\n \\"Success\\": \\"true\\",\\n \\"Data\\": {\\n \\"SiteMonitorOperatorQuotaQuota\\": 0,\\n \\"SecondMonitor\\": false,\\n \\"SiteMonitorQuotaTaskUsed\\": 6,\\n \\"SiteMonitorTaskQuota\\": 10,\\n \\"SiteMonitorVersion\\": \\"V1\\",\\n \\"SiteMonitorIdcQuota\\": 5\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t请求成功\\n\\t\\tC1359088-B0D3-4344-BA51-FB920425D836\\n\\t\\t\\n\\t\\t\\tV2\\n\\t\\t\\t2\\n\\t\\t\\tfalse\\n\\t\\t\\t0\\n\\t\\t\\t100\\n\\t\\t\\t5\\n\\t\\t\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '查询站点监控的配额以及版本',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSiteMonitorAttribute' => [
'summary' => '调用DescribeSiteMonitorAttribute接口查询站点监控任务的详细信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '监控任务ID。',
'type' => 'string',
'required' => true,
'example' => 'cc641dff-c19d-45f3-ad0a-818a0c4f****',
],
],
[
'name' => 'IncludeAlert',
'in' => 'query',
'schema' => [
'description' => '返回的任务详情是否包含报警规则。'."\n"
."\n"
.'- true:如果该参数的取值为true,则返回报警规则。'."\n"
.'- false(默认值):如果该参数的取值为false,则不返回报警规则。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回结果。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'MetricRules' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MetricRule' => [
'description' => '监控任务的报警规则。',
'type' => 'array',
'items' => [
'description' => '监控任务的报警规则。',
'type' => 'object',
'properties' => [
'ActionEnable' => [
'description' => '报警规则的状态。取值:'."\n"
."\n"
.'- true:启用。'."\n"
.'- false:禁用。',
'type' => 'string',
'example' => 'true',
],
'AlarmActions' => [
'description' => '报警规则通知的报警联系组。',
'type' => 'string',
'example' => 'CloudMonitor',
],
'ComparisonOperator' => [
'description' => '报警规则的阈值比较符。取值:'."\n"
."\n"
.'- `>=`'."\n"
.'- `>`'."\n"
.'- `<=`'."\n"
.'- `<`'."\n"
.'- `=`'."\n"
.'- `!=`'."\n"
.'- GreaterThanYesterday:同比昨天同时间上涨。'."\n"
.'- LessThanYesterday:同比昨天同时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanYesterday',
],
'Dimensions' => [
'description' => '报警规则对应的维度。',
'type' => 'string',
'example' => '[{"taskId": "cc641dff-c19d-45f3-ad0a-818a0c4f****" }]',
],
'EvaluationCount' => [
'description' => '报警重试次数。',
'type' => 'string',
'example' => '3',
],
'Expression' => [
'description' => '报警规则的表达式。',
'type' => 'string',
'example' => '$Availability=30',
],
'Level' => [
'description' => '报警规则的级别。取值:'."\n"
."\n"
.'- 1:紧急。'."\n"
."\n"
.'- 2:警告。'."\n"
."\n"
.'- 3:信息。',
'type' => 'string',
'example' => '2',
],
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'Availability',
],
'Namespace' => [
'description' => '云服务的数据命名空间。',
'type' => 'string',
'example' => 'acs_networkmonitor',
],
'OkActions' => [
'description' => '收到报警的联系人组。',
'type' => 'string',
'example' => '[ "CloudMonitor"]',
],
'Period' => [
'description' => '时间间隔。通常是监控项的上报周期,单位:秒。'."\n"
."\n"
.'>如果您设置了统计周期,则会按照此周期查询对应的统计数据 。',
'type' => 'string',
'example' => '15s',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'bf071ae_7b7aec3817b0fdf****',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'rule1',
],
'StateValue' => [
'description' => '报警的状态。取值:'."\n"
."\n"
.'- OK:正常。'."\n"
."\n"
.'- ALARM:报警。',
'type' => 'string',
'example' => 'OK',
],
'Statistics' => [
'description' => '报警的统计方法。取值:'."\n"
."\n"
.'- Availability:可用探测点百分比。'."\n"
.'- AvailableNumber:可用探测点数量。'."\n"
.'- ErrorCodeMaximum:任意状态码(独立报警)。'."\n"
.'- ErrorCodeMinimum:所有状态码(组合报警)。'."\n"
.'- Average:响应时间。',
'type' => 'string',
'example' => 'Availability',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '30',
],
],
],
],
],
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'D17DF650-7EBD-54D0-903A-1D4E624D7402',
],
'SiteMonitors' => [
'description' => '监控任务详情。',
'type' => 'object',
'properties' => [
'Address' => [
'description' => '监控任务的探测地址。',
'type' => 'string',
'example' => 'https://aliyun.com',
],
'AgentGroup' => [
'description' => '探测点类型。默认为PC。'."\n"
.'取值:'."\n"
."\n"
.'- PC 固网'."\n"
."\n"
.'- MOBILE 移动端',
'type' => 'string',
'example' => 'PC',
],
'CustomSchedule' => [
'description' => '自定义探测周期。只能选择周一至周日的某个时间段进行探测。',
'type' => 'object',
'properties' => [
'days' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'days' => [
'description' => '探测日。',
'type' => 'array',
'items' => [
'description' => '探测日。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
],
],
],
'end_hour' => [
'description' => '自定义探测结束时间。'."\n"
."\n"
.'单位:小时。',
'type' => 'integer',
'format' => 'int32',
'example' => '18',
],
'start_hour' => [
'description' => '自定义探测开始时间。'."\n"
."\n"
.'单位:小时。',
'type' => 'integer',
'format' => 'int32',
'example' => '8',
],
'time_zone' => [
'description' => '自定义探测的时区。',
'type' => 'string',
'example' => 'local',
],
],
],
'Interval' => [
'description' => '监控任务的周期。单位:分钟。取值:1、 5、15、30和60。',
'type' => 'string',
'example' => '1',
],
'IspCities' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'IspCity' => [
'description' => '探测点的运营商和城市。',
'type' => 'array',
'items' => [
'description' => '探测点的运营商和城市。',
'type' => 'object',
'properties' => [
'City' => [
'description' => '城市ID。',
'type' => 'string',
'example' => '738',
],
'CityName' => [
'description' => '城市名称。',
'type' => 'string',
'example' => '北京市',
],
'Isp' => [
'description' => '运营商ID。',
'type' => 'string',
'example' => '465',
],
'IspName' => [
'description' => '运营商名称。',
'type' => 'string',
'example' => '阿里巴巴',
],
'Type' => [
'description' => '探测点网络类型。取值:'."\n"
.'IDC: IDC机房'."\n"
.'LASTMILE: 网民家宽'."\n"
.'MOBILE: 移动蜂窝网',
'type' => 'string',
'example' => 'IDC',
],
],
],
],
],
],
'OptionJson' => [
'description' => '扩展选项。每一种探测类型有不同的扩展类型,详情请参见[CreateSiteMonitor](~~115048~~)。',
'type' => 'object',
'properties' => [
'assertions' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'assertions' => [
'description' => '断言配置组。',
'type' => 'array',
'items' => [
'description' => '断言配置组。',
'type' => 'object',
'properties' => [
'operator' => [
'description' => '断言比较操作符。取值:'."\n"
.'- contains:包含。'."\n"
.'- doesNotContain:不包含。'."\n"
.'- matches:正则匹配。'."\n"
.'- doesNotMatch:正则不匹配。'."\n"
.'- is:数值等于或字符匹配相等。'."\n"
.'- isNot:不等于。'."\n"
.'- lessThan:小于。'."\n"
.'- moreThan:大于。',
'type' => 'string',
'example' => 'lessThan',
],
'property' => [
'description' => '断言内容解析路径。'."\n"
."\n"
.'- 如果断言类型为`body_json`,则路径为`json path`。'."\n"
."\n"
.'- 如果断言类型是`body_xml`,则路径为`xml path`',
'type' => 'string',
'example' => 'json path',
],
'target' => [
'description' => '断言匹配比较的目标数值或字符。',
'type' => 'string',
'example' => '0',
],
'type' => [
'description' => '断言类型。取值:'."\n"
.'- response_time:判定响应时间是否符合预期。'."\n"
.'- status_code:判断HTTP响应状态码是否符合预期。'."\n"
.'- header:判定响应Header中的字段是否符合预期。'."\n"
.'- body_text:通过文本字符匹配判断返回Body中的内容是否符合预期。'."\n"
.'- body_json:通过JSON解析(JSON Path)判断返回Body中的内容是否符合预期。'."\n"
.'- body_xml:通过XML解析(XPath)判断返回Body中的内容是否符合预期。',
'type' => 'string',
'example' => 'response_time',
],
],
],
],
],
],
'attempts' => [
'description' => 'DNS失败后重试次数。',
'type' => 'integer',
'format' => 'int64',
'example' => '3',
],
'auth_info' => [
'description' => '鉴权信息',
'type' => 'object',
'properties' => [
'type' => [
'description' => '鉴权信息,目前支持HTTP Basic Authentication。可选值为basic。',
'type' => 'string',
'example' => 'basic',
],
'username' => [
'description' => 'HTTP Basic Authentication使用的用户名',
'type' => 'string',
'example' => 'test_username',
],
'password' => [
'description' => 'HTTP Basic Authentication使用的密码',
'type' => 'string',
'example' => 'test_password',
],
'use_cookie_session_key' => [
'description' => 'digest认证中,该参数指示密钥是否存储在客户端的Cookie中。',
'type' => 'boolean',
'example' => 'false',
],
'grant_type' => [
'description' => 'Oauth2.0认证中,使用的鉴权类型。可选值为client_credentials和password',
'type' => 'string',
'example' => 'password',
],
'client_id' => [
'description' => 'Oauth2.0中使用的客户端鉴权时的客户端id',
'type' => 'string',
'example' => 'client_id',
],
'client_secret' => [
'description' => 'Oauth2.0中使用的客户端鉴权时的客户端密钥',
'type' => 'string',
'example' => 'client_secret',
],
'scopes' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'scopes' => [
'description' => 'Oauth2.0中的申请的权限范围。',
'type' => 'array',
'items' => [
'description' => 'Oauth2.0中的申请的单个权限',
'type' => 'string',
'example' => 'test_operation',
],
],
],
],
'token_url' => [
'description' => 'OAuth2.0中的认证服务器地址',
'type' => 'string',
'example' => 'https://www.example.com',
],
'auth_style' => [
'description' => 'OAuth2.0认证风格,可选值为ROA和RPC',
'type' => 'string',
'example' => 'ROA',
],
'access_key_id' => [
'description' => '仅在多步拨测中支持,使用阿里云鉴权时,传入的accessKey,建议使用加密存储',
'type' => 'string',
'example' => 'testAk',
],
'access_key_secret' => [
'description' => '仅在多步拨测中支持,使用阿里云鉴权时,传入的accessKey Secret,建议使用加密存储',
'type' => 'string',
'example' => 'testSk',
],
'region_id' => [
'description' => '仅在多步拨测中支持,使用阿里云鉴权时,请求的regionId',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'api_action' => [
'description' => '仅在多步拨测中支持,使用阿里云操作时,请求api',
'type' => 'string',
'example' => 'example_api',
],
'api_version' => [
'description' => '仅在多步拨测中支持,使用阿里云操作时,请求api版本',
'type' => 'string',
'example' => '2019-01-01',
],
'with_addon_resources' => [
'description' => '仅在多步拨测中支持,当该步使用阿里云鉴权时,操作是否存在额外资源',
'type' => 'boolean',
'example' => 'false',
],
'service_name' => [
'description' => '使用AWS鉴权时,请求的服务名称。',
'type' => 'string',
'example' => 'example_service_name',
],
'session_token' => [
'description' => '使用AWS鉴权时的session_token',
'type' => 'string',
'example' => 'example_token',
],
],
],
'blocked_url_list' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'blocked_url_list' => [
'description' => '屏蔽的资源URL列表。支持路径通配符。',
'type' => 'array',
'items' => [
'description' => '屏蔽的资源URL列表。支持路径通配符。',
'type' => 'string',
'example' => 'www.taobao.com/**',
],
],
],
],
'browser_headers' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'browser_headers' => [
'description' => '自定义Header。结构为`{"key": "somekey", "value":"somevalue"}`',
'type' => 'array',
'items' => [
'description' => '自定义Header。结构为`{"key": "somekey", "value":"somevalue"}`',
'type' => 'object',
'example' => '{"key":"value"}',
],
],
],
],
'browser_hosts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'browser_hosts' => [
'description' => '自定义Host。结构为`{"url":"someurl", "ip":"someip"}`。',
'type' => 'array',
'items' => [
'description' => '自定义Host。结构为`{"url":"someurl", "ip":"someip"}`。',
'type' => 'string',
'example' => '{"url":"www.taobao.com","ip":"127.0.0.1"}',
],
],
],
],
'browser_info' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'browser_info' => [
'description' => '浏览器信息。',
'type' => 'array',
'items' => [
'description' => '浏览器信息。',
'type' => 'object',
'properties' => [
'browser' => [
'description' => '浏览器类型。',
'type' => 'string',
'example' => 'Chrome',
],
'device' => [
'description' => '屏幕类型。',
'type' => 'string',
'example' => 'laptop',
],
],
],
],
],
],
'browser_insecure' => [
'description' => '是否忽略证书错误。取值:'."\n"
."\n"
.'- false:不忽略证书错误。'."\n"
.'- true:忽略证书错误。',
'type' => 'boolean',
'example' => 'false',
],
'browser_task_version' => [
'description' => '浏览器拨测版本。取值:'."\n"
."\n"
.'- 1:单页拨测。'."\n"
.'- 2:多页拨测。',
'type' => 'string',
'example' => '1',
],
'cookie' => [
'description' => '发送HTTP请求的Cookie。',
'type' => 'string',
'example' => 'lang=en',
],
'diagnosis_mtr' => [
'description' => '是否开启任务失败后的自动MTR网络诊断。取值:'."\n"
.'- false:不开启自动MTR网络诊断。'."\n"
.'- true 开启自动MTR网络诊断。',
'type' => 'boolean',
'example' => 'false',
],
'diagnosis_ping' => [
'description' => '是否开启任务失败后自动PING网络延时探测。取值:'."\n"
.'- false:不开启自动PING网络延时探测。'."\n"
.'- true:开启自动PING网络延时探测。',
'type' => 'boolean',
'example' => 'false',
],
'dns_hijack_whitelist' => [
'description' => 'DNS劫持配置列表。',
'type' => 'string',
'example' => 'www.taobao.com:www.taobao.com.danuoyi.tbcache.com',
],
'dns_match_rule' => [
'description' => 'DNS的匹配规则。取值:'."\n"
."\n"
.'- IN_DNS:期望解析的别名或IP地址均在DNS应答中。'."\n"
.'- DNS_IN:所有的DNS应答都出现在期望解析的别名或IP地址中。'."\n"
.'- EQUAL:DNS应答和期望解析的别名或IP地址完全相同。'."\n"
.'- ANY:DNS应答和期望解析的别名或IP地址有交集。',
'type' => 'string',
'example' => 'IN_DNS',
],
'dns_server' => [
'description' => 'DNS服务器的IP地址。'."\n"
."\n"
.'> 仅适用于DNS探测类型。',
'type' => 'string',
'example' => '192.168.XX.XX',
],
'dns_type' => [
'description' => 'DNS解析类型。仅适用于DNS探测类型。取值:'."\n"
.'- A:指定主机名或域名对应的IP地址。'."\n"
.'- CNAME:将多个域名映射到另外一个域名。'."\n"
.'- NS:指定域名由某个DNS服务器解析。'."\n"
.'- MX:将域名指向一个邮件服务器地址。'."\n"
.'- TXT:主机名或域名的说明。文本长度限制512字节,通常用做SPF(Sender Policy Framework)记录,即反垃圾邮件。',
'type' => 'string',
'example' => 'A',
],
'empty_message' => [
'description' => '是否允许WebSocket任务不返回消息或返回空消息。取值:'."\n"
.'- false(默认):否。'."\n"
.'- true: 是。',
'type' => 'boolean',
'example' => 'false',
],
'expect_exist_string' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'expect_exist_string' => [
'description' => '期待页面中存在的字符串列表。',
'type' => 'array',
'items' => [
'description' => '期待页面中存在的字符串列表。',
'type' => 'string',
'example' => 'expected string',
],
],
],
],
'expect_non_exist_string' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'expect_non_exist_string' => [
'description' => '期待页面中不存在的字符串列表。',
'type' => 'array',
'items' => [
'description' => '期待页面中不存在的字符串列表。',
'type' => 'string',
'example' => 'unexpected string',
],
],
],
],
'expect_value' => [
'description' => '待解析的别名或地址。'."\n"
."\n"
.'> 该参数仅适用于DNS探测类型。',
'type' => 'string',
'example' => 'dns_server',
],
'failure_rate' => [
'description' => '丢包率。'."\n"
."\n"
.'> 该参数仅适用于PING探测类型。',
'type' => 'number',
'format' => 'float',
'example' => '0.4',
],
'header' => [
'description' => 'HTTP请求头。',
'type' => 'string',
'example' => 'testKey:testValue',
],
'http_method' => [
'description' => 'HTTP请求方法。取值:'."\n"
.'- get '."\n"
.'- post'."\n"
.'- head',
'type' => 'string',
'example' => 'get',
],
'ip_network' => [
'description' => 'ip_network指示该任务的网络类型,可选值为v4,v6,auto,默认值为v4',
'type' => 'string',
'example' => 'v4',
'enum' => [],
],
'isBase64Encode' => [
'description' => '是否对密码进行base64解码存储。取值:'."\n"
.'- true:对密码进行base64解码存储。'."\n"
.'- false:不对密码进行base64解码存储。',
'type' => 'string',
'example' => 'false',
],
'match_rule' => [
'description' => '是否包含报警规则。取值:'."\n"
.'- 0:是。'."\n"
.'- 1:否。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'min_tls_version' => [
'description' => '最低TLS版本。默认支持TLS1.2及以上版本,TLS1.0和1.1已被禁用,如仍需支持可更改配置',
'type' => 'string',
'example' => 'tlsv1.2',
],
'password' => [
'description' => 'SMTP、POP3或FTP探测类型的密码。',
'type' => 'string',
'example' => '123****',
],
'ping_num' => [
'description' => 'PING探测类型的心跳。',
'type' => 'integer',
'format' => 'int32',
'example' => '29',
],
'ping_port' => [
'description' => 'PING端口。适用于TCP PING。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'ping_type' => [
'description' => 'PING协议类型。取值:'."\n"
."\n"
.'- icmp'."\n"
."\n"
.'- tcp'."\n"
."\n"
.'- udp',
'type' => 'string',
'example' => 'icmp',
'default' => 'icmp',
],
'port' => [
'description' => 'TCP、UDP、SMTP、POP3探测类型的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '110',
],
'protocol' => [
'description' => '探测协议。',
'type' => 'string',
'example' => 'TCP',
],
'quic_enabled' => [
'description' => '浏览器拨测是否使用quic协议,取值:'."\n"
.'true,使用quic协议'."\n"
.'false,不实用quic协议'."\n"
.'默认值为false',
'type' => 'boolean',
'example' => 'true',
],
'quic_target' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'quic_target' => [
'description' => '强制使用quic协议的站点列表',
'type' => 'array',
'items' => [
'description' => '强制使用quic协议的站点,格式为url:port,port可以不填,默认为443',
'type' => 'string',
'example' => 'www.taobao.com',
],
],
],
],
'request_content' => [
'description' => 'HTTP探测类型的请求内容。',
'type' => 'string',
'example' => 'aa=bb',
],
'request_format' => [
'description' => 'HTTP请求内容格式。取值:'."\n"
.'- hex:十六进制格式。'."\n"
.'- txt:文本格式。',
'type' => 'string',
'example' => 'txt',
],
'response_content' => [
'description' => '匹配响应内容。',
'type' => 'string',
'example' => 'txt',
],
'response_format' => [
'description' => 'HTTP响应内容格式。取值:'."\n"
.'- hex:十六进制格式。'."\n"
.'- txt:文本格式。',
'type' => 'string',
'example' => 'txt',
],
'retry_delay' => [
'description' => '探测失败后重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'screen_shot' => [
'description' => '是否开启页面截图',
'type' => 'boolean',
'example' => 'false',
],
'time_out' => [
'description' => '超时时间。单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '3',
],
'traffic_hijack_element_blacklist' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'traffic_hijack_element_blacklist' => [
'description' => '当发生重定向时,如果浏览器加载资源的URL与该列表中的表达能匹配,则认为发生流量劫持。',
'type' => 'array',
'items' => [
'description' => '当发生重定向时,如果浏览器加载资源的URL与该列表中的表达能匹配,则认为发生流量劫持。',
'type' => 'string',
'example' => 'www.taobao.com',
],
],
],
],
'traffic_hijack_element_count' => [
'description' => '当发生重定向时,如果浏览器加载资源数超过这个值,则认为发生流量劫持。当该值为0时,不进行校验,默认值为0。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'traffic_hijack_element_whitelist' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'traffic_hijack_element_whitelist' => [
'description' => '当发生重定向时,如果浏览器加载资源的URL与该列表中的任意一个表达式都不匹配,则认为发生流量劫持。',
'type' => 'array',
'items' => [
'description' => '当发生重定向时,如果浏览器加载资源的URL与该列表中的任意一个表达式都不匹配,则认为发生流量劫持。',
'type' => 'string',
'example' => 'www.taobao.com',
],
],
],
],
'username' => [
'description' => 'FTP、SMTP或POP3的用户名。',
'type' => 'string',
'example' => 'testUser',
],
'waitTime_after_completion' => [
'description' => '浏览器拨测任务中,页面打开后的额外等待时间。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'scroll_end' => [
'description' => '当任务为浏览器探测任务时,scroll_end代表打开页面之后是否滚动到页面最下端。',
'type' => 'boolean',
'example' => 'false',
],
'host_binding' => [
'description' => 'HTTP任务自定义host,格式为ip1,ip2:address,可以配置多行映射。冒号左边是域名可被解析的A记录或者cname,使用逗号隔开,冒号右边是域名。',
'type' => 'string',
'example' => '127.0.0.1:www.aliyun.com',
],
'host_binding_type' => [
'description' => 'host_binding_type的可选值为0或1,指示自定义host的生效方式。0表示随机,1表示轮询。',
'type' => 'integer',
'format' => 'int32',
'enumValueTitles' => [
'0',
'1',
],
'example' => '0',
],
'hops' => [
'description' => '指定PING任务失败时,执行traceroute诊断的跳数',
'type' => 'integer',
'format' => 'int32',
'example' => '20',
],
'icmp_timeout_millis' => [
'description' => '指定使用ICMP协议进行的PING任务的单次PING超时时间,单位为毫秒',
'type' => 'integer',
'format' => 'int32',
'example' => '3000',
],
'config_variables' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'config_variables' => [
'description' => '环境变量配置,对多步探测生效。',
'type' => 'array',
'items' => [
'description' => '环境变量可以在不同测试步骤的参数中被引用(使用占位符 {{$.变量名称}} ,也可以从一步测试结果中解析返回内容并对对应的变量更新赋值且在下一步的测试中引用。 对于敏感信息,如API密钥,可勾选加密存储。',
'type' => 'object',
'properties' => [
'name' => [
'description' => '环境变量名称',
'type' => 'string',
'example' => 'variable_name',
],
'value' => [
'description' => '变量值',
'type' => 'string',
'example' => 'variable_value',
],
'secure' => [
'description' => '加密存储',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
],
'steps' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'steps' => [
'description' => '对多步探测生效。多步探测中的步骤配置。',
'type' => 'array',
'items' => [
'description' => '多步探测中的单步配置。',
'type' => 'object',
'properties' => [
'name' => [
'description' => '步骤名称(已废弃)。',
'type' => 'string',
'deprecated' => true,
'example' => 'step1',
],
'step_type' => [
'description' => '该步骤的拨测类型。可选类型有'."\n"
.'- http'."\n"
.'- ping'."\n"
.'- tcp'."\n"
.'- udp'."\n"
.'- dns'."\n"
.'- smtp'."\n"
.'- pop3'."\n"
.'- ftp'."\n"
.'- wait'."\n"
."\n"
.'其中wait为等待步骤。',
'type' => 'string',
'example' => 'http',
],
'url' => [
'description' => '多步拨测中,单步拨测的url',
'type' => 'string',
'example' => 'https://aliyun.com',
],
'allow_failure' => [
'description' => '当前步骤如果失败,是否还继续下一步探测。默认值为false。',
'type' => 'boolean',
'example' => 'true',
],
'is_critical' => [
'description' => '如果当前步骤失败,则会标记整个探测为失败。默认值为false。',
'type' => 'boolean',
'example' => 'true',
],
'wait_time_in_secs' => [
'description' => '等待时间,单位为秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'extracted_variables' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'extracted_variables' => [
'description' => '变量提取配置',
'type' => 'array',
'items' => [
'description' => '单个变量提取配置。',
'type' => 'object',
'properties' => [
'name' => [
'description' => '变量名。',
'type' => 'string',
'example' => 'test_variable',
],
'parser' => [
'description' => '变量提取方法设置',
'type' => 'object',
'properties' => [
'parser_type' => [
'description' => '提取变量的模式。0为json,1为xml,2为正则。',
'type' => 'string',
'example' => '0',
],
'value' => [
'description' => '变量提取表达式'."\n"
.'提取方式为json和xml时,变量提取表达式支持xml格式。'."\n"
.'提取方式为正则表达式时,提取和该值匹配的字符串。',
'type' => 'string',
'example' => 'x.testkey.arrayvalue[0].innerkey',
],
],
],
'field' => [
'description' => '当变量位置为http header时,该选项生效。提取header中该选项所指向的key。',
'type' => 'string',
'example' => 'request_id',
],
'extracted_type' => [
'description' => '提取变量的位置。0为http body,1为http header。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
'option' => [
'description' => '该步骤的扩展选项。每一种探测类型有不同的扩展类型,详情请参见[CreateSiteMonitor](~~115048~~)。',
'type' => 'string',
'example' => '{"enable_operator_dns": true}',
],
'step_name' => [
'description' => '步骤名称。',
'type' => 'string',
'example' => 'step1',
],
'use_generated_cookie' => [
'description' => '是否使用该步之前提取出的cookie。默认值为false。',
'type' => 'boolean',
'example' => 'true',
],
'auto_extract_cookie' => [
'description' => '自动提取cookie,这一步http的单步拨测返回的header里的set-cookie将会被解析,并在之后的拨测步骤里可见。默认值为false。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
],
'trace_region' => [
'description' => '设置与可观测链路OpenTelemetry版本集成时,目标应用的部署地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'trace_type' => [
'description' => '设置与可观测链路OpenTelemetry版本集成时,使用的链路追踪协议。'."\n"
.'可选值为'."\n"
.'- OpenTelemetry'."\n"
.'- Zipkin'."\n"
.'- Jaeger',
'type' => 'string',
'example' => 'OpenTelemetry',
],
'safe_link' => [
'description' => '对SMTP类型的任务生效。设置为1时,使用安全连接。默认值为0。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'enable_packet_capture' => [
'description' => '该任务是否开启抓包',
'type' => 'boolean',
'example' => 'true',
],
'use_private_crt' => [
'title' => '是否使用私有证书',
'description' => '是否使用私有证书',
'type' => 'boolean',
],
'private_crt_file_name' => [
'title' => '私有证书文件名',
'description' => '私有证书文件名',
'type' => 'string',
'example' => 'cert.pem',
],
'use_ssl' => [
'title' => '执行TCP任务时是否进行SSL连接',
'description' => '执行TCP任务时是否进行SSL连接',
'type' => 'boolean',
'example' => 'tlsv1.0',
],
'max_tls_version' => [
'title' => '最高TLS版本',
'description' => '最高TLS版本',
'type' => 'string',
'example' => 'tlsv1.3',
],
'server_name' => [
'title' => '服务器名称指示',
'description' => '服务器名称指示',
'type' => 'string',
'example' => 'www.aliyun.com',
],
'supported_cipher_suits' => [
'title' => '支持的加密套件',
'description' => '支持的加密套件',
'type' => 'string',
'example' => 'TLS_AES_256_GCM_SHA384',
],
],
],
'TaskId' => [
'description' => '监控任务ID。',
'type' => 'string',
'example' => 'cc641dff-c19d-45f3-ad0a-818a0c4f****',
],
'TaskName' => [
'description' => '监控任务名称。',
'type' => 'string',
'example' => 'test123',
],
'TaskState' => [
'description' => '监控任务的状态。取值:'."\n"
."\n"
.'- 1:启用。'."\n"
.'- 2:禁用。',
'type' => 'string',
'example' => '1',
],
'TaskType' => [
'description' => '监控任务类型。目前站点监控任务的类型包括:HTTP(S)、PING、TCP、UDP、DNS、SMTP、POP3、FTP。',
'type' => 'string',
'example' => 'HTTP',
],
'VpcConfig' => [
'description' => '内网拨测任务的VPC配置信息。',
'type' => 'object',
'properties' => [
'Region' => [
'description' => '内网拨测任务的目标站点所在地域。',
'type' => 'string',
'example' => 'cn-beijing',
],
'SecurityGroupId' => [
'description' => '该内网拨测任务受限于的安全组id。',
'type' => 'string',
'example' => 'sg-xxxxxx',
],
'VpcId' => [
'description' => '该内网拨测任务挂载的vpc id。',
'type' => 'string',
'example' => 'vpc-xxxxxx',
],
'VswitchId' => [
'description' => '该内网拨测任务挂载的vswitch id。',
'type' => 'string',
'example' => 'vsw-xxxxxx',
],
],
],
],
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'The parameter is missing or invalid. %s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'Task Id does not exist',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"MetricRules\\": {\\n \\"MetricRule\\": [\\n {\\n \\"ActionEnable\\": \\"true\\",\\n \\"AlarmActions\\": \\"CloudMonitor\\",\\n \\"ComparisonOperator\\": \\"GreaterThanYesterday\\",\\n \\"Dimensions\\": \\"[{\\\\\\"taskId\\\\\\": \\\\\\"cc641dff-c19d-45f3-ad0a-818a0c4f****\\\\\\" }]\\",\\n \\"EvaluationCount\\": \\"3\\",\\n \\"Expression\\": \\"$Availability=30\\",\\n \\"Level\\": \\"2\\",\\n \\"MetricName\\": \\"Availability\\",\\n \\"Namespace\\": \\"acs_networkmonitor\\",\\n \\"OkActions\\": \\"[ \\\\\\"CloudMonitor\\\\\\"]\\",\\n \\"Period\\": \\"15s\\",\\n \\"RuleId\\": \\"bf071ae_7b7aec3817b0fdf****\\",\\n \\"RuleName\\": \\"rule1\\",\\n \\"StateValue\\": \\"OK\\",\\n \\"Statistics\\": \\"Availability\\",\\n \\"Threshold\\": \\"30\\"\\n }\\n ]\\n },\\n \\"RequestId\\": \\"D17DF650-7EBD-54D0-903A-1D4E624D7402\\",\\n \\"SiteMonitors\\": {\\n \\"Address\\": \\"https://aliyun.com\\",\\n \\"AgentGroup\\": \\"PC\\",\\n \\"CustomSchedule\\": {\\n \\"days\\": {\\n \\"days\\": [\\n 1\\n ]\\n },\\n \\"end_hour\\": 18,\\n \\"start_hour\\": 8,\\n \\"time_zone\\": \\"local\\"\\n },\\n \\"Interval\\": \\"1\\",\\n \\"IspCities\\": {\\n \\"IspCity\\": [\\n {\\n \\"City\\": \\"738\\",\\n \\"CityName\\": \\"北京市\\",\\n \\"Isp\\": \\"465\\",\\n \\"IspName\\": \\"阿里巴巴\\",\\n \\"Type\\": \\"IDC\\"\\n }\\n ]\\n },\\n \\"OptionJson\\": {\\n \\"assertions\\": {\\n \\"assertions\\": [\\n {\\n \\"operator\\": \\"lessThan\\",\\n \\"property\\": \\"json path\\",\\n \\"target\\": \\"0\\",\\n \\"type\\": \\"response_time\\"\\n }\\n ]\\n },\\n \\"attempts\\": 3,\\n \\"auth_info\\": {\\n \\"type\\": \\"basic\\",\\n \\"username\\": \\"test_username\\",\\n \\"password\\": \\"test_password\\",\\n \\"use_cookie_session_key\\": false,\\n \\"grant_type\\": \\"password\\",\\n \\"client_id\\": \\"client_id\\",\\n \\"client_secret\\": \\"client_secret\\",\\n \\"scopes\\": {\\n \\"scopes\\": [\\n \\"test_operation\\"\\n ]\\n },\\n \\"token_url\\": \\"https://www.example.com\\",\\n \\"auth_style\\": \\"ROA\\",\\n \\"access_key_id\\": \\"testAk\\",\\n \\"access_key_secret\\": \\"testSk\\",\\n \\"region_id\\": \\"cn-hangzhou\\",\\n \\"api_action\\": \\"example_api\\",\\n \\"api_version\\": \\"2019-01-01\\",\\n \\"with_addon_resources\\": false,\\n \\"service_name\\": \\"example_service_name\\",\\n \\"session_token\\": \\"example_token\\"\\n },\\n \\"blocked_url_list\\": {\\n \\"blocked_url_list\\": [\\n \\"www.taobao.com/**\\"\\n ]\\n },\\n \\"browser_headers\\": {\\n \\"browser_headers\\": [\\n {\\n \\"key\\": \\"value\\"\\n }\\n ]\\n },\\n \\"browser_hosts\\": {\\n \\"browser_hosts\\": [\\n \\"{\\\\\\"url\\\\\\":\\\\\\"www.taobao.com\\\\\\",\\\\\\"ip\\\\\\":\\\\\\"127.0.0.1\\\\\\"}\\"\\n ]\\n },\\n \\"browser_info\\": {\\n \\"browser_info\\": [\\n {\\n \\"browser\\": \\"Chrome\\",\\n \\"device\\": \\"laptop\\"\\n }\\n ]\\n },\\n \\"browser_insecure\\": false,\\n \\"browser_task_version\\": \\"1\\",\\n \\"cookie\\": \\"lang=en\\",\\n \\"diagnosis_mtr\\": false,\\n \\"diagnosis_ping\\": false,\\n \\"dns_hijack_whitelist\\": \\"www.taobao.com:www.taobao.com.danuoyi.tbcache.com\\",\\n \\"dns_match_rule\\": \\"IN_DNS\\",\\n \\"dns_server\\": \\"192.168.XX.XX\\",\\n \\"dns_type\\": \\"A\\",\\n \\"empty_message\\": false,\\n \\"expect_exist_string\\": {\\n \\"expect_exist_string\\": [\\n \\"expected string\\"\\n ]\\n },\\n \\"expect_non_exist_string\\": {\\n \\"expect_non_exist_string\\": [\\n \\"unexpected string\\"\\n ]\\n },\\n \\"expect_value\\": \\"dns_server\\",\\n \\"failure_rate\\": 0.4,\\n \\"header\\": \\"testKey:testValue\\",\\n \\"http_method\\": \\"get\\",\\n \\"ip_network\\": \\"v4\\",\\n \\"isBase64Encode\\": \\"false\\",\\n \\"match_rule\\": 1,\\n \\"min_tls_version\\": \\"tlsv1.2\\",\\n \\"password\\": \\"123****\\",\\n \\"ping_num\\": 29,\\n \\"ping_port\\": 80,\\n \\"ping_type\\": \\"icmp\\",\\n \\"port\\": 110,\\n \\"protocol\\": \\"TCP\\",\\n \\"quic_enabled\\": true,\\n \\"quic_target\\": {\\n \\"quic_target\\": [\\n \\"www.taobao.com\\"\\n ]\\n },\\n \\"request_content\\": \\"aa=bb\\",\\n \\"request_format\\": \\"txt\\",\\n \\"response_content\\": \\"txt\\",\\n \\"response_format\\": \\"txt\\",\\n \\"retry_delay\\": 0,\\n \\"screen_shot\\": false,\\n \\"strict_mode\\": false,\\n \\"time_out\\": 3,\\n \\"traffic_hijack_element_blacklist\\": {\\n \\"traffic_hijack_element_blacklist\\": [\\n \\"www.taobao.com\\"\\n ]\\n },\\n \\"traffic_hijack_element_count\\": 0,\\n \\"traffic_hijack_element_whitelist\\": {\\n \\"traffic_hijack_element_whitelist\\": [\\n \\"www.taobao.com\\"\\n ]\\n },\\n \\"username\\": \\"testUser\\",\\n \\"waitTime_after_completion\\": 3,\\n \\"scroll_end\\": false,\\n \\"host_binding\\": \\"127.0.0.1:www.aliyun.com\\",\\n \\"host_binding_type\\": 0,\\n \\"hops\\": 20,\\n \\"icmp_timeout_millis\\": 3000,\\n \\"config_variables\\": {\\n \\"config_variables\\": [\\n {\\n \\"name\\": \\"variable_name\\",\\n \\"value\\": \\"variable_value\\",\\n \\"secure\\": true\\n }\\n ]\\n },\\n \\"steps\\": {\\n \\"steps\\": [\\n {\\n \\"name\\": \\"step1\\",\\n \\"step_type\\": \\"http\\",\\n \\"url\\": \\"https://aliyun.com\\",\\n \\"allow_failure\\": true,\\n \\"is_critical\\": true,\\n \\"wait_time_in_secs\\": 5,\\n \\"extracted_variables\\": {\\n \\"extracted_variables\\": [\\n {\\n \\"name\\": \\"test_variable\\",\\n \\"parser\\": {\\n \\"parser_type\\": \\"0\\",\\n \\"value\\": \\"x.testkey.arrayvalue[0].innerkey\\"\\n },\\n \\"field\\": \\"request_id\\",\\n \\"extracted_type\\": \\"1\\"\\n }\\n ]\\n },\\n \\"option\\": \\"{\\\\\\"enable_operator_dns\\\\\\": true}\\",\\n \\"step_name\\": \\"step1\\",\\n \\"use_generated_cookie\\": true,\\n \\"auto_extract_cookie\\": true\\n }\\n ]\\n },\\n \\"trace_region\\": \\"cn-hangzhou\\",\\n \\"trace_type\\": \\"OpenTelemetry\\",\\n \\"safe_link\\": 0,\\n \\"enable_packet_capture\\": true,\\n \\"use_private_crt\\": true,\\n \\"private_crt_file_name\\": \\"cert.pem\\",\\n \\"use_ssl\\": true,\\n \\"max_tls_version\\": \\"tlsv1.3\\",\\n \\"server_name\\": \\"www.aliyun.com\\",\\n \\"supported_cipher_suits\\": \\"TLS_AES_256_GCM_SHA384\\"\\n },\\n \\"TaskId\\": \\"cc641dff-c19d-45f3-ad0a-818a0c4f****\\",\\n \\"TaskName\\": \\"test123\\",\\n \\"TaskState\\": \\"1\\",\\n \\"TaskType\\": \\"HTTP\\",\\n \\"VpcConfig\\": {\\n \\"Region\\": \\"cn-beijing\\",\\n \\"SecurityGroupId\\": \\"sg-xxxxxx\\",\\n \\"VpcId\\": \\"vpc-xxxxxx\\",\\n \\"VswitchId\\": \\"vsw-xxxxxx\\"\\n }\\n },\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tGreaterThanYesterday\\r\\n\\t\\t\\tbf071ae_7b7aec3817b0fdf****\\r\\n\\t\\t\\t15s\\r\\n\\t\\t\\t3\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tcc641dff-c19d-45f3-ad0a-818a0c4f****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tAvailability\\r\\n\\t\\t\\tacs_networkmonitor\\r\\n\\t\\t\\tCloudMonitor\\r\\n\\t\\t\\tAvailability\\r\\n\\t\\t\\tCloudMonitor\\r\\n\\t\\t\\t$Availability=30\\r\\n\\t\\t\\ttrue\\r\\n\\t\\t\\tOK\\r\\n\\t\\t\\t2\\r\\n\\t\\t\\trule1\\r\\n\\t\\t\\t30\\r\\n\\t\\t\\r\\n\\t\\r\\n\\tsuccessful\\r\\n\\tD17DF650-7EBD-54D0-903A-1D4E624D7402\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t30000\\r\\n\\t\\t\\tget\\r\\n\\t\\t\\r\\n\\t\\tcc641dff-c19d-45f3-ad0a-818a0c4f****\\r\\n\\t\\thttps://aliyun.com\\r\\n\\t\\ttest123\\r\\n\\t\\tHTTP\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t阿里巴巴\\r\\n\\t\\t\\t\\t465\\r\\n\\t\\t\\t\\t北京市\\r\\n\\t\\t\\t\\t738\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t1\\r\\n\\t\\t1\\r\\n\\t\\r\\n\\t","errorExample":""}]',
'title' => '查询站点监控任务的详细信息',
'description' => '本文将提供一个示例,查询站点监控任务`cc641dff-c19d-45f3-ad0a-818a0c4f****`的详细信息,返回结果显示,站点监控任务的名称为`test123`、探测地址为`https://aliyun.com`、运营商为`阿里巴巴`等信息。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSiteMonitorISPCityList' => [
'summary' => '调用DescribeSiteMonitorISPCityList接口查询所有运营商探测点详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Isp',
'in' => 'query',
'schema' => [
'description' => '运营商探测点的名称或ID。'."\n"
."\n"
.'> 运营商名称支持模糊查询。',
'type' => 'string',
'required' => false,
'example' => '联通',
],
],
[
'name' => 'City',
'in' => 'query',
'schema' => [
'description' => '运营商探测点所在城市的名称或ID。'."\n"
."\n"
.'> 城市名称支持模糊查询。',
'type' => 'string',
'required' => false,
'example' => '贵阳市',
],
],
[
'name' => 'IPV6',
'in' => 'query',
'schema' => [
'description' => '是否查询IPv6探针。取值:'."\n"
.'- true(默认值):查询IPv6探针。'."\n"
.'- false:不查询IPv6探针。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'IPV4',
'in' => 'query',
'schema' => [
'description' => '是否查询IPv4探针。取值:'."\n"
.'- true(默认值):查询IPv4探针。'."\n"
.'- false:不查询IPv4探针。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'ViewAll',
'in' => 'query',
'schema' => [
'description' => '是否返回所有探测点。取值:'."\n"
."\n"
.'- true(默认值):返回所有探测点。'."\n"
.'- false:只返回可用探测点。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'B35D7D84-547B-4E61-B909-48A1F8A0C756',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'IspCityList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'IspCity' => [
'description' => '探测点列表。',
'type' => 'array',
'items' => [
'description' => '探测点列表。',
'type' => 'object',
'properties' => [
'CityName.en' => [
'description' => '城市名称(英文)。',
'type' => 'string',
'example' => 'Guiyang',
],
'IPV4ProbeCount' => [
'description' => 'IPv4探针数量。',
'type' => 'string',
'example' => '4',
],
'City' => [
'description' => '城市ID。',
'type' => 'string',
'example' => '4',
],
'Isp' => [
'description' => '运营商ID。',
'type' => 'string',
'example' => '232',
],
'CityName.zh_CN' => [
'description' => '城市名称(简体中文)。'."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '贵阳市',
],
'Region.zh_CN' => [
'description' => '省份(简体中文)。'."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '贵州省',
],
'IspName.zh_CN' => [
'description' => '运营商名称(简体中文)。'."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '联通',
],
'Country.en' => [
'description' => '国家(英文)。',
'type' => 'string',
'example' => 'China',
],
'IPV6ProbeCount' => [
'description' => 'IPv6探针数量。',
'type' => 'string',
'example' => '3',
],
'Region' => [
'description' => '省份代码。',
'type' => 'string',
'example' => '264',
],
'Country' => [
'description' => '国家代码。',
'type' => 'string',
'example' => '629',
],
'IspName.en' => [
'description' => '运营商名称(英文)。',
'type' => 'string',
'example' => 'China-Unicom',
],
'Region.en' => [
'description' => '省份(英文)。',
'type' => 'string',
'example' => 'Guizhou',
],
'Country.zh_CN' => [
'description' => '国家(简体中文)。'."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '中国',
],
'Area.zh_CN' => [
'description' => '区域(简体中文)。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '西南',
],
'Area.en' => [
'description' => '区域(汉语拼音)。',
'type' => 'string',
'example' => 'XiNan',
],
'IPPool' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'IPPool' => [
'description' => 'IP地址池。',
'type' => 'array',
'items' => [
'description' => 'IP地址池。',
'type' => 'string',
'example' => '["192.68.XX.XX","192.68.XX.XX"]',
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"RequestId\\": \\"B35D7D84-547B-4E61-B909-48A1F8A0C756\\",\\n \\"Success\\": \\"true\\",\\n \\"IspCityList\\": {\\n \\"IspCity\\": [\\n {\\n \\"CityName.en\\": \\"Guiyang\\",\\n \\"IPV4ProbeCount\\": \\"4\\",\\n \\"City\\": \\"4\\",\\n \\"Isp\\": \\"232\\",\\n \\"CityName.zh_CN\\": \\"贵阳市\\",\\n \\"Region.zh_CN\\": \\"贵州省\\",\\n \\"IspName.zh_CN\\": \\"联通\\",\\n \\"Country.en\\": \\"China\\",\\n \\"IPV6ProbeCount\\": \\"3\\",\\n \\"Region\\": \\"264\\",\\n \\"Country\\": \\"629\\",\\n \\"IspName.en\\": \\"China-Unicom\\",\\n \\"Region.en\\": \\"Guizhou\\",\\n \\"Country.zh_CN\\": \\"中国\\",\\n \\"Area.zh_CN\\": \\"西南\\",\\n \\"Area.en\\": \\"XiNan\\",\\n \\"IPPool\\": {\\n \\"IPPool\\": [\\n \\"[\\\\\\"192.68.XX.XX\\\\\\",\\\\\\"192.68.XX.XX\\\\\\"]\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tsuccessful\\r\\n\\tB35D7D84-547B-4E61-B909-48A1F8A0C756\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t中国\\r\\n\\t\\t\\t西南\\r\\n\\t\\t\\tGuiyang\\r\\n\\t\\t\\t4\\r\\n\\t\\t\\t232\\r\\n\\t\\t\\t4\\r\\n\\t\\t\\tChina-Unicom\\r\\n\\t\\t\\tChina\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t贵阳市\\r\\n\\t\\t\\tXiNan\\r\\n\\t\\t\\t贵州省\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t264\\r\\n\\t\\t\\t629\\r\\n\\t\\t\\t联通\\r\\n\\t\\t\\tGuizhou\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t192.168.XX.XX\\r\\n\\t\\t\\t\\t192.168.XX.XX\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\r\\n","errorExample":""}]',
'title' => '查询所有运营商探测点详情',
'description' => '本文将提供一个示例,查询运营商“联通”在“贵阳市”的探测点详情。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSiteMonitorData' => [
'summary' => '调用DescribeSiteMonitorData接口查询任务的细粒度监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '任务ID。',
'type' => 'string',
'required' => true,
'example' => '49f7b317-7645-4cc9-94fd-ea42e522****',
],
],
[
'name' => 'Type',
'in' => 'query',
'schema' => [
'description' => '监控的数据类型。取值:'."\n"
.'- metric:时序类指标监控'."\n"
.'- event:事件类监控',
'type' => 'string',
'required' => false,
'example' => 'metric',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项的名称。取值:'."\n"
.'- Availability:可用率'."\n"
.'- ResponseTime:响应时间',
'type' => 'string',
'required' => true,
'example' => 'Availability',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
."\n"
.'- Format格式:YYYY-MM-DDThh:mm:ssZ。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '1551579637000',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
."\n"
.'- Format格式:YYYY-MM-DDThh:mm:ssZ。',
'type' => 'string',
'required' => false,
'example' => '1551581437000',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '统计周期。单位:秒,取值为60或60的整数倍。'."\n"
.'>默认根据探测频率最小周期返回数据。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '分页游标。',
'type' => 'string',
'required' => false,
'example' => '49f7b317-7645-4cc9-94fd-ea42e5220930ea42e5220930ea42e522****',
],
],
[
'name' => 'Length',
'in' => 'query',
'schema' => [
'description' => '返回的数据点数量。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1000',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '分页游标。',
'type' => 'string',
'example' => 'ea42e5220930ea42e522****',
],
'Data' => [
'description' => '监控数据。',
'type' => 'string',
'example' => '[{"Maximum":247,"Mimimum":61,"Average":154,"userId":"127067667954****","taskId":"49f7b317-7645-4cc9-94fd-ea42e522****","timestamp":1551581760000}]',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3febb181-0d98-4af9-8b04-7faf36b048b9',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'string',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'Successful',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Data\\": \\"[{\\\\\\"Maximum\\\\\\":247,\\\\\\"Mimimum\\\\\\":61,\\\\\\"Average\\\\\\":154,\\\\\\"userId\\\\\\":\\\\\\"127067667954****\\\\\\",\\\\\\"taskId\\\\\\":\\\\\\"49f7b317-7645-4cc9-94fd-ea42e522****\\\\\\",\\\\\\"timestamp\\\\\\":1551581760000}]\\",\\n \\"NextToken\\": \\"ea42e5220930ea42e522****\\",\\n \\"RequestId\\": \\"3febb181-0d98-4af9-8b04-7faf36b048b9\\",\\n \\"Success\\": \\"true\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t1551581040000\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t100\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t123****\\r\\n\\t\\t\\t2\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t49f7b317-7645-4cc9-94fd-1****\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t1551581100000\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t100\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t12345\\r\\n\\t\\t\\t2\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t49f7b317-7645-4cc9-94fd-1****\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\r\\n\\t\\tDBDEAC51-EA3C-4853-8F25-6B48D38A28A9\\r\\n\\t\\ttrue\\r\\n\\t\\t200\\r\\n","errorExample":""}]',
'title' => '查询任务的细粒度监控数据',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' 返回结果是一个JSON字符串,描述信息如下:'."\n"
."\n"
.'- Error4XXRate:4XX错误占比'."\n"
.'- Error6XXRate:6xx错误占比'."\n"
.'- Error5XXRate:5xx错误占比'."\n"
.'- Error4XXNumber:4xx错误探针的数量'."\n"
.'- Error5XXNumber:5xx错误探针的数量'."\n"
.'- Error6XXNumber:6xx错误探针数量'."\n"
.'- Over5totalTime:响应时间超过5000毫秒的占比'."\n"
.'- Over3totalTime:响应时间超过3000毫秒的占比'."\n"
.'- Over2totalTime:响应时间超过2000毫秒的占比'."\n"
.'- Over10FailureRate:错误大于10%所占的比例'."\n"
.'- Over100FailureRate:错误大于99%所占的比例'."\n"
.'- Over30FailureRate:错误大于30%所占的比例'."\n"
.'- Over50FailureRate:错误大于50%所占的比例'."\n"
.'- Over80FailureRate:错误大于80%所占的比例'."\n"
.'- Over90FailureRate:错误大于90%所占的比例'."\n"
.'- Over400NumberRate:超过4XX错误所占的比例'."\n"
.'- Over500NumberRate:超过5XX错误所占的比例'."\n"
.'- AvailableNumber:可用探针数量'."\n"
.'- UnavailableNumber:不可用探测点数量'."\n"
.'- Availability:可用率'."\n"
.'- Unavailability:不可用率'."\n"
.'- ErrorCodeMaximum:最大错误码,例如:1分钟内5个探测点有4个是200, 1个是404, 那么最大错误码就是404'."\n"
.'- ErrorCodeMinimum:最小错误码, 例如:1分钟内5个探测点有4个是200, 1个是404, 那么最小错误码就是200'."\n"
."\n"
.'> 建议您使用AvailableNumber、UnavailableNumber、Availability、Unavailability、ErrorCodeMaximum或ErrorCodeMinimum,其他计算方式较繁琐。',
'extraInfo' => ' ',
],
'DescribeSiteMonitorStatistics' => [
'summary' => '调用DescribeSiteMonitorStatistics接口查询指定站点监控任务中指定监控项的平均统计数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '站点监控任务ID。'."\n"
."\n"
.'关于如何获取站点监控任务ID,请参见[DescribeSiteMonitorList](~~115052~~)。',
'type' => 'string',
'required' => true,
'example' => 'ef4cdc8b-9dc7-43e7-810e-f950e56c****',
],
],
[
'name' => 'TimeRange',
'in' => 'query',
'schema' => [
'description' => '统计周期。'."\n"
."\n\n"
.'单位:分钟。默认值:1440(1天)。最大值:43200(30天)。',
'type' => 'string',
'required' => false,
'example' => '1440',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间戳。'."\n"
."\n"
.'单位:毫秒。默认值为当前时间向前推1小时。',
'type' => 'string',
'required' => false,
'example' => '1576142850527',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。取值:'."\n"
."\n"
.'- Availability:可用率。'."\n"
.'- ErrorRate:错误率。'."\n"
.'- ResponseTime:响应时间。',
'type' => 'string',
'required' => true,
'example' => 'Availability',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'Successful',
],
'Data' => [
'description' => '统计结果。',
'type' => 'string',
'example' => '100',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3AD2724D-E317-4BFB-B422-D6691D071BE1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'The specified parameter is not valid.',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
403 => [
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
[
'errorCode' => 'InvalidClientTokenId',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Successful\\",\\n \\"Data\\": \\"100\\",\\n \\"RequestId\\": \\"3AD2724D-E317-4BFB-B422-D6691D071BE1\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\tsuccessful\\n\\t3AD2724D-E317-4BFB-B422-D6691D071BE1\\n\\t100\\n\\t200\\n\\ttrue\\n\\t","errorExample":""}]',
'title' => '查询指定站点监控任务中指定监控项的平均统计数据',
'description' => '本文将提供一个示例,查询站点监控任务`ef4cdc8b-9dc7-43e7-810e-f950e56c****`中监控项`Availability`(可用率)的平均统计数据。返回结果显示可用率为`100`。'."\n"
."\n\n",
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSiteMonitorList' => [
'summary' => '调用DescribeSiteMonitorList接口查询站点监控任务列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '站点监控任务ID。',
'type' => 'string',
'required' => false,
'example' => 'a1ecd34a-8157-44d9-b060-14950837****',
],
],
[
'name' => 'TaskType',
'in' => 'query',
'schema' => [
'description' => '站点监控任务探测类型。云监控支持的探测类型包括:HTTP 、PING 、TCP 、UDP 、DNS 、SMTP 、POP3 、FTP。',
'type' => 'string',
'required' => false,
'example' => 'HTTP',
],
],
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '查询站点监控任务的关键字。'."\n"
."\n"
.'> 支持根据任务名称或任务地址模糊搜索。',
'type' => 'string',
'required' => false,
'example' => 'site',
],
],
[
'name' => 'Page',
'in' => 'query',
'schema' => [
'description' => '分页页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示条数。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'TaskState',
'in' => 'query',
'schema' => [
'description' => '任务状态。取值:'."\n"
."\n"
.'- 1:正常。'."\n"
."\n"
.'- 2:禁用。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'AgentGroup',
'in' => 'query',
'schema' => [
'description' => '任务使用的节点类型。取值:'."\n"
."\n"
.'- PC:PC端探测点。'."\n"
."\n"
.'- MOBILE:移动端探测点。'."\n"
."\n"
.'- FC:内网探测点',
'type' => 'string',
'required' => false,
'example' => 'PC',
'enum' => [
'PC',
'MOBILE',
'FC',
],
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'A80DB41C-AF6C-50E1-ADB5-66DCBA3D266B',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
'PageNumber' => [
'description' => '分页页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '每页显示记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'TotalCount' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'SiteMonitors' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SiteMonitor' => [
'description' => '站点监控任务列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'TaskType' => [
'description' => '站点监控任务探测类型。云监控支持的探测类型包括:HTTP 、PING 、TCP 、UDP 、DNS 、SMTP 、POP3 、FTP。',
'type' => 'string',
'example' => 'TCP',
],
'UpdateTime' => [
'description' => '站点监控任务更新时间。',
'type' => 'string',
'example' => '2022-03-08 17:14:31',
],
'Interval' => [
'description' => '探测频率。单位:分钟。',
'type' => 'string',
'example' => '1',
],
'TaskState' => [
'description' => '任务状态。取值:'."\n"
."\n"
.'- 1:正常。'."\n"
."\n"
.'- 2:禁用。',
'type' => 'string',
'example' => '1',
],
'CreateTime' => [
'description' => '任务的创建时间。',
'type' => 'string',
'example' => '2021-11-01 11:05:18',
],
'TaskName' => [
'description' => '站点监控任务名称。',
'type' => 'string',
'example' => '新的探测任务',
],
'Address' => [
'description' => '任务的探测URL地址或IP地址。',
'type' => 'string',
'example' => 'https://aliyun.com',
],
'TaskId' => [
'description' => '站点监控任务ID。',
'type' => 'string',
'example' => 'f5783760-1b39-4b6b-80e8-453d962a****',
],
'OptionsJson' => [
'description' => '扩展选项。每一种探测类型有不同的扩展类型,详情请参见[CreateSiteMonitor](~~115048~~)。',
'type' => 'object',
'properties' => [
'password' => [
'description' => 'SMTP、POP3或FTP探测类型的密码。',
'type' => 'string',
'example' => '123****',
],
'request_format' => [
'description' => 'HTTP请求内容格式。取值:'."\n"
.'- hex:十六进制格式。'."\n"
.'- txt:文本格式。',
'type' => 'string',
'example' => 'hex',
],
'response_content' => [
'description' => '匹配响应内容。'."\n"
.'- 十六进制格式:当请求的内容是字节串,且无法用可见字符表达时,可以将字节串转换为十六进制表示的可见字符串形式。具体转换规则为:一个字节转换成二字节的十六进制字符,例如:1字节(1B)转换成十六进制为`01`, 27字节(27B)转换成十六进制为`1B`。二进制数组(Java形式)为`{(byte)1, (byte)27}`,转换成十六进制为`011b`或`011B`。站点监控对十六进制不区分大小写。将字符串`011B`填入请求内容中,同时请求内容格式选择十六进制格式。'."\n"
."\n"
.'- 文本格式:普通文本指字符串,即由可见字符组成的字符串。',
'type' => 'string',
'example' => 'cf0f85',
],
'failure_rate' => [
'description' => '丢包率。'."\n"
."\n"
.'> 该参数仅适用于PING探测类型。',
'type' => 'number',
'format' => 'float',
'example' => '0.5',
],
'time_out' => [
'description' => '超时时间。单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '3000',
],
'header' => [
'description' => 'HTTP请求头。格式为`key1:value1`,通过回车键换行。',
'type' => 'string',
'example' => 'testKey:testValue',
],
'cookie' => [
'description' => '发送HTTP请求的Cookie文本。',
'type' => 'string',
'example' => 'lang=en',
],
'port' => [
'description' => 'TCP、UDP、SMTP或POP3探测类型的端口。',
'type' => 'integer',
'format' => 'int32',
'example' => '80',
],
'ping_num' => [
'description' => 'PING探测的次数设置。',
'type' => 'integer',
'format' => 'int32',
'example' => '20',
],
'authentication' => [
'description' => '是否开启安全验证。取值:'."\n"
.'- 0:开启。'."\n"
.'- 1:关闭。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'http_method' => [
'description' => 'HTTP的请求方法。取值:'."\n"
.'- get '."\n"
.'- post'."\n"
.'- head',
'type' => 'string',
'example' => 'get',
],
'match_rule' => [
'description' => '是否包含报警规则。取值:'."\n"
.'- 0:包含。'."\n"
.'- 1:不包含。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'dns_match_rule' => [
'description' => 'DNS的匹配规则。取值:'."\n"
."\n"
.'- IN_DNS:期望解析的别名或IP地址均在DNS应答中。'."\n"
.'- DNS_IN:所有的DNS应答都出现在期望解析的别名或IP地址中。'."\n"
.'- EQUAL:DNS应答和期望解析的别名或IP地址完全相同。'."\n"
.'- ANY:DNS应答和期望解析的别名或IP地址有交集。',
'type' => 'string',
'example' => 'IN_DNS',
],
'request_content' => [
'description' => 'HTTP探测请求内容。',
'type' => 'string',
'example' => 'cf0f85',
],
'username' => [
'description' => 'FTP、SMTP或POP3的用户名。',
'type' => 'string',
'example' => 'testUser',
],
'response_format' => [
'description' => 'HTTP响应内容格式。取值:'."\n"
.'- hex:十六进制格式。'."\n"
.'- txt:文本格式。',
'type' => 'string',
'example' => 'hex',
],
'dns_type' => [
'description' => 'DNS解析类型。仅适用于DNS探测类型。取值:'."\n"
.'- A(默认值):指定主机名或域名对应的IP地址。'."\n"
.'- CNAME:将多个域名映射到另外一个域名。'."\n"
.'- NS:指定域名由某个DNS服务器解析。'."\n"
.'- MX:将域名指向一个邮件服务器地址。'."\n"
.'- TXT:主机名或域名的说明。文本长度限制512字节,通常用做SPF(Sender Policy Framework)记录,即反垃圾邮件。'."\n"
.'- AAAA:将域名解析到IPv6地址的DNS记录。',
'type' => 'string',
'example' => 'A',
],
'dns_server' => [
'description' => '指定DNS解析服务器的域名或IP地址。'."\n",
'type' => 'string',
'example' => '192.168.XX.XX',
],
'enable_operator_dns' => [
'description' => '是否使用运营商的DNS。'."\n"
.'- true(默认值):使用运营商的DNS。'."\n"
.'- false:不使用运营商的DNS。使用默认DNS或指定服务器的DNS。',
'type' => 'boolean',
'example' => 'true',
],
'attempts' => [
'description' => 'DNS失败后重试次数。',
'type' => 'integer',
'format' => 'int64',
'example' => '3',
],
'protocol' => [
'description' => 'DNS探测协议类型。取值:'."\n"
.'- udp(默认值)'."\n"
.'- tcp'."\n"
.'- tcp-tls',
'type' => 'string',
'example' => 'udp',
],
'proxy_protocol' => [
'description' => '是否开启ProxyProtocol。取值:'."\n"
.'- false(默认值):不开启ProxyProtocol。'."\n"
.'- true:开启ProxyProtocol。',
'type' => 'boolean',
'example' => 'false',
],
'acceptable_response_code' => [
'description' => '可接受的状态码。 '."\n"
."\n"
.'> 建议您使用断言配置。',
'type' => 'string',
'example' => '400',
],
'isBase64Encode' => [
'description' => '是否对密码进行base64解码存储。取值:'."\n"
.'- true:对密码进行base64解码存储。'."\n"
.'- false(默认值):不对密码进行base64解码存储。',
'type' => 'string',
'example' => 'false',
],
'cert_verify' => [
'description' => '是否验证证书。取值:'."\n"
.'- false(默认值):忽略证书验证。'."\n"
.'- true:证书验证。',
'type' => 'boolean',
'example' => 'false',
],
'unfollow_redirect' => [
'description' => '如果出现301或302状态码,是否跟随再次做重定向探测。取值:'."\n"
.'- true:不跟随跳转。'."\n"
.'- false(默认值):跟随跳转。',
'type' => 'boolean',
'example' => 'false',
],
'diagnosis_mtr' => [
'description' => '是否开启任务失败后的自动MTR网络诊断。取值:'."\n"
.'- false(默认值):不开启自动MTR网络诊断。'."\n"
.'- true 开启自动MTR网络诊断。',
'type' => 'boolean',
'example' => 'false',
],
'diagnosis_ping' => [
'description' => '是否开启探测任务失败后自动Ping网络延时探测。取值:'."\n"
.'- false(默认值):不开启。'."\n"
.'- true:开启。',
'type' => 'boolean',
'example' => 'false',
],
'retry_delay' => [
'description' => '探测失败后重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'assertions' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'assertions' => [
'description' => '断言配置组。',
'type' => 'array',
'items' => [
'description' => '断言配置组。',
'type' => 'object',
'properties' => [
'property' => [
'description' => '断言内容解析路径。'."\n"
."\n"
.'- 如果断言类型为`body_json`,则路径为`json path`。'."\n"
."\n"
.'- 如果断言类型是`body_xml`,则路径为`xml path`。'."\n",
'type' => 'string',
'example' => 'json path',
],
'type' => [
'description' => '断言类型。取值:'."\n"
.'- response_time:判定响应时间是否符合预期。'."\n"
.'- status_code:判断HTTP响应状态码是否符合预期。'."\n"
.'- header:判定响应Header中的字段是否符合预期。'."\n"
.'- body_text:通过文本字符匹配判断返回Body中的内容是否符合预期。'."\n"
.'- body_json:通过JSON解析(JSON Path)判断返回Body中的内容是否符合预期。'."\n"
.'- body_xml:通过XML解析(XPath)判断返回Body中的内容是否符合预期。',
'type' => 'string',
'example' => 'response_time',
],
'operator' => [
'description' => '断言比较操作符。取值:'."\n"
.'- contains:包含。'."\n"
.'- doesNotContain:不包含。'."\n"
.'- matches:正则匹配。'."\n"
.'- doesNotMatch:正则不匹配。'."\n"
.'- is:数值等于或字符匹配相等。'."\n"
.'- isNot:不等于。'."\n"
.'- lessThan:小于。'."\n"
.'- moreThan:大于。',
'type' => 'string',
'example' => 'lessThan',
],
'target' => [
'description' => '断言匹配比较的目标数值或字符。',
'type' => 'string',
'example' => '1000',
],
],
],
],
],
],
],
],
'AgentGroup' => [
'description' => '探针类型。取值:'."\n"
."\n"
.'- PC:PC端。'."\n"
.'- MOBILE:移动端。',
'type' => 'string',
'example' => 'PC',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"A80DB41C-AF6C-50E1-ADB5-66DCBA3D266B\\",\\n \\"Success\\": \\"true\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"TotalCount\\": 1,\\n \\"SiteMonitors\\": {\\n \\"SiteMonitor\\": [\\n {\\n \\"TaskType\\": \\"TCP\\",\\n \\"UpdateTime\\": \\"2022-03-08 17:14:31\\",\\n \\"Interval\\": \\"1\\",\\n \\"TaskState\\": \\"1\\",\\n \\"CreateTime\\": \\"2021-11-01 11:05:18\\",\\n \\"TaskName\\": \\"新的探测任务\\",\\n \\"Address\\": \\"https://aliyun.com\\",\\n \\"TaskId\\": \\"f5783760-1b39-4b6b-80e8-453d962a****\\",\\n \\"OptionsJson\\": {\\n \\"password\\": \\"123****\\",\\n \\"request_format\\": \\"hex\\",\\n \\"response_content\\": \\"cf0f85\\",\\n \\"failure_rate\\": 0.5,\\n \\"time_out\\": 3000,\\n \\"header\\": \\"testKey:testValue\\",\\n \\"cookie\\": \\"lang=en\\",\\n \\"port\\": 80,\\n \\"ping_num\\": 20,\\n \\"authentication\\": 1,\\n \\"http_method\\": \\"get\\",\\n \\"match_rule\\": 0,\\n \\"dns_match_rule\\": \\"IN_DNS\\",\\n \\"request_content\\": \\"cf0f85\\",\\n \\"username\\": \\"testUser\\",\\n \\"response_format\\": \\"hex\\",\\n \\"dns_type\\": \\"A\\",\\n \\"dns_server\\": \\"192.168.XX.XX\\",\\n \\"enable_operator_dns\\": true,\\n \\"attempts\\": 3,\\n \\"protocol\\": \\"udp\\",\\n \\"proxy_protocol\\": false,\\n \\"acceptable_response_code\\": \\"400\\",\\n \\"isBase64Encode\\": \\"false\\",\\n \\"cert_verify\\": false,\\n \\"unfollow_redirect\\": false,\\n \\"diagnosis_mtr\\": false,\\n \\"diagnosis_ping\\": false,\\n \\"retry_delay\\": 1,\\n \\"assertions\\": {\\n \\"assertions\\": [\\n {\\n \\"property\\": \\"json path\\",\\n \\"type\\": \\"response_time\\",\\n \\"operator\\": \\"lessThan\\",\\n \\"target\\": \\"1000\\"\\n }\\n ]\\n }\\n },\\n \\"AgentGroup\\": \\"PC\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t1\\r\\n\\tA80DB41C-AF6C-50E1-ADB5-66DCBA3D266B\\r\\n\\tsuccessful\\r\\n\\t10\\r\\n\\t1\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tf5783760-1b39-4b6b-80e8-453d962a****\\r\\n\\t\\t\\thttps://aliyun.com\\r\\n\\t\\t\\t\\r\\n\\t\\t\\ttest123\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\thex\\r\\n\\t\\t\\t\\thex\\r\\n\\t\\t\\t\\tcf0f85\\r\\n\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tTCP\\r\\n\\t\\t\\t2021-11-01 11:05:18\\r\\n\\t\\t\\t2022-03-08 17:14:31\\r\\n\\t\\t\\t1\\r\\n\\t\\t\\t1\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t","errorExample":""}]',
'title' => '查询站点监控任务列表',
'description' => '本文将提供一个示例,查询当前账号的站点监控任务列表。返回结果显示,当前账号存在一条站点监控记录`HanZhou_ECS2`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeSiteMonitorLog' => [
'summary' => '调用DescribeSiteMonitorLog接口查询一次性探测任务的探测日志。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TaskIds',
'in' => 'query',
'schema' => [
'description' => '探测任务ID。多个探测任务ID之间用半角逗号(,)分隔。',
'type' => 'string',
'required' => true,
'example' => 'afa5c3ce-f944-4363-9edb-ce919a29****',
],
],
[
'name' => 'Isp',
'in' => 'query',
'schema' => [
'description' => '运营商标识码。',
'type' => 'string',
'required' => false,
'example' => '465',
],
],
[
'name' => 'City',
'in' => 'query',
'schema' => [
'description' => '城市标识码。',
'type' => 'string',
'required' => false,
'example' => '546',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项。'."\n"
."\n"
.'目前仅支持监控项`ProbeLog`。',
'type' => 'string',
'required' => false,
'example' => 'ProbeLog',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。支持的格式:'."\n"
."\n"
.'- UNIX时间戳:从1970年01月01日开始所经过的毫秒数。'."\n"
.'- UTC格式:YYYY-MM-DDThh:mm:ssZ。'."\n"
."\n"
.'> - 开始时间和结束时间遵循左开右闭模式,StartTime不能等于或大于EndTime。 '."\n"
.' - 建议您使用UNIX时间戳,避免时区问题。',
'type' => 'string',
'required' => false,
'example' => '1638422474389',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。支持的格式:'."\n"
."\n"
.'- UNIX时间戳:从1970年01月01日开始所经过的毫秒数。'."\n"
.'- UTC格式:YYYY-MM-DDThh:mm:ssZ。'."\n"
."\n"
.'> 建议您使用UNIX时间戳,避免时区问题。',
'type' => 'string',
'required' => false,
'example' => '1638422475687',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '当请求的返回结果被截断时,您可以使用`NextToken`再次发起请求,获取从当前截断位置之后的内容。',
'type' => 'string',
'required' => false,
'example' => 'IWBjqMYSy0is7zSMGu16****',
],
],
[
'name' => 'Length',
'in' => 'query',
'schema' => [
'description' => '每页显示的记录条数,用于分页查询。取值范围:1~1440。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1000',
],
],
[
'name' => 'Filter',
'in' => 'query',
'schema' => [
'description' => '过滤探测值。'."\n"
."\n"
.'支持简单的表达式,例如:`TotalTime>100`,表示过滤出总响应时间超过100毫秒的探测数据。',
'type' => 'string',
'required' => false,
'example' => 'TotalTime>100',
],
],
[
'name' => 'BrowserInfo',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'required' => false,
'example' => '无',
],
],
[
'name' => 'Browser',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '浏览器类型。',
'type' => 'string',
'required' => false,
'enumValueTitles' => [
' Chrome' => ' Chrome',
'Safari' => 'Safari',
'Edge' => 'Edge',
'Firefox' => 'Firefox',
],
'example' => 'Chrome',
],
],
[
'name' => 'Device',
'in' => 'query',
'allowEmptyValue' => true,
'schema' => [
'description' => '设备类型(模拟屏幕大小类型)。',
'type' => 'string',
'required' => false,
'enumValueTitles' => [
'tablet' => 'tablet',
'mobile' => 'mobile',
'laptop' => 'laptop',
],
'example' => 'laptop',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '查询下一页使用的Token。',
'type' => 'string',
'example' => 'IWBjqMYSy0is7zSMGu16****',
],
'Data' => [
'description' => '一次性探测任务的探测日志。',
'type' => 'string',
'example' => '[{\\"redirectCount\\":0.0,\\"SSLConnectTime\\":0.0,\\"pingDetail\\":\\"\\",\\"HTTPConnectTime\\":0.0,\\"isp\\":\\"465\\",\\"errorCode\\":611,\\"ispCN\\":\\"阿里巴巴\\",\\"resolution\\":\\"\\",\\"areaEN\\":\\"HuaBei\\",\\"taskEndTimestamp\\":1638422475687,\\"targetIspEN\\":\\"\\",\\"TotalTime\\":1.0,\\"taskStartTimestamp\\":1638422474389,\\"countryCN\\":\\"中国\\",\\"provinceEN\\":\\"Beijing\\",\\"countryEN\\":\\"China\\",\\"targetCityEN\\":\\"\\",\\"curlConnectTime\\":0.0,\\"ips\\":\\"\\",\\"route\\":\\"\\",\\"tcpConnectTime\\":0.0,\\"cityEN\\":\\"Beijing\\",\\"HTTPDownloadSpeed\\":0.0,\\"HTTPDownloadTime\\":0.0,\\"HTTPResponseCode\\":0.0,\\"areaCN\\":\\"华北\\",\\"city\\":\\"546\\",\\"expection\\":\\"\\",\\"suorceIp\\":\\"192.168.XX.XX \\",\\"ispEN\\":\\"Alibaba\\",\\"HTTPDNSTime\\":1.0,\\"targetIsp\\":\\"\\",\\"curlStarttransferTime\\":0.0,\\"provinceCN\\":\\"北京市\\",\\"timestamp\\":1638422474000,\\"redirectTime\\":0.0,\\"targetCity\\":\\"\\", \\"expect\\":\\"\\",\\"HTTPDownloadSize\\":0.0,\\"localDns\\":\\"192.168.XX.XX\\",\\"cityCN\\":\\"北京市\\",\\"taskId\\":\\"afa5c3ce-f944-4363-9edb-ce919a29****\\"}]',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '67F646FA-ED8A-58C2-B461-451DB52C8B14',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successful',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"NextToken\\": \\"IWBjqMYSy0is7zSMGu16****\\",\\n \\"Data\\": \\"[{\\\\\\\\\\\\\\"redirectCount\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"SSLConnectTime\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"pingDetail\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"HTTPConnectTime\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"isp\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"465\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"errorCode\\\\\\\\\\\\\\":611,\\\\\\\\\\\\\\"ispCN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"阿里巴巴\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"resolution\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"areaEN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"HuaBei\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"taskEndTimestamp\\\\\\\\\\\\\\":1638422475687,\\\\\\\\\\\\\\"targetIspEN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"TotalTime\\\\\\\\\\\\\\":1.0,\\\\\\\\\\\\\\"taskStartTimestamp\\\\\\\\\\\\\\":1638422474389,\\\\\\\\\\\\\\"countryCN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"中国\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"provinceEN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"Beijing\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"countryEN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"China\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"targetCityEN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"curlConnectTime\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"ips\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"route\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"tcpConnectTime\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"cityEN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"Beijing\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"HTTPDownloadSpeed\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"HTTPDownloadTime\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"HTTPResponseCode\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"areaCN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"华北\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"city\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"546\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"expection\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"suorceIp\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"192.168.XX.XX \\\\\\\\\\\\\\",\\\\\\\\\\\\\\"ispEN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"Alibaba\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"HTTPDNSTime\\\\\\\\\\\\\\":1.0,\\\\\\\\\\\\\\"targetIsp\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"curlStarttransferTime\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"provinceCN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"北京市\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"timestamp\\\\\\\\\\\\\\":1638422474000,\\\\\\\\\\\\\\"redirectTime\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"targetCity\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\", \\\\\\\\\\\\\\"expect\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"HTTPDownloadSize\\\\\\\\\\\\\\":0.0,\\\\\\\\\\\\\\"localDns\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"192.168.XX.XX\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"cityCN\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"北京市\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"taskId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"afa5c3ce-f944-4363-9edb-ce919a29****\\\\\\\\\\\\\\"}]\\",\\n \\"RequestId\\": \\"67F646FA-ED8A-58C2-B461-451DB52C8B14\\",\\n \\"Success\\": \\"true\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successful\\"\\n}","type":"json"}]',
'title' => '查询一次性探测任务的探测日志',
'description' => '仅开通网络分析与监控的阿里云账号,才能创建一次性探测任务。'."\n"
."\n"
.'本文将提供一个示例,查询一次性探测任务`afa5c3ce-f944-4363-9edb-ce919a29****`的探测日志。',
],
'DescribeMetricLast' => [
'summary' => '调用DescribeMetricLast接口查询指定监控项的最新监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '云产品的监控项名称。'."\n"
."\n"
.'关于监控项名称,请参见[云产品监控项](~~163515~~)。'."\n"
."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'CPUUtilization',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '监控数据的统计周期。'."\n"
."\n"
.'取值:15、60、900和3600。'."\n"
."\n"
.'单位:秒。'."\n"
."\n"
.'> - 如果不设置统计周期,则按照注册监控项时申请的上报周期来查询监控数据。'."\n"
.' - 每个云产品的监控项(`MetricName`)的统计周期不同。更多信息,请参见[云产品监控项](~~163515~~)中目标云产品**指标列表**页面中的`Min Periods`列。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询监控项的开始时间。',
'type' => 'string',
'required' => false,
'example' => '2019-01-31 10:00:00',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询监控项的结束时间。'."\n"
."\n"
.'- 对于秒级数据,查询数据的起始时间是EndTime往前倒推20分钟后与startTime对比的最大值。'."\n"
."\n"
.'- 对于分钟级数据,查询数据的起始时间是EndTime往前倒推2小时后与startTime对比的最大值。'."\n"
."\n"
.'- 对于小时级数据,查询数据的起始时间是EndTime往前倒推2天后与startTime对比的最大值。'."\n"
."\n"
.' ',
'type' => 'string',
'required' => false,
'example' => '2019-01-31 10:10:00',
],
],
[
'name' => 'Dimensions',
'in' => 'query',
'schema' => [
'description' => '指定资源的监控维度。'."\n"
."\n"
.'格式:`key:value`键值对形式的集合,例如:`{"userId":"120886317861****"}`和`{"instanceId":"i-2ze2d6j5uhg20x47****"}`。'."\n"
."\n"
.'> 单次请求最多支持批量查询50个实例。'."\n"
."\n\n"
."\n\n",
'type' => 'string',
'required' => false,
'example' => '[{"instanceId":"i-2ze2d6j5uhg20x47****"}]',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '分页游标的标识。'."\n"
."\n"
.'- 如果匹配查询条件的返回结果超过了分页大小,则会返回这个分页游标。'."\n"
.'- 如果需要获取下一页数据,将返回的游标值作为请求参数即可,直到无游标值返回,表示已经获取了全部数据。',
'type' => 'string',
'required' => false,
'example' => '15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****',
],
],
[
'name' => 'Length',
'in' => 'query',
'schema' => [
'description' => '返回监控数据的每页大小,用于分页查询。'."\n"
."\n"
.'默认值:1000,即每页1000条监控数据。'."\n"
."\n"
.'> 单次请求Length的最大值为1440。',
'type' => 'string',
'required' => false,
'example' => '1000',
],
],
[
'name' => 'Express',
'in' => 'query',
'schema' => [
'description' => '对现有查询结果进行实时计算的表达式。',
'type' => 'string',
'required' => false,
'example' => '{"groupby":["userId","instanceId"]}',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '分页游标标识。',
'type' => 'string',
'example' => 'xxxxxx',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '021472A6-25E3-4094-8D00-BA4B6A5486C3',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Datapoints' => [
'description' => '监控数据列表。',
'type' => 'string',
'example' => '[{"timestamp":1548777660000,"userId":"123456789876****","instanceId":"i-abcdefgh12****","Minimum":93.1,"Average":99.52,"Maximum":100}]',
],
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'Period' => [
'description' => '时间间隔。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '60',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"NextToken\\": \\"xxxxxx\\",\\n \\"RequestId\\": \\"021472A6-25E3-4094-8D00-BA4B6A5486C3\\",\\n \\"Success\\": true,\\n \\"Datapoints\\": \\"[{\\\\\\"timestamp\\\\\\":1548777660000,\\\\\\"userId\\\\\\":\\\\\\"123456789876****\\\\\\",\\\\\\"instanceId\\\\\\":\\\\\\"i-abcdefgh12****\\\\\\",\\\\\\"Minimum\\\\\\":93.1,\\\\\\"Average\\\\\\":99.52,\\\\\\"Maximum\\\\\\":100}]\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"Period\\": \\"60\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t60\\r\\n\\t\\r\\n\\t\\t1548777660000\\r\\n\\t\\t100\\r\\n\\t\\t123456789876****\\r\\n\\t\\t93.1\\r\\n\\t\\ti-abcdefgh12****\\r\\n\\t\\t99.52\\r\\n\\t\\r\\n\\t6A5F022D-AC7C-460E-94AE-B9E75083D027\\r\\n\\ttrue\\r\\n\\t200\\r\\n","errorExample":""}]',
'title' => '查询指定监控项的最新监控数据',
'description' => '### 使用限制'."\n"
.'- 调用DescribeMetricLast、DescribeMetricList、DescribeMetricData和DescribeMetricTop的接口,有100万次/月免费额度(总计),当免费额度用完且您没有开通基础云监控按量计费时,将无法正常使用该API。如果您已开通基础云监控的按量计费,当免费调用额度用完时,该API仍然可以正常使用,超出免费额度部分将自动按使用量计费。开通方法详见[开通按量计费](https://common-buy.aliyun.com/?spm=a2c4g.11186623.0.0.6c8f3481IbSHgG&commodityCode=cms_basic_public_cn&from_biz_channel=help_bill)。'."\n"
.'- 单个API的调用次数限制为50次/秒,即一个阿里云账号及该账号下的RAM用户共用50次/秒。'."\n"
."\n"
.'> 当您调用API时,如果返回信息`Throttling.User`或`Request was denied due to user flow control`,则说明该API被限流。处理方法,请参见[如何处理查询API限流问题](~~2615031~~)。'."\n"
.'### 注意事项'."\n"
.'各云产品监控数据的存储时长与`Period`(统计周期)有关,`Period`越大,查询的监控数据越稀疏,监控数据的存储时间越长,具体关系如下:'."\n"
.'- `Period`小于60秒,存储时长为7天。'."\n"
.'- `Period`等于60秒,存储时长为31天。'."\n"
.'- `Period`大于等于300秒,存储时长为91天。'."\n"
.'### 使用说明'."\n"
.'本文将提供一个示例,查询云产品`acs_ecs_dashboard`监控项`CPUUtilization`的最新监控数据。返回结果显示,当前账号`123456789876****`下实例`i-abcdefgh12****`间隔60秒的最大值为100、最小值为93.1、平均值为99.52。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。 ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMetricList' => [
'summary' => '调用 DescribeMetricList 接口查询指定云产品的指定监控项的监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '云产品的监控项名称。'."\n"
."\n"
.'关于监控项名称,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cpu_idle',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '监控数据的统计周期。'."\n"
."\n"
.'取值:15、60、900和3600。'."\n"
."\n"
.'单位:秒。'."\n"
."\n"
.'> - 如果不设置统计周期,则按照注册监控项时申请的上报周期来查询监控数据。'."\n"
.'- 每个云产品的监控项(`MetricName`)的统计周期不同。更多信息,请参见[云产品监控项](~~163515~~)。'."\n",
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '开始时间。支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
.'- Format格式:YYYY-MM-DD hh:mm:ss。 '."\n"
."\n"
.'> - 开始和结束时间执行的是左开右闭的模式,StartTime不能等于或大于EndTime。'."\n"
.'- StartTime和EndTime之间的间隔小于等于31天。',
'type' => 'string',
'required' => false,
'example' => '2019-01-30 00:00:00',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '结束时间。支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
.'- Format格式:YYYY-MM-DD hh:mm:ss。 '."\n"
."\n"
.'> StartTime和EndTime之间的间隔小于等于31天。',
'type' => 'string',
'required' => false,
'example' => '2019-01-30 00:10:00',
],
],
[
'name' => 'Dimensions',
'in' => 'query',
'schema' => [
'description' => '指定资源的监控维度。'."\n"
."\n"
.'格式:`key:value`键值对形式的集合,例如:`{"userId":"120886317861****"}`和`{"instanceId":"i-2ze2d6j5uhg20x47****"}`。'."\n"
."\n"
.'> 单次请求最多支持批量查询50个实例。',
'type' => 'string',
'required' => false,
'example' => '[{"instanceId":"i-2ze2d6j5uhg20x47****"}]',
],
],
[
'name' => 'NextToken',
'in' => 'query',
'schema' => [
'description' => '分页游标标识。'."\n"
."\n\n"
.'>如果不设置该参数,则表示获取第一页的数据。当该参数有返回值时,说明还有下一页,您可以将返回的NextToken作为参数再次请求获得下一页的数据,直到返回为Null为止,表示获取到了所有的数据。',
'type' => 'string',
'required' => false,
'example' => '15761485350009dd70bb64cff1f0fff750b08ffff073be5fb1e785e2b020f1a949d5ea14aea7fed82f01dd8****',
],
],
[
'name' => 'Length',
'in' => 'query',
'schema' => [
'description' => '每页显示的记录条数,用于分页查询。'."\n"
."\n"
.'> 单次请求Length的最大值为1440。',
'type' => 'string',
'required' => false,
'example' => '1000',
],
],
[
'name' => 'Express',
'in' => 'query',
'schema' => [
'description' => '查询出的现有结果进行实时计算的表达式。'."\n"
."\n"
.'> 目前仅支持groupby,类似数据库的groupby语句。',
'type' => 'string',
'required' => false,
'example' => '{"groupby":["userId","instanceId"]}',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'NextToken' => [
'description' => '分页游标标识。',
'type' => 'string',
'example' => '15761441850009dd70bb64cff1f0fff6d0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Datapoints' => [
'description' => '监控数据列表。',
'type' => 'string',
'example' => '[{"timestamp":1548777660000,"userId":"120886317861****","instanceId":"i-abc","Minimum":9.92,"Average":9.92,"Maximum":9.92}]',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'Period' => [
'description' => '时间间隔。单位:秒。取值:60、300、900。',
'type' => 'string',
'example' => '60',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"NextToken\\": \\"15761441850009dd70bb64cff1f0fff6d0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****\\",\\n \\"RequestId\\": \\"3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42\\",\\n \\"Success\\": true,\\n \\"Datapoints\\": \\"[{\\\\\\"timestamp\\\\\\":1548777660000,\\\\\\"userId\\\\\\":\\\\\\"120886317861****\\\\\\",\\\\\\"instanceId\\\\\\":\\\\\\"i-abc\\\\\\",\\\\\\"Minimum\\\\\\":9.92,\\\\\\"Average\\\\\\":9.92,\\\\\\"Maximum\\\\\\":9.92}]\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"Period\\": \\"60\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t60\\r\\n\\t\\r\\n\\t\\t1490152860000\\r\\n\\t\\t100\\r\\n\\t\\t120886317861****\\r\\n\\t\\t93.1\\r\\n\\t\\ti-abcdefgh12****\\r\\n\\t\\t99.52\\r\\n\\t\\r\\n\\t6A5F022D-AC7C-460E-94AE-B9E75083D027\\r\\n\\ttrue\\r\\n\\t200\\r\\n","errorExample":""}]',
'title' => '查询指定云产品的指定监控项的监控数据',
'description' => '### 使用限制'."\n"
.'- 调用DescribeMetricLast、DescribeMetricList、DescribeMetricData和DescribeMetricTop的接口,有100万次/月免费额度(总计),当免费额度用完且您没有开通基础云监控按量计费时,将无法正常使用该API。如果您已开通基础云监控的按量计费,当免费调用额度用完时,该API仍然可以正常使用,超出免费额度部分将自动按使用量计费。开通方法详见[开通按量计费](https://common-buy.aliyun.com/?spm=a2c4g.11186623.0.0.6c8f3481IbSHgG&commodityCode=cms_basic_public_cn&from_biz_channel=help_bill)。'."\n"
.'- 单个API的调用次数限制为50次/秒。一个阿里云账号及该账号下的RAM用户共用50次/秒。'."\n"
.'> 当您调用API时,如果返回信息`Throttling.User`或`Request was denied due to user flow control`,则说明该API被限流。处理方法,请参见[如何处理查询API限流问题](~~2615031~~)。'."\n"
.'### 注意事项'."\n"
.'各云产品监控数据的存储时长与`Period`(统计周期)有关,`Period`越大,查询的监控数据越稀疏,监控数据的存储时间越长,具体关系如下:'."\n"
.'- `Period`小于60秒,存储时长为7天。'."\n"
.'- `Period`等于60秒,存储时长为31天。'."\n"
.'- `Period`大于等于300秒,存储时长为91天。'."\n"
.'### 使用说明'."\n"
.'本文将提供一个示例,查询云产品`acs_ecs_dashboard`的监控项`cpu_idle`的监控数据。返回结果显示,当前账号`120886317861****`下实例`i-abcdefgh12****`间隔60秒的最大值为100、最小值为93.1、平均值为99.52。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMetricData' => [
'summary' => '调用DescribeMetricData接口查询指定云产品的某个监控项的监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '云产品的监控项名称。'."\n"
."\n"
.'关于云产品的监控项名称,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cpu_idle',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '监控项的统计周期。'."\n"
."\n"
.'取值:15、60、900和3600。'."\n"
."\n"
.'单位:秒。'."\n"
."\n"
.'> - 如果不设置统计周期,则按照注册监控项时申请的上报周期来查询监控数据。'."\n"
.'- 监控项(`MetricName`)的统计周期,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询监控数据的开始时间。'."\n"
."\n"
.'- 当您未设置`StartTime`和`EndTime`时,查询当前时间最近一个统计周期`Period`的监控数据。'."\n"
."\n"
.'- 当您同时设置`StartTime`和`EndTime`时,查询指定时间段内距离`EndTime`最近一个统计周期`Period`的监控数据。具体如下:'."\n"
."\n"
.' - 当`Period`设置为15秒时,指定时间段必须小于或等于20分钟。例如:StartTime为2021-05-08 08:10:00,EndTime为2021-05-08 08:30:00,统计距离2021-05-08 08:30:00最近一个15秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为60秒或900秒时,指定时间段必须小于或等于2小时。例如:Period为60秒,StartTime为2021-05-08 08:00:00,EndTime为2021-05-08 10:00:00,统计距离2021-05-08 10:00:00最近一个60秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为3600秒时,指定时间段必须小于或等于2天。例如:StartTime为2021-05-08 08:00:00,EndTime为2021-05-10 08:00:00,统计距离2021-05-10 08:00:00最近一个3600秒的监控数据。'."\n"
."\n"
.'开始时间支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
."\n"
.'- Format格式:YYYY-MM-DDThh:mm:ssZ。'."\n"
."\n"
.'> - `StartTime`如果设置过早,则无效。'."\n"
.'- 建议您使用Unix时间戳,避免时区的问题。',
'type' => 'string',
'required' => false,
'example' => '1618368900000',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询监控数据的结束时间。'."\n"
."\n"
.'- 当您未设置`StartTime`和`EndTime`时,查询当前时间最近一个统计周期`Period`的监控数据。'."\n"
."\n"
.'- 当您同时设置`StartTime`和`EndTime`时,查询指定时间段内距离`EndTime`最近一个统计周期`Period`的监控数据。具体如下:'."\n"
."\n"
.' - 当`Period`设置为15秒时,指定时间段必须小于或等于20分钟。例如:StartTime为2021-05-08 08:10:00,EndTime为2021-05-08 08:30:00,统计距离2021-05-08 08:30:00最近一个15秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为60秒或900秒时,指定时间段必须小于或等于2小时。例如:Period为60秒,StartTime为2021-05-08 08:00:00,EndTime为2021-05-08 10:00:00,统计距离2021-05-08 10:00:00最近一个60秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为3600秒时,指定时间段必须小于或等于2天。例如:StartTime为2021-05-08 08:00:00,EndTime为2021-05-10 08:00:00,统计距离2021-05-10 08:00:00最近一个3600秒的监控数据。'."\n"
."\n\n"
."\n"
.'结束时间支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
."\n"
.'- Format格式:YYYY-MM-DDThh:mm:ssZ。'."\n"
."\n"
.'> 建议您使用Unix时间戳,避免时区的问题。'."\n"
."\n"
.' ',
'type' => 'string',
'required' => false,
'example' => '1618368960000',
],
],
[
'name' => 'Dimensions',
'in' => 'query',
'schema' => [
'description' => '维度Map,用于查询指定资源的监控数据。'."\n"
."\n"
.'格式:key-value键值对形式的集合,常用的key-value集合为`instanceId:i-2ze2d6j5uhg20x47****`。'."\n"
."\n"
.'> 单次请求最多支持批量查询50个实例。'."\n",
'type' => 'string',
'required' => false,
'example' => '[{"instanceId": "i-abcdefgh12****"}]',
],
],
[
'name' => 'Express',
'in' => 'query',
'schema' => [
'description' => '对查询出的现有结果进行实时计算的表达式。'."\n"
."\n"
.'> 目前仅支持`groupby`(类似数据库`groupby`语句)。',
'type' => 'string',
'required' => false,
'example' => '{"groupby":["userId","instanceId"]}',
],
],
[
'name' => 'Length',
'in' => 'query',
'schema' => [
'description' => '每页显示的记录条数,用于分页查询。'."\n"
."\n"
.'默认值:1000。'."\n"
."\n"
.'> 单次请求Length的最大值为1440。',
'type' => 'string',
'required' => false,
'example' => '1000',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '6A5F022D-AC7C-460E-94AE-B9E75083D027',
],
'Datapoints' => [
'description' => '监控数据列表。包括如下信息:'."\n"
."\n"
.'- `timestamp`:发生报警的时间戳。'."\n"
."\n"
.'- `userId`:发生报警的用户ID。'."\n"
."\n"
.'- `instanceId`:发生报警的实例ID。'."\n"
."\n"
.'- `Minimum`、`Average`、`Maximum`:报警规则。',
'type' => 'string',
'example' => '[{\\"timestamp\\":1618368900000,\\"Average\\":95.8291666666667,\\"Minimum\\":65.48,\\"Maximum\\":100.0},{\\"timestamp\\":1618368960000,\\"Average\\":95.8683333333333,\\"Minimum\\":67.84,\\"Maximum\\":100.0}]',
],
'Period' => [
'description' => '监控数据的统计周期。'."\n"
."\n"
.'取值:15、60、900和3600。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '60',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"6A5F022D-AC7C-460E-94AE-B9E75083D027\\",\\n \\"Datapoints\\": \\"[{\\\\\\\\\\\\\\"timestamp\\\\\\\\\\\\\\":1618368900000,\\\\\\\\\\\\\\"Average\\\\\\\\\\\\\\":95.8291666666667,\\\\\\\\\\\\\\"Minimum\\\\\\\\\\\\\\":65.48,\\\\\\\\\\\\\\"Maximum\\\\\\\\\\\\\\":100.0},{\\\\\\\\\\\\\\"timestamp\\\\\\\\\\\\\\":1618368960000,\\\\\\\\\\\\\\"Average\\\\\\\\\\\\\\":95.8683333333333,\\\\\\\\\\\\\\"Minimum\\\\\\\\\\\\\\":67.84,\\\\\\\\\\\\\\"Maximum\\\\\\\\\\\\\\":100.0}]\\",\\n \\"Period\\": \\"60\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t7598FEED-3B79-4B4A-AD01-435F34DA8EDC\\r\\n\\t60\\t\\r\\n [{\\\\\\"timestamp\\\\\\":1618368900000,\\\\\\"Average\\\\\\":95.8291666666667,\\\\\\"Minimum\\\\\\":65.48,\\\\\\"Maximum\\\\\\":100.0},{\\\\\\"timestamp\\\\\\":1618368960000,\\\\\\"Average\\\\\\":95.8683333333333,\\\\\\"Minimum\\\\\\":67.84,\\\\\\"Maximum\\\\\\":100.0}]\\r\\n\\t200\\r\\n\\t","errorExample":""}]',
'title' => '查询指定云产品的某个监控项的监控数据',
'description' => '### 使用限制'."\n"
.'- 调用DescribeMetricLast、DescribeMetricList、DescribeMetricData和DescribeMetricTop的接口,有100万次/月免费额度(总计),当免费额度用完且您没有开通基础云监控按量计费时,将无法正常使用该API。如果您已开通基础云监控的按量计费,当免费调用额度用完时,该API仍然可以正常使用,超出免费额度部分将自动按使用量计费。开通方法详见[开通按量计费](https://common-buy.aliyun.com/?spm=a2c4g.11186623.0.0.6c8f3481IbSHgG&commodityCode=cms_basic_public_cn&from_biz_channel=help_bill)。'."\n"
.'- 单个API的调用次数限制为10次/秒。一个阿里云账号及该账号下的RAM用户共用10次/秒。'."\n"
.'### 使用说明'."\n"
.'> 与[DescribeMetricList](~~51936~~)不同,本接口具有统计功能(即`Dimension={"instanceId": "i-abcdefgh12****"}`),将该账号下的所有监控数据进行聚合统计。'."\n"
."\n"
.'本文将提供一个示例,查询云产品`acs_ecs_dashboard`监控项`cpu_idle`的监控数据。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DescribeMetricMetaList' => [
'summary' => '调用DescribeMetricMetaList接口查询云监控开放的监控项详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的命名空间。'."\n"
."\n"
.'关于云产品的命名空间,请参见[云产品监控项](~~163515~~)。'."\n",
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'acs_kvstore',
],
],
[
'name' => 'Labels',
'in' => 'query',
'schema' => [
'description' => '根据标签过滤资源。是一个JSON的字符串。'."\n"
."\n"
.'格式:`[{"name":"标签键","value":"标签值"},{"name":"标签键","value":"标签值"}] `。已有标签说明如下: '."\n"
."\n"
.'- metricCategory:监控项分类描述。 '."\n"
.'- alertEnable:是否需要报警。 '."\n"
.'- alertUnit:建议的报警单位。 '."\n"
.'- unitFactor:单位转换系数。 '."\n"
.'- minAlertPeriod:最小报警周期。 '."\n"
.'- productCategory:产品类型分类。 ',
'type' => 'string',
'required' => false,
'example' => '[{"name":"productCategory","value":"kvstore_old"}]',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。详情请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'CPUUtilization',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页参数。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页最大数量。默认值:30。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '30',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'CDE9EAFF-D54E-4024-BBFC-B0AAC883143B',
],
'TotalCount' => [
'description' => '总记录条数。',
'type' => 'string',
'example' => '10',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '资源中监控项的配置信息。',
'type' => 'array',
'items' => [
'description' => '资源中监控项的配置信息。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'ads.diskSize',
],
'Description' => [
'description' => '监控项描述。',
'type' => 'string',
'example' => 'The rated disk capacity',
],
'Labels' => [
'description' => '监控项的标签,是一个或多个JSON字符串。'."\n"
."\n"
.'格式:`[{"name":"标签键","value":"标签值"}]`,`name`可以重复,已有标签说明如下: '."\n"
."\n"
.'- metricCategory:监控项分类描述。 '."\n"
.'- alertEnable:是否需要报警。 '."\n"
.'- alertUnit:建议的报警单位。 '."\n"
.'- unitFactor:单位转换系数。 '."\n"
.'- minAlertPeriod:最小报警周期。 '."\n"
.'- productCategory:产品类型分类。 ',
'type' => 'string',
'example' => '[{\\"name\\":\\"minAlertPeriod\\",\\"value\\":\\"300\\"},{\\"name\\":\\"alertDefault\\",\\"value\\":\\"\\"},{\\"name\\":\\"unitFactor\\",\\"value\\":\\"1\\"},{\\"name\\":\\"alertUnit\\",\\"value\\":\\"Mbytes\\"},{\\"name\\":\\"productCategory\\",\\"value\\":\\"ads\\"},{\\"name\\":\\"is_alarm\\",\\"value\\":\\"true\\"},{\\"name\\":\\"metricCategory\\",\\"value\\":\\"workerId\\"}]',
],
'Unit' => [
'description' => '监控项的单位。',
'type' => 'string',
'example' => 'MB',
],
'Dimensions' => [
'description' => '资源的监控维度。多个监控维度之间用半角逗号(,)分隔。',
'type' => 'string',
'example' => 'userId,instanceId,tableSchema,workerId',
],
'Namespace' => [
'description' => '云产品的命名空间。',
'type' => 'string',
'example' => 'acs_ads',
],
'Periods' => [
'description' => '监控项的所有统计周期。多个统计周期之间用半角逗号(,)分隔。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '300',
],
'Statistics' => [
'description' => '统计方法。多个统计方法之间用半角逗号(,)分隔。',
'type' => 'string',
'example' => 'Average,Minimum,Maximum',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Parameter invalid.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"CDE9EAFF-D54E-4024-BBFC-B0AAC883143B\\",\\n \\"TotalCount\\": \\"10\\",\\n \\"Success\\": true,\\n \\"Resources\\": {\\n \\"Resource\\": [\\n {\\n \\"MetricName\\": \\"ads.diskSize\\",\\n \\"Description\\": \\"The rated disk capacity\\",\\n \\"Labels\\": \\"[{\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"minAlertPeriod\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"300\\\\\\\\\\\\\\"},{\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"alertDefault\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"\\\\\\\\\\\\\\"},{\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"unitFactor\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"1\\\\\\\\\\\\\\"},{\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"alertUnit\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"Mbytes\\\\\\\\\\\\\\"},{\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"productCategory\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"ads\\\\\\\\\\\\\\"},{\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"is_alarm\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"true\\\\\\\\\\\\\\"},{\\\\\\\\\\\\\\"name\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"metricCategory\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"workerId\\\\\\\\\\\\\\"}]\\",\\n \\"Unit\\": \\"MB\\",\\n \\"Dimensions\\": \\"userId,instanceId,tableSchema,workerId\\",\\n \\"Namespace\\": \\"acs_ads\\",\\n \\"Periods\\": \\"300\\",\\n \\"Statistics\\": \\"Average,Minimum,Maximum\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t1853\\r\\n\\t\\tCDE9EAFF-D54E-4024-BBFC-B0AAC883143B\\r\\n\\t\\ttrue\\r\\n\\t\\t200\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t磁盘额定容量\\r\\n\\t\\t\\t\\tAverage,Minimum,Maximum\\r\\n\\t\\t\\t\\tads.diskSize\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"300\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertDefault\\\\\\",\\\\\\"value\\\\\\":\\\\\\"\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"unitFactor\\\\\\",\\\\\\"value\\\\\\":\\\\\\"1\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"Mbytes\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"productCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"ads\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"workerId\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,instanceId,tableSchema,workerId\\r\\n\\t\\t\\t\\tacs_ads\\r\\n\\t\\t\\t\\t300\\r\\n\\t\\t\\t\\tMB\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t磁盘已用容量\\r\\n\\t\\t\\t\\tAverage,Minimum,Maximum\\r\\n\\t\\t\\t\\tads.diskUsed\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"Mbytes\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"300\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"workerId\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,instanceId,tableSchema,workerId\\r\\n\\t\\t\\t\\tacs_ads\\r\\n\\t\\t\\t\\t300\\r\\n\\t\\t\\t\\tMB\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t磁盘使用率\\r\\n\\t\\t\\t\\tAverage,Minimum,Maximum\\r\\n\\t\\t\\t\\tads.diskUsedPercent\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"%\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"300\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"workerId\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,instanceId,tableSchema,workerId\\r\\n\\t\\t\\t\\tacs_ads\\r\\n\\t\\t\\t\\t300\\r\\n\\t\\t\\t\\t%\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tqueue的未消费的消息数目\\r\\n\\t\\t\\t\\tMaximum\\r\\n\\t\\t\\t\\tQueueMessageAccumulation\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"60\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertDefault\\\\\\",\\\\\\"value\\\\\\":\\\\\\"\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"unitFactor\\\\\\",\\\\\\"value\\\\\\":\\\\\\"1\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"count/min\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"productCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"amqp\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"queue\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,regionId,vhostName,queueName\\r\\n\\t\\t\\t\\tacs_amqp\\r\\n\\t\\t\\t\\t60,300\\r\\n\\t\\t\\t\\tcount/min\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tqueue每分钟消息生产量\\r\\n\\t\\t\\t\\tValue\\r\\n\\t\\t\\t\\tQueueMessageInput\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"60\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertDefault\\\\\\",\\\\\\"value\\\\\\":\\\\\\"\\\\\\"},{\\\\\\"n ame\\\\\\":\\\\\\"unitFactor\\\\\\",\\\\\\"value\\\\\\":\\\\\\"1\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"count/min\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"productCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"amqp\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"queue\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,regionId,vhostName,queueName\\r\\n\\t\\t\\t\\tacs_amqp\\r\\n\\t\\t\\t\\t60,300\\r\\n\\t\\t\\t\\tcount/min\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tqueue的未消费的消息数目\\r\\n\\t\\t\\t\\tValue\\r\\n\\t\\t\\t\\tQueueMessageOutput\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"60\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertDefault\\\\\\",\\\\\\"value\\\\\\":\\\\\\"\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"unitFactor\\\\\\",\\\\\\"value\\\\\\":\\\\\\"1\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"count/min\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"productCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"amqp\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"queue\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,regionId,vhostName,queueName\\r\\n\\t\\t\\t\\tacs_amqp\\r\\n\\t\\t\\t\\t60,300\\r\\n\\t\\t\\t\\tcount/min\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t实例每分钟产生的消息数量\\r\\n\\t\\t\\t\\tValue\\r\\n\\t\\t\\t\\tVhostMessageInput\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"60\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertDefault\\\\\\",\\\\\\"value\\\\\\":\\\\\\"\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"unitFactor\\\\\\",\\\\\\"value\\\\\\":\\\\\\"1\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"count/min\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"productCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"amqp\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"vhost\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,regionId,vhostName\\r\\n\\t\\t\\t\\tacs_amqp\\r\\n\\t\\t\\t\\t60,300\\r\\n\\t\\t\\t\\tcount/min\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t实例每分钟消费的消息数量\\r\\n\\t\\t\\t\\tValue\\r\\n\\t\\t\\t\\tVhostMessageOutput\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"60\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertDefault\\\\\\",\\\\\\"value\\\\\\":\\\\\\"\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"unitFactor\\\\\\",\\\\\\"value\\\\\\":\\\\\\"1\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"count/min\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"productCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"amqp\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"vhost\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,regionId,vhostName\\r\\n\\t\\t\\t\\tacs_amqp\\r\\n\\t\\t\\t\\t60,300\\r\\n\\t\\t\\t\\tcount/min\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\tLatency\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"ms\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"60\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"instanceId\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,region,apiUid\\r\\n\\t\\t\\t\\tacs_apigateway_dashboard\\r\\n\\t\\t\\t\\t60,300,900\\r\\n\\t\\t\\t\\tms\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t时间粒度内http返回码4XX占全部返回码的百分比\\r\\n\\t\\t\\t\\tAverage,Minimum,Maximum\\r\\n\\t\\t\\t\\tcode4xx\\r\\n\\t\\t\\t\\t[{\\\\\\"name\\\\\\":\\\\\\"alertUnit\\\\\\",\\\\\\"value\\\\\\":\\\\\\"%\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"minAlertPeriod\\\\\\",\\\\\\"value\\\\\\":\\\\\\"60\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"metricCategory\\\\\\",\\\\\\"value\\\\\\":\\\\\\"instanceId\\\\\\"},{\\\\\\"name\\\\\\":\\\\\\"is_alarm\\\\\\",\\\\\\"value\\\\\\":\\\\\\"true\\\\\\"}]\\r\\n\\t\\t\\t\\tuserId,instanceId\\r\\n\\t\\t\\t\\tacs_cdn\\r\\n\\t\\t\\t\\t60,300\\r\\n\\t\\t\\t\\t%\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n","errorExample":""}]',
'title' => '查询云监控开放的监控项详情',
'description' => '通常配合查询监控数据接口DescribeMetricList和DescribeMetricLast一起使用,详情请参见[DescribeMetricList](~~51936~~)和[DescribeMetricLast](~~51939~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeProjectMeta' => [
'summary' => '调用DescribeProjectMeta接口查询云监控支持的时序类监控项产品列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Labels',
'in' => 'query',
'schema' => [
'description' => '标签。根据标签过滤,标签为每个报警增加特殊标记。'."\n"
."\n"
.'目前仅支持按照产品过滤,即`name`为`product`的过滤方式,例如:{"name":"product","value":"ECS"}。'."\n"
.'>对于阿里云中云监控控制台的特殊标签,不建议您使用。'."\n",
'type' => 'string',
'required' => false,
'example' => '[{"name":"product","value":"ECS"}]',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'取值范围:1~100。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页大小。'."\n"
."\n"
.'取值范围:1~10000。'."\n"
."\n"
.'默认值:30。'."\n"
."\n"
.'>目前阿里云未限制该参数,如果您需要获取所有结果,则将分页大小设置为较大的值即可。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '30',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '4C2061B2-3B1B-43BF-A4A4-C53426F479C0',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'PageSize' => [
'description' => '分页大小。',
'type' => 'string',
'example' => '5',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'string',
'example' => '1',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'string',
'example' => '12',
],
'Resources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '云产品信息。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Namespace' => [
'description' => '命名空间,用于区分产品。格式:`acs_产品缩写`,详情请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'example' => 'acs_cdn',
],
'Description' => [
'description' => '描述信息。',
'type' => 'string',
'example' => 'CDN',
],
'Labels' => [
'description' => '标签。根据标签过滤,标签为每个报警增加特殊标记。'."\n"
."\n"
.'例如:报警所属产品的规格,是否能设置告警,格式:`[{"name":"标签名","value":"标签值"}、{"name":"标签名","value":"标签值"}]`。常用的标签如下:'."\n"
."\n"
.'- alertUnit:报警的单位。'."\n"
.' 为了避免原始上报数据的单位过小,而导致告警规则输入的值过大而增加的`alertUnit`标签,目前主要应用于云监控控制台。'."\n"
."\n"
.'- minAlertPeriod:最小上报周期。上报监控数据的时间间隔,通常为1分钟。'."\n"
."\n"
.'- metricCategory:产品的规格。例如: kvstore_sharding。'."\n"
.' 部分阿里云产品分不同规格,定义在同一个namespace中,用该参数进行区分。'."\n"
."\n"
.'- is_alarm:能否设置告警规则。'."\n"
.' 对于阿里云中云监控控制台的特殊标签,不建议您使用。'."\n"
."\n",
'type' => 'string',
'example' => '[{"metricCategory":ecs}]',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"4C2061B2-3B1B-43BF-A4A4-C53426F479C0\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"PageSize\\": \\"5\\",\\n \\"PageNumber\\": \\"1\\",\\n \\"Total\\": \\"12\\",\\n \\"Resources\\": {\\n \\"Resource\\": [\\n {\\n \\"Namespace\\": \\"acs_cdn\\",\\n \\"Description\\": \\"CDN\\",\\n \\"Labels\\": \\"[{\\\\\\"metricCategory\\\\\\":ecs}]\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t1\\r\\n\\t\\t5\\r\\n\\t\\t4C2061B2-3B1B-43BF-A4A4-C53426F479C0\\r\\n\\t\\ttrue\\r\\n\\t\\t200\\r\\n\\t\\t12\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t分析型数据库\\r\\n\\t\\t\\t\\t[{\\"name\\":\\"product\\",\\"value\\":\\"ADS\\"},{\\"name\\":\\"productCategory\\",\\"value\\":\\"ads\\"},{\\"name\\":\\"groupFlag\\",\\"value\\":\\"true\\"}]\\r\\n\\t\\t\\t\\tacs_ads\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t智能推荐\\r\\n\\t\\t\\t\\t[{\\"name\\":\\"product\\",\\"value\\":\\"AIRec\\"},{\\"name\\":\\"productCategory\\",\\"value\\":\\"airec\\"},{\\"name\\":\\"groupFlag\\",\\"value\\":\\"true\\"}]\\r\\n\\t\\t\\t\\tacs_airec\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tAPI网关\\r\\n\\t\\t\\t\\t[{\\"name\\":\\"product\\",\\"value\\":\\"APIGateway\\"},{\\"name\\":\\"productCategory\\",\\"value\\":\\"apigateway\\"},{\\"name\\":\\"groupFlag\\",\\"value\\":\\"true\\"}]\\r\\n\\t\\t\\t\\tacs_apigateway_dashboard\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tCDN\\r\\n\\t\\t\\t\\t[{\\"name\\":\\"product\\",\\"value\\":\\"CDN\\"},{\\"name\\":\\"productCategory\\",\\"value\\":\\"cdn\\"},{\\"name\\":\\"groupFlag\\",\\"value\\":\\"true\\"}]\\r\\n\\t\\t\\t\\tacs_cdn\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t云企业网\\r\\n\\t\\t\\t\\t[{\\"name\\":\\"product\\",\\"value\\":\\"CEN\\"},{\\"name\\":\\"productCategory\\",\\"value\\":\\"cen,cen_flow,cen_vbr\\"},{\\"name\\":\\"groupFlag\\",\\"value\\":\\"true\\"}]\\r\\n\\t\\t\\t\\tacs_cen\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\r\\n","errorExample":""}]',
'title' => '查询云监控支持的时序类监控项产品列表',
'description' => '获取接入的云产品信息,包括产品的描述信息、Namespace和标签。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteExporterOutput' => [
'summary' => '调用DeleteExporterOutput接口删除监控数据导出配置。',
'methods' => [
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'DestName',
'in' => 'query',
'schema' => [
'description' => '配置的目标名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'testName',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 状态码为200表示成功,其余取值表示失败。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'Success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '2DECF751-7AFA-43BB-8C63-2B6B07E51AE1',
],
'Success' => [
'description' => '是否成功,取值: '."\n"
.'- `true`:成功'."\n"
.'- `false`:失败',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Success\\",\\n \\"RequestId\\": \\"2DECF751-7AFA-43BB-8C63-2B6B07E51AE1\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"success\\n296AE90D-153C-4612-AF24-75D0F5921976\\n200\\ntrue","errorExample":""}]',
'title' => '删除监控数据导出配置',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteExporterRule' => [
'summary' => '调用DeleteExporterRule接口删除数据导出规则。',
'methods' => [
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '导出规则名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'myRuleName',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 状态码为200表示成功,其余取值表示失败。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '6A5F022D-AC7C-460E-94AE-B9E75083D023',
],
'Success' => [
'description' => '是否成功,取值: '."\n"
.'- `true`:成功'."\n"
.'- `false`:失败',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"6A5F022D-AC7C-460E-94AE-B9E75083D023\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"success\\n8B524AE2-FBB1-4202-AA17-B3DEAAC8D861\\n200\\ntrue","errorExample":""}]',
'title' => '删除数据导出规则',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeExporterOutputList' => [
'summary' => '调用DescribeExporterOutputList接口查询监控数据导出列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页码,默认为1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '1',
'default' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数,默认为10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '10',
'default' => '1000',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 状态码为200表示成功,其余取值表示失败。',
'type' => 'string',
'example' => '200',
],
'Datapoints' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Datapoint' => [
'description' => '输出的配置列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ConfigJson' => [
'description' => '监控输出配置。',
'type' => 'object',
'properties' => [
'ak' => [
'description' => 'AccessKeyId。',
'type' => 'string',
'example' => 'LTAIpY33********',
],
'endpoint' => [
'description' => 'SLS的数据对应的域名。',
'type' => 'string',
'example' => 'http://cn-qingdao-share.log.aliyuncs.com',
],
'logstore' => [
'description' => '日志库。',
'type' => 'string',
'example' => 'monitorlogstore',
],
'project' => [
'description' => 'SLS项目。',
'type' => 'string',
'example' => 'exporter',
],
],
],
'CreateTime' => [
'description' => '创建的uninx时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1584016495498',
],
'DestName' => [
'description' => '配置的名称。',
'type' => 'string',
'example' => 'exporterOut',
],
'DestType' => [
'description' => '数据导出的类型。'."\n"
."\n"
.'> 目前仅支持SLS,后续将支持导出更多的产品。',
'type' => 'string',
'example' => 'SLS',
],
],
],
],
],
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'sucess',
],
'PageNumber' => [
'description' => '当前页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '请求ID。'."\n"
."\n",
'type' => 'string',
'example' => '0E657631-CD6C-4C24-9637-98D000B9272C',
],
'Success' => [
'description' => '是否成功,取值: '."\n"
.'- `true`:成功'."\n"
.'- `false`:失败',
'type' => 'boolean',
'example' => 'true',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '25',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"0E657631-CD6C-4C24-9637-98D000B9272C\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"sucess\\",\\n \\"PageNumber\\": 1,\\n \\"Total\\": 25,\\n \\"Datapoints\\": {\\n \\"Datapoint\\": [\\n {\\n \\"DestType\\": \\"SLS\\",\\n \\"CreateTime\\": 1584016495498,\\n \\"DestName\\": \\"exporterOut\\",\\n \\"ConfigJson\\": {\\n \\"ak\\": \\"LTAIpY33********\\",\\n \\"endpoint\\": \\"http://cn-qingdao-share.log.aliyuncs.com\\",\\n \\"project\\": \\"exporter\\",\\n \\"logstore\\": \\"monitorlogstore\\",\\n \\"as\\": \\"TxHwuJ8yAb3AULcnny******\\"\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"BB30C6D9-8D0D-442E-9484-C15BADE76A21\\n1\\n1\\n\\n \\n SLS\\n desctName1\\n 1584016495498\\n \\n http://cn-qingdao-share.log.aliyuncs.com\\n TxHwuJ8yAb3AULcnny******\\n exporter\\n LTAIpY33********\\n exporter\\n \\n \\n\\n200\\ntrue","errorExample":""}]',
'title' => '查询监控数据导出列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeExporterRuleList' => [
'summary' => '调用DescribeExporterRuleList接口查询数据导出规则列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '分页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '1',
'default' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '10',
'default' => '1000',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 状态码为200表示成功,其余取值表示失败。',
'type' => 'string',
'example' => '200',
],
'Datapoints' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Datapoint' => [
'description' => '数据点。',
'type' => 'array',
'items' => [
'description' => '数据点。',
'type' => 'object',
'properties' => [
'CreateTime' => [
'description' => '创建时间',
'type' => 'integer',
'format' => 'int64',
'example' => '1667526533000',
],
'Describe' => [
'description' => '导出规则描述。',
'type' => 'string',
'example' => 'export test',
],
'Dimension' => [
'description' => '维度',
'type' => 'string',
'example' => 'hotsName',
],
'DstName' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'DstName' => [
'description' => '目标名称。',
'type' => 'array',
'items' => [
'description' => '目标名称。',
'type' => 'string',
'example' => '[]',
],
],
],
],
'Enabled' => [
'description' => '是否启用。',
'type' => 'boolean',
'example' => 'true',
],
'MetricName' => [
'description' => '指标名称。',
'type' => 'string',
'example' => 'CPUUtilization',
],
'Namespace' => [
'description' => '云产品的命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'RuleName' => [
'description' => '规则名称。',
'type' => 'string',
'example' => 'L121-寿险-全能保建议书系统_DefaultEventRule_10842827',
],
'TargetWindows' => [
'description' => '导出数据的时间窗口。单位:秒。'."\n"
."\n"
.'> - 如果需要导出多个窗口,则使用英文逗号(,)分隔。'."\n"
.'- 不支持导出小于60秒的数据。',
'type' => 'string',
'example' => 'rule_test',
],
],
],
],
],
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'PageNumber' => [
'description' => '分页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '6BA047CA-8BC6-40BC-BC8F-FBECF35F1993',
],
'Success' => [
'description' => '是否成功,取值: '."\n"
.'- `true`:成功'."\n"
.'- `false`:失败',
'type' => 'boolean',
'example' => 'true',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1000',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Datapoints\\": {\\n \\"Datapoint\\": [\\n {\\n \\"CreateTime\\": 1667526533000,\\n \\"Describe\\": \\"export test\\",\\n \\"Dimension\\": \\"hotsName\\",\\n \\"DstName\\": {\\n \\"DstName\\": [\\n \\"[]\\"\\n ]\\n },\\n \\"Enabled\\": true,\\n \\"MetricName\\": \\"CPUUtilization\\",\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"RuleName\\": \\"L121-寿险-全能保建议书系统_DefaultEventRule_10842827\\",\\n \\"TargetWindows\\": \\"rule_test\\"\\n }\\n ]\\n },\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"PageNumber\\": 1,\\n \\"RequestId\\": \\"6BA047CA-8BC6-40BC-BC8F-FBECF35F1993\\",\\n \\"Success\\": true,\\n \\"Total\\": 1000\\n}","type":"json"}]',
'title' => '查询数据导出规则列表',
],
'DescribeMetricTop' => [
'summary' => '调用DescribeMetricTop接口先查询指定云产品的指定监控项的最新监控数据,再查询该监控项排序后的监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '监控数据的统计周期。'."\n"
."\n"
.'取值:15、60、900和3600。'."\n"
."\n"
.'单位:秒。'."\n"
."\n"
.'> - 如果不设置统计周期,则按照注册监控项时申请的上报周期来查询监控数据。'."\n"
.'- 每个云产品的监控项(`MetricName`)的统计周期不同。更多信息,请参见[云产品监控项](~~163515~~)。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '云产品的监控项名称。'."\n"
."\n"
.'关于监控项名称,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cpu_idle',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询监控数据的开始时间。'."\n"
."\n"
.'- 当您未设置`StartTime`和`EndTime`时,查询当前时间最近一个统计周期`Period`的监控数据。'."\n"
."\n"
.'- 当您同时设置`StartTime`和`EndTime`时,查询指定时间段内距离`EndTime`最近一个统计周期`Period`的监控数据。具体如下:'."\n"
."\n"
.' - 当`Period`设置为15秒时,指定时间段必须小于或等于20分钟。例如:StartTime为2021-05-08 08:10:00,EndTime为2021-05-08 08:30:00,统计距离2021-05-08 08:30:00最近一个15秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为60秒或900秒时,指定时间段必须小于或等于2小时。例如:Period为60秒,StartTime为2021-05-08 08:00:00,EndTime为2021-05-08 10:00:00,统计距离2021-05-08 10:00:00最近一个60秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为3600秒时,指定时间段必须小于或等于2天。例如:StartTime为2021-05-08 08:00:00,EndTime为2021-05-10 08:00:00,统计距离2021-05-10 08:00:00最近一个3600秒的监控数据。'."\n"
."\n"
.'开始时间支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
."\n"
.'- Format格式:YYYY-MM-DDThh:mm:ssZ。'."\n"
."\n"
.'> - `StartTime`如果设置过早,则无效。'."\n"
.'- 建议您使用Unix时间戳,避免时区的问题。',
'type' => 'string',
'required' => false,
'example' => '2021-05-08 08:00:00',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询监控数据的结束时间。'."\n"
."\n"
.'- 当您未设置`StartTime`和`EndTime`时,查询当前时间最近一个统计周期`Period`的监控数据。'."\n"
."\n"
.'- 当您同时设置`StartTime`和`EndTime`时,查询指定时间段内距离`EndTime`最近一个统计周期`Period`的监控数据。具体如下:'."\n"
."\n"
.' - 当`Period`设置为15秒时,指定时间段必须小于或等于20分钟。例如:StartTime为2021-05-08 08:10:00,EndTime为2021-05-08 08:30:00,统计距离2021-05-08 08:30:00最近一个15秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为60秒或900秒时,指定时间段必须小于或等于2小时。例如:Period为60秒,StartTime为2021-05-08 08:00:00,EndTime为2021-05-08 10:00:00,统计距离2021-05-08 10:00:00最近一个60秒的监控数据。'."\n"
."\n"
.' - 当`Period`设置为3600秒时,指定时间段必须小于或等于2天。例如:StartTime为2021-05-08 08:00:00,EndTime为2021-05-10 08:00:00,统计距离2021-05-10 08:00:00最近一个3600秒的监控数据。'."\n"
."\n\n"
."\n"
.'结束时间支持的格式:'."\n"
."\n"
.'- Unix时间戳:从1970年1月1日开始所经过的毫秒数。'."\n"
."\n"
.'- Format格式:YYYY-MM-DDThh:mm:ssZ。'."\n"
."\n"
.'> 建议您使用Unix时间戳,避免时区的问题。'."\n"
."\n"
.' ',
'type' => 'string',
'required' => false,
'example' => '2021-05-08 10:00:00',
],
],
[
'name' => 'Dimensions',
'in' => 'query',
'schema' => [
'description' => '指定资源的监控维度。'."\n"
."\n"
.'格式:`key:value`键值对形式的集合,例如:`{"userId":"120886317861****"}`和`{"instanceId":"i-2ze2d6j5uhg20x47****"}`。'."\n"
."\n"
.'> 单次请求最多支持批量查询50个实例。',
'type' => 'string',
'required' => false,
'example' => '[{"instanceId": "i-2ze2d6j5uhg20x47****"}]',
],
],
[
'name' => 'Orderby',
'in' => 'query',
'schema' => [
'description' => '排序字段,即按该字段进行排序。取值:'."\n"
."\n"
.'- Average:平均值。'."\n"
."\n"
.'- Minimum:最小值。'."\n"
."\n"
.'- Maximum:最大值。',
'type' => 'string',
'required' => true,
'example' => 'Average',
],
],
[
'name' => 'OrderDesc',
'in' => 'query',
'schema' => [
'description' => '排序方式。取值:'."\n"
.'- true:由小到大排序。'."\n"
.'- false(默认值):由大到小排序。',
'type' => 'string',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'Length',
'in' => 'query',
'schema' => [
'description' => '每页显示的记录条数。'."\n"
."\n"
.'用于分页查询,默认值:10。'."\n"
."\n"
.'> 单次请求Length的最大值为1440。',
'type' => 'string',
'required' => false,
'example' => '10',
],
],
[
'name' => 'Express',
'in' => 'query',
'schema' => [
'description' => '对查询出的现有结果进行实时计算的表达式。'."\n"
."\n"
.'> 目前仅支持`groupby`(类似数据库的groupby语句)。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '{"groupby":["userId","instanceId"]}',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42',
],
'Datapoints' => [
'description' => '监控数据列表。',
'type' => 'string',
'example' => '[{\\"order\\":1,\\"timestamp\\":1620287520000,\\"userId\\":\\"120886317861****\\",\\"instanceId\\":\\"i-j6ccf7d5fn335qpo****\\",\\"Average\\":99.92,\\"Minimum\\":99.5,\\"Maximum\\":100.0,\\"_count\\":1.0},{\\"order\\":2,\\"timestamp\\":1620287520000,\\"userId\\":\\"120886317861****\\",\\"instanceId\\":\\"i-0xii2bvf42iqvxbp****\\",\\"Average\\":99.91,\\"Minimum\\":99.0,\\"Maximum\\":100.0,\\"_count\\":1.0}]',
],
'Period' => [
'description' => '监控数据的统计周期。单位:秒。取值:15、60、900和3600。',
'type' => 'string',
'example' => '60',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42\\",\\n \\"Datapoints\\": \\"[{\\\\\\\\\\\\\\"order\\\\\\\\\\\\\\":1,\\\\\\\\\\\\\\"timestamp\\\\\\\\\\\\\\":1620287520000,\\\\\\\\\\\\\\"userId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"120886317861****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"instanceId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"i-j6ccf7d5fn335qpo****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"Average\\\\\\\\\\\\\\":99.92,\\\\\\\\\\\\\\"Minimum\\\\\\\\\\\\\\":99.5,\\\\\\\\\\\\\\"Maximum\\\\\\\\\\\\\\":100.0,\\\\\\\\\\\\\\"_count\\\\\\\\\\\\\\":1.0},{\\\\\\\\\\\\\\"order\\\\\\\\\\\\\\":2,\\\\\\\\\\\\\\"timestamp\\\\\\\\\\\\\\":1620287520000,\\\\\\\\\\\\\\"userId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"120886317861****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"instanceId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"i-0xii2bvf42iqvxbp****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"Average\\\\\\\\\\\\\\":99.91,\\\\\\\\\\\\\\"Minimum\\\\\\\\\\\\\\":99.0,\\\\\\\\\\\\\\"Maximum\\\\\\\\\\\\\\":100.0,\\\\\\\\\\\\\\"_count\\\\\\\\\\\\\\":1.0}]\\",\\n \\"Period\\": \\"60\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t18DC44ED-B058-49B0-9D49-1D6608328E4D\\r\\n\\t60\\r\\n\\t[{\\\\\\"order\\\\\\":1,\\\\\\"timestamp\\\\\\":1620287520000,\\\\\\"userId\\\\\\":\\\\\\"120886317861****\\\\\\",\\\\\\"instanceId\\\\\\":\\\\\\"i-j6ccf7d5fn335qpo****\\\\\\",\\\\\\"Average\\\\\\":99.92,\\\\\\"Minimum\\\\\\":99.5,\\\\\\"Maximum\\\\\\":100.0,\\\\\\"_count\\\\\\":1.0},{\\\\\\"order\\\\\\":2,\\\\\\"timestamp\\\\\\":1620287520000,\\\\\\"userId\\\\\\":\\\\\\"120886317861****\\\\\\",\\\\\\"instanceId\\\\\\":\\\\\\"i-0xii2bvf42iqvxbp****\\\\\\",\\\\\\"Average\\\\\\":99.91,\\\\\\"Minimum\\\\\\":99.0,\\\\\\"Maximum\\\\\\":100.0,\\\\\\"_count\\\\\\":1.0}]\\r\\n\\t200\\r\\n\\t","errorExample":""}]',
'title' => '查询排序后的最新监控数据',
'description' => '### 使用限制'."\n"
.'- 调用DescribeMetricLast、DescribeMetricList、DescribeMetricData和DescribeMetricTop的接口,有100万次/月免费额度(总计),当免费额度用完且您没有开通基础云监控按量计费时,将无法正常使用该API。如果您已开通基础云监控的按量计费,当免费调用额度用完时,该API仍然可以正常使用,超出免费额度部分将自动按使用量计费。开通方法详见[开通按量计费](https://common-buy.aliyun.com/?spm=a2c4g.11186623.0.0.6c8f3481IbSHgG&commodityCode=cms_basic_public_cn&from_biz_channel=help_bill)。'."\n"
.'- 单个API的调用次数限制为10次/秒。一个阿里云账号及该账号下的RAM用户共用10次/秒。'."\n"
.'### 注意事项'."\n"
.'各云产品监控数据的存储时长与`Period`(统计周期)有关,`Period`越大,查询的监控数据越稀疏,监控数据的存储时间越长,具体关系如下:'."\n"
.'- `Period`小于60秒,存储时长为7天。'."\n"
.'- `Period`等于60秒,存储时长为31天。'."\n"
.'- `Period`大于等于300秒,存储时长为91天。'."\n"
.'### 使用说明'."\n"
.'本文将提供一个示例,查询云服务`acs_ecs_dashboard`监控项`cpu_idle`在最近60秒的监控数据,并对监控数据的`Average`从大到小排序。',
'requestParamsDescription' => ' 关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutExporterOutput' => [
'summary' => '调用PutExporterOutput接口创建或者修改一个监控数据导出配置。',
'methods' => [
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'DestName',
'in' => 'query',
'schema' => [
'description' => '配置的名称。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'exporterConfig',
],
],
[
'name' => 'ConfigJson',
'in' => 'query',
'schema' => [
'description' => '数据导出的配置。是一个JSONObject字符串。必须要包含如下字段:'."\n"
."\n"
.'- endpoint:日志服务(SLS)数据对应的域名。'."\n"
.'- project:项目。'."\n"
.'- logstore:日志库。'."\n"
.'- ak:AccessKey ID。'."\n"
.'- as:AccessKey Secret。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '{ "endpoint": "http://cn-qingdao-share.log.aliyuncs.com", "project": "exporter", "logstore": "exporter","ak": "LTAIp*******", "userId": "17754********", "as": "TxHwuJ8yAb3AU******"}',
],
],
[
'name' => 'Desc',
'in' => 'query',
'schema' => [
'description' => '配置的描述信息。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'CPU指标导出',
],
],
[
'name' => 'DestType',
'in' => 'query',
'schema' => [
'description' => '导出的产品。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'sls',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '6A5F022D-AC7C-460E-94AE-B9E75083D027',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"6A5F022D-AC7C-460E-94AE-B9E75083D027\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\tE5DC60DD-2FDE-488F-942C-424FA3E18BF8\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '创建或者修改一个监控数据导出配置',
'description' => '> 目前仅支持日志服务(SLS),后续将支持导出更多的产品。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutExporterRule' => [
'summary' => '调用PutExporterRule接口创建或修改数据导出规则。',
'methods' => [
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '规则名称。'."\n"
."\n"
.'> 如果该规则名称与现有的名称重复,则表示修改,否则表示创建。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'rule1_****',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云服务的数据命名空间。更多信息,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。>详细信息请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'CPUUtilization',
],
],
[
'name' => 'TargetWindows',
'in' => 'query',
'schema' => [
'description' => '导出数据的时间窗口。单位:秒。'."\n"
."\n"
.'> - 如果需要导出多个窗口,则使用英文逗号(,)分隔。'."\n"
.'- 不支持导出小于60秒的数据。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => '60,300',
],
],
[
'name' => 'Describe',
'in' => 'query',
'schema' => [
'description' => '导出规则描述。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'desc_******',
],
],
[
'name' => 'DstNames',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '数据导出的目的地。',
'type' => 'array',
'items' => [
'description' => '数据导出的目的地。',
'type' => 'string',
'required' => false,
'example' => 'dst_******',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。'."\n",
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '创建或修改数据导出规则',
],
'DescribeAlertHistoryList' => [
'summary' => '调用DescribeAlertHistoryList接口查询报警历史详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => true,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'关于如何查询报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => false,
'example' => 'applyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。'."\n"
."\n"
.'关于如何查询报警规则名称,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Rule',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于如何查询云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '云产品的监控项名称。'."\n"
."\n"
.'关于如何查询云产品的监控项名称,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => false,
'example' => '7671****',
],
],
[
'name' => 'Status',
'in' => 'query',
'schema' => [
'description' => '通道沉默状态。取值:'."\n"
.'- 2(默认值):通道沉默。'."\n"
.'- 0:报警或恢复。'."\n"
.'- 1:失效期。',
'type' => 'string',
'required' => false,
'example' => '2',
],
],
[
'name' => 'State',
'in' => 'query',
'schema' => [
'description' => '报警状态。取值:'."\n"
.'- ALARM(默认值):报警状态。'."\n"
.'- OK:正常状态。',
'type' => 'string',
'required' => false,
'example' => 'ALARM',
],
],
[
'name' => 'Ascending',
'in' => 'query',
'schema' => [
'description' => '时间排序。取值:'."\n"
.'- true(默认值):表示时间倒序。'."\n"
.'- false:表示时间正序。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的开始时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1640237400000',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的结束时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1640608200000',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。'."\n"
."\n"
.'默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'Page',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C3C69FBE-2262-541F-A409-C52F380BAE63',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'string',
'example' => '2',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'AlarmHistoryList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AlarmHistory' => [
'description' => '报警历史详情。',
'type' => 'array',
'items' => [
'description' => '报警历史详情。',
'type' => 'object',
'properties' => [
'Status' => [
'description' => '通道沉默状态。取值:'."\n"
.'- 2(默认值):通道沉默。'."\n"
.'- 0:报警或恢复。'."\n"
.'- 1:失效期。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'EvaluationCount' => [
'description' => '报警重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'State' => [
'description' => '报警状态。取值:'."\n"
."\n"
.'- ALARM:报警状态。'."\n"
."\n"
.'- OK:正常状态。',
'type' => 'string',
'example' => 'ALARM',
],
'Namespace' => [
'description' => '云服务的命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'Webhooks' => [
'description' => 'URL回调地址。',
'type' => 'string',
'example' => 'https://www.aliyun.com',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'ECS_Rule',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'applyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****',
],
'LastTime' => [
'description' => '报警持续的时间。单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '360133',
],
'Value' => [
'description' => '出现报警或报警恢复时的监控值。',
'type' => 'string',
'example' => '10.58',
],
'Expression' => [
'description' => '报警触发的表达式。',
'type' => 'string',
'example' => '$Average>=10',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '7671****',
],
'AlertTime' => [
'description' => '报警推送的时间戳。单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1640586600000',
],
'InstanceName' => [
'description' => '实例名称。',
'type' => 'string',
'example' => 'i-bp1cqhiw1za2****',
],
'Dimensions' => [
'description' => '报警的资源。',
'type' => 'string',
'example' => '{\\"instanceId\\":\\"i-bp1cqhiw1za2****\\"}',
],
'Level' => [
'description' => '报警的级别和通知方式。取值:'."\n"
."\n"
.'- P2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n",
'type' => 'string',
'example' => 'P4',
],
'Contacts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Contact' => [
'description' => '报警联系人。',
'type' => 'array',
'items' => [
'description' => '报警联系人。',
'type' => 'string',
'example' => 'Alice',
],
],
],
],
'ContactALIIMs' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactALIIM' => [
'description' => '报警联系人的旺旺号。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'array',
'items' => [
'description' => '报警联系人的旺旺号。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => 'username@example.com',
],
],
],
],
'ContactMails' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactMail' => [
'description' => '报警联系人的邮箱地址。',
'type' => 'array',
'items' => [
'description' => '报警联系人的邮箱地址。',
'type' => 'string',
'example' => 'username@example.com',
],
],
],
],
'ContactSmses' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactSms' => [
'description' => '报警联系人的手机号码。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'array',
'items' => [
'description' => '报警联系人的手机号码。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '13900009999',
],
],
],
],
'ContactGroups' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactGroup' => [
'description' => '报警联系人组。',
'type' => 'array',
'items' => [
'description' => '报警联系人组。',
'type' => 'string',
'example' => 'ECS_Group',
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError ',
'errorMessage' => 'The request processing has failed due to some unknown error. ',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'staticInfo' => [
'substitutions' => [
'Cms::2019-01-01::DescribeAlertLogList',
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"C3C69FBE-2262-541F-A409-C52F380BAE63\\",\\n \\"Total\\": \\"2\\",\\n \\"Success\\": true,\\n \\"AlarmHistoryList\\": {\\n \\"AlarmHistory\\": [\\n {\\n \\"Status\\": 2,\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"EvaluationCount\\": 3,\\n \\"State\\": \\"ALARM\\",\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"Webhooks\\": \\"https://www.aliyun.com\\",\\n \\"RuleName\\": \\"ECS_Rule\\",\\n \\"RuleId\\": \\"applyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****\\",\\n \\"LastTime\\": 360133,\\n \\"Value\\": \\"10.58\\",\\n \\"Expression\\": \\"$Average>=10\\",\\n \\"GroupId\\": \\"7671****\\",\\n \\"AlertTime\\": 1640586600000,\\n \\"InstanceName\\": \\"i-bp1cqhiw1za2****\\",\\n \\"Dimensions\\": \\"{\\\\\\\\\\\\\\"instanceId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"i-bp1cqhiw1za2****\\\\\\\\\\\\\\"}\\",\\n \\"Level\\": \\"P4\\",\\n \\"Contacts\\": {\\n \\"Contact\\": [\\n \\"Alice\\"\\n ]\\n },\\n \\"ContactALIIMs\\": {\\n \\"ContactALIIM\\": [\\n \\"username@example.com\\"\\n ]\\n },\\n \\"ContactMails\\": {\\n \\"ContactMail\\": [\\n \\"username@example.com\\"\\n ]\\n },\\n \\"ContactSmses\\": {\\n \\"ContactSms\\": [\\n \\"13900009999\\"\\n ]\\n },\\n \\"ContactGroups\\": {\\n \\"ContactGroup\\": [\\n \\"ECS_Group\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t2\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tECS_Group\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tapplyTemplate61dc81b5-d357-4cf6-a9b7-9f83c1d5****\\r\\n\\t\\t\\t{\\\\\\"instanceId\\\\\\":\\\\\\"i-bp1cqhiw1za2****\\\\\\"}\\r\\n\\t\\t\\t3\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\t1640586600000\\r\\n\\t\\t\\t7671****\\r\\n\\t\\t\\ti-bp1cqhiw1za2****\\r\\n\\t\\t\\tcpu_total\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t$Average>=10\\r\\n\\t\\t\\tALARM\\r\\n\\t\\t\\t10.58\\r\\n\\t\\t\\tP4\\r\\n\\t\\t\\tP4\\r\\n\\t\\t\\t360133\\r\\n\\t\\t\\tECS_Rule\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tECS_Group\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tapplyTemplate61dc81b5-d357-4cf6-a9b7-9f83****\\r\\n\\t\\t\\t{\\\\\\"instanceId\\\\\\":\\\\\\"i-bp1cqhiw1za2807s****\\\\\\"}\\r\\n\\t\\t\\t3\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\t1640586540000\\r\\n\\t\\t\\t7671****\\r\\n\\t\\t\\ti-bp1cqhiw1za2807s****\\r\\n\\t\\t\\tcpu_total\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t$Average>=10\\r\\n\\t\\t\\tALARM\\r\\n\\t\\t\\t10.13\\r\\n\\t\\t\\tP4\\r\\n\\t\\t\\t300085\\r\\n\\t\\t\\tECS_Rule\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\\\\\"username@example.com\\\\\\"\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\r\\n\\tC3C69FBE-2262-541F-A409-C52F380BAE63\\r\\n\\t2\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询报警历史详情',
'description' => '本API不再维护,推荐您使用[DescribeAlertLogList](~~201087~~)。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeAlertLogCount' => [
'summary' => '调用DescribeAlertLogCount接口统计报警历史。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的开始时间戳。'."\n"
."\n"
.'单位:毫秒。'."\n"
."\n"
.'您只能查询最近一年的报警历史,如果查询时间大于一年,则参数`AlertLogCount`的返回值为空。'."\n"
."\n"
.'> 开始时间(StartTime)和结束时间(EndTime)之间必须小于等于15天,并且需要同时填写或同时不填写。如果不填,则默认查询最近15分钟的报警历史。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1609988009694',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的结束时间戳。'."\n"
."\n"
.'单位:毫秒。'."\n"
."\n"
.'您只能查询最近一年的报警历史,如果查询时间大于一年,则参数`AlertLogCount`的返回值为空。'."\n"
."\n"
.'> 开始时间(StartTime)和结束时间(EndTime)之间必须小于等于15天,并且需要同时填写或同时不填写。如果不填,则默认查询最近15分钟的报警历史。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1610074409694',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'SearchKey',
'in' => 'query',
'schema' => [
'description' => '统计报警历史的搜索关键字。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云服务的命名空间。'."\n"
."\n"
.'>关于云服务的命名空间,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '7301****',
],
],
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '云服务名称缩写。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '报警的级别和通知方式。取值:'."\n"
."\n"
.'- P2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n",
'type' => 'string',
'required' => false,
'example' => 'P4',
],
],
[
'name' => 'SendStatus',
'in' => 'query',
'schema' => [
'description' => '报警状态。取值:'."\n"
.'- 0:发生报警或报警恢复正常。'."\n"
.'- 1:非生效期。'."\n"
.'- 2:通道沉默周期。'."\n"
.'- 3:主机重启中。'."\n"
.'- 4:不发送报警。'."\n"
."\n"
.'当报警状态为0时,如果Level的取值为P2、P3或P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。',
'type' => 'string',
'required' => false,
'example' => '0',
],
],
[
'name' => 'ContactGroup',
'in' => 'query',
'schema' => [
'description' => '报警联系人组。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Group',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。',
'type' => 'string',
'required' => false,
'example' => 'test123',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。'."\n"
."\n"
.'>关于云服务的监控项,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
],
[
'name' => 'LastMin',
'in' => 'query',
'schema' => [
'description' => '获取日志的周期。单位:分钟。',
'type' => 'string',
'required' => false,
'example' => '360',
],
],
[
'name' => 'GroupBy',
'in' => 'query',
'schema' => [
'description' => '对数据进行空间维度聚合,相当于SQL中的Group By。取值:'."\n"
.'- `product`:按照云服务统计。'."\n"
.'- `level`:按照报警级别统计。'."\n"
.'- `groupId`:按照应用分组统计。'."\n"
.'- `contactGroup`:按照报警联系人组统计。'."\n"
.'- `product,metricName`:按照云服务和监控项统计。 ',
'type' => 'string',
'required' => true,
'example' => 'product',
],
],
[
'name' => 'SourceType',
'in' => 'query',
'schema' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'required' => false,
'example' => '无',
],
],
[
'name' => 'EventType',
'in' => 'query',
'schema' => [
'description' => '告警类型。取值:'."\n"
."\n"
.'- TRIGGERED:告警触发。'."\n"
."\n"
.'- RESOLVED:告警恢复。',
'type' => 'string',
'required' => false,
'example' => 'TRIGGERED',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n\n"
.'关于如何获取报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => false,
'example' => 'bfae2ca5b4e07d2c7278772e***********',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '1C4A3709-BF52-42EE-87B5-7435F0929585',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'AlertLogCount' => [
'description' => '报警历史数量统计。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Count' => [
'description' => '报警历史统计的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Logs' => [
'description' => '报警历史统计的数量详情。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Name' => [
'description' => '报警历史统计的字段名称。',
'type' => 'string',
'example' => 'product',
],
'Value' => [
'description' => '报警历史统计的字段值。',
'type' => 'string',
'example' => 'ECS',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Parameter invalid.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"1C4A3709-BF52-42EE-87B5-7435F0929585\\",\\n \\"Success\\": true,\\n \\"AlertLogCount\\": [\\n {\\n \\"Count\\": 1,\\n \\"Logs\\": [\\n {\\n \\"Name\\": \\"product\\",\\n \\"Value\\": \\"ECS\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t0BA67F6D-B699-4E3F-B205-93A5C38A0A2E\\r\\n\\t\\r\\n\\t\\t1\\r\\n\\t\\t\\r\\n\\t\\t\\tECS\\r\\n\\t\\t\\tproduct\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '统计报警历史',
'description' => '该接口只能统计到最近一年的报警历史。'."\n"
."\n"
.'本文将提供一个示例,从云服务`product`维度查询ECS的报警统计历史。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeAlertLogList' => [
'summary' => '调用DescribeAlertLogList接口查询报警历史。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的开始时间戳。'."\n"
."\n"
.'单位:毫秒。'."\n"
."\n"
.'您只能查询最近一年的报警历史,如果查询时间大于一年,则参数`AlertLogList`的返回值为空。'."\n"
."\n"
.'> 开始时间(`StartTime`)和结束时间(`EndTime`)之间必须小于等于15天,并且需要同时填写或同时不填写。如果不填,则默认查询最近15分钟的报警历史。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1609988009694',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的结束时间戳。'."\n"
."\n"
.'单位:毫秒。'."\n"
."\n"
.'您只能查询最近一年的报警历史,如果查询时间大于一年,则参数`AlertLogList`的返回值为空。'."\n"
."\n"
.'> 开始时间(`StartTime`)和结束时间(`EndTime`)之间必须小于等于15天,并且需要同时填写或同时不填写。如果不填,则默认查询最近15分钟的报警历史。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1610074409694',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页大小。'."\n"
."\n"
.'默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'SearchKey',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的搜索关键字。',
'type' => 'string',
'required' => false,
'example' => 'alert',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '7301****',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的命名空间。'."\n"
."\n"
.'> 关于云产品的命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '云产品名称缩写。'."\n"
."\n"
.'关于如何获取云产品名称缩写,请参见[DescribeProductsOfActiveMetricRule](~~114930~~)。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '报警的级别和通知方式。取值:'."\n"
."\n"
.'- P2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。',
'type' => 'string',
'required' => false,
'example' => 'P4',
],
],
[
'name' => 'SendStatus',
'in' => 'query',
'schema' => [
'description' => '报警状态。取值:'."\n"
.'- 0:发生报警或报警恢复正常。'."\n"
.'- 1:非生效期。'."\n"
.'- 2:通道沉默周期。'."\n"
.'- 3:主机重启中。'."\n"
.'- 4:不发送报警。'."\n"
."\n"
.'当报警状态为0时,如果Level的取值为P2、P3或P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。',
'type' => 'string',
'required' => false,
'example' => '0',
],
],
[
'name' => 'ContactGroup',
'in' => 'query',
'schema' => [
'description' => '报警联系人组。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Group',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。',
'type' => 'string',
'required' => false,
'example' => 'test123',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。'."\n"
."\n"
.'>关于云产品的监控项,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'IntranetInRate',
],
],
[
'name' => 'LastMin',
'in' => 'query',
'schema' => [
'description' => '获取日志的周期。单位:分钟。',
'type' => 'string',
'required' => false,
'example' => '360',
],
],
[
'name' => 'GroupBy',
'in' => 'query',
'schema' => [
'description' => '对数据进行空间维度聚合,相当于SQL中的Group By。取值:'."\n"
.'- `product`:按照云产品统计。'."\n"
.'- `level`:按照报警级别统计。'."\n"
.'- `groupId`:按照应用分组统计。'."\n"
.'- `contactGroup`:按照报警联系人组统计。'."\n"
.'- `product,metricName`:按照云产品和监控项统计。 ',
'type' => 'string',
'required' => false,
'example' => 'product',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'关于如何查询报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。'."\n",
'type' => 'string',
'required' => false,
'example' => 'bc369e8_30f87e517ed2fc****',
],
],
[
'name' => 'SourceType',
'in' => 'query',
'schema' => [
'description' => '报警规则类型。取值:METRIC,表示时序指标报警规则。',
'type' => 'string',
'required' => false,
'example' => 'METRIC',
],
],
[
'name' => 'EventType',
'in' => 'query',
'schema' => [
'description' => '告警类型。取值:'."\n"
."\n"
.'- TRIGGERED:告警触发。'."\n"
."\n"
.'- RESOLVED:告警恢复。',
'type' => 'string',
'required' => false,
'example' => 'TRIGGERED',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '1C4A3709-BF52-42EE-87B5-7435F0929585',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'PageSize' => [
'description' => '每页显示记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'AlertLogList' => [
'description' => '报警历史列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'EventName' => [
'description' => '事件名称。',
'type' => 'string',
'example' => 'IOHang',
],
'Product' => [
'description' => '云产品标识。取值:'."\n"
."\n"
.'- 如果是阿里云产品,则为云产品名称缩写,例如:ECS。'."\n"
."\n"
.'- 如果非阿里云产品,则为`acs_产品关键字`,例如:acs_networkmonitor。',
'type' => 'string',
'example' => 'ECS',
],
'BlackListUUID' => [
'description' => '命中的报警黑名单UUID。',
'type' => 'string',
'example' => '8410dbbd-7d30-41c5-94cb-****',
],
'Message' => [
'description' => '报警相关信息,为一个JSON串。',
'type' => 'string',
'example' => '{"alertName":"e47aa0ac-4076-44db-a47d-d1083968****_Availability"}',
],
'Namespace' => [
'description' => '云产品的命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'LevelChange' => [
'description' => '报警级别的变更。取值:'."\n"
.'- `P4->OK`:由P4级别报警到报警恢复。'."\n"
.'- `P4->P4`:P4级别报警。',
'type' => 'string',
'example' => 'P4->OK',
],
'InstanceId' => [
'description' => '资源ID。',
'type' => 'string',
'example' => 'i-m5e1qg6uo38rztr4****',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'CPU使用率',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'd582b9e9-b1c1-4f17-9279-0fe7333a****_ResponseTime',
],
'BlackListName' => [
'description' => '命中的报警黑名单名称。',
'type' => 'string',
'example' => 'Black_Test',
],
'GroupName' => [
'description' => '应用分组名称。',
'type' => 'string',
'example' => 'ECS_Instances',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '7301****',
],
'AlertTime' => [
'description' => '发生报警的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1610043776621',
],
'InstanceName' => [
'description' => '资源名称。',
'type' => 'string',
'example' => 'portalHost',
],
'BlackListDetail' => [
'description' => '命中的报警黑名单详情。',
'type' => 'string',
'example' => '{"id":12****,"metricProject":"acs_ecs_dashboard","userId":173651113438****,"uuid":"8410dbbd-7d30-41c5-94cb-****","name":"alert-****","productCategory":"ecs","instances":[{"instanceId":"i-m5e1qg6uo38rztr4****"}],"metrics":null,"scopeType":"USER","scopeValue":"","startTime":"0001-01-01T00:00:00Z","endTime":"9999-12-31T23:59:59.999999999+08:00","effectiveTime":null,"isEnable":true,"status":1,"gmtCreate":"2021-11-02T16:35:59+08:00","gmtModified":"2021-11-02T16:35:59+08:00","loadTime":"2021-11-02T16:36:15.213072177+08:00"}',
],
'Level' => [
'description' => '报警级别和报警通知方式。取值:'."\n"
."\n"
.'- P2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。',
'type' => 'string',
'example' => 'P4',
],
'SendStatus' => [
'description' => '报警状态。取值:'."\n"
.'- 0:发生报警或报警恢复正常。'."\n"
.'- 1:非生效期。'."\n"
.'- 2:通道沉默周期。'."\n"
.'- 3:主机重启中。'."\n"
.'- 4:不发送报警。'."\n"
."\n"
.'当报警状态为0时,如果Level的取值为P2、P3或P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。',
'type' => 'string',
'example' => '0',
],
'ExtendedInfo' => [
'description' => '报警的扩展信息。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Name' => [
'description' => '扩展字段名称。',
'type' => 'string',
'example' => 'userId',
],
'Value' => [
'description' => '扩展字段值。',
'type' => 'string',
'example' => '100931896542****',
],
],
],
],
'Dimensions' => [
'description' => '报警资源的维度。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '报警资源的Key。',
'type' => 'string',
'example' => 'instanceId',
],
'Value' => [
'description' => '报警资源的Value。',
'type' => 'string',
'example' => 'i-m5e1qg6uo38rztr4****',
],
],
],
],
'WebhookList' => [
'description' => '报警回调的URL地址列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'code' => [
'description' => '报警回调的状态码。',
'type' => 'string',
'example' => '200',
],
'url' => [
'description' => '报警回调的URL地址。',
'type' => 'string',
'example' => 'https://www.aliyun.com/webhook.html',
],
'message' => [
'description' => '报警回调的返回信息。',
'type' => 'string',
'example' => 'success',
],
],
],
],
'DingdingWebhookList' => [
'description' => '报警联系人的webhook地址列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人的Webhook地址列表。',
'type' => 'string',
'example' => 'https://oapi.dingtalk.com/robot/send?access_token=b7ff24032da1a5f86659ecda46797e13cc1d4e4da6903d7b014ea1d1488b****',
],
],
'ContactOnCallList' => [
'description' => '报警联系人的电话通知列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人的电话通知列表。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '1368888****',
],
],
'ContactMailList' => [
'description' => '报警联系人的邮件列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人的邮件列表。',
'type' => 'string',
'example' => 'username@example.com',
],
],
'ContactGroups' => [
'description' => '报警联系人组的列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人组。',
'type' => 'string',
'example' => 'ECS_Group',
],
],
'ContactALIIWWList' => [
'description' => '旺旺报警联系人列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人的旺旺列表。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => 'Alice',
],
],
'ContactSMSList' => [
'description' => '报警联系人的短信通知列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人的短信通知列表。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '1368888****',
],
],
'ContactDingList' => [
'description' => '报警联系人的钉钉列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人的钉钉列表。',
'type' => 'string',
'example' => 'CloudMonitor',
],
],
'SendDetail' => [
'description' => '报警推送结果详情。',
'type' => 'object',
'properties' => [
'ResultCode' => [
'description' => '报警信息推送状态。'."\n"
."\n"
.'- success:推送成功。'."\n"
."\n"
.'- 错误码:当配置错误时,无推送列表,显示错误码。',
'type' => 'string',
'example' => 'success',
],
'ChannelResultList' => [
'description' => '按报警渠道推送的报警结果列表。',
'type' => 'array',
'items' => [
'description' => '按报警渠道推送的报警结果。',
'type' => 'object',
'properties' => [
'Channel' => [
'description' => '报警推送渠道。取值:'."\n"
."\n"
.'- MAIL:邮件。'."\n"
."\n"
.'- SMS:短信。'."\n"
."\n"
.'- WEBHOOK:报警回调。'."\n"
."\n"
.'- SLS:日志服务。'."\n"
."\n"
.'- ONCALL:电话。'."\n"
."\n"
.'- FC:函数计算'."\n"
."\n"
.'- MNS:消息队列。',
'type' => 'string',
'example' => 'MAIL',
],
'ResultList' => [
'description' => '云监控向报警渠道发送的报警信息结果列表。',
'type' => 'array',
'items' => [
'description' => '云监控向报警渠道发送的报警信息结果。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'- 当`Channel`为`WEBHOOK`时,状态码为200或500。'."\n"
."\n"
.'- 当`Channel`为`MAIL`、`SMS`、`SLS`、`ONCALL`、`FC`和`MNS`时,无该参数,或该参数为空。',
'type' => 'string',
'example' => '200',
],
'RequestId' => [
'description' => '调用其他云产品返回的请求ID。',
'type' => 'string',
'example' => '0BDAF8A8-04DC-5F0C-90E4-724D42C4****',
],
'Success' => [
'description' => '调用目标的结果'."\n"
."\n"
.'- true 成功'."\n"
."\n"
.'- false 失败',
'type' => 'boolean',
'example' => 'true',
],
'Detail' => [
'description' => '返回结果详情。',
'type' => 'string',
'example' => '{ }',
],
'notifyTargetList' => [
'description' => '渠道通知列表。',
'type' => 'array',
'items' => [
'description' => '渠道通知列表。',
'type' => 'string',
'example' => 'MAIL',
],
],
],
],
],
],
],
],
],
],
'Escalation' => [
'description' => '触发报警的规则。',
'type' => 'object',
'properties' => [
'Expression' => [
'description' => '触发报警的规则描述。'."\n"
."\n"
.'> 报警规则的主体,当监控数据满足报警条件时,触发报警规则。',
'type' => 'string',
'example' => '$Average<90',
],
'Times' => [
'description' => '报警重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Level' => [
'description' => '报警级别和报警通知方式。取值:'."\n"
."\n"
.'- P2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。',
'type' => 'string',
'example' => 'P4',
],
],
],
'SendResultList' => [
'description' => '报警的发送结果列表。',
'type' => 'array',
'items' => [
'description' => '报警的发送结果列表。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '发送报警渠道。取值:'."\n"
.'- MAIL:邮件。'."\n"
.'- ALIIM:旺旺。'."\n"
.'- SMS:短信。'."\n"
.'- CALL:电话。'."\n"
.'- DING:钉钉机器人。'."\n"
.'- Merged:报警合并。',
'type' => 'string',
'example' => 'MAIL',
],
'Value' => [
'description' => '报警渠道对应的通知对象。',
'type' => 'array',
'items' => [
'description' => '报警渠道对应的通知对象。',
'type' => 'string',
'example' => 'username@example.com',
],
],
],
],
],
'LogId' => [
'description' => '日志ID。',
'type' => 'string',
'example' => '7510****::e8a472a0-46ae-4ac0-84b1-e46be368****',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Parameter invalid.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1C4A3709-BF52-42EE-87B5-7435F0929585\\",\\n \\"Success\\": true,\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"PageNumber\\": 1,\\n \\"PageSize\\": 10,\\n \\"AlertLogList\\": [\\n {\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"EventName\\": \\"IOHang\\",\\n \\"Product\\": \\"ECS\\",\\n \\"BlackListUUID\\": \\"8410dbbd-7d30-41c5-94cb-****\\",\\n \\"Message\\": \\"{\\\\\\"alertName\\\\\\":\\\\\\"e47aa0ac-4076-44db-a47d-d1083968****_Availability\\\\\\"}\\",\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"LevelChange\\": \\"P4->OK\\",\\n \\"InstanceId\\": \\"i-m5e1qg6uo38rztr4****\\",\\n \\"RuleName\\": \\"CPU使用率\\",\\n \\"RuleId\\": \\"d582b9e9-b1c1-4f17-9279-0fe7333a****_ResponseTime\\",\\n \\"BlackListName\\": \\"Black_Test\\",\\n \\"GroupName\\": \\"ECS_Instances\\",\\n \\"GroupId\\": \\"7301****\\",\\n \\"AlertTime\\": \\"1610043776621\\",\\n \\"InstanceName\\": \\"portalHost\\",\\n \\"BlackListDetail\\": \\"{\\\\\\"id\\\\\\":12****,\\\\\\"metricProject\\\\\\":\\\\\\"acs_ecs_dashboard\\\\\\",\\\\\\"userId\\\\\\":173651113438****,\\\\\\"uuid\\\\\\":\\\\\\"8410dbbd-7d30-41c5-94cb-****\\\\\\",\\\\\\"name\\\\\\":\\\\\\"alert-****\\\\\\",\\\\\\"productCategory\\\\\\":\\\\\\"ecs\\\\\\",\\\\\\"instances\\\\\\":[{\\\\\\"instanceId\\\\\\":\\\\\\"i-m5e1qg6uo38rztr4****\\\\\\"}],\\\\\\"metrics\\\\\\":null,\\\\\\"scopeType\\\\\\":\\\\\\"USER\\\\\\",\\\\\\"scopeValue\\\\\\":\\\\\\"\\\\\\",\\\\\\"startTime\\\\\\":\\\\\\"0001-01-01T00:00:00Z\\\\\\",\\\\\\"endTime\\\\\\":\\\\\\"9999-12-31T23:59:59.999999999+08:00\\\\\\",\\\\\\"effectiveTime\\\\\\":null,\\\\\\"isEnable\\\\\\":true,\\\\\\"status\\\\\\":1,\\\\\\"gmtCreate\\\\\\":\\\\\\"2021-11-02T16:35:59+08:00\\\\\\",\\\\\\"gmtModified\\\\\\":\\\\\\"2021-11-02T16:35:59+08:00\\\\\\",\\\\\\"loadTime\\\\\\":\\\\\\"2021-11-02T16:36:15.213072177+08:00\\\\\\"}\\",\\n \\"Level\\": \\"P4\\",\\n \\"SendStatus\\": \\"0\\",\\n \\"ExtendedInfo\\": [\\n {\\n \\"Name\\": \\"userId\\",\\n \\"Value\\": \\"100931896542****\\"\\n }\\n ],\\n \\"Dimensions\\": [\\n {\\n \\"Key\\": \\"instanceId\\",\\n \\"Value\\": \\"i-m5e1qg6uo38rztr4****\\"\\n }\\n ],\\n \\"WebhookList\\": [\\n {\\n \\"code\\": \\"200\\",\\n \\"url\\": \\"https://www.aliyun.com/webhook.html\\",\\n \\"message\\": \\"success\\"\\n }\\n ],\\n \\"DingdingWebhookList\\": [\\n \\"https://oapi.dingtalk.com/robot/send?access_token=b7ff24032da1a5f86659ecda46797e13cc1d4e4da6903d7b014ea1d1488b****\\"\\n ],\\n \\"ContactOnCallList\\": [\\n \\"1368888****\\"\\n ],\\n \\"ContactMailList\\": [\\n \\"username@example.com\\"\\n ],\\n \\"ContactGroups\\": [\\n \\"ECS_Group\\"\\n ],\\n \\"ContactALIIWWList\\": [\\n \\"Alice\\"\\n ],\\n \\"ContactSMSList\\": [\\n \\"1368888****\\"\\n ],\\n \\"ContactDingList\\": [\\n \\"CloudMonitor\\"\\n ],\\n \\"SendDetail\\": {\\n \\"ResultCode\\": \\"success\\",\\n \\"ChannelResultList\\": [\\n {\\n \\"Channel\\": \\"MAIL\\",\\n \\"ResultList\\": [\\n {\\n \\"Code\\": \\"200\\",\\n \\"RequestId\\": \\"0BDAF8A8-04DC-5F0C-90E4-724D42C4****\\",\\n \\"Success\\": true,\\n \\"Detail\\": \\"{ }\\",\\n \\"notifyTargetList\\": [\\n \\"MAIL\\"\\n ]\\n }\\n ]\\n }\\n ]\\n },\\n \\"Escalation\\": {\\n \\"Expression\\": \\"$Average<90\\",\\n \\"Times\\": 1,\\n \\"Level\\": \\"P4\\"\\n },\\n \\"SendResultList\\": [\\n {\\n \\"Key\\": \\"MAIL\\",\\n \\"Value\\": [\\n \\"username@example.com\\"\\n ]\\n }\\n ],\\n \\"LogId\\": \\"7510****::e8a472a0-46ae-4ac0-84b1-e46be368****\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t{\\\\\\"alertName\\\\\\":\\\\\\"d582b9e9-b1c1-4f17-9279-0fe7333a****_ResponseTime\\\\\\",\\\\\\"curLevel\\\\\\":\\\\\\"OK\\\\\\",\\\\\\"dimensions\\\\\\":{\\\\\\"taskId\\\\\\":\\\\\\"d582b9e9-b1c1-4f17-9279-0fe7333a****\\\\\\",\\\\\\"userId\\\\\\":\\\\\\"127067667954****\\\\\\"},\\\\\\"escalation\\\\\\":{\\\\\\"expression\\\\\\":\\\\\\"$Average>=800\\\\\\",\\\\\\"level\\\\\\":P4,\\\\\\"tag\\\\\\":\\\\\\"P4\\\\\\",\\\\\\"times\\\\\\":1}\\r\\n\\t\\td582b9e9-b1c1-4f17-9279-0fe7****_ResponseTime\\r\\n\\t\\t\\r\\n\\t\\t\\t$Average>=800\\r\\n\\t\\t\\t1\\r\\n\\t\\t\\tP4\\r\\n\\t\\t\\r\\n\\t\\t0\\r\\n\\t\\tacs_ecs_dashboard\\r\\n\\t\\tcpu_total\\r\\n\\t\\tCPU使用率\\r\\n\\t\\tECS_Group\\r\\n\\t\\t\\r\\n\\t\\tP4->OK\\r\\n\\t\\t\\r\\n\\t\\t\\t100931896542****\\r\\n\\t\\t\\tuserId\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\ti-abcdefgh12****\\r\\n\\t\\t\\tinstanceId\\r\\n\\t\\t\\r\\n\\t\\tAlertOk\\r\\n\\t\\t\\r\\n\\t\\t\\ti-hp34y1eiszazu49y****\\r\\n\\t\\t\\tinstanceId\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t12706****\\r\\n\\t\\t\\tuserId\\r\\n\\t\\t\\r\\n\\t\\tacs_ecs_dashboard\\r\\n\\t\\t1610085521564\\r\\n\\t\\t7301****\\r\\n\\t\\tportalHost\\r\\n\\t\\tOK\\r\\n\\t\\r\\n\\t6FCB1AB7-57F7-4DDA-B14E-6468FAFE79D9\\r\\n\\t10\\r\\n\\t1\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询报警历史',
'description' => '该接口只能查询到最近一年的报警历史。'."\n"
."\n"
.'本文将提供一个示例,从云产品`product`维度查询云服务器ECS的报警历史。',
'requestParamsDescription' => ' 关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeAlertLogHistogram' => [
'summary' => '调用DescribeAlertLogHistogram接口查询报警历史的直方图列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'StartTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的开始时间戳。'."\n"
."\n"
.'单位:毫秒。'."\n"
."\n"
.'> - 您只能查询最近一年的报警历史。'."\n"
.'> - 开始时间(`StartTime`)和结束时间(`EndTime`)之间必须小于等于15天。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1609988009694',
],
],
[
'name' => 'EndTime',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的结束时间戳。'."\n"
."\n"
.'单位:毫秒。'."\n"
."\n"
.'> - 您只能查询最近一年的报警历史。'."\n"
.'> - 开始时间(`StartTime`)和结束时间(`EndTime`)之间必须小于等于15天。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1609989009694',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。'."\n"
."\n"
.'默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'SearchKey',
'in' => 'query',
'schema' => [
'description' => '查询报警历史的搜索关键字。',
'type' => 'string',
'required' => false,
'example' => 'alert',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '7301****',
],
],
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '云服务名称缩写。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云服务的命名空间。'."\n"
."\n"
.'>关于云服务的命名空间,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '报警的级别和通知方式。取值:'."\n"
."\n"
.'- P2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- P4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。',
'type' => 'string',
'required' => false,
'example' => 'P4',
],
],
[
'name' => 'SendStatus',
'in' => 'query',
'schema' => [
'description' => '报警状态。取值:'."\n"
.'- 0:发生报警或报警恢复正常。'."\n"
.'- 1:非生效期。'."\n"
.'- 2:通道沉默周期。'."\n"
.'- 3:主机重启中。'."\n"
.'- 4:不发送报警。'."\n"
."\n"
.'当报警状态为0时,如果Level的取值为P2、P3或P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。'."\n"
.'当报警状态为0时,如果Level的取值为P4,则发生告警;如果Level的取值为OK,则报警恢复正常。',
'type' => 'string',
'required' => false,
'example' => '0',
],
],
[
'name' => 'ContactGroup',
'in' => 'query',
'schema' => [
'description' => '报警联系人组。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Group',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。',
'type' => 'string',
'required' => false,
'example' => 'test123',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。'."\n"
."\n"
.'>关于云服务的监控项,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
],
[
'name' => 'LastMin',
'in' => 'query',
'schema' => [
'description' => '获取日志的周期。单位:分钟。',
'type' => 'string',
'required' => false,
'example' => '360',
],
],
[
'name' => 'GroupBy',
'in' => 'query',
'schema' => [
'description' => '对数据进行空间维度聚合,相当于SQL中的Group By。取值:'."\n"
.'- `product`:按照云服务统计。'."\n"
.'- `level`:按照报警级别统计。'."\n"
.'- `groupId`:按照应用分组统计。'."\n"
.'- `contactGroup`:按照报警联系人组统计。'."\n"
.'- `product,metricName`:按照云服务和监控项统计。 ',
'type' => 'string',
'required' => false,
'example' => 'product',
],
],
[
'name' => 'SourceType',
'in' => 'query',
'schema' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'required' => false,
'example' => '无',
],
],
[
'name' => 'EventType',
'in' => 'query',
'schema' => [
'description' => '告警类型。取值:'."\n"
."\n"
.'- TRIGGERED:告警触发。'."\n"
.'- RESOLVED:告警恢复。',
'type' => 'string',
'required' => false,
'example' => 'RESOLVED',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n\n"
.'关于如何获取报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => false,
'example' => 'ae06917_75a8c43178ab66****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '1C4A3709-BF52-42EE-87B5-7435F0929585',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'AlertLogHistogramList' => [
'description' => '查询报警历史的直方图列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'From' => [
'description' => '查询报警历史的开始时间戳。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1610074791',
],
'To' => [
'description' => '查询报警历史的结束时间戳。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1610074800',
],
'Count' => [
'description' => '报警历史的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '20',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"1C4A3709-BF52-42EE-87B5-7435F0929585\\",\\n \\"Success\\": true,\\n \\"AlertLogHistogramList\\": [\\n {\\n \\"From\\": 1610074791,\\n \\"To\\": 1610074800,\\n \\"Count\\": 20\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n The specified resource is not found.\\n 1C4A3709-BF52-42EE-87B5-7435F0929585\\n true\\n \\n 1610074791\\n 1610074800\\n 20\\n \\n","errorExample":""}]',
'title' => '查询报警历史的直方图列表',
'description' => '本文将提供一个示例,从云服务`product`维度查询ECS报警历史的直方图列表。',
'requestParamsDescription' => ' 关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeProductsOfActiveMetricRule' => [
'summary' => '调用DescribeProductsOfActiveMetricRule接口查询开通一键报警规则的云服务列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'F82E6667-7811-4BA0-842F-5B2DC42BBAAD',
],
'Datapoints' => [
'description' => '开通一键报警的云服务列表。云服务之间用英文逗号(,)分隔。取值:'."\n"
.' '."\n"
.'- ecs:云服务器ECS。'."\n"
.'- rds:云数据库RDS版。'."\n"
.'- slb:负载均衡。'."\n"
.'- redis_standard:Redis 开源版标准架构。'."\n"
.'- redis_sharding:Redis 开源版集群架构。'."\n"
.'- redis_splitrw:Redis 开源版读写分离架构。'."\n"
.'- mongodb:云数据库MongoDB版(副本集)。'."\n"
.'- mongodb_sharding:云数据库MongoDB版(分片集群)。'."\n"
.'- hbase:云数据库HBase版。'."\n"
.'- elasticsearch:Elasticsearch。'."\n"
.'- opensearch:OpenSearch。',
'type' => 'string',
'example' => 'ecs,rds',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。'."\n",
'type' => 'boolean',
'example' => 'true',
],
'AllProductInitMetricRuleList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AllProductInitMetricRule' => [
'description' => '开通一键报警的云服务列表。',
'type' => 'array',
'items' => [
'description' => '开通一键报警的云服务列表。',
'type' => 'object',
'properties' => [
'Product' => [
'description' => '阿里云服务缩写。',
'type' => 'string',
'example' => 'ecs',
],
'AlertInitConfigList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AlertInitConfig' => [
'description' => '初始化开通一键报警云服务的规则列表。',
'type' => 'array',
'items' => [
'description' => '初始化开通一键报警云服务的规则列表。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控项名称。详情请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'example' => 'cpu_total',
],
'EvaluationCount' => [
'description' => '报警重试次数。',
'type' => 'string',
'example' => '3',
],
'Namespace' => [
'description' => '指标所属空间。用于区分每个云服务配置。详情请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'example' => 'acs_rds_dashboard',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => '报警统计方法。详情请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'example' => 'Average',
],
'Period' => [
'description' => '监控数据的聚合周期。单位:分钟。详情请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'example' => '1m',
],
'Level' => [
'description' => '报警级别。',
'type' => 'string',
'enumValueTitles' => [
'INFO' => '信息',
'WARN' => '警告',
'CRITICAL' => '紧急',
],
'example' => 'CRITICAL',
],
'ComparisonOperator' => [
'description' => '警告级别阈值比较符。',
'type' => 'string',
'enumValueTitles' => [
'LessThanThreshold' => '小于',
'GreaterThanLastWeek' => '同比上周同一时间上涨',
'LessThanOrEqualToThreshold' => '小于等于',
'NotEqualToThreshold' => '不等于',
'GreaterThanLastPeriod' => '环比上周期上涨',
'GreaterThanYesterday' => '同比昨天时间上涨',
'LessThanYesterday' => '同比昨天时间下降',
'LessThanLastWeek' => '同比上周同一时间下降',
'GreaterThanOrEqualToThreshold' => '大于等于',
'GreaterThanThreshold' => '大于',
'LessThanLastPeriod' => '环比上周期下降',
],
'example' => 'GreaterThanOrEqualToThreshold',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'The specified parameter is not valid.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'The Request is not authorization.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"F82E6667-7811-4BA0-842F-5B2DC42BBAAD\\",\\n \\"Datapoints\\": \\"ecs,rds\\",\\n \\"Success\\": true,\\n \\"AllProductInitMetricRuleList\\": {\\n \\"AllProductInitMetricRule\\": [\\n {\\n \\"Product\\": \\"ecs\\",\\n \\"AlertInitConfigList\\": {\\n \\"AlertInitConfig\\": [\\n {\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"EvaluationCount\\": \\"3\\",\\n \\"Namespace\\": \\"acs_rds_dashboard\\",\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\",\\n \\"Period\\": \\"1m\\",\\n \\"Level\\": \\"CRITICAL\\",\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\tA4FFAEFF-4225-4EF6-8F63-FAAA8F58289D\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tCPUUtilization\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t1m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\t\\t\\t\\t95\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tvm.DiskUtilization\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t1m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\t\\t\\t\\t95\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tvm.MemoryUtilization\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t1m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\t\\t\\t\\t95\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tInternetOutRate_Percent\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t1m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\t\\t\\t\\t95\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tecs\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tCpuUsage\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t5m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tDiskUsage\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t5m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tIOPSUsage\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t5m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tConnectionUsage\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t5m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tDataDelay\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\t5m\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\trds\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tDocSizeRatiobyApp\\r\\n\\t\\t\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t\\t\\t10m\\r\\n\\t\\t\\t\\t\\t\\tMaximum\\r\\n\\t\\t\\t\\t\\t\\tacs_opensearch\\r\\n\\t\\t\\t\\t\\t\\t85\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tlossqpsbyapp\\r\\n\\t\\t\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t\\t\\t10m\\r\\n\\t\\t\\t\\t\\t\\tMaximum\\r\\n\\t\\t\\t\\t\\t\\tacs_opensearch\\r\\n\\t\\t\\t\\t\\t\\t0\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tComputeResourceRatiobyApp\\r\\n\\t\\t\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t\\t\\t10m\\r\\n\\t\\t\\t\\t\\t\\tMaximum\\r\\n\\t\\t\\t\\t\\t\\tacs_opensearch\\r\\n\\t\\t\\t\\t\\t\\t85\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tapp_realtime_write_latency\\r\\n\\t\\t\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t\\t\\t20m\\r\\n\\t\\t\\t\\t\\t\\tMaximum\\r\\n\\t\\t\\t\\t\\t\\tacs_opensearch\\r\\n\\t\\t\\t\\t\\t\\t1800000\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\topensearch\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\trds,redis_standard\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询开通一键报警规则的云服务列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeActiveMetricRuleList' => [
'summary' => '调用DescribeActiveMetricRuleList接口查询一键报警规则的列表详情。',
'methods' => [
'get',
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '支持一键报警规则的云产品名称缩写。'."\n"
."\n"
.'关于如何获取云产品名称,请参见[DescribeProductsOfActiveMetricRule](~~114930~~)。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ecs',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'F82E6667-7811-4BA0-842F-5B2DC42BBAAD',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Datapoints' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Alarm' => [
'description' => '报警规则列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SilenceTime' => [
'description' => '通道沉默时间。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '86400',
],
'MetricName' => [
'description' => '监控指标名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'EvaluationCount' => [
'description' => '报警重试次数。',
'type' => 'string',
'example' => '3',
],
'Webhook' => [
'description' => 'URL回调地址。',
'type' => 'string',
'example' => 'https://www.aliyun.com',
],
'State' => [
'description' => '报警规则的启用状态。',
'type' => 'string',
'example' => 'Enable',
],
'ContactGroups' => [
'description' => '报警联系人组。',
'type' => 'string',
'example' => 'ECS_Group',
],
'Namespace' => [
'description' => '云产品的命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'SystemDefault_acs_rds_dashboard_CpuUsage',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'a151cd6023eacee2f0978e03863cc1697c89508****',
],
'Period' => [
'description' => '监控数据的聚合周期。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '60',
],
'ComparisonOperator' => [
'description' => '报警规则比较符。取值:'."\n"
."\n"
.'- `>`'."\n"
."\n"
.'- `<`'."\n"
."\n"
.'- `>=`'."\n"
."\n"
.'- `<=`'."\n"
."\n"
.'- `=`'."\n"
."\n"
.'- `=`',
'type' => 'string',
'example' => '>',
],
'EndTime' => [
'description' => '报警规则失效时间。'."\n"
."\n"
.'单位:小时。例如:23表示`23:59:59`。',
'type' => 'string',
'example' => '24',
],
'StartTime' => [
'description' => '报警规则生效起始时间。'."\n"
."\n"
.'单位:小时。例如:00表示`00:00:00`。',
'type' => 'string',
'example' => '00',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => '统计方法。',
'type' => 'string',
'example' => 'Average',
],
'Enable' => [
'description' => '报警规则的启用状态。取值:'."\n"
."\n"
.'- true:启用。'."\n"
."\n"
.'- false:禁用。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
],
'AlertList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Alert' => [
'description' => '报警规则列表。该列表的结构和获取报警规则列表保持统一。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SilenceTime' => [
'description' => '通道沉默时间。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '86400',
],
'MetricName' => [
'description' => '监控项的名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'Webhook' => [
'description' => 'URL回调地址。',
'type' => 'string',
'example' => 'http://www.aliyun.com',
],
'ContactGroups' => [
'description' => '报警联系人组。',
'type' => 'string',
'example' => 'ECS_Group',
],
'Namespace' => [
'description' => '云服务的命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'EffectiveInterval' => [
'description' => '报警规则的生效时间段。',
'type' => 'string',
'example' => '00:00-23:59',
],
'NoEffectiveInterval' => [
'description' => '报警不生效的时间段。',
'type' => 'string',
'example' => '00:00-06:00',
],
'MailSubject' => [
'description' => '发送邮件的主题。',
'type' => 'string',
'example' => 'ECS_Bucket',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'myAlert',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'ruleIdxxxx',
],
'Period' => [
'description' => '监控数据的聚合周期。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '60',
],
'AlertState' => [
'description' => '报警规则状态。取值:'."\n"
."\n"
.'- OK:正常。'."\n"
."\n"
.'- ALARM:报警。'."\n"
."\n"
.'- INSUFFICIENT_DATA:无数据。',
'type' => 'string',
'example' => 'OK',
],
'Dimensions' => [
'description' => '指定资源的监控数据。',
'type' => 'string',
'example' => '""',
],
'EnableState' => [
'description' => '报警规则的启用状态。取值:'."\n"
."\n"
.'- true:启用。'."\n"
."\n"
.'- false:禁用。',
'type' => 'boolean',
'example' => 'true',
],
'Resources' => [
'description' => '报警规则关联的资源。 ',
'type' => 'string',
'example' => '[{"resource":"_ALL"}]',
],
'Escalations' => [
'description' => '报警分级别触发条件。',
'type' => 'object',
'properties' => [
'Info' => [
'description' => 'Info级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Info级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanThreshold',
],
'Times' => [
'description' => 'Info级别连续出现次数。'."\n"
."\n"
.'Info级别连续出现达到该值且超过阈值才会触发报警。',
'type' => 'string',
'example' => '3',
],
'Threshold' => [
'description' => 'Info级别阈值。',
'type' => 'string',
'example' => '95',
],
'Statistics' => [
'description' => 'Info级别报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
],
],
'Warn' => [
'description' => 'Warn级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Warn级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanThreshold',
],
'Times' => [
'description' => 'Warn级别连续出现次数。'."\n"
."\n"
.'Warn级别连续出现达到该值且超过阈值才会触发报警。',
'type' => 'string',
'example' => '3',
],
'Threshold' => [
'description' => 'Warn级别阈值。',
'type' => 'string',
'example' => '80',
],
'Statistics' => [
'description' => 'Warn级别报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
],
],
'Critical' => [
'description' => 'Critical级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Critical级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanThreshold',
],
'Times' => [
'description' => 'Critical级别连续出现次数。Critical级别连续出现达到该值且超过阈值才会触发报警。',
'type' => 'string',
'example' => '3',
],
'Threshold' => [
'description' => 'Critical级别阈值。',
'type' => 'string',
'example' => '99',
],
'Statistics' => [
'description' => 'Critical级别报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"F82E6667-7811-4BA0-842F-5B2DC42BBAAD\\",\\n \\"Success\\": true,\\n \\"Datapoints\\": {\\n \\"Alarm\\": [\\n {\\n \\"SilenceTime\\": \\"86400\\",\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"EvaluationCount\\": \\"3\\",\\n \\"Webhook\\": \\"https://www.aliyun.com\\",\\n \\"State\\": \\"Enable\\",\\n \\"ContactGroups\\": \\"ECS_Group\\",\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"RuleName\\": \\"SystemDefault_acs_rds_dashboard_CpuUsage\\",\\n \\"RuleId\\": \\"a151cd6023eacee2f0978e03863cc1697c89508****\\",\\n \\"Period\\": \\"60\\",\\n \\"ComparisonOperator\\": \\">\\",\\n \\"EndTime\\": \\"24\\",\\n \\"StartTime\\": \\"00\\",\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\",\\n \\"Enable\\": \\"true\\"\\n }\\n ]\\n },\\n \\"AlertList\\": {\\n \\"Alert\\": [\\n {\\n \\"SilenceTime\\": \\"86400\\",\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"Webhook\\": \\"http://www.aliyun.com\\",\\n \\"ContactGroups\\": \\"ECS_Group\\",\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"EffectiveInterval\\": \\"00:00-23:59\\",\\n \\"NoEffectiveInterval\\": \\"00:00-06:00\\",\\n \\"MailSubject\\": \\"ECS_Bucket\\",\\n \\"RuleName\\": \\"myAlert\\",\\n \\"RuleId\\": \\"ruleIdxxxx\\",\\n \\"Period\\": \\"60\\",\\n \\"AlertState\\": \\"OK\\",\\n \\"Dimensions\\": \\"\\\\\\"\\\\\\"\\",\\n \\"EnableState\\": true,\\n \\"Resources\\": \\"[{\\\\\\"resource\\\\\\":\\\\\\"_ALL\\\\\\"}]\\",\\n \\"Escalations\\": {\\n \\"Info\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanThreshold\\",\\n \\"Times\\": \\"3\\",\\n \\"Threshold\\": \\"95\\",\\n \\"Statistics\\": \\"Average\\"\\n },\\n \\"Warn\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanThreshold\\",\\n \\"Times\\": \\"3\\",\\n \\"Threshold\\": \\"80\\",\\n \\"Statistics\\": \\"Average\\"\\n },\\n \\"Critical\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanThreshold\\",\\n \\"Times\\": \\"3\\",\\n \\"Threshold\\": \\"99\\",\\n \\"Statistics\\": \\"Average\\"\\n }\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t86400\\r\\n\\t\\t\\t\\tECS_Group\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t${serviceType}-${metricName}-${levelDescription}\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_IOPSUsage\\r\\n\\t\\t\\t\\t300\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\tINSUFFICIENT_DATA\\r\\n\\t\\t\\t\\tIOPSUsage\\r\\n\\t\\t\\t\\ttrue\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tGreaterThanThreshold\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t[{\\\\\\"resource\\\\\\":\\\\\\"_ALL\\\\\\"}]\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_IOPSUsage\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t86400\\r\\n\\t\\t\\t\\tECS_Group\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t${serviceType}-${metricName}-${levelDescription}\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_CpuUsage\\r\\n\\t\\t\\t\\t300\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\tINSUFFICIENT_DATA\\r\\n\\t\\t\\t\\tCpuUsage\\r\\n\\t\\t\\t\\ttrue\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tGreaterThanThreshold\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t[{\\\\\\"resource\\\\\\":\\\\\\"_ALL\\\\\\"}]\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_CpuUsage\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t86400\\r\\n\\t\\t\\t\\t[\\\\\\"Alice\\\\\\"]\\r\\n\\t\\t\\t\\tGreaterThanThreshold\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_IOPSUsage\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t300\\r\\n\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\tIOPSUsage\\r\\n\\t\\t\\t\\tINSUFFICIENT_DATA\\r\\n\\t\\t\\t\\ttrue\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_IOPSUsage\\r\\n\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t86400\\r\\n\\t\\t\\t\\t[\\\\\\"Jim\\\\\\"]\\r\\n\\t\\t\\t\\tGreaterThanThreshold\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_CpuUsage\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t300\\r\\n\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\tacs_rds_dashboard\\r\\n\\t\\t\\t\\tCpuUsage\\r\\n\\t\\t\\t\\tINSUFFICIENT_DATA\\r\\n\\t\\t\\t\\ttrue\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tSystemDefault_acs_rds_dashboard_CpuUsage\\r\\n\\t\\t\\t\\t80\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询一键报警规则的列表详情',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'EnableActiveMetricRule' => [
'summary' => '调用EnableActiveMetricRule接口启用一键报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '支持一键报警规则的云服务名称。取值:'."\n"
."\n"
.'* ecs:云服务器ECS。'."\n"
.'* rds:云数据库RDS版。'."\n"
.'* slb:负载均衡。'."\n"
.'* redis_standard:Redis 开源版标准架构。'."\n"
.'* redis_sharding:Redis 开源版集群架构。'."\n"
.'* redis_splitrw:Redis 开源版读写分离架构。'."\n"
.'* mongodb:云数据库MongoDB版(副本集)。'."\n"
.'* mongodb_sharding:云数据库MongoDB版(分片集群)。'."\n"
.'* hbase:云数据库HBase版。'."\n"
.'* elasticsearch:Elasticsearch。'."\n"
.'* opensearch:OpenSearch。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。'."\n",
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'F82E6667-7811-4BA0-842F-5B2DC42BBAAD',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"F82E6667-7811-4BA0-842F-5B2DC42BBAAD\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n true\\n 55850888-9CCE-4FD5-B949-5F8947D63929\\n","errorExample":""}]',
'title' => '启用一键报警规则',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DisableActiveMetricRule' => [
'summary' => '调用DisableActiveMetricRule接口禁用一键报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Product',
'in' => 'query',
'schema' => [
'description' => '支持一键报警规则的云服务名称。取值:'."\n"
."\n"
.'* ecs:云服务器ECS。'."\n"
.'* rds:云数据库RDS版。'."\n"
.'* slb:负载均衡。'."\n"
.'* redis_standard:Redis 开源版标准架构。'."\n"
.'* redis_sharding:Redis 开源版集群架构。'."\n"
.'* redis_splitrw:Redis 开源版读写分离架构。'."\n"
.'* mongodb:云数据库MongoDB版(副本集)。'."\n"
.'* mongodb_sharding:云数据库MongoDB版(分片集群)。'."\n"
.'* hbase:云数据库HBase版。'."\n"
.'* elasticsearch:Elasticsearch。'."\n"
.'* opensearch:OpenSearch。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'F82E6667-7811-4BA0-842F-5B2DC42BBAAD',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"F82E6667-7811-4BA0-842F-5B2DC42BBAAD\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '禁用一键报警规则',
],
'CreateMetricRuleTemplate' => [
'summary' => '调用CreateMetricRuleTemplate接口创建报警模板。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '报警模板名称。',
'type' => 'string',
'required' => true,
'example' => 'Template1',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '报警模板描述信息。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Template1',
],
],
[
'name' => 'AlertTemplates',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警模板列表。',
'type' => 'array',
'items' => [
'description' => '报警模板。',
'type' => 'object',
'properties' => [
'Escalations.Info.Threshold' => [
'description' => '普通级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '20',
],
'MetricName' => [
'description' => '监控项名称。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取监控项,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'cpu_total',
],
'Webhook' => [
'description' => '报警发生回调时的URL地址。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'填写公网可访问的URL地址,云监控会将报警信息通过POST请求推送到该地址,目前仅支持HTTP协议。',
'type' => 'string',
'required' => false,
'example' => 'http://ww.aliyun.com',
],
'Escalations.Warn.Threshold' => [
'description' => '警告级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '30',
],
'Namespace' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取云产品的数据命名空间,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。'."\n",
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
'Period' => [
'description' => '监控数据的聚合周期。单位:秒。'."\n"
."\n"
.'默认为监控项对应的最小周期,通常不需要指定。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '60',
],
'RuleName' => [
'description' => '报警规则名称。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'string',
'required' => true,
'example' => 'ECS_Rule1',
],
'Escalations.Critical.Times' => [
'description' => '发送紧急报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Selector' => [
'description' => 'Dimension扩展字段的选项。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'例如:报警模板被应用到了一个应用分组中,当该参数设置为`{"disk":"/"}`,监控项(MetricName)设置为`DiskUtilization`时,表示关联报警模板的应用分组中所有实例的磁盘根分区(`"/"`) 被关联到了对应报警规则中。'."\n"
."\n"
.'>关于扩展字段选项的取值,请参见[DescribeMetricRuleTemplateAttribute](~~114979~~)。',
'type' => 'string',
'required' => false,
'example' => '{"disk":"/"}',
],
'Escalations.Info.Statistics' => [
'description' => '普通级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Warn.Times' => [
'description' => '发送警告报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
'Escalations.Info.ComparisonOperator' => [
'description' => '普通级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Category' => [
'description' => '云产品名称缩写。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取云产品名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
'Escalations.Critical.Threshold' => [
'description' => '触发紧急级别报警通知的阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '30',
],
'Escalations.Critical.Statistics' => [
'description' => '紧急级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Critical.ComparisonOperator' => [
'description' => '紧急级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Warn.ComparisonOperator' => [
'description' => '警告级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Info.Times' => [
'description' => '发送普通报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
'Escalations.Warn.Statistics' => [
'description' => '警告级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 200,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回数据。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9763ED1A-4D09-41BF-851E-310421750204',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Id' => [
'description' => '报警模板ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '12345',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'InvalidClientTokenId',
'errorMessage' => 'not allow this operation.',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
412 => [
[
'errorCode' => 'ResourcesOverLimit',
'errorMessage' => 'Resources over limit.',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalFailure',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"9763ED1A-4D09-41BF-851E-310421750204\\",\\n \\"Success\\": true,\\n \\"Id\\": 12345\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t9763ED1A-4D09-41BF-851E-310421750204\\n\\t\\t12345\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '创建报警模板',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteMetricRuleTemplate' => [
'summary' => '调用DeleteMetricRuleTemplate接口删除报警规则模板。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TemplateId',
'in' => 'query',
'schema' => [
'description' => '报警规则模板ID。',
'type' => 'string',
'required' => true,
'example' => '123****',
'docRequired' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '7B63F8CF-D48D-4608-A402-04FB5B2B4B6A',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resource' => [
'description' => '模板信息。',
'type' => 'object',
'properties' => [
'TemplateId' => [
'description' => '模板ID。',
'type' => 'string',
'example' => '123****',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"7B63F8CF-D48D-4608-A402-04FB5B2B4B6A\\",\\n \\"Success\\": true,\\n \\"Resource\\": {\\n \\"TemplateId\\": \\"123****\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n \\r\\n 123****\\r\\n \\r\\n 7B63F8CF-D48D-4608-A402-04FB5B2B4B6A\\r\\n true\\r\\n 200\\r\\n","errorExample":""}]',
'title' => '删除报警规则模板',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ModifyMetricRuleTemplate' => [
'summary' => '调用ModifyMetricRuleTemplate接口修改报警模板。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'TemplateId',
'in' => 'query',
'schema' => [
'description' => '报警模板ID。'."\n"
."\n"
.'关于如何获取报警模板ID,请参见[DescribeMetricRuleTemplateList](~~114982~~)。'."\n"
."\n",
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '123456',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '报警模板名称。'."\n"
."\n"
.'关于如何获取报警模板名称,请参见[DescribeMetricRuleTemplateList](~~114982~~)。',
'type' => 'string',
'required' => false,
'example' => 'Template_123',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '报警模板描述。',
'type' => 'string',
'required' => false,
'example' => 'ECS_template1',
],
],
[
'name' => 'RestVersion',
'in' => 'query',
'schema' => [
'description' => '报警模板的版本。该参数随报警模板的修改次数自动更新。'."\n"
."\n"
.'关于如何获取报警模板的版本,请参见[DescribeMetricRuleTemplateList](~~114982~~)。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'example' => '1',
],
],
[
'name' => 'AlertTemplates',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警模板列表。',
'type' => 'array',
'items' => [
'description' => '报警模板列表。',
'type' => 'object',
'properties' => [
'Escalations.Info.Threshold' => [
'description' => '普通级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '20',
],
'MetricName' => [
'description' => '监控项名称。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取监控项,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。'."\n",
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
'Webhook' => [
'description' => '报警发生回调时的URL地址。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'填写公网可访问的URL地址,云监控会将报警信息通过POST请求推送到该地址,目前仅支持HTTP协议。',
'type' => 'string',
'required' => false,
'example' => 'http://www.aliyun.com',
],
'Escalations.Warn.Threshold' => [
'description' => '警告级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '30',
],
'Namespace' => [
'description' => '云产品的命名空间。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取云产品的命名空间,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
'Period' => [
'description' => '监控数据的统计周期。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 设置为300秒,表示每300秒统计一次监控值。如果监控数据每分钟上报一次,则会统计5分钟的值(平均值、最大值、最小值)。因为该统计周期可能会造成非您期望的报警,所以目前不建议您单独设置该参数。'."\n"
."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '60',
],
'RuleName' => [
'description' => '报警规则名称。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => 'Rule_123',
],
'Escalations.Critical.Times' => [
'description' => '发送紧急报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '2',
],
'Selector' => [
'description' => 'Dimension扩展字段的选项。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'例如:报警模板被应用到了一个应用分组中,当该参数设置为`{"disk":"/"}`,监控项(MetricName)设置为`DiskUtilization`时,表示关联报警模板的应用分组中所有实例的磁盘根分区(`"/"`) 被关联到了对应报警规则中。'."\n"
."\n"
.'>关于扩展字段选项的取值,请参见[DescribeMetricRuleTemplateAttribute](~~114979~~)。',
'type' => 'string',
'required' => false,
'example' => '{"disk":"/"}',
],
'Escalations.Info.Statistics' => [
'description' => '普通级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Warn.Times' => [
'description' => '发送警告报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
'Escalations.Info.ComparisonOperator' => [
'description' => '普通级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Category' => [
'description' => '云产品名称缩写。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取云产品名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => false,
'example' => 'ecs',
],
'Escalations.Critical.Threshold' => [
'description' => '触发紧急级别报警通知的阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '30',
],
'Escalations.Critical.Statistics' => [
'description' => '紧急级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Critical.ComparisonOperator' => [
'description' => '紧急级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Warn.ComparisonOperator' => [
'description' => '警告级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Info.Times' => [
'description' => '发送普通报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
'Escalations.Warn.Statistics' => [
'description' => '警告级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 200,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9E07117F-F6AE-4F1C-81E8-36FBB4892235',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => 'InvalidQueryParameter',
'errorMessage' => '%s',
],
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'InvalidClientTokenId',
'errorMessage' => 'The X.509 certificate or cms access key ID provided does not exist in our records.',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalFailure',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"9E07117F-F6AE-4F1C-81E8-36FBB4892235\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t97EAC0E2-CD54-4183-95AC-F0C113024E18\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '修改报警模板',
'description' => '本文将提供一个示例,修改版本`1`的报警模板`123456`,将报警级别修改为`Critical`,报警统计方法修改为`Average`,报警阈值比较符修改为`GreaterThanOrEqualToThreshold`,报警阈值修改为`90`,报警重试次数修改为`3`。返回结果显示,修改报警模板成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMetricRuleTemplateAttribute' => [
'summary' => '调用DescribeMetricRuleTemplateAttribute接口查询报警模板详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '报警模板名称。`Name`和`TemplateId`必须设置一个。'."\n"
."\n"
.'关于如何获取报警模板名称,请参见[DescribeMetricRuleTemplateList](~~114982~~)。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'ECS_Template1',
],
],
[
'name' => 'TemplateId',
'in' => 'query',
'schema' => [
'description' => '报警模板ID。`Name`和`TemplateId`必须设置一个。'."\n"
."\n"
.'关于如何获取报警模板ID,请参见[DescribeMetricRuleTemplateList](~~114982~~)。',
'type' => 'string',
'required' => false,
'example' => '70****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '返回结果。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '8F3A82AD-DA92-52B0-8EC6-C059D1C3839F',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resource' => [
'description' => '报警模板详情。',
'type' => 'object',
'properties' => [
'Description' => [
'description' => '报警模板描述信息。',
'type' => 'string',
'example' => 'ECS模板',
],
'Name' => [
'description' => '报警模板名称。',
'type' => 'string',
'example' => 'ECS_Template1',
],
'RestVersion' => [
'description' => '报警模板版本。',
'type' => 'string',
'example' => '1',
],
'TemplateId' => [
'description' => '报警模板ID。',
'type' => 'string',
'example' => '70****',
],
'AlertTemplates' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AlertTemplate' => [
'description' => '报警模板列表。',
'type' => 'array',
'items' => [
'description' => '报警模板。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'Selector' => [
'description' => '报警维度扩展选项。',
'type' => 'string',
'example' => '{"disk":"/"}',
],
'Webhook' => [
'description' => '触发报警回调的URL地址。',
'type' => 'string',
'example' => 'https://www.aliyun.com',
],
'Namespace' => [
'description' => '云服务的命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'Category' => [
'description' => '云服务名称缩写。',
'type' => 'string',
'example' => 'ecs',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'ECS_Rule',
],
'NoDataPolicy' => [
'description' => '无监控数据时报警的处理方式。取值:'."\n"
.'- KEEP_LAST_STATE(默认值):不做任何处理。'."\n"
.'- INSUFFICIENT_DATA:报警内容为无数据。'."\n"
.'- OK:正常。',
'type' => 'string',
'example' => 'KEEP_LAST_STATE',
],
'Escalations' => [
'description' => '阈值及报警级别。',
'type' => 'object',
'properties' => [
'Info' => [
'description' => 'Info级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Info级别的阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'Times' => [
'description' => 'Info级别的重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'Threshold' => [
'description' => 'Info级别的阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => 'Info级别的统计方法。'."\n"
."\n"
.'每个云服务的`Statistics`取值不同。更多信息,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'example' => 'Average',
],
],
],
'Warn' => [
'description' => 'Warn级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Warn级别阈值的比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'Times' => [
'description' => 'Warn级别的重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'Threshold' => [
'description' => 'Warn级别的阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => 'Warn级别的统计方法。'."\n"
."\n"
.'每个云服务的`Statistics`取值不同。更多信息,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'example' => 'Average',
],
],
],
'Critical' => [
'description' => 'Critical级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Critical级别的阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'Times' => [
'description' => 'Critical级别的重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
'Threshold' => [
'description' => 'Critical级别的阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => 'Critical级别的统计方法。'."\n"
."\n"
.'每个云服务的`Statistics`取值不同。更多信息,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'example' => 'Average',
],
],
],
],
],
'Labels' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Labels' => [
'description' => '报警模板标签。',
'type' => 'array',
'items' => [
'description' => '报警模板的标签。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '报警模板的标签键。',
'type' => 'string',
'example' => 'label1',
],
'Value' => [
'description' => '报警模板的标签值。',
'type' => 'string',
'example' => 'value1',
],
],
],
],
],
],
'SilenceTime' => [
'description' => '通道沉默时间。单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '3600',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"8F3A82AD-DA92-52B0-8EC6-C059D1C3839F\\",\\n \\"Success\\": true,\\n \\"Resource\\": {\\n \\"Description\\": \\"ECS模板\\",\\n \\"Name\\": \\"ECS_Template1\\",\\n \\"RestVersion\\": \\"1\\",\\n \\"TemplateId\\": \\"70****\\",\\n \\"AlertTemplates\\": {\\n \\"AlertTemplate\\": [\\n {\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"Selector\\": \\"{\\\\\\"disk\\\\\\":\\\\\\"/\\\\\\"}\\",\\n \\"Webhook\\": \\"https://www.aliyun.com\\",\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"Category\\": \\"ecs\\",\\n \\"RuleName\\": \\"ECS_Rule\\",\\n \\"NoDataPolicy\\": \\"KEEP_LAST_STATE\\",\\n \\"Escalations\\": {\\n \\"Info\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"Times\\": 3,\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\"\\n },\\n \\"Warn\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"Times\\": 3,\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\"\\n },\\n \\"Critical\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"Times\\": 5,\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\"\\n }\\n },\\n \\"Labels\\": {\\n \\"Labels\\": [\\n {\\n \\"Key\\": \\"label1\\",\\n \\"Value\\": \\"value1\\"\\n }\\n ]\\n },\\n \\"SilenceTime\\": 3600\\n }\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t8F3A82AD-DA92-52B0-8EC6-C059D1C3839F\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tcpu_total\\r\\n\\t\\t\\t\\tecs\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\tGreaterThanOrEqualToThreshold\\r\\n\\t\\t\\t\\t\\t\\t5\\r\\n\\t\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t\\t90\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\t\\tECS_Rule\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t1\\r\\n\\t\\t70****\\r\\n\\t\\tECS_Template1\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询报警模板详情',
'description' => '本文将提供一个示例,查询报警模板`70****`的详情。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMetricRuleTemplateList' => [
'summary' => '调用DescribeMetricRuleTemplateList接口查询报警模板列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '报警模板名称。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Template1',
],
],
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '报警模板名称关键字。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
[
'name' => 'TemplateId',
'in' => 'query',
'schema' => [
'description' => '报警模板ID。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '70****',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示模板的记录条数。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '10',
],
],
[
'name' => 'History',
'in' => 'query',
'schema' => [
'description' => '是否显示报警模板应用到应用分组的历史记录。取值:'."\n"
."\n"
.'- true:显示。'."\n"
."\n"
.'- false(默认值):不显示。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'Order',
'in' => 'query',
'schema' => [
'description' => '排序方式。取值:'."\n"
."\n"
.'- true(默认值):升序。 '."\n"
."\n"
.'- false:降序。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'OrderBy',
'in' => 'query',
'schema' => [
'description' => '排序依据。取值:'."\n"
."\n"
.'- gmtMotified:修改日期。 '."\n"
."\n"
.'- gmtCreate(默认值):创建日期。',
'type' => 'string',
'required' => false,
'example' => 'gmtCreate',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '659401C0-6214-5C02-972A-CFA929D717B7',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int64',
'example' => '2',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Templates' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Template' => [
'description' => '报警模板列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Description' => [
'description' => '报警模板描述信息。',
'type' => 'string',
'example' => 'ECS的CPU使用率',
],
'GmtCreate' => [
'description' => '创建报警模板的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1646018798000',
],
'Name' => [
'description' => '报警模板名称。',
'type' => 'string',
'example' => 'ECS_Template1',
],
'RestVersion' => [
'description' => '报警模板版本。'."\n"
."\n"
.'默认值:0。',
'type' => 'integer',
'format' => 'int64',
'example' => '0',
],
'GmtModified' => [
'description' => '修改报警模板的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1646054798000',
],
'TemplateId' => [
'description' => '报警模板ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '70****',
],
'ApplyHistories' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ApplyHistory' => [
'description' => '报警模板应用到应用分组的历史记录。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '3607****',
],
'GroupName' => [
'description' => '应用分组名称。',
'type' => 'string',
'example' => 'ECS_Group',
],
'ApplyTime' => [
'description' => '报警模板应用到应用分组的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1646055898000',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"659401C0-6214-5C02-972A-CFA929D717B7\\",\\n \\"Total\\": 2,\\n \\"Success\\": true,\\n \\"Templates\\": {\\n \\"Template\\": [\\n {\\n \\"Description\\": \\"ECS的CPU使用率\\",\\n \\"GmtCreate\\": 1646018798000,\\n \\"Name\\": \\"ECS_Template1\\",\\n \\"RestVersion\\": 0,\\n \\"GmtModified\\": 1646054798000,\\n \\"TemplateId\\": 0,\\n \\"ApplyHistories\\": {\\n \\"ApplyHistory\\": [\\n {\\n \\"GroupId\\": 0,\\n \\"GroupName\\": \\"ECS_Group\\",\\n \\"ApplyTime\\": 1646055898000\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t659401C0-6214-5C02-972A-CFA929D717B7\\r\\n\\t2\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t1606291110000\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t1646018798000\\r\\n\\t\\t\\t0\\r\\n\\t\\t\\t70****\\r\\n\\t\\t\\tECS_Template1\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t1607420429000\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t1646017352000\\r\\n\\t\\t\\t1\\r\\n\\t\\t\\t71****\\r\\n\\t\\t\\tECS_Template2\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询报警模板列表',
'description' => '本文将提供一个示例,查询报警模板列表。返回结果显示,报警模板列表中共有2个报警模板,分别是`ECS_Template1`和`ECS_Template2`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。'."\n"
."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'ApplyMetricRuleTemplate' => [
'summary' => '调用ApplyMetricRuleTemplate接口将报警模板应用到应用分组并生成报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默周期。单位:秒。默认值:86400。'."\n"
."\n"
.'> 当监控数据持续超过报警规则阈值时,每个沉默周期内只发送一次报警通知。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '86400',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => true,
'example' => '123456',
],
],
[
'name' => 'TemplateIds',
'in' => 'query',
'schema' => [
'description' => '报警模板ID。'."\n"
."\n"
.'关于如何获取报警模板ID,请参见[DescribeMetricRuleTemplateList](~~114982~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '700****',
],
],
[
'name' => 'EnableStartTime',
'in' => 'query',
'schema' => [
'description' => '报警生效的开始时间。取值范围:00~23,表示00:00到23:00。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '00',
],
],
[
'name' => 'EnableEndTime',
'in' => 'query',
'schema' => [
'description' => '报警生效的结束时间。取值范围:00~23,表示00:59到23:59。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '23',
],
],
[
'name' => 'NotifyLevel',
'in' => 'query',
'schema' => [
'description' => '报警通知方式。取值:'."\n"
."\n"
.'- 2:电话+短信+邮箱+旺旺+钉钉机器人。'."\n"
."\n"
.'- 3:短信+邮箱+旺旺+钉钉机器人。'."\n"
."\n"
.'- 4:旺旺+钉钉机器人。'."\n"
."\n\n"
.'4:旺旺+钉钉机器人。'."\n"
."\n"
.'4:旺旺+钉钉机器人。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '4',
],
],
[
'name' => 'ApplyMode',
'in' => 'query',
'schema' => [
'description' => '模板应用方式。取值:'."\n"
."\n"
.'- GROUP_INSTANCE_FIRST:应用分组实例优先。应用报警模板时,以应用分组实例优先,如果应用分组中不存在该实例,则忽略模板中的规则。'."\n"
."\n"
.'- ALARM_TEMPLATE_FIRST:报警模板实例优先。应用报警模板时,不管应用分组中是否存在该实例,都创建报警规则。',
'type' => 'string',
'required' => false,
'example' => 'GROUP_INSTANCE_FIRST',
],
],
[
'name' => 'Webhook',
'in' => 'query',
'schema' => [
'description' => '报警发生时会回调指定的URL地址并发送POST请求。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com',
],
],
[
'name' => 'AppendMode',
'in' => 'query',
'schema' => [
'description' => '模板应用策略。取值:'."\n"
."\n"
.'- all:删除已选择分组上所有通过报警模板创建的规则,然后按模板创建新的报警规则(默认值)。'."\n"
."\n"
.'- append:删除已选择分组上通过该报警模板创建的规则,然后按当前模板创建新的报警规则。',
'type' => 'string',
'required' => false,
'example' => 'all',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3F897F3C-020A-4993-95B4-63ABB84F83E6',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resource' => [
'description' => '报警规则影响的资源。',
'type' => 'object',
'properties' => [
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '123456',
],
'AlertResults' => [
'description' => '生成报警规则的详细结果。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'alert rule is creating, please wait a few minutes.',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'test123',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'applyTemplate8ab74c6b-9f27-47ab-8841-de01dc08****',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"3F897F3C-020A-4993-95B4-63ABB84F83E6\\",\\n \\"Success\\": true,\\n \\"Resource\\": {\\n \\"GroupId\\": 123456,\\n \\"AlertResults\\": [\\n {\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"alert rule is creating, please wait a few minutes.\\",\\n \\"Success\\": true,\\n \\"RuleName\\": \\"test123\\",\\n \\"RuleId\\": \\"applyTemplate8ab74c6b-9f27-47ab-8841-de01dc08****\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t37D4037E-827E-4E66-87DF-F56A22F2884D\\r\\n\\t\\r\\n\\t\\t123456\\r\\n\\t\\t\\r\\n\\t\\t\\talert rule is creating, please wait a few minutes.\\r\\n\\t\\t\\tapplyTemplate8ab74c6b-9f27-47ab-8841-de01dc08****\\r\\n\\t\\t\\t202\\r\\n\\t\\t\\ttest123\\r\\n\\t\\t\\ttrue\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '应用报警模板至应用分组',
'description' => '本文将提供一个示例,将报警模板`700****`应用到应用分组`123456`,生成报警规则的ID为`applyTemplate8ab74c6b-9f27-47ab-8841-de01dc08****`,名称为`test123`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMetricRuleList' => [
'summary' => '查询报警规则列表中的所有规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。'."\n"
."\n"
.'关于如何获取监控项名称,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。'."\n"
."\n"
.'补充说明:针对组合指标,只能够根据第一个指标项进行检索。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
],
[
'name' => 'EnableState',
'in' => 'query',
'schema' => [
'description' => '报警规则的启用状态。取值:'."\n"
.'- true:启用。'."\n"
.'- false:禁用。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的命名空间。'."\n"
."\n"
.'关于如何获取云产品的命名空间,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'Page',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'AlertState',
'in' => 'query',
'schema' => [
'description' => '报警规则状态。取值:'."\n"
.'- OK:正常。'."\n"
.'- ALARM:报警。'."\n"
.'- INSUFFICIENT_DATA:无数据。',
'type' => 'string',
'required' => false,
'example' => 'OK',
],
],
[
'name' => 'Dimensions',
'in' => 'query',
'schema' => [
'description' => '指定资源的监控维度。'."\n"
."\n"
.'格式:`key:value`键值对形式的集合,例如:`{"userId":"120886317861****"}`和`{"instanceId":"i-2ze2d6j5uhg20x47****"}`。',
'type' => 'string',
'required' => false,
'example' => '{"instanceId":"i-2ze2d6j5uhg20x47****"}',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。'."\n"
."\n"
.'该参数支持模糊查询。',
'type' => 'string',
'required' => false,
'example' => 'Rule_01',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => false,
'example' => '7301****',
],
],
[
'name' => 'RuleIds',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。多个报警规则ID之间用半角逗号(,)分隔,一次最多可查询20条。',
'type' => 'string',
'required' => false,
'example' => 'applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '386C6712-335F-5054-930A-CC92B851ECBA',
],
'Total' => [
'description' => '总记录数。',
'type' => 'string',
'example' => '1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Alarms' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Alarm' => [
'description' => '报警规则列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SilenceTime' => [
'description' => '通道沉默周期。单位:秒。默认值:86400,最小值:3600。'."\n"
."\n"
.'监控数据持续超过报警规则阈值时,每个沉默周期内只发送一次报警通知。',
'type' => 'integer',
'format' => 'int32',
'example' => '86400',
],
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'Webhook' => [
'description' => '报警发生回调时的 URL 地址。云监控会将报警信息通过 POST 请求推送到该地址,目前仅支持 HTTP 协议。',
'type' => 'string',
'example' => 'https://www.aliyun.com',
],
'ContactGroups' => [
'description' => '报警联系组。',
'type' => 'string',
'example' => 'ECS_Alarm',
],
'SourceType' => [
'description' => '报警规则类型。取值:METRIC,表示时序指标报警规则。',
'type' => 'string',
'example' => 'METRIC',
],
'Namespace' => [
'description' => '云服务的命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'MailSubject' => [
'description' => '报警邮件主题。',
'type' => 'string',
'example' => '"${serviceType}-${metricName}-${levelDescription}通知(${dimensions})"',
],
'NoEffectiveInterval' => [
'description' => '报警规则的失效时间范围。',
'type' => 'string',
'example' => '00:00-05:30',
],
'EffectiveInterval' => [
'description' => '报警规则的生效时间范围。',
'type' => 'string',
'example' => '05:31-23:59',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'Rule_01',
],
'AlertState' => [
'description' => '报警规则状态。取值:'."\n"
."\n"
.'- OK:正常。'."\n"
."\n"
.'- ALARM:报警。'."\n"
."\n"
.'- INSUFFICIENT_DATA:无数据。',
'type' => 'string',
'example' => 'OK',
],
'Period' => [
'description' => '统计周期。',
'type' => 'string',
'example' => '60',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****',
],
'GroupName' => [
'description' => '应用分组名称。'."\n"
.'> 如果报警规则关联到应用分组,此处显示该参数。',
'type' => 'string',
'example' => 'ECS_Group',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '7301****',
],
'Dimensions' => [
'description' => '报警规则维度。',
'type' => 'string',
'example' => '[{"instanceId":"i-2ze2d6j5uhg20x47****"}]',
],
'EnableState' => [
'description' => '启用状态。取值:'."\n"
."\n"
.'- true:启用。'."\n"
."\n"
.'- false:禁用。',
'type' => 'boolean',
'example' => 'true',
],
'Resources' => [
'description' => '报警规则关联的资源。',
'type' => 'string',
'example' => '[{\\"instanceId\\":\\"i-2ze2d6j5uhg20x47****\\"}]',
],
'Escalations' => [
'description' => '报警分级别触发条件。',
'type' => 'object',
'properties' => [
'Info' => [
'description' => 'Info 级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Info级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'PreCondition' => [
'description' => 'Info 级别报警的前置条件。当参数 ComparisonOperator 设置为同比或环比时,与该参数共同起作用。'."\n"
."\n"
.'例如:该参数设置为$Average>80,ComparisonOperator 设置为 GreaterThanYesterday,Threshold 设置为 10,表示当平均值大于 80 且环比昨天上涨 10%时,触发报警。'."\n"
."\n"
.'>$Average>0 中的$Average 为一个占位符,格式为$监控结果字段值,云监控会将其替换为对应的统计值或原始的监控值。',
'type' => 'string',
'example' => '$Average>80',
],
'Times' => [
'description' => 'Info级别报警连续出现次数。报警连续出现这个次数,且超过阈值才会触发报警。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'Threshold' => [
'description' => 'Info级别报警阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => 'Info级别报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
],
],
'Warn' => [
'description' => 'Warn级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Warn级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'PreCondition' => [
'description' => 'Warn级别报警的前置条件。当参数ComparisonOperator设置为同比或环比时,与该参数共同起作用。'."\n"
."\n"
.'例如:该参数设置为$Average>80,ComparisonOperator设置为GreaterThanYesterday,Threshold设置为10,表示当平均值大于80且环比昨天上涨10%时,触发报警。'."\n"
.'> $Average>0 中的$Average 为一个占位符,格式为$监控结果字段值,云监控会将其替换为对应的统计值或原始的监控值。',
'type' => 'string',
'example' => '$Average>80',
],
'Times' => [
'description' => 'Warn级别报警连续出现次数。报警连续出现这个次数,且超过阈值才会触发报警。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'Threshold' => [
'description' => 'Warn级别报警阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => 'Warn级别报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
],
],
'Critical' => [
'description' => 'Critical级别报警触发条件。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => 'Critical级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'PreCondition' => [
'description' => 'Critical 级别报警的前置条件。当参数 ComparisonOperator 设置为同比或环比时,与该参数共同起作用。'."\n"
."\n"
.'例如:该参数设置为$Average>80,ComparisonOperator 设置为 GreaterThanYesterday,Threshold 设置为 10,表示当平均值大于 80 且环比昨天上涨 10%时,触发报警。'."\n"
.'>$Average>0中的$Average为一个占位符,格式为`$监控结果字段值`,云监控会将其替换为对应的统计值或原始的监控值。',
'type' => 'string',
'example' => '$Average>80',
],
'Times' => [
'description' => 'Critical级别报警连续出现次数。报警连续出现这个次数,且超过阈值才会触发报警。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'Threshold' => [
'description' => 'Critical级别报警阈值。',
'type' => 'string',
'example' => '90',
],
'Statistics' => [
'description' => 'Critical级别报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
],
],
],
],
'NoDataPolicy' => [
'description' => '无监控数据时报警的处理方式。取值:'."\n"
.'- KEEP_LAST_STATE(默认值):不做任何处理。'."\n"
.'- INSUFFICIENT_DATA:报警内容为无数据。'."\n"
.'- OK:正常。',
'type' => 'string',
'example' => 'KEEP_LAST_STATE',
],
'CompositeExpression' => [
'description' => '多指标的报警条件。'."\n"
.'> 单指标和多指标互斥,不能同时设置。',
'type' => 'object',
'properties' => [
'Level' => [
'description' => '报警级别。取值:'."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'example' => 'CRITICAL',
],
'ExpressionList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ExpressionList' => [
'description' => '标准创建的报警条件列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '云产品的监控项名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'Period' => [
'description' => '监控项的聚合周期。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '60',
],
'Statistics' => [
'description' => '监控项的统计方法。取值:'."\n"
.'- $Maximum:最大值。'."\n"
.'- $Minimum:最小值。'."\n"
.'- $Average:平均值。'."\n"
.'- $Availability:可用率(通常用于站点监控)。'."\n"
."\n"
.'> `$`为监控项的统一前缀符号。支持的云产品,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'example' => '$Maximum',
],
'ComparisonOperator' => [
'description' => '阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '90',
],
],
],
],
],
],
'ExpressionListJoin' => [
'description' => '多指标报警条件之间的关系。取值: '."\n"
."\n"
.'- `&&`:当所有指标都符合报警条件时,才触发报警。当ExpressionList下各表达式均为`true`时,才触发报警。'."\n"
."\n"
.'- `||`:其中一个指标符合报警条件,即触发报警。',
'type' => 'string',
'example' => '||',
],
'ExpressionRaw' => [
'description' => '表达式创建的报警条件。包括但不限于以下情况:'."\n"
."\n"
.'- 为部分资源设置报警黑名单,例如:`$instanceId != \'i-io8kfvcpp7x5****\' ``&&`` $Average > 50`,表示当报警规则中的实例`i-io8kfvcpp7x5****`的`Average`大于50时,也不会产生报警。'."\n"
.'- 对规则中的指定实例设置特殊报警阈值,例如:`$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)`,表示当报警规则中的实例`i-io8kfvcpp7x5****`的`Average`大于80时,才报警,其他实例的`Average`大于50,即可报警。'."\n"
.'- 对规则中超过阈值的实例数量进行限制,例如:`count($Average > 20) > 3`,表示当报警规则中的`Average`大于20的实例数大于3个时,才进行报警。'."\n",
'type' => 'string',
'example' => '$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)',
],
'Times' => [
'description' => '发出报警通知需要达到报警条件的次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
],
],
'Labels' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Labels' => [
'description' => '报警规则标签。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '报警规则的标签键。',
'type' => 'string',
'example' => 'cmsRuleKey',
],
'Value' => [
'description' => '报警规则的标签值。',
'type' => 'string',
'example' => 'cmsRuleValue',
],
],
],
],
],
],
'Prometheus' => [
'description' => 'Prometheus报警。'."\n"
."\n"
.'> 仅当您为企业云监控创建Prometheus报警规则,需要设置该参数。',
'type' => 'object',
'properties' => [
'PromQL' => [
'description' => 'PromQL查询语句。'."\n"
."\n"
.'> 通过PromQL查询语句获取的数据即为报警数据,请您在该语句中携带报警阈值。',
'type' => 'string',
'example' => 'CpuUsage{instanceId="xxxx"}[1m]>90',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'example' => 'CRITICAL',
],
'Times' => [
'description' => '发出报警通知需要达到报警条件的次数。',
'type' => 'integer',
'format' => 'int64',
'example' => '3',
],
'Annotations' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Annotations' => [
'description' => 'Prometheus报警时,将注释的键和值进行渲染,易于您对监控项或报警规则的理解。'."\n"
.'> 该功能等同于Prometheus的Annotation。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '注释的键。',
'type' => 'string',
'example' => 'summary',
],
'Value' => [
'description' => '注释的值。',
'type' => 'string',
'example' => '{{ $labels.instance }} CPU usage above 10% {current value: {{ humanizePercentage $value }} }',
],
],
],
],
],
],
],
],
'ProductCategory' => [
'description' => '云产品类型。',
'type' => 'string',
'example' => 'slb',
],
'GmtCreate' => [
'description' => '规则创建时间,Unix时间戳。',
'type' => 'integer',
'format' => 'int64',
'example' => '1760432061000',
],
'GmtUpdate' => [
'description' => '规则更新时间,Unix时间戳。',
'type' => 'string',
'example' => '1760432061000',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'Invalid parameter.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'The Request is not authorization.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"386C6712-335F-5054-930A-CC92B851ECBA\\",\\n \\"Total\\": \\"1\\",\\n \\"Success\\": true,\\n \\"Alarms\\": {\\n \\"Alarm\\": [\\n {\\n \\"SilenceTime\\": 86400,\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"Webhook\\": \\"https://www.aliyun.com\\",\\n \\"ContactGroups\\": \\"ECS_Alarm\\",\\n \\"SourceType\\": \\"METRIC\\",\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"MailSubject\\": \\"\\\\\\"${serviceType}-${metricName}-${levelDescription}通知(${dimensions})\\\\\\"\\",\\n \\"NoEffectiveInterval\\": \\"00:00-05:30\\",\\n \\"EffectiveInterval\\": \\"05:31-23:59\\",\\n \\"RuleName\\": \\"Rule_01\\",\\n \\"AlertState\\": \\"OK\\",\\n \\"Period\\": \\"60\\",\\n \\"RuleId\\": \\"applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****\\",\\n \\"GroupName\\": \\"ECS_Group\\",\\n \\"GroupId\\": \\"7301****\\",\\n \\"Dimensions\\": \\"[{\\\\\\"instanceId\\\\\\":\\\\\\"i-2ze2d6j5uhg20x47****\\\\\\"}]\\",\\n \\"EnableState\\": true,\\n \\"Resources\\": \\"[{\\\\\\\\\\\\\\"instanceId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"i-2ze2d6j5uhg20x47****\\\\\\\\\\\\\\"}]\\",\\n \\"Escalations\\": {\\n \\"Info\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"PreCondition\\": \\"$Average>80\\",\\n \\"Times\\": 3,\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\"\\n },\\n \\"Warn\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"PreCondition\\": \\"$Average>80\\",\\n \\"Times\\": 3,\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\"\\n },\\n \\"Critical\\": {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"PreCondition\\": \\"$Average>80\\",\\n \\"Times\\": 3,\\n \\"Threshold\\": \\"90\\",\\n \\"Statistics\\": \\"Average\\"\\n }\\n },\\n \\"NoDataPolicy\\": \\"KEEP_LAST_STATE\\",\\n \\"CompositeExpression\\": {\\n \\"Level\\": \\"CRITICAL\\",\\n \\"ExpressionList\\": {\\n \\"ExpressionList\\": [\\n {\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"Period\\": 60,\\n \\"Statistics\\": \\"$Maximum\\",\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"Threshold\\": \\"90\\"\\n }\\n ]\\n },\\n \\"ExpressionListJoin\\": \\"||\\",\\n \\"ExpressionRaw\\": \\"$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)\\",\\n \\"Times\\": 3\\n },\\n \\"Labels\\": {\\n \\"Labels\\": [\\n {\\n \\"Key\\": \\"cmsRuleKey\\",\\n \\"Value\\": \\"cmsRuleValue\\"\\n }\\n ]\\n },\\n \\"Prometheus\\": {\\n \\"PromQL\\": \\"CpuUsage{instanceId=\\\\\\"xxxx\\\\\\"}[1m]>90\\",\\n \\"Level\\": \\"CRITICAL\\",\\n \\"Times\\": 3,\\n \\"Annotations\\": {\\n \\"Annotations\\": [\\n {\\n \\"Key\\": \\"summary\\",\\n \\"Value\\": \\"{{ $labels.instance }} CPU usage above 10% {current value: {{ humanizePercentage $value }} }\\"\\n }\\n ]\\n }\\n },\\n \\"ProductCategory\\": \\"slb\\",\\n \\"GmtCreate\\": 1760432061000,\\n \\"GmtUpdate\\": \\"1760432061000\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t386C6712-335F-5054-930A-CC92B851ECBA\\r\\n\\t1\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tECS_Group\\r\\n\\t\\t\\t86400\\r\\n\\t\\t\\tECS_Alarm\\r\\n\\t\\t\\t00:00-05:30\\r\\n\\t\\t\\tgroup\\r\\n\\t\\t\\t${serviceType}-${metricName}-${levelDescription}通知(${dimensions})\\r\\n\\t\\t\\tMETRIC\\r\\n\\t\\t\\tapplyTemplate344cfd42-0f32-4fd6-805a-88d7908a****\\r\\n\\t\\t\\t60\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\ti-2ze2d6j5uhg20x47****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t05:31-23:59\\r\\n\\t\\t\\tacs_ecs_dashboard\\r\\n\\t\\t\\tOK\\r\\n\\t\\t\\t7301****\\r\\n\\t\\t\\tcpu_total\\r\\n\\t\\t\\ttrue\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tGreaterThanOrEqualToThreshold\\r\\n\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t90\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tGreaterThanOrEqualToThreshold\\r\\n\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t90\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tGreaterThanOrEqualToThreshold\\r\\n\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\tAverage\\r\\n\\t\\t\\t\\t\\t90\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\thttps://www.aliyun.com\\r\\n\\t\\t\\t[{\\\\\\"instanceId\\\\\\":\\\\\\"i-2ze2d6j5uhg20x47****\\\\\\"}]\\r\\n\\t\\t\\tRule_01\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询报警规则列表中的所有规则',
'description' => '本文将提供一个示例,查询当前阿里云账号下的报警规则列表中的所有报警规则。返回结果显示,报警规则列表中只有一条报警规则,该报警规则的名称为`Rule_01`、ID为`applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'CreateGroupMetricRules' => [
'summary' => '调用CreateGroupMetricRules接口批量为指定应用分组创建报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。'."\n"
."\n",
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => true,
'example' => '3607****',
],
],
[
'name' => 'GroupMetricRules',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '应用分组的监控项规则列表。',
'type' => 'array',
'items' => [
'description' => '应用分组的监控项规则。',
'type' => 'object',
'properties' => [
'Escalations.Info.Threshold' => [
'description' => '普通级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '10',
],
'MetricName' => [
'description' => '监控项名称。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取监控项名称,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'cpu_total',
],
'Escalations.Warn.Threshold' => [
'description' => '警告级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '20',
],
'EffectiveInterval' => [
'description' => '报警规则的生效时间范围。N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => '05:31-23:59',
],
'NoEffectiveInterval' => [
'description' => '报警规则的失效时间范围。N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => '00:00-05:30',
],
'RuleId' => [
'description' => '报警规则ID。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => '456789',
],
'Escalations.Critical.Times' => [
'description' => '发送紧急报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Dimensions' => [
'description' => '指定资源的监控维度。'."\n"
."\n"
.'格式:`key:value`键值对形式的集合,例如:`{"userId":"120886317861****"}`和`{"instanceId":"i-2ze2d6j5uhg20x47****"}`。',
'type' => 'string',
'required' => false,
'example' => '[{"instanceId":"i-m5e1qg6uo38rztr4****"}]',
],
'Escalations.Critical.Threshold' => [
'description' => '触发紧急级别报警通知的阈值。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '90',
],
'Escalations.Critical.Statistics' => [
'description' => '紧急级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Warn.ComparisonOperator' => [
'description' => '警告级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Info.Times' => [
'description' => '发送普通报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
'SilenceTime' => [
'description' => '报警通知的沉默周期。N的取值范围:1~200。'."\n"
."\n"
.'单位:秒。默认值:86400。最小值:3600。'."\n"
."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '86400',
],
'Webhook' => [
'description' => '报警发生回调时的URL地址。N的取值范围:1~200。'."\n"
."\n"
.'填写公网可访问的URL地址,云监控会将报警信息通过POST请求推送到该地址,目前仅支持HTTP协议。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com',
],
'Namespace' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取云产品的数据命名空间,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
'EmailSubject' => [
'description' => '报警邮件主题。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => 'ECS实例',
],
'Period' => [
'description' => '监控数据的上报周期。'."\n"
."\n"
.'N的取值范围:1~200。 '."\n"
."\n"
.'`Period`的取值为60或60的整数倍。单位:秒。默认值:300。'."\n"
."\n\n"
."\n\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '60',
],
'RuleName' => [
'description' => '报警规则名称。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'string',
'required' => true,
'example' => 'ECS_Rule1',
],
'Escalations.Info.Statistics' => [
'description' => '普通级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Warn.Times' => [
'description' => '发送警告报警通知需要监控指标达到报警阈值的次数。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Escalations.Info.ComparisonOperator' => [
'description' => '普通级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Interval' => [
'description' => '报警规则的探测周期。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'单位:秒。秒默认为监控项的最小频率。'."\n"
."\n"
.'> 建议报警规则的探测周期和数据上报周期保持一致。如果报警规则的探测周期小于数据上报周期,会因为数据不足而不能触发报警。',
'type' => 'string',
'required' => false,
'example' => '60',
],
'Category' => [
'description' => '云产品名称缩写。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取云产品名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => true,
'example' => 'ECS',
],
'Escalations.Critical.ComparisonOperator' => [
'description' => '紧急级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。 '."\n"
.'- GreaterThanThreshold:大于。 '."\n"
.'- LessThanOrEqualToThreshold:小于等于。 '."\n"
.'- LessThanThreshold:小于。 '."\n"
.'- NotEqualToThreshold:不等于。 '."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。 '."\n"
.'- LessThanYesterday:同比昨天时间下降。 '."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。 '."\n"
.'- LessThanLastWeek:同比上周同一时间下降。 '."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。 '."\n"
.'- LessThanLastPeriod:环比上周期下降。 '."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Warn.Statistics' => [
'description' => '警告级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'NoDataPolicy' => [
'description' => '无监控数据时报警的处理方式。取值:'."\n"
.'- KEEP_LAST_STATE(默认值):不做任何处理。'."\n"
.'- INSUFFICIENT_DATA:报警内容为无数据。'."\n"
.'- OK:正常。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => 'KEEP_LAST_STATE',
],
'ContactGroups' => [
'description' => '报警联系人组。'."\n"
."\n"
.'N的取值范围:1~200。'."\n"
."\n"
.'关于如何获取报警联系人组,请参见[DescribeContactGroupList](~~114922~~)。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'ECS_Group',
],
'Labels' => [
'description' => '报警规则的标签键。',
'type' => 'array',
'items' => [
'description' => '报警规则的标签键。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '报警规则的标签键。报警通知中会包含标签。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => 'key1',
],
'Value' => [
'description' => '报警规则的标签值。报警通知中会包含标签。'."\n"
."\n"
.'N的取值范围:1~200。',
'type' => 'string',
'required' => false,
'example' => 'value1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
'minItems' => 0,
],
'Options' => [
'description' => '高级设置。'."\n"
."\n"
.'格式:{"key1":"value1","key2":"value2"},例如:{"NotSendOK":true},表示是否发送报警恢复通知,key为NotSendOK,value为true(不发送)或false(默认发送)。',
'type' => 'string',
'required' => false,
'example' => '{'."\n"
.' "NotSendOK": true'."\n"
.'}',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 200,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '报错信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'AlertResult' => [
'description' => '报警规则列表。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '新创建报警规则的状态码。'."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '新创建报警规则的错误信息。',
'type' => 'string',
'example' => 'Metric not found.',
],
'Success' => [
'description' => '新创建报警规则是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'RuleName' => [
'description' => '新创建报警规则的名称。',
'type' => 'string',
'example' => 'ECS_Rule1',
],
'RuleId' => [
'description' => '新创建报警规则的ID。',
'type' => 'string',
'example' => '456789',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => '500',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D\\",\\n \\"Success\\": true,\\n \\"Resources\\": {\\n \\"AlertResult\\": [\\n {\\n \\"Code\\": 200,\\n \\"Message\\": \\"Metric not found.\\",\\n \\"Success\\": true,\\n \\"RuleName\\": \\"ECS_Rule1\\",\\n \\"RuleId\\": \\"456789\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tCED22B00-CFD8-5BDF-A645-CAF7B81FAE45\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t456789\\r\\n\\t\\t\\t200\\r\\n\\t\\t\\ttrue\\r\\n\\t\\t\\tECS_Rule1\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '批量为指定应用分组创建报警规则',
'description' => '本文将提供一个示例,为应用分组`123456`中的云服务器ECS的监控项`cpu_total`创建一条报警规则,其中报警规则ID为`456789`,报警规则名称为`ECS_Rule1`,报警级别为`Critical`,报警统计方法为`Average`,报警阈值比较符为`GreaterThanOrEqualToThreshold`,报警阈值为`90`,报警重试次数为`3`。返回结果显示,报警规则`ECS_Rule1`创建成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateMetricRuleResources' => [
'summary' => '调用CreateMetricRuleResources接口创建一个报警规则关联的资源。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则 ID。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'i-2ze3w55tr2rcpejpcfap_59c96b85-0339-4f35-ba66-ae4e34d3****',
],
],
[
'name' => 'Overwrite',
'in' => 'query',
'schema' => [
'description' => '是否覆盖。取值:'."\n"
."\n"
.'- true:覆盖。表示本次提交的资源将覆盖之前的关联资源,即全量修改。'."\n"
."\n"
.'- false:不覆盖。表示本次提交的资源将不覆盖之前的关联资源(关联的结果资源为历史的关联资源加本次提交的资源),即增量修改。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => 'false',
],
],
[
'name' => 'Resources',
'in' => 'query',
'schema' => [
'description' => '关联的资源。格式为一个 JSON 数组。'."\n"
.'> 每次最多添加 100 个资源实例,一个报警规则最多关联 3000 个实例。'."\n"
.'>',
'type' => 'string',
'required' => true,
'example' => '[{"instanceId":"i-a2d5q7pm3f9yr29e****"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'> 200 表示成功。'."\n"
.'>',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求 ID。',
'type' => 'string',
'example' => '0671A721-0D7A-4F11-BB77-2416325D65AB',
],
'Success' => [
'description' => '操作是否成功。true 表示成功,false 表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"0671A721-0D7A-4F11-BB77-2416325D65AB\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '创建一个报警规则关联的资源',
],
'DeleteMetricRuleTargets' => [
'summary' => '调用DeleteMetricRuleTargets接口删除一个报警规则的推送渠道。',
'methods' => [
'post',
'get',
'delete',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ruleId-xxxxxx',
],
],
[
'name' => 'TargetIds',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '目标ID。',
'type' => 'array',
'items' => [
'description' => '目标ID。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => '1',
],
'required' => true,
'example' => '12345',
'maxItems' => 5,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。'."\n",
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '786E92D2-AC66-4250-B76F-F1E2FCDDBA1C',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'FailIds' => [
'description' => '删除失败的目标ID列表。',
'type' => 'object',
'properties' => [
'TargetIds' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'TargetId' => [
'description' => '删除失败的目标ID。',
'type' => 'array',
'items' => [
'description' => '删除失败的目标ID。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed because of an unknown error, exception or failure.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"786E92D2-AC66-4250-B76F-F1E2FCDDBA1C\\",\\n \\"Success\\": true,\\n \\"FailIds\\": {\\n \\"TargetIds\\": {\\n \\"TargetId\\": [\\n \\"1\\"\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t786E92D2-AC66-4250-B76F-F1E2FCDDBA1C\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n\\t\\t\\r\\n\\t\\t\\t1\\r\\n\\t\\t\\r\\n","errorExample":""}]',
'title' => '删除报警规则的推送渠道',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteMetricRules' => [
'summary' => '调用DeleteMetricRules接口删除一个或多个报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '要删除的报警规则ID的列表。',
'type' => 'array',
'items' => [
'description' => '要删除的报警规则ID。',
'type' => 'string',
'required' => false,
'example' => 'c3b2804a297444d0aa7bfd4fb0e4a01b',
],
'required' => true,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。说明 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '09B3A484-1A2B-5743-BB6B-D796416F2677',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternetServerError',
'errorMessage' => 'InternetServerError',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"09B3A484-1A2B-5743-BB6B-D796416F2677\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '删除一个或多个报警规则',
],
'DeleteMetricRuleResources' => [
'summary' => '调用DeleteMetricRuleResources接口删除报警规则关联的资源。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'rr-bp18017n6iolv****',
],
],
[
'name' => 'Resources',
'in' => 'query',
'schema' => [
'description' => '报警规则关联的资源。',
'type' => 'string',
'required' => true,
'example' => '[{"instanceId":"i-uf6hm9lnlzsarrc7****"}]',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The alert does not exist.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'D8A35882-90C6-4F03-BBEB-153C180398EA',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The alert does not exist.\\",\\n \\"RequestId\\": \\"D8A35882-90C6-4F03-BBEB-153C180398EA\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t0671A721-0D7A-4F11-BB77-2416325D65AB\\n\\t\\ttrue\\n\\t\\t200\\n","errorExample":""}]',
'title' => '删除报警规则关联的资源',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'EnableMetricRules' => [
'summary' => '调用EnableMetricRules接口启用一个或多个报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'N的取值范围:1~100。'."\n"
."\n"
.'关于如何获取报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。'."\n",
'type' => 'array',
'items' => [
'description' => '报警规则ID。'."\n"
."\n"
.'N的取值范围:1~100。'."\n"
."\n"
.'关于如何获取报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => false,
'example' => 'GroupProcess_67800278_2FE7D515-4BBD-447B-BC1A-3F17ED49****',
],
'required' => true,
'example' => 'ab05733c97b7ce239fb1b53393dc1697c123****',
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'FF38D33A-67C1-40EB-AB65-FAEE51EDB644',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
402 => [
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"FF38D33A-67C1-40EB-AB65-FAEE51EDB644\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n success\\n FF38D33A-67C1-40EB-AB65-FAEE51EDB644\\n true\\n","errorExample":""}]',
'title' => '启用一个或多个报警规则',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DisableMetricRules' => [
'summary' => '调用DisableMetricRules接口禁用报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警规则ID。',
'type' => 'array',
'items' => [
'description' => '报警规则ID。',
'type' => 'string',
'required' => false,
'example' => 'uuid_a141b055483428c22bab05443287196afa42cb6146',
],
'required' => true,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'FF38D33A-67C1-40EB-AB65-FAEE51EDB644',
],
'Success' => [
'description' => '操作是否成功。取值:-true:成功。-false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"FF38D33A-67C1-40EB-AB65-FAEE51EDB644\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '禁用报警规则',
],
'DescribeMetricRuleTargets' => [
'summary' => '调用DescribeMetricRuleTargets接口查询指定报警规则的推送渠道。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n\n"
.'关于如何获取报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ae06917_75a8c43178ab66****',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'User not authorized to operate on the specified resource.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '786E92D2-AC66-4250-B76F-F1E2FCDDBA1C',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Targets' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Target' => [
'description' => '报警触发目标。',
'type' => 'array',
'items' => [
'description' => '报警触发目标。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。',
'type' => 'string',
'example' => '1',
],
'Arn' => [
'description' => '资源ARN。格式为`acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message`。目前支持轻量消息队列(原 MNS),弹性伸缩ESS,日志服务SLS,函数计算FC。例如:`acs:mns:cn-hangzhou:120886317861****:/queues/test123/message`。轻量消息队列(原 MNS)的ARN参数说明如下:'."\n"
."\n"
.'- {云产品缩写}:mns'."\n"
."\n"
.'- {userId}:阿里云账号ID。'."\n"
."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
."\n"
.'- {资源类型}`:接收报警的资源类型。取值:'."\n"
."\n"
.' - **queues**:队列。'."\n"
.' - **topics**:主题。'."\n"
."\n"
.'- {资源名称}:资源名称。'."\n"
."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。'."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。',
'type' => 'string',
'example' => 'acs:mns:cn-hangzhou:120886317861****:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'example' => 'INFO',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => '%s',
],
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"User not authorized to operate on the specified resource.\\",\\n \\"RequestId\\": \\"786E92D2-AC66-4250-B76F-F1E2FCDDBA1C\\",\\n \\"Success\\": true,\\n \\"Targets\\": {\\n \\"Target\\": [\\n {\\n \\"Id\\": \\"1\\",\\n \\"Arn\\": \\"acs:mns:cn-hangzhou:120886317861****:/queues/test/message\\",\\n \\"Level\\": \\"INFO\\",\\n \\"JsonParams\\": \\"{\\\\\\"customField1\\\\\\":\\\\\\"value1\\\\\\",\\\\\\"customField2\\\\\\":\\\\\\"$.name\\\\\\"}\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t786E92D2-AC66-4250-B76F-F1E2FCDDBA1C\\n\\t200\\n\\ttrue\\n\\t","errorExample":""}]',
'title' => '查询指定报警规则的推送渠道',
'description' => '## 使用说明'."\n"
.'本文将提供一个示例,查询报警规则`ae06917_75a8c43178ab66****`关联的目标资源。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeMetricRuleCount' => [
'summary' => '调用DescribeMetricRuleCount接口获取各种状态报警规则的数量。',
'methods' => [
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云服务的命名空间。详情请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。详情请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'FF38D33A-67C1-40EB-AB65-FAEE51EDB644',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'MetricRuleCount' => [
'description' => '各类状态报警规则的数量。',
'type' => 'object',
'properties' => [
'Ok' => [
'description' => '正常状态报警规则的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '40',
],
'Nodata' => [
'description' => '无数据状态报警规则的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'Disable' => [
'description' => '禁用状态报警规则的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'Total' => [
'description' => '报警规则总数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '45',
],
'Alarm' => [
'description' => '报警状态报警规则的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '5',
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
402 => [
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'Throttli∂ngException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"FF38D33A-67C1-40EB-AB65-FAEE51EDB644\\",\\n \\"Success\\": true,\\n \\"MetricRuleCount\\": {\\n \\"Ok\\": 40,\\n \\"Nodata\\": 0,\\n \\"Disable\\": 0,\\n \\"Total\\": 45,\\n \\"Alarm\\": 5\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n true\\n 200\\n FF38D33A-67C1-40EB-AB65-FAEE51EDB644\\n \\n 40\\n 0\\n 45\\n 0\\n 5\\n \\n","errorExample":""}]',
'title' => '获取各种状态报警规则的数量',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeAlertingMetricRuleResources' => [
'summary' => '调用DescribeAlertingMetricRuleResources接口查询指定报警规则中正在发生报警的资源列表。',
'methods' => [
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。关于如何查询报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。关于如何查询应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '7671****',
],
],
[
'name' => 'Page',
'in' => 'query',
'schema' => [
'description' => '分页页码。 '."\n"
."\n"
.'默认值:1 。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页大小。'."\n"
."\n"
.'默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于如何获取云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_mns_new',
],
],
[
'name' => 'Dimensions',
'in' => 'query',
'schema' => [
'description' => '维度Map,用于查询指定资源的监控数据。',
'type' => 'string',
'required' => false,
'example' => '{\\"userId\\":\\"120886317861****\\",\\"region\\":\\"cn-huhehaote\\",\\"queue\\":\\"test-0128\\"}',
],
],
[
'name' => 'AlertBeforeTime',
'in' => 'query',
'schema' => [
'description' => '用于查询在这个时刻之前发生的报警。支持毫秒时间戳。',
'type' => 'string',
'required' => false,
'example' => '1698827400000',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request processing has failed due to some unknown error.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '0724011B-D9E0-4B2F-8C51-F17A894CC42C',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Resources' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '报警规则的资源列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'ActiveMessages',
],
'RetryTimes' => [
'description' => '报警重试次数。',
'type' => 'string',
'example' => '3',
],
'MetricValues' => [
'description' => '触发报警时监控项的值。格式为一个JSON字符串。',
'type' => 'string',
'example' => '{\\"timestamp\\":1623727500000,\\"Sum\\":926,\\"value\\":463,\\"Maximum\\":463,\\"Minimum\\":463,\\"Average\\":463,\\"SampleCount\\":2,\\"userId\\":\\"120886317861****\\",\\"region\\":\\"cn-huhehaote\\",\\"queue\\":\\"test-0128\\"}',
],
'Namespace' => [
'description' => '云产品的数据命名空间。',
'type' => 'string',
'example' => 'acs_mns_new',
],
'RuleName' => [
'description' => '报警规则名称。',
'type' => 'string',
'example' => 'test123456789',
],
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****',
],
'ProductCategory' => [
'description' => '云产品类型。',
'type' => 'string',
'example' => 'mns',
],
'StartTime' => [
'description' => '资源被关联到报警规则的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1622427900000',
],
'Resource' => [
'description' => '报警的资源。',
'type' => 'string',
'example' => 'userId=120886317861****,region=cn-huhehaote,queue=test-0128',
],
'LastModifyTime' => [
'description' => '最后一次修改报警规则的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1622827900000',
],
'GroupId' => [
'description' => '应用分组ID。'."\n"
.'>如果报警规则与指定应用分组关联,则显示该应用分组ID。',
'type' => 'string',
'example' => '7671****',
],
'Dimensions' => [
'description' => '维度Map,用于查询指定资源的监控数据。',
'type' => 'string',
'example' => '{\\"region\\":\\"cn-huhehaote\\",\\"queue\\":\\"test-0128\\",\\"userId\\":\\"120886317861****\\"}',
],
'LastAlertTime' => [
'description' => '最后一次触发报警的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1622427900000',
],
'Level' => [
'description' => '报警的级别和通知方式。取值:'."\n"
."\n"
.'- 2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- 4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- 4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '10',
],
'Statistics' => [
'description' => '报警统计方法。',
'type' => 'string',
'example' => 'Average',
],
'Enable' => [
'description' => '是否启用报警规则。取值:'."\n"
."\n"
.'- true:启用报警规则。'."\n"
."\n"
.'- false:不启用报警规则。'."\n",
'type' => 'string',
'example' => 'true',
],
'Escalation' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Resource' => [
'description' => '触发报警的规则。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => '阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
."\n"
.'- GreaterThanThreshold:大于。'."\n"
."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
."\n"
.'- LessThanThreshold:小于。'."\n"
."\n"
.'- NotEqualToThreshold:不等于。'."\n"
."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'PreCondition' => [
'description' => '阈值比较符号。取值:'."\n"
."\n"
.'- `>=`'."\n"
."\n"
.'- `=`'."\n"
."\n"
.'- `<=`'."\n"
."\n"
.'- `>`'."\n"
."\n"
.'- `<`'."\n"
."\n"
.'- `!=`',
'type' => 'string',
'example' => '>=',
],
'Expression' => [
'description' => '触发报警的规则描述。'."\n"
."\n"
.'> 报警规则的主体,当监控数据满足报警条件时,触发报警规则。',
'type' => 'string',
'example' => '$Average>=10',
],
'Times' => [
'description' => '报警重试次数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Tag' => [
'description' => '该参数已废弃,无需关注。',
'type' => 'string',
'example' => '无',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'example' => '10',
],
'Level' => [
'description' => '报警的级别和通知方式。取值:'."\n"
."\n"
.'- 2:电话+短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 3:短信+邮件+钉钉机器人。'."\n"
."\n"
.'- 4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- 4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。'."\n"
."\n"
.'- 4:邮件+钉钉机器人。'."\n"
."\n"
.'- OK:无报警。',
'type' => 'integer',
'format' => 'int32',
'example' => '3',
],
'ExpressionListJoin' => [
'description' => '多个监控项之间的关系。取值:'."\n"
."\n"
.'- &&:当所有监控项都满足报警条件时,发送报警通知。'."\n"
.'- ||:当其中一个监控项满足报警条件时,发送报警通知。',
'type' => 'string',
'example' => '&&',
],
'ExpressionList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ExpressionList' => [
'description' => '多指标报警规则描述。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'ComparisonOperator' => [
'description' => '报警级别的阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'example' => 'GreaterThanOrEqualToThreshold',
],
'MetricName' => [
'description' => '监控项名称。',
'type' => 'string',
'example' => 'cpu_total',
],
'Period' => [
'description' => '监控项的统计周期。单位:秒。默认为监控项的原始上报周期。',
'type' => 'string',
'example' => '60',
],
'Statistics' => [
'description' => '报警级别的统计方法。取值:'."\n"
."\n"
.'- Maximum:最大值。'."\n"
.'- Minimum:最小值。'."\n"
.'- Average:平均值。',
'type' => 'string',
'example' => 'Average',
],
'Threshold' => [
'description' => '报警阈值。'."\n"
.' ',
'type' => 'string',
'example' => '90',
],
],
],
],
],
],
'ExpressionRaw' => [
'description' => '表达式创建的报警条件。包括但不限于以下情况:'."\n"
."\n"
.'- 为部分资源设置报警黑名单,例如:`$instanceId != \'i-io8kfvcpp7x5****\' ``&&`` $Average > 50`,表示当报警规则中的实例`i-io8kfvcpp7x5****`的`Average`大于50时,也不会产生报警。'."\n"
.'- 对规则中的指定实例设置特殊报警阈值,例如:`$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)`,表示当报警规则中的实例`i-io8kfvcpp7x5****`的`Average`大于80时,才报警,其他实例的`Average`大于50,即可报警。'."\n"
.'- 对规则中超过阈值的实例数量进行限制,例如:`count($Average > 20) > 3`,表示当报警规则中的`Average`大于20的实例数大于3个时,才进行报警。'."\n",
'type' => 'string',
'example' => '$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)',
],
],
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": 200,\\n \\"Message\\": \\"The request processing has failed due to some unknown error.\\",\\n \\"RequestId\\": \\"0724011B-D9E0-4B2F-8C51-F17A894CC42C\\",\\n \\"Total\\": 2,\\n \\"Success\\": true,\\n \\"Resources\\": {\\n \\"Resource\\": [\\n {\\n \\"MetricName\\": \\"ActiveMessages\\",\\n \\"RetryTimes\\": \\"3\\",\\n \\"MetricValues\\": \\"{\\\\\\\\\\\\\\"timestamp\\\\\\\\\\\\\\":1623727500000,\\\\\\\\\\\\\\"Sum\\\\\\\\\\\\\\":926,\\\\\\\\\\\\\\"value\\\\\\\\\\\\\\":463,\\\\\\\\\\\\\\"Maximum\\\\\\\\\\\\\\":463,\\\\\\\\\\\\\\"Minimum\\\\\\\\\\\\\\":463,\\\\\\\\\\\\\\"Average\\\\\\\\\\\\\\":463,\\\\\\\\\\\\\\"SampleCount\\\\\\\\\\\\\\":2,\\\\\\\\\\\\\\"userId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"120886317861****\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"region\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"cn-huhehaote\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"queue\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"test-0128\\\\\\\\\\\\\\"}\\",\\n \\"Namespace\\": \\"acs_mns_new\\",\\n \\"RuleName\\": \\"test123456789\\",\\n \\"RuleId\\": \\"putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****\\",\\n \\"ProductCategory\\": \\"mns\\",\\n \\"StartTime\\": \\"1622427900000\\",\\n \\"Resource\\": \\"userId=120886317861****,region=cn-huhehaote,queue=test-0128\\",\\n \\"LastModifyTime\\": \\"1622827900000\\",\\n \\"GroupId\\": \\"7671****\\",\\n \\"Dimensions\\": \\"{\\\\\\\\\\\\\\"region\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"cn-huhehaote\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"queue\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"test-0128\\\\\\\\\\\\\\",\\\\\\\\\\\\\\"userId\\\\\\\\\\\\\\":\\\\\\\\\\\\\\"120886317861****\\\\\\\\\\\\\\"}\\",\\n \\"LastAlertTime\\": \\"1622427900000\\",\\n \\"Level\\": 3,\\n \\"Threshold\\": \\"10\\",\\n \\"Statistics\\": \\"Average\\",\\n \\"Enable\\": \\"true\\",\\n \\"Escalation\\": {\\n \\"Resource\\": [\\n {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"PreCondition\\": \\">=\\",\\n \\"Expression\\": \\"$Average>=10\\",\\n \\"Times\\": 1,\\n \\"Tag\\": \\"无\\",\\n \\"Threshold\\": \\"10\\",\\n \\"Level\\": 3,\\n \\"ExpressionListJoin\\": \\"&&\\",\\n \\"ExpressionList\\": {\\n \\"ExpressionList\\": [\\n {\\n \\"ComparisonOperator\\": \\"GreaterThanOrEqualToThreshold\\",\\n \\"MetricName\\": \\"cpu_total\\",\\n \\"Period\\": \\"60\\",\\n \\"Statistics\\": \\"Average\\",\\n \\"Threshold\\": \\"90\\"\\n }\\n ]\\n },\\n \\"ExpressionRaw\\": \\"$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)\\"\\n }\\n ]\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t0724011B-D9E0-4B2F-8C51-F17A894CC42C\\r\\n\\t\\r\\n\\t2\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tputNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t$Average>=10\\r\\n\\t\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\tmns\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tuserId=120886317861****,region=cn-huhehaote,queue=test-0128\\r\\n\\t\\t\\t1622427900000\\r\\n\\t\\t\\t{\\\\\\"userId\\\\\\":\\\\\\"120886317861****\\\\\\",\\\\\\"region\\\\\\":\\\\\\"cn-huhehaote\\\\\\",\\\\\\"queue\\\\\\":\\\\\\"test-0128\\\\\\"}\\r\\n\\t\\t\\t{\\\\\\"timestamp\\\\\\":1623727500000,\\\\\\"Sum\\\\\\":926,\\\\\\"value\\\\\\":463,\\\\\\"Maximum\\\\\\":463,\\\\\\"Minimum\\\\\\":463,\\\\\\"Average\\\\\\":463,\\\\\\"SampleCount\\\\\\":2,\\\\\\"userId\\\\\\":\\\\\\"120886317861****\\\\\\",\\\\\\"region\\\\\\":\\\\\\"cn-huhehaote\\\\\\",\\\\\\"queue\\\\\\":\\\\\\"test-0128\\\\\\"}\\r\\n\\t\\t\\t1623727904000\\r\\n\\t\\t\\tAverage\\r\\n\\t\\t\\tacs_mns_new\\r\\n\\t\\t\\t7671****\\r\\n\\t\\t\\tActiveMessages\\r\\n\\t\\t\\t1622427900000\\r\\n\\t\\t\\tmns\\r\\n\\t\\t\\ttrue\\r\\n\\t\\t\\t3\\r\\n\\t\\t\\ttest123456789\\r\\n\\t\\t\\t1\\r\\n\\t\\t\\t10\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\tputNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t$Average>=10\\r\\n\\t\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t\\tmns\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tuserId=120886317861****,region=cn-huhehaote,queue=test-022401-1\\r\\n\\t\\t\\t1622427900000\\r\\n\\t\\t\\t{\\\\\\"userId\\\\\\":\\\\\\"120886317861****\\\\\\",\\\\\\"region\\\\\\":\\\\\\"cn-huhehaote\\\\\\",\\\\\\"queue\\\\\\":\\\\\\"test-022401-1\\\\\\"}\\r\\n\\t\\t\\t{\\\\\\"timestamp\\\\\\":1623727500000,\\\\\\"queue\\\\\\":\\\\\\"test-022401-1\\\\\\",\\\\\\"Maximum\\\\\\":349,\\\\\\"Minimum\\\\\\":349,\\\\\\"Sum\\\\\\":698,\\\\\\"value\\\\\\":349,\\\\\\"userId\\\\\\":\\\\\\"120886317861****\\\\\\",\\\\\\"region\\\\\\":\\\\\\"cn-huhehaote\\\\\\",\\\\\\"Average\\\\\\":349,\\\\\\"SampleCount\\\\\\":2}\\r\\n\\t\\t\\t1623727904000\\r\\n\\t\\t\\tAverage\\r\\n\\t\\t\\tacs_mns_new\\r\\n\\t\\t\\t7671****\\r\\n\\t\\t\\tActiveMessages\\r\\n\\t\\t\\t1622427900000\\r\\n\\t\\t\\tmns\\r\\n\\t\\t\\ttrue\\r\\n\\t\\t\\t3\\r\\n\\t\\t\\ttest123456789\\r\\n\\t\\t\\t1\\r\\n\\t\\t\\t10\\r\\n\\t\\t\\r\\n\\t\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询指定报警规则中正在发生报警的资源列表',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutMetricRuleTargets' => [
'summary' => '调用PutMetricRuleTargets接口为指定报警规则添加或修改推送渠道。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'关于如何获取报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。'."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ae06917_75a8c43178ab66****',
],
],
[
'name' => 'Targets',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。'."\n"
."\n"
.'关于如何获取报警触发目标ID,请参见[DescribeMetricRuleTargets](~~121592~~)。',
'type' => 'string',
'required' => true,
'example' => '1',
],
'Arn' => [
'description' => '资源ARN。目前支持轻量消息队列(原 MNS),弹性伸缩ESS,日志服务SLS,函数计算FC。'."\n"
."\n"
.'轻量消息队列(原 MNS)的ARN参数说明如下:'."\n"
."\n"
.'`acs:mns:{regionId}:{userId}:/{资源类型}/{资源名称}/message`。'."\n"
."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
.'- {userId}:资源所属的阿里云账号。'."\n"
.'- {资源类型}`:接收报警的资源类型。取值:'."\n"
."\n"
.' - **queues**:队列。'."\n"
.' - **topics**:主题。'."\n"
."\n"
.'- {资源名称}:资源名称。'."\n"
."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。'."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。'."\n"
."\n"
.'弹性伸缩的ARN:'."\n"
."\n"
.'acs:ess:{regionId}:{userId}:scalingGroupId/{伸缩组id}:scalingRuleId/{伸缩规则id}'."\n"
."\n"
.'日志服务的ARN:'."\n"
."\n"
.'acs:log:{regionId}:{userId}:project/{project名称}/logstore/{日志库名称}'."\n"
."\n"
.'函数计算的ARN:'."\n"
."\n"
.'acs:fc:{regionId}:{userId}:services/{服务名称}/functions/{函数名称}',
'type' => 'string',
'required' => true,
'example' => 'acs:mns:cn-hangzhou:120886317861****:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'required' => false,
'example' => '["INFO", "WARN", "CRITICAL"]',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'required' => false,
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 5,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request processing has failed due to some unknown error.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '6A569B0D-9055-58AF-9E82-BAEAF95C0FD5',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'FailData' => [
'description' => '失败列表。',
'type' => 'object',
'properties' => [
'Targets' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Target' => [
'description' => '报警触发目标。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Id' => [
'description' => '报警触发目标ID。',
'type' => 'string',
'example' => '1',
],
'Arn' => [
'description' => '资源ARN。格式为`acs:{云产品缩写}:{regionId}:{userId}:/{资源类型}/{资源名称}/message`。目前支持轻量消息队列(原 MNS),弹性伸缩ESS,日志服务SLS,函数计算FC。例如:`acs:mns:cn-hangzhou:120886317861****:/queues/test123/message`。轻量消息队列(原 MNS)的ARN参数说明如下:'."\n"
."\n"
.'- {云产品缩写}:mns'."\n"
."\n"
.'- {userId}:阿里云账号ID。'."\n"
."\n"
.'- {regionId}:轻量消息队列(原 MNS)或主题所在地域。'."\n"
."\n"
.'- {资源类型}`:接收报警的资源类型。取值:'."\n"
."\n"
.' - **queues**:队列。'."\n"
.' - **topics**:主题。'."\n"
."\n"
.'- {资源名称}:资源名称。'."\n"
."\n"
.' - 如果资源类型为**queues**,则资源名称为队列名称。'."\n"
.' - 如果资源类型为**topics**,则资源名称为主题名称。',
'type' => 'string',
'example' => 'acs:mns:cn-hangzhou:111:/queues/test/message',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
."\n"
.'- INFO:信息。'."\n"
.'- WARN:警告。'."\n"
.'- CRITICAL:紧急。',
'type' => 'string',
'example' => '["INFO", "WARN", "CRITICAL"]',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
200 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The request processing has failed due to some unknown error.\\",\\n \\"RequestId\\": \\"6A569B0D-9055-58AF-9E82-BAEAF95C0FD5\\",\\n \\"Success\\": true,\\n \\"FailData\\": {\\n \\"Targets\\": {\\n \\"Target\\": [\\n {\\n \\"Id\\": \\"1\\",\\n \\"Arn\\": \\"acs:mns:cn-hangzhou:111:/queues/test/message\\",\\n \\"Level\\": \\"[\\\\\\"INFO\\\\\\", \\\\\\"WARN\\\\\\", \\\\\\"CRITICAL\\\\\\"]\\"\\n }\\n ]\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t6A569B0D-9055-58AF-9E82-BAEAF95C0FD5\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '为指定报警规则添加或修改推送渠道',
'description' => '## 使用说明'."\n"
.'本文将提供一个示例,为报警规则`ae06917_75a8c43178ab66****`关联资源`acs:mns:cn-hangzhou:120886317861****:/queues/test/message`,报警触发目标ID为`1`。返回结果显示,添加关联资源成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutResourceMetricRule' => [
'summary' => '设置报警规则',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'您可以输入新的报警规则ID,也可以使用云监控已存在的报警规则ID。关于如何查询报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。'."\n"
."\n"
.'> 输入新的报警规则ID,表示创建一条阈值报警规则。'."\n"
."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'a151cd6023eacee2f0978e03863cc1697c89508****',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。'."\n"
."\n"
.'您可以输入新的报警规则名称,也可以使用云监控已存在的报警规则名称。关于如何查询报警规则名称,请参见[DescribeMetricRuleList](~~114941~~)。'."\n"
."\n"
.'> 输入新的报警规则名称,表示创建一条阈值报警规则。',
'type' => 'string',
'required' => true,
'example' => 'test123',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。关于如何查询云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 当您为企业云监控创建Prometheus报警规则时,该参数必须为`acs_prometheus`。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。关于如何查询监控项名称,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 当您为企业云监控创建Prometheus报警规则时,该参数为指标仓库名称。关于如何获取指标仓库名称,请参见[DescribeHybridMonitorNamespaceList](~~428880~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'cpu_total',
],
],
[
'name' => 'Resources',
'in' => 'query',
'schema' => [
'description' => '资源信息,例如:`[{"instanceId":"i-uf6j91r34rnwawoo****"}]`、`[{"userId":"100931896542****"}]`。'."\n"
."\n"
.'关于资源信息支持的维度Dimensions,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'docRequired' => true,
'example' => '[{"instanceId":"i-uf6j91r34rnwawoo****"}]',
],
],
[
'name' => 'ContactGroups',
'in' => 'query',
'schema' => [
'description' => '报警联系组。报警通知会发送给该报警联系组中的报警联系人。'."\n"
."\n"
.'> 报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见[PutContact](~~114923~~)和[PutContactGroup](~~114929~~)。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'ECS_Group',
],
],
[
'name' => 'Webhook',
'in' => 'query',
'schema' => [
'description' => '报警发生回调时指定的URL地址,向URL发送POST请求。',
'type' => 'string',
'required' => false,
'example' => 'https://alert.aliyun.com.com:8080/callback',
],
],
[
'name' => 'EffectiveInterval',
'in' => 'query',
'schema' => [
'description' => '报警规则的生效时间范围。',
'type' => 'string',
'required' => false,
'example' => '00:00-23:59',
],
],
[
'name' => 'NoEffectiveInterval',
'in' => 'query',
'schema' => [
'description' => '报警规则的失效时间范围。',
'type' => 'string',
'required' => false,
'example' => '00:00-06:00',
],
],
[
'name' => 'SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默周期。单位:秒,默认值:86400。'."\n"
."\n"
.'> 通道沉默周期是指报警发生后未恢复正常,间隔多久重新发送一次报警通知。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '86400',
'default' => '86400',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '监控项的统计周期。单位:秒。默认为监控项的原始上报周期。'."\n"
."\n"
.'>关于如何查询监控项的统计周期,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'Interval',
'in' => 'query',
'schema' => [
'description' => '报警规则的触发周期。单位:秒。'."\n"
."\n"
.'>关于如何查询监控项的统计周期,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'EmailSubject',
'in' => 'query',
'schema' => [
'description' => '报警邮件主题。',
'type' => 'string',
'required' => false,
'example' => 'ECS实例报警',
],
],
[
'name' => 'Escalations.Critical.Statistics',
'in' => 'query',
'schema' => [
'description' => 'Critical级别报警统计方法。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
[
'name' => 'Escalations.Critical.ComparisonOperator',
'in' => 'query',
'schema' => [
'description' => 'Critical级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- EqualToThreshold:等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
],
[
'name' => 'Escalations.Critical.Threshold',
'in' => 'query',
'schema' => [
'description' => 'Critical级别报警阈值。'."\n"
."\n\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '90',
],
],
[
'name' => 'Escalations.Critical.Times',
'in' => 'query',
'schema' => [
'description' => 'Critical级别报警重试次数。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
],
[
'name' => 'Escalations.Warn.Statistics',
'in' => 'query',
'schema' => [
'description' => 'Warn级别报警统计方法。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
[
'name' => 'Escalations.Warn.ComparisonOperator',
'in' => 'query',
'schema' => [
'description' => 'Warn级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- EqualToThreshold:等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
],
[
'name' => 'Escalations.Warn.Threshold',
'in' => 'query',
'schema' => [
'description' => 'Warn级别报警阈值。'."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '90',
],
],
[
'name' => 'Escalations.Warn.Times',
'in' => 'query',
'schema' => [
'description' => 'Warn级别报警重试次数。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
],
[
'name' => 'Escalations.Info.Statistics',
'in' => 'query',
'schema' => [
'description' => 'Info级别报警统计方法。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
[
'name' => 'Escalations.Info.ComparisonOperator',
'in' => 'query',
'schema' => [
'description' => 'Info级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- EqualToThreshold:等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
],
[
'name' => 'Escalations.Info.Threshold',
'in' => 'query',
'schema' => [
'description' => 'Info级别报警阈值。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '90',
],
],
[
'name' => 'Escalations.Info.Times',
'in' => 'query',
'schema' => [
'description' => 'Info级别报警重试次数。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
],
[
'name' => 'NoDataPolicy',
'in' => 'query',
'schema' => [
'description' => '无监控数据时报警的处理方式。取值:'."\n"
."\n"
.'- KEEP\\_LAST\\_STATE(默认值):不做任何处理。'."\n"
.'- INSUFFICIENT\\_DATA:报警内容为无数据。'."\n"
.'- OK:正常。',
'type' => 'string',
'required' => false,
'example' => 'KEEP_LAST_STATE',
],
],
[
'name' => 'CompositeExpression',
'in' => 'query',
'style' => 'json',
'schema' => [
'description' => '多指标的报警条件。'."\n"
."\n"
.'> 单指标和多指标互斥,不能同时设置。',
'type' => 'object',
'properties' => [
'ExpressionList' => [
'description' => '标准创建的报警条件列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '云产品的监控项名称。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
'Period' => [
'description' => '监控项的聚合周期。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '60',
],
'Statistics' => [
'description' => '监控项的统计方法。取值:'."\n"
.'- $Maximum:最大值。'."\n"
.'- $Minimum:最小值。'."\n"
.'- $Average:平均值。'."\n"
.'- $Availability:可用率(通常用于站点监控)。'."\n"
."\n"
.'> `$`为监控项的统一前缀符号。支持的云产品,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => '$Maximum',
],
'ComparisonOperator' => [
'description' => '阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- EqualToThreshold:等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Threshold' => [
'description' => '报警阈值。',
'type' => 'string',
'required' => false,
'example' => '90',
],
],
'required' => false,
],
'required' => false,
],
'ExpressionListJoin' => [
'description' => '多指标报警条件之间的关系。取值: '."\n"
."\n"
.'- `&&`:当所有指标都符合报警条件时,才触发报警。当ExpressionList下各表达式均为`true`时,才触发报警。'."\n"
."\n"
.'- `||`:其中一个指标符合报警条件,即触发报警。',
'type' => 'string',
'required' => false,
'example' => '||',
],
'ExpressionRaw' => [
'description' => '表达式创建的报警条件。包括但不限于以下情况:'."\n"
."\n"
.'- 为部分资源设置报警黑名单,例如:`$instanceId != \'i-io8kfvcpp7x5****\' ``&&`` $Average > 50`,表示当报警规则中的实例`i-io8kfvcpp7x5****`的`Average`大于50时,也不会产生报警。'."\n"
.'- 对规则中的指定实例设置特殊报警阈值,例如:`$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)`,表示当报警规则中的实例`i-io8kfvcpp7x5****`的`Average`大于80时,才报警,其他实例的`Average`大于50,即可报警。'."\n"
.'- 对规则中超过阈值的实例数量进行限制,例如:`count($Average > 20) > 3`,表示当报警规则中的`Average`大于20的实例数大于3个时,才进行报警。'."\n",
'type' => 'string',
'required' => false,
'example' => '$Average > ($instanceId == \'i-io8kfvcpp7x5****\'? 80: 50)',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'required' => false,
'example' => 'CRITICAL',
],
'Times' => [
'description' => '发出报警通知需要达到报警条件的次数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
],
'required' => false,
],
],
[
'name' => 'Labels',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '当监控项达到报警条件并进行报警时,标签同时写入监控项,在报警通知中进行展示。'."\n"
."\n"
.'> 该功能与Prometheus报警中的Label相同。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '标签键。',
'type' => 'string',
'required' => false,
'example' => 'tagKey1',
],
'Value' => [
'description' => '标签值。'."\n"
."\n"
.'> 标签值支持模板参数,将模板参数替换为实际标签值。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'Prometheus',
'in' => 'query',
'style' => 'json',
'schema' => [
'description' => 'Prometheus报警。'."\n"
."\n"
.'> 仅当您为企业云监控创建Prometheus报警规则,需要设置该参数。',
'type' => 'object',
'properties' => [
'PromQL' => [
'description' => 'PromQL查询语句。'."\n"
."\n"
.'> 通过PromQL查询语句获取的数据即为报警数据,请您在该语句中携带报警阈值。',
'type' => 'string',
'required' => false,
'example' => 'cpuUsage{instanceId="xxxx"}[1m]>90',
],
'Level' => [
'description' => '报警级别。取值:'."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'required' => false,
'example' => 'CRITICAL',
],
'Times' => [
'description' => '发出报警通知需要达到报警条件的次数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Annotations' => [
'description' => 'Prometheus报警时,将注释的键和值进行渲染,易于您对监控项或报警规则的理解。'."\n"
."\n"
.'> 该功能等同于Prometheus的Annotation。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '注释的键。',
'type' => 'string',
'required' => false,
'example' => 'summary',
],
'Value' => [
'description' => '注释的值。',
'type' => 'string',
'required' => false,
'example' => '{{ $labels.instance }} CPU usage above 10% {current value: {{ humanizePercentage $value }} }',
],
],
'required' => false,
],
'required' => false,
],
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request processing has failed due to some unknown error.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '65D50468-ECEF-48F1-A6E1-D952E89D9436',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
429 => [
[
'errorCode' => 'ResourceOverLimit',
'errorMessage' => 'The resource has exceeded the limit. %s',
],
],
499 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The request processing has failed due to some unknown error.\\",\\n \\"RequestId\\": \\"65D50468-ECEF-48F1-A6E1-D952E89D9436\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t200\\r\\n\\t\\r\\n\\t65D50468-ECEF-48F1-A6E1-D952E89D9436\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '为指定资源的指定监控项设置一条阈值报警规则',
'description' => '本文将提供一个示例,为云服务器ECS `acs_ecs_dashboard`的实例`i-uf6j91r34rnwawoo****`中的监控项`cpu_total`设置阈值报警规则。该报警规则的报警联系组为`ECS_Group`、报警规则名称为`test123`、报警规则ID为`a151cd6023eacee2f0978e03863cc1697c89508****`、Critical级别的统计方法为`Average`、Critical级别的比较符为`GreaterThanOrEqualToThreshold`、Critical级别的阈值为`90`和Critical级别的报警重试次数为`3`。'."\n"
.'> 2024-08-15 增加Statistics校验,统计值只能填对应指标的Statistics。关于如何获取该参数的取值,请参见[云产品监控项](https://help.aliyun.com/zh/cms/support/appendix-1-metrics)。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutResourceMetricRules' => [
'summary' => '调用PutResourceMetricRules接口为指定资源的指定监控项设置多条阈值报警规则。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Rules',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '阈值报警规则列表。'."\n"
."\n"
.'N的取值范围:1~50。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Escalations.Info.Threshold' => [
'description' => 'Info级别报警阈值。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '90',
],
'MetricName' => [
'description' => '监控项名称。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'关于如何查询监控项名称,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'cpu_total',
],
'Escalations.Warn.Threshold' => [
'description' => 'Warn级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '90',
],
'EffectiveInterval' => [
'description' => '报警规则的生效时间范围。'."\n"
."\n"
.'N的取值范围:1~50。',
'type' => 'string',
'required' => false,
'example' => '00:00-23:59',
],
'NoEffectiveInterval' => [
'description' => '报警规则的失效时间范围。'."\n"
."\n"
.'N的取值范围:1~50。',
'type' => 'string',
'required' => false,
'example' => '00:00-06:00',
],
'RuleId' => [
'description' => '报警规则ID。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'您可以输入新的报警规则ID,也可以使用云监控已存在的报警规则ID。关于如何查询报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。'."\n"
."\n"
.'> 输入新的报警规则ID,表示创建一条阈值报警规则。',
'type' => 'string',
'required' => true,
'example' => 'a151cd6023eacee2f0978e03863cc1697c89508****',
],
'Escalations.Critical.Times' => [
'description' => 'Critical级别报警重试次数。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Escalations.Critical.Threshold' => [
'description' => 'Critical级别报警阈值。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '90',
],
'Escalations.Critical.Statistics' => [
'description' => 'Critical级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Warn.ComparisonOperator' => [
'description' => 'Warn级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- EqualToThreshold:等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Info.Times' => [
'description' => 'Info级别报警重试次数。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Resources' => [
'description' => '资源信息,例如:`[{"instanceId":"i-uf6j91r34rnwawoo****"}]`、`[{"userId":"100931896542****"}]`。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'关于资源信息支持的维度Dimensions,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => '[{"instanceId":"i-uf6j91r34rnwawoo****"}]',
],
'SilenceTime' => [
'description' => '通道沉默周期。'."\n"
."\n"
.'单位:秒,默认值:86400。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 通道沉默周期是指报警发生后未恢复正常,间隔多久重新发送一次报警通知。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '86400',
],
'Webhook' => [
'description' => '报警发生回调时指定的URL地址,向URL发送POST请求。'."\n"
."\n"
.'N的取值范围:1~50。',
'type' => 'string',
'required' => false,
'example' => 'https://alert.aliyun.com.com:8080/callback',
],
'ContactGroups' => [
'description' => '报警联系组。报警通知会发送给该报警联系组中的报警联系人。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见[PutContact](~~114923~~)和[PutContactGroup](~~114929~~)。',
'type' => 'string',
'required' => true,
'example' => 'ECS_Group',
],
'Namespace' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'关于如何查询云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
'EmailSubject' => [
'description' => '报警邮件主题。'."\n"
."\n"
.'N的取值范围:1~50。',
'type' => 'string',
'required' => false,
'example' => 'ECS实例报警',
],
'Period' => [
'description' => '监控项的统计周期。'."\n"
."\n"
.'单位:秒。默认为监控项的原始上报周期。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'>关于如何查询监控项的统计周期,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => '60',
],
'RuleName' => [
'description' => '报警规则名称。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'您可以输入新的报警规则名称,也可以使用云监控已存在的报警规则名称。关于如何查询报警规则名称,请参见[DescribeMetricRuleList](~~114941~~)。'."\n"
."\n"
.'> 输入新的报警规则名称,表示创建一条阈值报警规则。',
'type' => 'string',
'required' => true,
'example' => 'test123',
],
'Escalations.Info.Statistics' => [
'description' => 'Info级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'Escalations.Warn.Times' => [
'description' => 'Warn级别报警重试次数。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
'Escalations.Info.ComparisonOperator' => [
'description' => 'Info级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- EqualToThreshold:等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Interval' => [
'description' => '报警规则的触发周期。'."\n"
."\n"
.'单位:秒。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'>关于如何查询监控项的统计周期,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => '60',
],
'Escalations.Critical.ComparisonOperator' => [
'description' => 'Critical级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- EqualToThreshold:等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
'Escalations.Warn.Statistics' => [
'description' => 'Warn级别报警统计方法。'."\n"
."\n"
.'N的取值范围:1~50。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 报警级别Critical(严重)、Warn(警告)或Info(信息)至少设置一个,且该报警级别中的参数Statistics、ComparisonOperator、Threshold和Times必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
'NoDataPolicy' => [
'description' => '无监控数据时报警的处理方式。取值:'."\n"
."\n"
.'- KEEP_LAST_STATE(默认值):不做任何处理。'."\n"
.'- INSUFFICIENT_DATA:报警内容为无数据。'."\n"
.'- OK:正常。'."\n"
."\n"
.'N的取值范围:1~50。',
'type' => 'string',
'required' => false,
'example' => 'KEEP_LAST_STATE',
],
'Labels' => [
'description' => '当监控项达到报警条件并进行报警时,标签同时写入监控项,在报警通知中进行展示。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '标签键。',
'type' => 'string',
'required' => false,
'example' => 'tagKey1',
],
'Value' => [
'description' => '标签值。'."\n"
."\n"
.'> 标签值支持模板参数,将模板参数替换为实际标签值。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
'minItems' => 0,
],
],
'required' => false,
],
'required' => true,
'maxItems' => 500,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request processing has failed due to some unknown error.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '15D1440E-BF24-5A41-93E4-36864635179E',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'FailedListResult' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Target' => [
'description' => '为资源设置报警规则的失败结果列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => 'a151cd6023eacee2f0978e03863cc1697c89508****',
],
'Result' => [
'description' => '失败结果。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。',
'type' => 'string',
'example' => '404',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request processing has failed due to some unknown error.',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'false',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
422 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
499 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The request processing has failed due to some unknown error.\\",\\n \\"RequestId\\": \\"15D1440E-BF24-5A41-93E4-36864635179E\\",\\n \\"Success\\": true,\\n \\"FailedListResult\\": {\\n \\"Target\\": [\\n {\\n \\"RuleId\\": \\"a151cd6023eacee2f0978e03863cc1697c89508****\\",\\n \\"Result\\": {\\n \\"Code\\": \\"404\\",\\n \\"Message\\": \\"The request processing has failed due to some unknown error.\\",\\n \\"Success\\": false\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\r\\n\\t15D1440E-BF24-5A41-93E4-36864635179E\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '为指定资源的指定监控项设置多条阈值报警规则',
'description' => '本文将提供一个示例,为云服务器ECS `acs_ecs_dashboard`的实例`i-uf6j91r34rnwawoo****`中的监控项`cpu_total`设置阈值报警规则。该报警规则的报警联系组为`ECS_Group`、报警规则名称为`test123`、报警规则ID为`a151cd6023eacee2f0978e03863cc1697c89508****`、Critical级别的统计方法为`Average`、Critical级别的比较符为`GreaterThanOrEqualToThreshold`、Critical级别的阈值为`90`和Critical级别的报警重试次数为`3`。'."\n"
.'> 2024-08-15 增加Statistics校验,统计值只能填对应指标的Statistics。关于如何获取该参数的取值,请参见[云产品监控项](https://help.aliyun.com/zh/cms/support/appendix-1-metrics)。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutGroupMetricRule' => [
'summary' => '调用PutGroupMetricRule接口创建或修改指定应用分组中的报警规则。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => true,
'example' => '17285****',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'- 当您为该应用分组创建报警规则时,直接输入报警规则ID。'."\n"
."\n"
.'- 当您修改该应用分组中的指定报警规则时,需要获取报警规则ID。关于如何获取报警规则ID,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => true,
'example' => '123456',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '云产品名称缩写。'."\n"
."\n"
.'关于如何获取云产品名称缩写,请参见[DescribeProjectMeta](~~114916~~)接口的返回参数`Labels`中的`metricCategory`。',
'type' => 'string',
'required' => false,
'example' => 'ECS',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。'."\n"
."\n"
.'- 当您为该应用分组创建报警规则时,直接输入报警规则名称。'."\n"
."\n"
.'- 当您修改该应用分组中的指定报警规则时,需要获取报警规则名称。关于如何获取报警规则名称,请参见[DescribeMetricRuleList](~~114941~~)。',
'type' => 'string',
'required' => true,
'example' => 'Rule_01',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的命名空间。'."\n"
."\n"
.'关于如何获取云产品的命名空间,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'MetricName',
'in' => 'query',
'schema' => [
'description' => '监控项名称。'."\n"
."\n"
.'关于如何获取监控项名称,请参见[DescribeMetricMetaList](~~98846~~)或[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'cpu_total',
],
],
[
'name' => 'Dimensions',
'in' => 'query',
'schema' => [
'description' => '应用分组中报警规则的第一级维度。'."\n"
."\n"
.'格式:`key:value`键值对形式的集合,例如:`{"userId":"120886317861****"}`和`{"instanceId":"i-m5e1qg6uo38rztr4****"}`。'."\n",
'type' => 'string',
'required' => false,
'example' => '[{"instanceId":"i-m5e1qg6uo38rztr4****"}]',
],
],
[
'name' => 'ExtraDimensionJson',
'in' => 'query',
'schema' => [
'description' => '应用分组中报警规则的第二级或第三级维度。'."\n"
."\n"
.'格式:`key:value`键值对形式的集合,例如:`port:80`、`/dev/xvda:d-m5e6yphgzn3aprwu****`。'."\n"
."\n"
.'当报警规则的第一级维度为`{"instanceId":"i-m5e1qg6uo38rztr4****"}`时,其第二级维度为该实例中的云盘`{"/dev/xvda":"d-m5e6yphgzn3aprwu****"}`。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => '{"/dev/xvda":"d-m5e6yphgzn3aprwu****"}',
],
],
[
'name' => 'EffectiveInterval',
'in' => 'query',
'schema' => [
'description' => '报警规则的生效时间范围。',
'type' => 'string',
'required' => false,
'example' => '05:31-23:59',
],
],
[
'name' => 'NoEffectiveInterval',
'in' => 'query',
'schema' => [
'description' => '报警规则的失效时间范围。',
'type' => 'string',
'required' => false,
'example' => '00:00-05:30',
],
],
[
'name' => 'SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默周期。'."\n"
."\n"
.'单位:秒。默认值:86400。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '86400',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '监控数据的上报周期。'."\n"
."\n"
.'`Period`的取值为60或60的整数倍。单位:秒。默认值:300。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'Interval',
'in' => 'query',
'schema' => [
'description' => '报警规则的探测周期。单位:秒。'."\n"
."\n"
.'> 建议报警规则的探测周期和数据上报周期保持一致。如果报警规则的探测周期小于数据上报周期,会因为数据不足而不能触发报警。',
'type' => 'string',
'required' => false,
'example' => '60',
],
],
[
'name' => 'Webhook',
'in' => 'query',
'schema' => [
'description' => '报警发生回调时的URL地址。'."\n"
."\n"
.'填写公网可访问的URL地址,云监控会将报警信息通过POST请求推送到该地址,目前仅支持HTTP协议。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com',
],
],
[
'name' => 'EmailSubject',
'in' => 'query',
'schema' => [
'description' => '报警邮件主题。',
'type' => 'string',
'required' => false,
'example' => 'ECS实例',
],
],
[
'name' => 'ContactGroups',
'in' => 'query',
'schema' => [
'description' => '报警联系组。',
'type' => 'string',
'required' => false,
'example' => 'ECS_Group',
],
],
[
'name' => 'Escalations.Critical.Statistics',
'in' => 'query',
'schema' => [
'description' => 'Critical级别报警统计方法。多个统计方法之间用半角逗号(,)分隔。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
[
'name' => 'Escalations.Critical.ComparisonOperator',
'in' => 'query',
'schema' => [
'description' => 'Critical级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
],
[
'name' => 'Escalations.Critical.Threshold',
'in' => 'query',
'schema' => [
'description' => 'Critical级别报警阈值。',
'type' => 'string',
'required' => false,
'example' => '90',
],
],
[
'name' => 'Escalations.Critical.Times',
'in' => 'query',
'schema' => [
'description' => 'Critical级别报警重试次数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
],
[
'name' => 'Escalations.Warn.Statistics',
'in' => 'query',
'schema' => [
'description' => 'Warn级别报警统计方法。多个统计方法之间用半角逗号(,)分隔。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
[
'name' => 'Escalations.Warn.ComparisonOperator',
'in' => 'query',
'schema' => [
'description' => 'Warn级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
],
[
'name' => 'Escalations.Warn.Threshold',
'in' => 'query',
'schema' => [
'description' => 'Warn级别报警阈值。',
'type' => 'string',
'required' => false,
'example' => '90',
],
],
[
'name' => 'Escalations.Warn.Times',
'in' => 'query',
'schema' => [
'description' => 'Warn级别报警重试次数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
],
[
'name' => 'Escalations.Info.Statistics',
'in' => 'query',
'schema' => [
'description' => 'Info级别报警统计方法。多个统计方法之间用半角逗号(,)分隔。'."\n"
."\n"
.'该参数的取值由指定云产品的`MetricName`对应的`Statistics`列决定,例如:Maximum、Minimum和Average。关于如何获取该参数的取值,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'Average',
],
],
[
'name' => 'Escalations.Info.ComparisonOperator',
'in' => 'query',
'schema' => [
'description' => 'Info级别阈值比较符。取值:'."\n"
."\n"
.'- GreaterThanOrEqualToThreshold:大于等于。'."\n"
.'- GreaterThanThreshold:大于。'."\n"
.'- LessThanOrEqualToThreshold:小于等于。'."\n"
.'- LessThanThreshold:小于。'."\n"
.'- NotEqualToThreshold:不等于。'."\n"
.'- GreaterThanYesterday:同比昨天时间上涨。'."\n"
.'- LessThanYesterday:同比昨天时间下降。'."\n"
.'- GreaterThanLastWeek:同比上周同一时间上涨。'."\n"
.'- LessThanLastWeek:同比上周同一时间下降。'."\n"
.'- GreaterThanLastPeriod:环比上周期上涨。'."\n"
.'- LessThanLastPeriod:环比上周期下降。',
'type' => 'string',
'required' => false,
'example' => 'GreaterThanOrEqualToThreshold',
],
],
[
'name' => 'Escalations.Info.Threshold',
'in' => 'query',
'schema' => [
'description' => 'Info级别报警阈值。',
'type' => 'string',
'required' => false,
'example' => '90',
],
],
[
'name' => 'Escalations.Info.Times',
'in' => 'query',
'schema' => [
'description' => 'Info级别报警重试次数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '3',
],
],
[
'name' => 'NoDataPolicy',
'in' => 'query',
'schema' => [
'description' => '无监控数据时报警的处理方式。取值:'."\n"
.'- KEEP_LAST_STATE(默认值):不做任何处理。'."\n"
.'- INSUFFICIENT_DATA:报警内容为无数据。'."\n"
.'- OK:正常。',
'type' => 'string',
'required' => false,
'example' => 'KEEP_LAST_STATE',
],
],
[
'name' => 'Labels',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警规则标签。'."\n"
."\n"
.'报警通知中会包含标签。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'description' => '报警规则的标签键。',
'type' => 'string',
'required' => false,
'example' => 'key1',
],
'Value' => [
'description' => '报警规则的标签值。',
'type' => 'string',
'required' => false,
'example' => 'value1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 20,
'minItems' => 0,
],
],
[
'name' => 'Options',
'in' => 'query',
'schema' => [
'description' => '高级设置。'."\n"
."\n"
.'格式:{"key1":"value1","key2":"value2"},例如:{"NotSendOK":true},表示是否发送报警恢复通知,key为NotSendOK,value为true(不发送)或false(默认发送)。',
'type' => 'string',
'required' => false,
'example' => '{"NotSendOK":true}',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '报错信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Result' => [
'description' => '创建或修改报警规则的结果。',
'type' => 'object',
'properties' => [
'RuleId' => [
'description' => '报警规则ID。',
'type' => 'string',
'example' => '123456',
],
],
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
499 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D\\",\\n \\"Success\\": true,\\n \\"Result\\": {\\n \\"RuleId\\": \\"123456\\"\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\r\\n\\t461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t\\r\\n\\t\\t123456\\r\\n\\t\\r\\n","errorExample":""}]',
'title' => '创建或修改指定应用分组中的报警规则',
'description' => '本文将提供一个示例,为应用分组`17285****`中的云服务器ECS的监控项`cpu_total`创建一条报警规则,其中报警规则的ID为`123456`,报警规则名称为`Rule_test`,报警级别为`Critical`,报警统计方法为`Average`,报警阈值比较符为`GreaterThanOrEqualToThreshold`,报警阈值为`90`,报警重试次数为`3`。返回结果显示,创建报警规则成功,报警规则ID为`123456`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteEventRuleTargets' => [
'summary' => '调用DeleteEventRuleTargets接口删除事件报警的推送渠道。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '事件报警规则名称。'."\n"
."\n"
.'关于如何获取事件报警规则名称,请参见[DescribeEventRuleList](~~114996~~)。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => 'testRule',
],
],
[
'name' => 'Ids',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '事件报警规则ID列表。',
'type' => 'array',
'items' => [
'description' => '事件报警规则ID。',
'type' => 'string',
'required' => false,
'example' => 'testRuleId',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'successfull',
],
'RequestId' => [
'description' => '请求ID,用于定位日志,排查问题。',
'type' => 'string',
'example' => '142989D9-CC52-54D0-928D-2C9B1D9F051C',
],
'Success' => [
'description' => '是否成功,取值: '."\n"
.'- `true`:成功'."\n"
.'- `false`:失败',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"successfull\\",\\n \\"RequestId\\": \\"142989D9-CC52-54D0-928D-2C9B1D9F051C\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '删除事件报警的推送渠道',
],
'DeleteEventRules' => [
'summary' => '调用DeleteEventRules接口删除事件报警规则。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'high',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleNames',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '要删除的规则的名称列表。',
'type' => 'array',
'items' => [
'description' => '要删除的规则的名称。',
'type' => 'string',
'required' => false,
'example' => 'lq-test',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。说明 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求的uuid,便于查询日志。',
'type' => 'string',
'example' => '45231A42-5A09-5AFF-953C-A5B3D4ED8925',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"45231A42-5A09-5AFF-953C-A5B3D4ED8925\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '删除事件报警规则',
],
'EnableEventRules' => [
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RuleNames',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '要启用的事件规则名称列表',
'type' => 'array',
'items' => [
'description' => '要启用的事件规则名称。',
'type' => 'string',
'required' => false,
'example' => 'ruleName1',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。说明 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '20F2896A-6684-4A04-8255-4155B1593C70',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"20F2896A-6684-4A04-8255-4155B1593C70\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '启用一个或者多个事件监控报警规则',
'summary' => '调用EnableEventRules接口启用一个或者多个事件监控报警规则。',
],
'DisableEventRules' => [
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'update',
],
'parameters' => [
[
'name' => 'RuleNames',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警规则名称。',
'type' => 'array',
'items' => [
'description' => '报警规则名称。',
'type' => 'string',
'required' => false,
'example' => 'ruleName1',
],
'required' => true,
'maxItems' => 20,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3FD0E8B5-F132-4F4E-A081-2878AF378B12',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"3FD0E8B5-F132-4F4E-A081-2878AF378B12\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '调用DisableEventRule接口禁用一个或多个事件报警规则',
'summary' => '调用DisableEventRule接口禁用一个或多个事件报警规则。',
],
'DescribeEventRuleAttribute' => [
'summary' => '调用DescribeEventRuleAttribute接口查询指定事件报警规则的详情。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '事件报警规则名称。'."\n"
."\n"
.'关于如何获取事件报警规则名称,请参见[DescribeEventRuleList](~~114996~~)。'."\n"
."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'testRule',
],
],
[
'name' => 'SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默周期。'."\n"
."\n"
.'单位:秒,默认值:86400(1天)。'."\n"
."\n"
.'> 当监控数据持续超过报警规则阈值时,每个沉默周期内只发送一次报警通知。',
'type' => 'string',
'required' => false,
'example' => '86400',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The alert does not exist.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '9AA3F210-C03D-4C86-8DB6-21C84FF692A1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Result' => [
'description' => '事件报警规则详情。',
'type' => 'object',
'properties' => [
'EventType' => [
'description' => '事件类型。取值:'."\n"
."\n"
.'- SYSTEM:系统事件。'."\n"
."\n"
.'- CUSTOM:自定义事件。',
'type' => 'string',
'example' => 'SYSTEM',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '3607****',
],
'Name' => [
'description' => '事件报警规则的名称。',
'type' => 'string',
'example' => 'test_DefaultEventRule_7378****',
],
'Description' => [
'description' => '事件报警规则的描述信息。',
'type' => 'string',
'example' => 'Default group event rule.',
],
'State' => [
'description' => '事件报警规则的状态。取值:'."\n"
."\n"
.'- ENABLED:启用。'."\n"
."\n"
.'- DISABLED:禁用。',
'type' => 'string',
'example' => 'ENABLED',
],
'EventPattern' => [
'description' => '事件模式。用于描述事件的触发条件。',
'type' => 'object',
'properties' => [
'Product' => [
'description' => '云产品名称。',
'type' => 'string',
'example' => 'CloudMonitor',
],
'LevelList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'LevelList' => [
'description' => '事件报警规则的级别的列表。',
'type' => 'array',
'items' => [
'description' => '事件报警规则的级别。取值:'."\n"
."\n"
.'- CRITICAL:严重。'."\n"
."\n"
.'- WARN:警告。'."\n"
."\n"
.'- INFO:信息。',
'type' => 'string',
'example' => '["CRITICAL","WARN"] ',
],
],
],
],
'StatusList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'StatusList' => [
'description' => '事件报警规则的状态的列表。',
'type' => 'array',
'items' => [
'description' => '事件状态。',
'type' => 'string',
'example' => 'Running',
],
],
],
],
'NameList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'NameList' => [
'description' => '事件报警规则的名称的列表。',
'type' => 'array',
'items' => [
'description' => '事件名称。',
'type' => 'string',
'example' => 'Agent_Status_Running',
],
],
],
],
'EventTypeList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'EventTypeList' => [
'description' => '事件报警规则的类型列表。',
'type' => 'array',
'items' => [
'description' => '事件报警规则的类型。'."\n"
."\n"
.'`*`表示不限制报警规则类型。',
'type' => 'string',
'example' => '*',
],
],
],
],
'SQLFilter' => [
'description' => '按照SQL过滤日志。如果符合条件,则触发报警。',
'type' => 'string',
'example' => 'ycccluster1 and (i-23ij0o82612 or Executed1) or Asimulated not 222',
],
'KeywordFilterObj' => [
'description' => '过滤关键词。',
'type' => 'object',
'properties' => [
'Keywords' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'keyword' => [
'description' => '事件匹配的关键字列表。',
'type' => 'array',
'items' => [
'description' => '关键字。',
'type' => 'string',
'example' => 'VMException',
],
],
],
],
'Relation' => [
'description' => '多个关键字的条件。取值:'."\n"
."\n"
.'- OR: 多个关键字之间或的关系。'."\n"
.'- NOT:不包含关键字。表示匹配非关键字列表中的所有事件。',
'type' => 'string',
'example' => 'OR',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The alert does not exist.\\",\\n \\"RequestId\\": \\"9AA3F210-C03D-4C86-8DB6-21C84FF692A1\\",\\n \\"Success\\": true,\\n \\"Result\\": {\\n \\"EventType\\": \\"SYSTEM\\",\\n \\"GroupId\\": \\"3607****\\",\\n \\"Name\\": \\"test_DefaultEventRule_7378****\\",\\n \\"Description\\": \\"Default group event rule.\\",\\n \\"State\\": \\"ENABLED\\",\\n \\"EventPattern\\": {\\n \\"Product\\": \\"CloudMonitor\\",\\n \\"LevelList\\": {\\n \\"LevelList\\": [\\n \\"[\\\\\\"CRITICAL\\\\\\",\\\\\\"WARN\\\\\\"] \\"\\n ]\\n },\\n \\"StatusList\\": {\\n \\"StatusList\\": [\\n \\"Running\\"\\n ]\\n },\\n \\"NameList\\": {\\n \\"NameList\\": [\\n \\"Agent_Status_Running\\"\\n ]\\n },\\n \\"EventTypeList\\": {\\n \\"EventTypeList\\": [\\n \\"*\\"\\n ]\\n },\\n \\"SQLFilter\\": \\"ycccluster1 and (i-23ij0o82612 or Executed1) or Asimulated not 222\\",\\n \\"KeywordFilterObj\\": {\\n \\"Keywords\\": {\\n \\"keyword\\": [\\n \\"VMException\\"\\n ]\\n },\\n \\"Relation\\": \\"OR\\"\\n }\\n }\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t9AA3F210-C03D-4C86-8DB6-21C84FF692A1\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tAgent_Status_Running\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tCRITICAL\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tCloudMonitor\\r\\n\\t\\t\\r\\n\\t\\tDefault group event rule\\r\\n\\t\\tSYSTEM\\r\\n\\t\\tENABLED\\r\\n\\t\\ttest_DefaultEventRule_7378****\\r\\n\\t\\t3607****\\r\\n\\t\\r\\n\\t","errorExample":""}]',
'title' => '查询指定事件报警规则的详情',
'description' => '本文将提供一个示例,查询事件报警规则`testRule`的详情。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeEventRuleList' => [
'summary' => '调用DescribeEventRuleList接口查询事件报警规则列表。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'NamePrefix',
'in' => 'query',
'schema' => [
'description' => '事件报警规则前缀。',
'type' => 'string',
'required' => false,
'example' => 'test',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:10。',
'type' => 'string',
'required' => false,
'example' => '10',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '7378****',
],
],
[
'name' => 'IsEnable',
'in' => 'query',
'schema' => [
'description' => '启用或禁用事件报警规则。取值:'."\n"
."\n"
.'true(默认值):启用。'."\n"
."\n"
.'false:禁用。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '事件报警规则列表。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'User not authorized to operate on the specified resource.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'D0E6D82B-16B5-422A-8136-EE5BDC01E415',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '21',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'EventRules' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'EventRule' => [
'description' => '事件报警规则。',
'type' => 'array',
'items' => [
'description' => '事件报警规则。',
'type' => 'object',
'properties' => [
'EventType' => [
'description' => '事件报警类型。取值:'."\n"
."\n"
.'- SYSTEM:系统事件。'."\n"
."\n"
.'- CUSTOM:自定义事件。',
'type' => 'string',
'example' => 'SYSTEM',
],
'Description' => [
'description' => '事件报警规则的描述信息。',
'type' => 'string',
'example' => 'Default group event rule.',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '7378****',
],
'Name' => [
'description' => '事件报警规则名称。',
'type' => 'string',
'example' => 'test_DefaultEventRule_7378****',
],
'State' => [
'description' => '事件报警规则状态。取值:'."\n"
."\n"
.'- ENABLED:启用。'."\n"
."\n"
.'- DISABLED:禁用。',
'type' => 'string',
'example' => 'ENABLED',
],
'EventPattern' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'EventPattern' => [
'description' => '事件报警规则的模式。',
'type' => 'array',
'items' => [
'description' => '事件报警规则的模式。',
'type' => 'object',
'properties' => [
'Product' => [
'description' => '云服务名称的缩写。',
'type' => 'string',
'example' => 'CloudMonitor',
],
'LevelList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'LevelList' => [
'description' => '事件的等级列表。',
'type' => 'array',
'items' => [
'description' => '事件的等级。取值:'."\n"
."\n"
.'- CRITICAL:严重。'."\n"
."\n"
.'- WARN:警告。'."\n"
."\n"
.'- INFO:信息。',
'type' => 'string',
'example' => 'CRITICAL',
],
],
],
],
'EventTypeList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'EventTypeList' => [
'description' => '事件报警规则的类型列表。',
'type' => 'array',
'items' => [
'description' => '事件报警规则的类型。'."\n"
."\n"
.'`*`表示不限制报警规则类型。',
'type' => 'string',
'example' => '*',
],
],
],
],
'NameList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'NameList' => [
'description' => '事件名称列表。',
'type' => 'array',
'items' => [
'description' => '事件名称列表。',
'type' => 'string',
'example' => '["Agent_Status_Stopped"]',
],
],
],
],
'CustomFilters' => [
'description' => '自定义过滤条件。',
'type' => 'string',
'example' => 'ECS123',
],
'KeywordFilter' => [
'description' => '过滤关键词。',
'type' => 'object',
'properties' => [
'Keywords' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Keywords' => [
'description' => '事件匹配的关键字列表。',
'type' => 'array',
'items' => [
'description' => '关键字。',
'type' => 'string',
'example' => 'VMException',
],
],
],
],
'Relation' => [
'description' => '多个关键字的条件。取值:'."\n"
."\n"
.'- OR: 多个关键字之前是或的关系。'."\n"
.'- NOT:不包含关键字。表示匹配非关键字列表中的所有事件。',
'type' => 'string',
'example' => 'OR',
],
],
],
'SQLFilter' => [
'description' => '按照SQL过滤日志。如果符合条件,则触发报警。',
'type' => 'string',
'example' => 'ycccluster1 and (i-23ij0o82612 or Executed1) or Asimulated not 222',
],
],
],
],
],
],
'SilenceTime' => [
'description' => '通道沉默周期。',
'type' => 'integer',
'format' => 'int64',
'example' => '86400',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"User not authorized to operate on the specified resource.\\",\\n \\"RequestId\\": \\"D0E6D82B-16B5-422A-8136-EE5BDC01E415\\",\\n \\"Total\\": 21,\\n \\"Success\\": true,\\n \\"EventRules\\": {\\n \\"EventRule\\": [\\n {\\n \\"EventType\\": \\"SYSTEM\\",\\n \\"Description\\": \\"Default group event rule.\\",\\n \\"GroupId\\": \\"7378****\\",\\n \\"Name\\": \\"test_DefaultEventRule_7378****\\",\\n \\"State\\": \\"ENABLED\\",\\n \\"EventPattern\\": {\\n \\"EventPattern\\": [\\n {\\n \\"Product\\": \\"CloudMonitor\\",\\n \\"LevelList\\": {\\n \\"LevelList\\": [\\n \\"CRITICAL\\"\\n ]\\n },\\n \\"EventTypeList\\": {\\n \\"EventTypeList\\": [\\n \\"*\\"\\n ]\\n },\\n \\"NameList\\": {\\n \\"NameList\\": [\\n \\"[\\\\\\"Agent_Status_Stopped\\\\\\"]\\"\\n ]\\n },\\n \\"CustomFilters\\": \\"ECS123\\",\\n \\"KeywordFilter\\": {\\n \\"Keywords\\": {\\n \\"Keywords\\": [\\n \\"VMException\\"\\n ]\\n },\\n \\"Relation\\": \\"OR\\"\\n },\\n \\"SQLFilter\\": \\"ycccluster1 and (i-23ij0o82612 or Executed1) or Asimulated not 222\\"\\n }\\n ]\\n },\\n \\"SilenceTime\\": 86400\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tC8308712-6E7A-4FA0-82AC-80D018DAD168\\r\\n\\t3\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tCRITICAL\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tCloudMonitor\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tSYSTEM\\r\\n\\t\\t\\tENABLED\\r\\n\\t\\t\\ttest123\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tCRITICAL\\r\\n\\t\\t\\t\\t\\tWARN\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tDefault group event rule.\\r\\n\\t\\t\\tSYSTEM\\r\\n\\t\\t\\tENABLED\\r\\n\\t\\t\\ttest_DefaultEventRule_7378****\\r\\n\\t\\t\\t7378****\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tCRITICAL\\r\\n\\t\\t\\t\\t\\tWARN\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t*\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tDefault group event rule.\\r\\n\\t\\t\\tSYSTEM\\r\\n\\t\\t\\tENABLED\\r\\n\\t\\t\\ttest123_DefaultEventRule_7301****\\r\\n\\t\\t\\t7301****\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询事件报警规则列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeEventRuleTargetList' => [
'summary' => '查询事件规则列表',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '事件报警规则名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'testRule',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '87170bc7-e28a-4c93-b9bf-90a1dbe84736',
],
'ContactParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactParameter' => [
'description' => '报警联系组通知方式。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ContactGroupName' => [
'description' => '报警联系人组的名称。',
'type' => 'string',
'example' => '默认告警通知组',
],
'Level' => [
'description' => '通知级别。取值:'."\n"
."\n"
.'- 2:电话、短信、钉钉、Email。'."\n"
."\n"
.'- 3:短信、钉钉、Email。'."\n"
."\n"
.'- 4:钉钉、Email。'."\n"
."\n"
.'4:钉钉、Email。'."\n"
."\n"
.'4:钉钉、Email。'."\n",
'type' => 'string',
'example' => '3',
],
'Id' => [
'description' => '报警联系人组通知方式唯一标识。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
],
'FcParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'FCParameter' => [
'description' => '函数计算通知方式。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'ServiceName' => [
'description' => '函数计算服务名称。',
'type' => 'string',
'example' => 'service1',
],
'FunctionName' => [
'description' => '函数名称。',
'type' => 'string',
'example' => 'fcTest1',
],
'Arn' => [
'description' => 'ARN资源描述。'."\n"
."\n"
.'格式:`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下:'."\n"
."\n"
.'- Service:云产品code。'."\n"
."\n"
.'- Region:地域ID。'."\n"
."\n"
.'- Account:阿里云账号ID。'."\n"
."\n"
.'- ResourceType:资源类型。'."\n"
."\n"
.'- ResourceId:资源ID。',
'type' => 'string',
'example' => 'acs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***',
],
'Id' => [
'description' => '函数服务通知方式唯一标识。',
'type' => 'string',
'example' => '3',
],
'Region' => [
'description' => '函数计算服务对应的地域。',
'type' => 'string',
'example' => 'cn-qingdao',
],
],
],
],
],
],
'MnsParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MnsParameter' => [
'description' => '轻量消息队列(原 MNS)通知。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Queue' => [
'description' => '轻量消息队列(原 MNS)的名称。',
'type' => 'string',
'example' => 'testQueue',
],
'Arn' => [
'description' => 'ARN资源描述。'."\n"
."\n"
.'格式:`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下:'."\n"
."\n"
.'- Service:云服务Code。'."\n"
."\n"
.'- Region:地域ID。'."\n"
."\n"
.'- Account:阿里云账号ID。'."\n"
."\n"
.'- ResourceType:资源类型。'."\n"
."\n"
.'- ResourceId:资源ID。',
'type' => 'string',
'example' => 'acs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***',
],
'Region' => [
'description' => '轻量消息队列(原 MNS)对应的地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'Id' => [
'description' => '轻量消息队列(原 MNS)通知方式唯一标识。',
'type' => 'string',
'example' => '2',
],
'Topic' => [
'description' => '轻量消息队列(原 MNS)的主题。',
'type' => 'string',
'example' => 'topic_sample',
],
],
],
],
],
],
'WebhookParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'WebhookParameter' => [
'description' => 'URL回调通知方式。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Url' => [
'description' => '回调的URL地址。',
'type' => 'string',
'example' => 'http://www.aliyun.com',
],
'Method' => [
'description' => 'HTTP回调的请求方法。目前支持GET和POST方法。',
'type' => 'string',
'example' => 'GET',
],
'Protocol' => [
'description' => '协议类型。',
'type' => 'string',
'example' => 'HTTP',
],
'Id' => [
'description' => 'URL回调通知方式唯一标识。',
'type' => 'string',
'example' => '5',
],
],
],
],
],
],
'SlsParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'SlsParameter' => [
'description' => '日志服务(SLS)通知方式。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Project' => [
'description' => 'Project名称。',
'type' => 'string',
'example' => 'project_test',
],
'LogStore' => [
'description' => 'LogStore名称。',
'type' => 'string',
'example' => 'logstore_test',
],
'Arn' => [
'description' => 'ARN资源描述。'."\n"
."\n"
.'格式:`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下:'."\n"
."\n"
.'- Service:云服务Code。'."\n"
."\n"
.'- Region:地域ID。'."\n"
."\n"
.'- Account:阿里云账号ID。'."\n"
."\n"
.'- ResourceType:资源类型。'."\n"
."\n"
.'- ResourceId:资源ID。',
'type' => 'string',
'example' => 'acs:log:cn-hangzhou::project/cms-log-mo****/logstore/c***',
],
'Region' => [
'description' => 'Project对应的地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'Id' => [
'description' => '日志服务通知方式唯一标识。',
'type' => 'string',
'example' => '4',
],
],
],
],
],
],
'OpenApiParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'OpenApiParameters' => [
'description' => '回调API的参数含义。',
'type' => 'array',
'items' => [
'type' => 'object',
'properties' => [
'Action' => [
'description' => 'API名称。',
'type' => 'string',
'example' => 'PutLogs',
],
'Arn' => [
'description' => 'ARN资源描述。'."\n"
.'格式:`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下:'."\n"
.' - Service:阿里云产品。'."\n"
.' - Region:地域ID。'."\n"
.' - Account:阿里云账号ID。'."\n"
.' - ResourceType:资源类型。'."\n"
.' - ResourceId:资源ID。ARN资源描述。'."\n"
.'格式:`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下:'."\n"
.' - Service:阿里云产品。'."\n"
.' - Region:地域ID。'."\n"
.' - Account:阿里云账号ID。'."\n"
.' - ResourceType:资源类型。'."\n"
.' - ResourceId:资源ID。',
'type' => 'string',
'example' => 'acs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***',
],
'Id' => [
'description' => 'API回调通知方式的唯一标识。',
'type' => 'string',
'example' => '3',
],
'Product' => [
'description' => 'API对应的云产品ID。',
'type' => 'string',
'example' => 'log',
],
'Region' => [
'description' => '资源对应的地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'Role' => [
'description' => '角色名称。',
'type' => 'string',
'example' => 'MyRole',
],
'Version' => [
'description' => 'API的版本。',
'type' => 'string',
'example' => '2019-01-01',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"87170bc7-e28a-4c93-b9bf-90a1dbe84736\\",\\n \\"ContactParameters\\": {\\n \\"ContactParameter\\": [\\n {\\n \\"ContactGroupName\\": \\"默认告警通知组\\",\\n \\"Level\\": \\"3\\",\\n \\"Id\\": \\"1\\"\\n }\\n ]\\n },\\n \\"FcParameters\\": {\\n \\"FCParameter\\": [\\n {\\n \\"ServiceName\\": \\"service1\\",\\n \\"FunctionName\\": \\"fcTest1\\",\\n \\"Arn\\": \\"acs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***\\",\\n \\"Id\\": \\"3\\",\\n \\"Region\\": \\"cn-qingdao\\"\\n }\\n ]\\n },\\n \\"MnsParameters\\": {\\n \\"MnsParameter\\": [\\n {\\n \\"Queue\\": \\"testQueue\\",\\n \\"Arn\\": \\"acs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***\\",\\n \\"Region\\": \\"cn-hangzhou\\",\\n \\"Id\\": \\"2\\",\\n \\"Topic\\": \\"topic_sample\\"\\n }\\n ]\\n },\\n \\"WebhookParameters\\": {\\n \\"WebhookParameter\\": [\\n {\\n \\"Url\\": \\"http://www.aliyun.com\\",\\n \\"Method\\": \\"GET\\",\\n \\"Protocol\\": \\"HTTP\\",\\n \\"Id\\": \\"5\\"\\n }\\n ]\\n },\\n \\"SlsParameters\\": {\\n \\"SlsParameter\\": [\\n {\\n \\"Project\\": \\"project_test\\",\\n \\"LogStore\\": \\"logstore_test\\",\\n \\"Arn\\": \\"acs:log:cn-hangzhou::project/cms-log-mo****/logstore/c***\\",\\n \\"Region\\": \\"cn-hangzhou\\",\\n \\"Id\\": \\"4\\"\\n }\\n ]\\n },\\n \\"OpenApiParameters\\": {\\n \\"OpenApiParameters\\": [\\n {\\n \\"Action\\": \\"PutLogs\\",\\n \\"Arn\\": \\"acs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***\\",\\n \\"Id\\": \\"3\\",\\n \\"Product\\": \\"log\\",\\n \\"Region\\": \\"cn-hangzhou\\",\\n \\"Role\\": \\"MyRole\\",\\n \\"Version\\": \\"2019-01-01\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\t87170bc7-e28a-4c93-b9bf-90a1dbe84736\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t默认告警通知组\\r\\n\\t\\t\\t\\t3\\r\\n\\t\\t\\t\\t1\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tproject_test\\r\\n\\t\\t\\t\\tlogstore_test\\r\\n\\t\\t\\t\\tcn-hangzhou\\r\\n\\t\\t\\t\\tacs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***\\r\\n\\t\\t\\t\\t2\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t200\\r\\n","errorExample":""}]',
'title' => '查询指定事件报警规则的推送渠道',
'description' => '本文将提供一个示例,查询事件报警规则`testRule`的详情。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutEventRuleTargets' => [
'summary' => '调用PutEventRuleTargets接口添加或修改规则的推送渠道。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则的名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'testEventRule',
],
],
[
'name' => 'FcParameters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '函数计算通知方式。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'FunctionName' => [
'description' => '函数名称。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'fc-test',
],
'Region' => [
'description' => '函数服务对应的地域。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
'ServiceName' => [
'description' => '函数服务的服务名称。N的取值范围为1~5。',
'type' => 'string',
'required' => false,
'example' => 'fc-test',
],
'Id' => [
'description' => '规则发送目标的唯一标识。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 5,
],
],
[
'name' => 'ContactParameters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警联系组通知方式。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'ContactGroupName' => [
'description' => '报警联系人组的名称。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => '默认报警联系组',
],
'Id' => [
'description' => '规则发送目标的唯一标识。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => '2',
],
'Level' => [
'description' => '报警通知级别。N的取值范围:1~5。取值:'."\n"
."\n"
.'- 2:电话、短信、钉钉、邮箱'."\n"
."\n"
.'- 3:短信、钉钉、邮箱'."\n"
."\n"
.'- 4:钉钉、邮箱'."\n"
."\n"
.'4:钉钉、邮箱'."\n"
."\n"
.'4:钉钉、邮箱',
'type' => 'string',
'required' => false,
'example' => '4',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 5,
],
],
[
'name' => 'MnsParameters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '轻量消息队列(原 MNS)通知。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Region' => [
'description' => '轻量消息队列(原 MNS)对应的地域。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
'Queue' => [
'description' => '队列名称。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'queue1',
],
'Id' => [
'description' => '规则发送目标的唯一标识。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => '3',
],
'Topic' => [
'description' => '轻量消息队列(原 MNS)的主题。',
'type' => 'string',
'required' => false,
'example' => 'topic_sample',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 5,
],
],
[
'name' => 'WebhookParameters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => 'URL回调通知方式。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Protocol' => [
'description' => '协议名称。N的取值范围:1~5。取值:'."\n"
."\n"
.'- http'."\n"
.'- telnet'."\n"
.'- ping'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'http',
],
'Url' => [
'description' => '回调的URL。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'http://www.aliyun.com',
],
'Method' => [
'description' => 'HTTP回调的请求方法。N的取值范围:1~5。'."\n"
."\n"
.'目前仅支持GET和POST。',
'type' => 'string',
'required' => false,
'example' => 'GET',
],
'Id' => [
'description' => '规则发送目标的唯一标识。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => '4',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 5,
],
],
[
'name' => 'SlsParameters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '日志服务(SLS)通知方式。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'LogStore' => [
'description' => '日志服务对应的日志库。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'testlogstore',
],
'Region' => [
'description' => '日志服务对应的地域。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
'Project' => [
'description' => '日志服务对应的项目。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => 'testproject',
],
'Id' => [
'description' => '规则发送目标的唯一标识。N的取值范围:1~5。',
'type' => 'string',
'required' => false,
'example' => '5',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 5,
],
],
[
'name' => 'OpenApiParameters',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => 'API回调通知参数列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Action' => [
'description' => 'API名称。',
'type' => 'string',
'required' => false,
'example' => 'PutLogs',
],
'Arn' => [
'description' => '资源的ARN。N的取值范围:1~5。'."\n"
.'格式:`arn:acs:${Service}:${Region}:${Account}:${ResourceType}/${ResourceId}`。各字段含义如下:'."\n"
.' - Service:云产品。'."\n"
.' - Region:地域ID。'."\n"
.' - Account:阿里云账号ID。'."\n"
.' - ResourceType:资源类型。'."\n"
.' - ResourceId:资源ID。',
'type' => 'string',
'required' => false,
'example' => 'acs:log:cn-hangzhou::project/cms-log-mon***/logstore/cxxxx***',
],
'Id' => [
'description' => 'API回调通知方式的唯一标识。',
'type' => 'string',
'required' => false,
'example' => '3',
],
'Product' => [
'description' => 'API对应的云产品ID。',
'type' => 'string',
'required' => false,
'example' => 'log',
],
'Region' => [
'description' => '资源对应的地域。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
'Role' => [
'description' => '角色名称。',
'type' => 'string',
'required' => false,
'example' => 'MyRole',
],
'Version' => [
'description' => 'API的版本。',
'type' => 'string',
'required' => false,
'example' => '2019-01-01',
],
'JsonParams' => [
'description' => '报警回调的JSON格式参数。',
'type' => 'string',
'required' => false,
'example' => '{"customField1":"value1","customField2":"$.name"}',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 5,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '409C64DA-CF14-45DF-B463-471C790DD15A',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
'FailedParameterCount' => [
'description' => '错误参数数量统计。',
'type' => 'string',
'example' => '2',
],
'FailedContactParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactParameter' => [
'description' => '如果规则发送目标中包含创建错误的报警联系人组,则返回此参数。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'ContactGroupName' => [
'description' => '报警联系人组的名称。',
'type' => 'string',
'example' => '默认报警联系人组',
],
'Id' => [
'description' => '规则发送目标的ID。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'Level' => [
'description' => "\n"
.'报警通知级别。取值:'."\n"
."\n"
.'- 2:电话、短信、钉钉、邮箱'."\n"
."\n"
.'- 3:短信、钉钉、邮箱'."\n"
."\n"
.'- 4:钉钉、邮箱'."\n"
."\n"
.'4:钉钉、邮箱'."\n"
."\n"
.'4:钉钉、邮箱'."\n"
."\n",
'type' => 'string',
'example' => '4',
],
],
],
],
],
],
'FailedMnsParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'MnsParameter' => [
'description' => '如果规则发送目标中包含创建错误的轻量消息队列(原 MNS),则返回此参数。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Queue' => [
'description' => '队列的名称。',
'type' => 'string',
'example' => 'testQueue',
],
'Id' => [
'description' => '规则发送目标的ID。',
'type' => 'integer',
'format' => 'int32',
'example' => '2',
],
'Region' => [
'description' => '地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
],
],
],
],
],
'FailedFcParameters' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'FcParameter' => [
'description' => '如果规则发送目标中包含创建错误的函数服务,则返回此参数。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'ServiceName' => [
'description' => '函数服务的名称。',
'type' => 'string',
'example' => 'serviceTest1',
],
'FunctionName' => [
'description' => '函数名称。',
'type' => 'string',
'example' => 'functionTest1',
],
'Id' => [
'description' => '规则发送目标的ID。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Region' => [
'description' => '地域ID。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"409C64DA-CF14-45DF-B463-471C790DD15A\\",\\n \\"Success\\": true,\\n \\"FailedParameterCount\\": \\"2\\",\\n \\"FailedContactParameters\\": {\\n \\"ContactParameter\\": [\\n {\\n \\"ContactGroupName\\": \\"默认报警联系人组\\",\\n \\"Id\\": 2,\\n \\"Level\\": \\"4\\"\\n }\\n ]\\n },\\n \\"FailedMnsParameters\\": {\\n \\"MnsParameter\\": [\\n {\\n \\"Queue\\": \\"testQueue\\",\\n \\"Id\\": 2,\\n \\"Region\\": \\"cn-hangzhou\\"\\n }\\n ]\\n },\\n \\"FailedFcParameters\\": {\\n \\"FcParameter\\": [\\n {\\n \\"ServiceName\\": \\"serviceTest1\\",\\n \\"FunctionName\\": \\"functionTest1\\",\\n \\"Id\\": 1,\\n \\"Region\\": \\"cn-hangzhou\\"\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t681CC49A-DD28-4D11-B86F-19D3F71E0EAE\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '添加或修改规则的推送渠道',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutEventRule' => [
'summary' => '调用PutEventRule接口创建或修改事件的报警规则。',
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '事件报警规则名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'myRuleName',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '事件报警规则所属的应用分组ID。',
'type' => 'string',
'required' => false,
'example' => '7378****',
],
],
[
'name' => 'EventType',
'in' => 'query',
'schema' => [
'description' => '事件报警规则的类型。取值:'."\n"
."\n"
.'- SYSTEM:系统事件。'."\n"
.'- CUSTOM:自定义事件。',
'type' => 'string',
'required' => false,
'example' => 'SYSTEM',
'default' => 'SYSTEM',
'enum' => [
'SYSTEM',
'CUSTOM',
],
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '事件报警规则的描述。',
'type' => 'string',
'required' => false,
'example' => '事件报警测试',
],
],
[
'name' => 'State',
'in' => 'query',
'schema' => [
'description' => '事件报警规则的状态。取值:'."\n"
."\n"
.'- ENABLED:启用。'."\n"
.'- DISABLED:禁用。',
'type' => 'string',
'required' => false,
'example' => 'ENABLED',
'default' => 'ENABLED',
'enum' => [
'ENABLED',
'DISABLED',
],
],
],
[
'name' => 'EventPattern',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '事件报警规则的模式。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'EventTypeList' => [
'description' => '事件报警规则的类型。N的取值范围:1~50。取值:'."\n"
."\n"
.'- StatusNotification:故障通知。'."\n"
."\n"
.'- Exception:异常。'."\n"
."\n"
.'- Maintenance:运维。'."\n"
."\n"
.'- *:无限制。',
'type' => 'array',
'items' => [
'description' => '事件报警规则的类型。N的取值范围:1~50。取值:'."\n"
."\n"
.'- StatusNotification:故障通知。'."\n"
."\n"
.'- Exception:异常。'."\n"
."\n"
.'- Maintenance:运维。'."\n"
."\n"
.'- *:无限制。',
'type' => 'string',
'required' => false,
'example' => 'Exception',
],
'required' => false,
'example' => 'Exception',
'maxItems' => 5,
],
'StatusList' => [
'description' => '事件报警规则的状态。N的取值范围:1~50。',
'type' => 'array',
'items' => [
'description' => '事件报警规则的状态。N的取值范围:1~50。',
'type' => 'string',
'required' => false,
'example' => 'Failed',
],
'required' => false,
'example' => 'Failed',
'maxItems' => 5,
],
'Product' => [
'description' => '云服务类型。N的取值范围:1~50。'."\n"
."\n"
.'>关于事件报警规则支持的云服务,请参见[DescribeSystemEventMetaList](~~114972~~)。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
'LevelList' => [
'description' => '事件报警规则的等级。N的取值范围:1~50。取值:'."\n"
."\n"
.'- CRITICAL:严重。'."\n"
."\n"
.'- WARN:警告。'."\n"
."\n"
.'- INFO:信息。'."\n"
."\n"
.'- *:所有等级。'."\n",
'type' => 'array',
'items' => [
'description' => '事件报警规则的等级。N的取值范围:1~50。取值:'."\n"
."\n"
.'- CRITICAL:严重。'."\n"
."\n"
.'- WARN:警告。'."\n"
."\n"
.'- INFO:信息。'."\n"
."\n"
.'- *:所有等级。'."\n",
'type' => 'string',
'required' => false,
'example' => 'CRITICAL',
],
'required' => false,
'example' => 'CRITICAL',
'maxItems' => 5,
],
'NameList' => [
'description' => '事件报警规则的名称。N的取值范围:1~50。',
'type' => 'array',
'items' => [
'description' => '事件报警规则的名称。N的取值范围:1~50。',
'type' => 'string',
'required' => false,
'example' => 'Agent_Status_Stopped',
],
'required' => false,
'example' => 'Agent_Status_Stopped',
'maxItems' => 20,
],
'CustomFilters' => [
'description' => '事件过滤关键字。当事件内容包含该关键字时,自动触发报警。',
'type' => 'string',
'required' => false,
'example' => 'Stopping',
],
'SQLFilter' => [
'description' => 'SQL事件过滤。当事件内容满足SQL条件时,自动触发报警。'."\n"
.'> SQL事件过滤的语法与日志服务SLS的查询语法保持一致。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX and Executed',
],
],
'required' => false,
],
'required' => true,
'maxItems' => 50,
],
],
[
'name' => 'SilenceTime',
'in' => 'query',
'schema' => [
'description' => '通道沉默时间。单位:秒。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '86400',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'Data' => [
'description' => '创建或修改事件报警规则时,返回影响的行数。',
'type' => 'string',
'example' => '1',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '0B47C47B-E68A-4429-BB23-370E91889C7D',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"Data\\": \\"1\\",\\n \\"RequestId\\": \\"0B47C47B-E68A-4429-BB23-370E91889C7D\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\t0B47C47B-E68A-4429-BB23-370E91889C7D\\n\\t\\t1\\n\\t\\t200\\n\\t\\ttrue\\n","errorExample":""}]',
'title' => '创建或修改事件的报警规则',
'description' => '如果报警规则名称不存在,则创建新的报警规则;如果报警规则名称存在,则修改已有报警规则。'."\n"
."\n"
.'本文将提供一个示例,为云服务`ecs`创建一条事件报警规则`myRuleName`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutCustomEventRule' => [
'methods' => [
'post',
'get',
'put',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'systemTags' => [
'operationType' => 'create',
],
'parameters' => [
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。获取方法请参见[DescribeCustomEventAttribute](~~115262~~)。'."\n"
."\n"
.'> 0表示上报的自定义事件不属于任何一个应用分组。',
'type' => 'string',
'required' => true,
'example' => '7378****',
],
],
[
'name' => 'RuleId',
'in' => 'query',
'schema' => [
'description' => '报警规则ID。'."\n"
."\n"
.'> 如果报警规则ID已存在,则表示修改报警规则;如果报警规则ID不存在,则表示创建报警规则。',
'type' => 'string',
'required' => true,
'example' => 'CustomRuleId1',
],
],
[
'name' => 'RuleName',
'in' => 'query',
'schema' => [
'description' => '报警规则名称。',
'type' => 'string',
'required' => true,
'example' => 'CustomeRule',
],
],
[
'name' => 'EventName',
'in' => 'query',
'schema' => [
'description' => '自定义事件名称。获取方法请参见[DescribeCustomEventAttribute](~~115262~~)。',
'type' => 'string',
'required' => true,
'example' => 'HostDown',
],
],
[
'name' => 'ContactGroups',
'in' => 'query',
'schema' => [
'description' => '报警联系人组。多个联系人组之间用英文逗号(,)分隔。',
'type' => 'string',
'required' => true,
'example' => 'ECS_Group',
],
],
[
'name' => 'Webhook',
'in' => 'query',
'schema' => [
'description' => '报警发生回调时指定的URL地址,向URL发送POST请求。',
'type' => 'string',
'required' => false,
'example' => 'https://www.aliyun.com',
],
],
[
'name' => 'EffectiveInterval',
'in' => 'query',
'schema' => [
'description' => '报警规则生效的时间范围。取值范围:00:00-23:59。',
'type' => 'string',
'required' => false,
'example' => '00:00-23:59',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '自定义事件监控数据的聚合周期。单位:秒。取值为60或60的整数倍。默认值:300。',
'type' => 'string',
'required' => false,
'example' => '60',
'default' => '300',
],
],
[
'name' => 'EmailSubject',
'in' => 'query',
'schema' => [
'description' => '报警邮件主题。',
'type' => 'string',
'required' => false,
'example' => 'ECS实例',
],
],
[
'name' => 'Threshold',
'in' => 'query',
'schema' => [
'description' => '报警阈值。',
'type' => 'string',
'required' => true,
'example' => '99',
],
],
[
'name' => 'Level',
'in' => 'query',
'schema' => [
'description' => '报警级别。取值:'."\n"
.'- CRITICAL:严重。'."\n"
.'- WARN:警告。'."\n"
.'- INFO:信息。',
'type' => 'string',
'required' => true,
'example' => 'CRITICAL',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request has failed due to a temporary failure of the server.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'AD5DCD82-BD1C-405F-BAED-32302DE9F498',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
204 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
206 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
406 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
499 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The request has failed due to a temporary failure of the server.\\",\\n \\"RequestId\\": \\"AD5DCD82-BD1C-405F-BAED-32302DE9F498\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n\\tAD5DCD82-BD1C-405F-BAED-32302DE9F498\\n\\t200\\n\\ttrue\\n","errorExample":""}]',
'title' => '创建自定义事件报警规则',
'summary' => '调用PutCustomEventRule接口创建自定义事件报警规则。',
'description' => '调用本接口前,请先调用PutCustomEvent接口上报自定义事件的监控数据,详情请参见[PutCustomEvent](~~115012~~)。',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'CreateMetricRuleBlackList' => [
'summary' => '调用CreateMetricRuleBlackList接口创建报警黑名单策略。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的名称。',
'type' => 'string',
'required' => true,
'example' => 'Blacklist-01',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云服务的数据命名空间。'."\n"
."\n"
.'关于云服务的命名空间,请参见[云服务监控项](~~163515~~)。'."\n",
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '云服务的类型分类。例如:Redis有`kvstore_standard`(标准版)、`kvstore_sharding`(集群版)和`kvstore_splitrw`(读写分离版)等。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
],
[
'name' => 'ScopeType',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的生效范围。取值:'."\n"
."\n"
.'- USER(默认值):报警黑名单策略仅在当前阿里云账号中生效。'."\n"
."\n"
.'- GROUP:报警黑名单策略在指定应用分组中生效,您需要选择指定应用分组。'."\n"
.' 关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => false,
'example' => 'USER',
],
],
[
'name' => 'ScopeValue',
'in' => 'query',
'schema' => [
'description' => '应用分组ID列表。格式为JSON Array。'."\n"
."\n"
.'> 仅当`ScopeType`为`GROUP`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => '["67****","78****"]',
],
],
[
'name' => 'EnableStartTime',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略生效的开始时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1640237400000',
],
],
[
'name' => 'EnableEndTime',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略生效的结束时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1640608200000',
],
],
[
'name' => 'EffectiveTime',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的生效时间范围。'."\n"
."\n"
.'- 如果您未设置该参数,则报警黑名单策略永久有效。'."\n"
."\n"
.'- 如果您已设置该参数,则黑名单策略仅在指定的时间范围内有效。该参数有以下两种格式示例:'."\n"
.' - `03:00-04:59`:本地时间凌晨3点到凌5点(不包含05:00)报警黑名单策略有效。'."\n"
.' - `03:00-04:59 UTC+0700`:东7区时间凌晨3点到凌晨5点(不包含05:00)报警黑名单策略有效。',
'type' => 'string',
'required' => false,
'example' => '03:00-04:59',
],
],
[
'name' => 'Instances',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警黑名单策略中指定云服务的实例列表。',
'type' => 'array',
'items' => [
'description' => '报警黑名单策略中指定云服务的实例列表。'."\n"
."\n"
.'N的取值范围:1~100。',
'type' => 'string',
'required' => false,
'example' => '{"instanceId":"i-bp1ew0zfkjblsuwx****"}',
],
'required' => true,
'maxItems' => 100,
],
],
[
'name' => 'Metrics',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '实例中的监控指标。'."\n"
."\n"
.'- 如果您未设置该参数,则报警黑名单策略应用于指定云服务下的所有监控指标。'."\n"
."\n"
.'- 如果您已设置该参数,则黑名单策略仅应用于当前监控指标。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控指标名称。'."\n"
."\n"
.'N的取值范围:1~10。',
'type' => 'string',
'required' => true,
'example' => 'disk_utilization',
],
'Resource' => [
'description' => '实例的扩展维度信息。例如:`{"device":"C:"}`,表示对云服务器ECS实例下的所有C盘应用黑名单策略。'."\n"
."\n"
.'N的取值范围:1~10。',
'type' => 'string',
'required' => false,
'example' => '{"device":"C:"}',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 10,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The request has failed due to a temporary failure of the server.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '5C637FA3-3959-3352-8BE6-78CE2ED2D33D',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Id' => [
'description' => '报警黑名单策略的ID。',
'type' => 'string',
'example' => '93514c96-ceb8-47d8-8ee3-93b6d98b****',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The request has failed due to a temporary failure of the server.\\",\\n \\"RequestId\\": \\"5C637FA3-3959-3352-8BE6-78CE2ED2D33D\\",\\n \\"Success\\": true,\\n \\"Id\\": \\"93514c96-ceb8-47d8-8ee3-93b6d98b****\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 5C637FA3-3959-3352-8BE6-78CE2ED2D33D\\n 93514c96-ceb8-47d8-8ee3-93b6d98b****\\n true\\n","errorExample":""}]',
'title' => '创建报警黑名单策略',
'description' => '### 背景信息'."\n"
."\n"
.'- 报警黑名单是指云监控根据报警黑名单策略对报警通知进行屏蔽。当阈值报警规则中某个云服务的某个实例中的某个指标无需发送报警通知时,您可以为其设置报警黑名单策略,对报警通知进行屏蔽。'."\n"
."\n"
.'- 目前云监控仅支持为阈值指标设置报警黑名单策略,不支持系统事件。关于云监控支持的云服务和阈值指标,请参见[云服务监控项](~~163515~~)。'."\n"
."\n\n"
."\n",
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'ModifyMetricRuleBlackList' => [
'summary' => '调用ModifyMetricRuleBlackList接口修改报警黑名单策略。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的ID。'."\n"
."\n"
.'关于如何获取报警黑名单策略的ID,请参见[DescribeMetricRuleBlackList](~~457257~~)。',
'type' => 'string',
'required' => true,
'example' => '93514c96-ceb8-47d8-8ee3-93b6d98b****',
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的名称。',
'type' => 'string',
'required' => true,
'example' => 'Blacklist-02',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于云产品的命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '云产品分类。例如:Redis有`kvstore_standard`(标准版)、`kvstore_sharding`(集群版)和`kvstore_splitrw`(读写分离版)等。',
'type' => 'string',
'required' => true,
'example' => 'ecs',
],
],
[
'name' => 'ScopeType',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的生效范围。取值:'."\n"
."\n"
.'- USER:报警黑名单策略仅在当前阿里云账号中生效。'."\n"
."\n"
.'- GROUP(默认值):报警黑名单策略在指定应用分组中生效,您需要选择指定应用分组。'."\n"
.' 关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => false,
'example' => 'USER',
],
],
[
'name' => 'ScopeValue',
'in' => 'query',
'schema' => [
'description' => '应用分组ID列表。'."\n"
."\n"
.'> 仅当`ScopeType`为`GROUP`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => '["67****","78****"]',
],
],
[
'name' => 'EnableStartTime',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略生效的开始时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1640237400000',
],
],
[
'name' => 'EnableEndTime',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略生效的结束时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'required' => false,
'example' => '1640608200000',
],
],
[
'name' => 'EffectiveTime',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的生效时间范围。是否设置该参数的含义如下:'."\n"
."\n"
.'- 如果您未设置该参数,则报警黑名单策略永久有效。'."\n"
."\n"
.'- 如果您已设置该参数,则黑名单策略仅在指定的时间范围内有效。该参数有以下两种格式示例:'."\n"
.' - `03:00-04:59`:本地时间凌晨3点到凌晨5点(不包含05:00)报警黑名单策略有效。'."\n"
.' - `03:00-04:59 UTC+0700`:东7区时间凌晨3点到凌晨5点(不包含05:00)报警黑名单策略有效。',
'type' => 'string',
'required' => false,
'example' => '03:00-04:59',
],
],
[
'name' => 'Instances',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警黑名单策略中指定云服务的实例列表。',
'type' => 'array',
'items' => [
'description' => '报警黑名单策略中指定云服务的实例列表。'."\n"
."\n"
.'N的取值范围:1~100。',
'type' => 'string',
'required' => false,
'example' => '{"instancceId":"i-bp1ew0zfkjblsuwx****"}',
],
'required' => true,
'maxItems' => 100,
],
],
[
'name' => 'Metrics',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '实例中的监控指标。'."\n"
."\n"
.'- 如果您未设置该参数,则报警黑名单策略应用于指定云服务下的所有监控指标。'."\n"
."\n"
.'- 如果您已设置该参数,则黑名单策略仅应用于当前监控指标。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控指标名称。'."\n"
."\n"
.'N的取值范围:1~10。',
'type' => 'string',
'required' => true,
'example' => 'disk_utilization',
],
'Resource' => [
'description' => '实例的扩展维度信息。例如:`{"device":"C:"}`,表示对云服务器ECS实例下的所有C盘应用黑名单策略。'."\n"
."\n"
.'N的取值范围:1~10。',
'type' => 'string',
'required' => false,
'example' => '{"device":"C:"}',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '008773AE-1D86-3231-90F9-1AF7F808F9CE',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Count' => [
'description' => '成功修改报警黑名单策略的数量。',
'type' => 'string',
'example' => '1',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"008773AE-1D86-3231-90F9-1AF7F808F9CE\\",\\n \\"Success\\": true,\\n \\"Count\\": \\"1\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 008773AE-1D86-3231-90F9-1AF7F808F9CE\\n true\\n 1\\n","errorExample":""}]',
'title' => '修改报警黑名单策略',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DeleteMetricRuleBlackList' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'systemTags' => [
'operationType' => 'delete',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的ID。多个ID之间以半角逗号(,)分隔,且不能超过50个。'."\n"
."\n"
.'关于如何获取报警黑名单策略的ID,请参见[DescribeMetricRuleBlackList](~~457257~~)。'."\n"
."\n"
.'> 该参数也支持JSON Array格式,例如:`["a9ad2ac2-3ed9-11ed-b878-0242ac12****","5cb8a9a4-198f-4651-a353-f8b28788****"]`。',
'type' => 'string',
'required' => true,
'example' => 'a9ad2ac2-3ed9-11ed-b878-0242ac12****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'B88D233C-A004-3AB8-AD9C-30CBDD4440C5',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Count' => [
'description' => '成功删除的报警黑名单策略的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"B88D233C-A004-3AB8-AD9C-30CBDD4440C5\\",\\n \\"Success\\": true,\\n \\"Count\\": 1\\n}","errorExample":""},{"type":"xml","example":"\\n B88D233C-A004-3AB8-AD9C-30CBDD4440C5\\n true\\n 1\\n","errorExample":""}]',
'title' => '删除报警黑名单策略',
'summary' => '调用DeleteMetricRuleBlackList接口删除报警黑名单策略。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DescribeMetricRuleBlackList' => [
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '云服务的数据命名空间。'."\n"
."\n"
.'关于云服务的命名空间,请参见[云服务监控项](~~163515~~)。',
'type' => 'string',
'required' => false,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '当前页码。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示的记录条数。'."\n"
."\n"
.'默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '100',
],
],
[
'name' => 'Order',
'in' => 'query',
'schema' => [
'description' => '查询结果按时间的排序方式。取值:'."\n"
."\n"
.'- DESC(默认值):降序。'."\n"
."\n"
.'- ASC:升序。'."\n",
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => 'DESC',
],
],
[
'name' => 'Category',
'in' => 'query',
'schema' => [
'description' => '云服务分类。例如:Redis有`kvstore_standard`(标准版)、`kvstore_sharding`(集群版)和`kvstore_splitrw`(读写分离版)等。',
'type' => 'string',
'required' => false,
'example' => 'ecs',
],
],
[
'name' => 'Ids',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警黑名单策略的ID列表。',
'type' => 'array',
'items' => [
'description' => '报警黑名单策略的ID。',
'type' => 'string',
'required' => false,
'example' => 'a9ad2ac2-3ed9-11ed-b878-0242ac12****',
],
'required' => false,
'maxItems' => 20,
],
],
[
'name' => 'Name',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略名称。'."\n"
."\n"
.'该参数支持模糊查询。',
'type' => 'string',
'required' => false,
'example' => 'Blacklist-01',
],
],
[
'name' => 'ScopeType',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的生效范围。取值:'."\n"
."\n"
.'- USER:报警黑名单策略仅在当前阿里云账号中生效。'."\n"
."\n"
.'- GROUP:报警黑名单策略在指定应用分组中生效。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'USER',
],
],
[
'name' => 'IsEnable',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的启用状态。取值:'."\n"
."\n"
.'- true:启用。'."\n"
.'- false:禁用。'."\n",
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'InstanceIds',
'in' => 'query',
'allowEmptyValue' => false,
'style' => 'flat',
'schema' => [
'description' => '报警黑名单策略中的实例ID列表。'."\n"
."\n"
.'N的取值范围:0~10。',
'type' => 'array',
'items' => [
'description' => '报警黑名单策略中的实例ID。',
'type' => 'string',
'required' => false,
'example' => 'i-2ze2d6j5uhg20x47****',
],
'required' => false,
'maxItems' => 10,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'D63E76CB-29AA-5B9F-88CE-400A6F28D428',
],
'Total' => [
'description' => '报警黑名单策略的总条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'DescribeMetricRuleBlackList' => [
'description' => '报警黑名单策略列表。',
'type' => 'array',
'items' => [
'description' => '报警黑名单策略列表。',
'type' => 'object',
'properties' => [
'EffectiveTime' => [
'description' => '报警黑名单策略的生效时间范围。',
'type' => 'string',
'example' => '00:00-23:59',
],
'UpdateTime' => [
'description' => '修改报警黑名单策略的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1665718373000',
],
'CreateTime' => [
'description' => '创建报警黑名单策略的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1665714561000',
],
'ScopeType' => [
'description' => '报警黑名单策略的生效范围。取值:'."\n"
."\n"
.'- USER:报警黑名单策略仅在当前阿里云账号中生效。'."\n"
."\n"
.'- GROUP:报警黑名单策略在指定应用分组中生效。',
'type' => 'string',
'example' => 'USER',
],
'IsEnable' => [
'description' => '报警黑名单策略的状态。取值:'."\n"
."\n"
.'- true:启用。'."\n"
."\n"
.'- false:禁用。',
'type' => 'boolean',
'example' => 'true',
],
'Namespace' => [
'description' => '云服务的数据命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'Category' => [
'description' => '云服务分类。例如:Redis有`kvstore_standard`(标准版)、`kvstore_sharding`(集群版)和`kvstore_splitrw`(读写分离版)等。',
'type' => 'string',
'example' => 'ecs',
],
'EnableEndTime' => [
'description' => '报警黑名单策略的开始时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1640608200000',
],
'Name' => [
'description' => '报警黑名单策略的名称。',
'type' => 'string',
'example' => 'Blacklist-01',
],
'EnableStartTime' => [
'description' => '报警黑名单策略的结束时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1640237400000',
],
'Id' => [
'description' => '报警黑名单策略的ID。',
'type' => 'string',
'example' => '93514c96-ceb8-47d8-8ee3-93b6d98b****',
],
'Metrics' => [
'description' => '实例中的监控指标。',
'type' => 'array',
'items' => [
'description' => '实例中的监控指标。',
'type' => 'object',
'properties' => [
'Resource' => [
'description' => '实例的扩展维度信息。例如:`{"device":"C:"}`,表示对云服务器ECS实例下的所有C盘应用黑名单策略。',
'type' => 'string',
'example' => '[{"device":"C:"}]',
],
'MetricName' => [
'description' => '监控指标名称。'."\n",
'type' => 'string',
'example' => 'disk_utilization',
],
],
],
],
'Instances' => [
'description' => '报警黑名单策略中指定云服务的实例列表。',
'type' => 'array',
'items' => [
'description' => '报警黑名单策略中指定云服务的实例列表。',
'type' => 'string',
'example' => 'i-rj99xc6cptkk64ml****',
],
],
'ScopeValue' => [
'description' => '应用分组ID列表。',
'type' => 'array',
'items' => [
'description' => '应用分组ID列表。格式为JSON Array。'."\n"
."\n"
.'> 仅当`ScopeType`为`GROUP`时,显示该参数。',
'type' => 'string',
'example' => '["67****","78****"]',
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"D63E76CB-29AA-5B9F-88CE-400A6F28D428\\",\\n \\"Total\\": 1,\\n \\"Success\\": true,\\n \\"DescribeMetricRuleBlackList\\": [\\n {\\n \\"EffectiveTime\\": \\"00:00-23:59\\",\\n \\"UpdateTime\\": \\"1665718373000\\",\\n \\"CreateTime\\": \\"1665714561000\\",\\n \\"ScopeType\\": \\"USER\\",\\n \\"IsEnable\\": true,\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"Category\\": \\"ecs\\",\\n \\"EnableEndTime\\": 1640608200000,\\n \\"Name\\": \\"Blacklist-01\\",\\n \\"EnableStartTime\\": 1640237400000,\\n \\"Id\\": \\"93514c96-ceb8-47d8-8ee3-93b6d98b****\\",\\n \\"Metrics\\": [\\n {\\n \\"Resource\\": \\"[{\\\\\\"device\\\\\\":\\\\\\"C:\\\\\\"}]\\",\\n \\"MetricName\\": \\"disk_utilization\\"\\n }\\n ],\\n \\"Instances\\": [\\n \\"i-rj99xc6cptkk64ml****\\"\\n ],\\n \\"ScopeValue\\": [\\n \\"[\\\\\\"67****\\\\\\",\\\\\\"78****\\\\\\"]\\"\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n D63E76CB-29AA-5B9F-88CE-400A6F28D428\\n 1\\n \\n USER\\n \\n i-rj99xc6cptkk64ml****\\n \\n true\\n \\n disk_utilization\\n \\n \\n ecs\\n 1635714561000\\n 1635718373000\\n 93514c96-ceb8-47d8-8ee3-93b6d98b****\\n acs_ecs_dashboard\\n Blacklist-01\\n \\n true\\n","errorExample":""}]',
'title' => '查询报警黑名单策略列表',
'summary' => '调用DescribeMetricRuleBlackList接口查询报警黑名单策略列表。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'EnableMetricRuleBlackList' => [
'summary' => '调用EnableMetricRuleBlackList接口启用或禁用报警黑名单策略。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'high',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Id',
'in' => 'query',
'schema' => [
'description' => '报警黑名单策略的ID。多个ID之间以半角逗号(,)分隔,且不能超过50个。'."\n"
."\n"
.'关于如何获取报警黑名单策略的ID,请参见[DescribeMetricRuleBlackList](~~457257~~)。'."\n"
."\n"
.'> 该参数也支持JSON Array格式,例如:`["a9ad2ac2-3ed9-11ed-b878-0242ac12****","5cb8a9a4-198f-4651-a353-f8b28788****"]`。',
'type' => 'string',
'required' => true,
'example' => 'a9ad2ac2-3ed9-11ed-b878-0242ac12****',
],
],
[
'name' => 'IsEnable',
'in' => 'query',
'schema' => [
'description' => '启用或禁用报警黑名单策略。取值:'."\n"
."\n"
.'- true:启用。'."\n"
."\n"
.'- false(默认值):禁用。',
'type' => 'boolean',
'required' => true,
'example' => 'true',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'>200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '94869866-1621-3652-BBC9-72A47B2AC2F5',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Count' => [
'description' => '成功启用或禁用的报警黑名单策略的数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'AccessForbidden',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => 'ResourceConflict',
'errorMessage' => 'Concurrent modification of resources.',
],
[
'errorCode' => 'ResourceExist',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"94869866-1621-3652-BBC9-72A47B2AC2F5\\",\\n \\"Success\\": true,\\n \\"Count\\": 1\\n}","errorExample":""},{"type":"xml","example":"\\n 94869866-1621-3652-BBC9-72A47B2AC2F5\\n true\\n 1\\n","errorExample":""}]',
'title' => '启用或禁用报警黑名单策略',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DeleteContactGroup' => [
'summary' => '调用DeleteContactGroup接口删除报警联系人组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'ContactGroupName',
'in' => 'query',
'schema' => [
'description' => '报警联系组名称。',
'type' => 'string',
'required' => true,
'example' => '我的报警组',
'docRequired' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'F722BE59-2400-4A64-9C1A-AD886AED9A69',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
[
[
'errorCode' => 'ContactNotExists',
'errorMessage' => 'ContactGroupName Not Exists',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"F722BE59-2400-4A64-9C1A-AD886AED9A69\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n F722BE59-2400-4A64-9C1A-AD886AED9A69\\n true\\n 200\\n","errorExample":""}]',
'title' => '删除报警联系人组',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DeleteContact' => [
'summary' => '调用DeleteContact接口删除报警联系人。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'deprecated' => false,
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'ContactName',
'in' => 'query',
'schema' => [
'description' => '报警联系人姓名。',
'type' => 'string',
'required' => true,
'example' => '张三',
'docRequired' => true,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '50D4CFE1-01E5-4543-939C-18BC01E3EC1C',
],
'Success' => [
'description' => '操作是否成功。true表示成功,false表示失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
[
[
'errorCode' => 'ContactNotExists',
'errorMessage' => 'ContactName does not exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"50D4CFE1-01E5-4543-939C-18BC01E3EC1C\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 50D4CFE1-01E5-4543-939C-18BC01E3EC1C\\n true\\n 200\\n","errorExample":""}]',
'title' => '删除报警联系人',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeContactListByContactGroup' => [
'summary' => '调用DescribeContactListByContactGroup接口查询报警联系组中的报警联系人列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'ContactGroupName',
'in' => 'query',
'schema' => [
'description' => '报警联系组名称。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => 'CloudMonitor',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The group is not exists.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Contacts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Contact' => [
'description' => '报警联系人。',
'type' => 'array',
'items' => [
'description' => '报警联系人。',
'type' => 'object',
'properties' => [
'UpdateTime' => [
'description' => '更新报警联系人的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552323252000',
],
'Name' => [
'description' => '报警联系人的姓名。',
'type' => 'string',
'example' => 'Alice',
],
'CreateTime' => [
'description' => '创建报警联系人的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552314252000',
],
'Desc' => [
'description' => '报警联系组的描述。',
'type' => 'string',
'example' => 'ECS',
],
'Channels' => [
'description' => '报警通道。',
'type' => 'object',
'properties' => [
'Mail' => [
'description' => '报警联系人的Email地址。',
'type' => 'string',
'example' => 'alice@example.com',
],
'AliIM' => [
'description' => '报警联系人的旺旺名称。'."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => 'Alice',
],
'DingWebHook' => [
'description' => '报警联系人的钉钉机器人地址。',
'type' => 'string',
'example' => 'https://oapi.dingtalk.com/robot/send?access_token=9bf44f8189597d07dfdd7a123455ffc112****',
],
'SMS' => [
'description' => '报警联系人的手机号码。'."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => '1333333****',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The group is not exists.\\",\\n \\"RequestId\\": \\"06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83\\",\\n \\"Success\\": true,\\n \\"Contacts\\": {\\n \\"Contact\\": [\\n {\\n \\"UpdateTime\\": 1552323252000,\\n \\"Name\\": \\"Alice\\",\\n \\"CreateTime\\": 1552314252000,\\n \\"Desc\\": \\"ECS\\",\\n \\"Channels\\": {\\n \\"Mail\\": \\"alice@example.com\\",\\n \\"AliIM\\": \\"Alice\\",\\n \\"DingWebHook\\": \\"https://oapi.dingtalk.com/robot/send?access_token=9bf44f8189597d07dfdd7a123455ffc112****\\",\\n \\"SMS\\": \\"1333333****\\"\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t96B41DE5-6DC9-4FAF-A790-3D4AA17C1F09\\r\\n\\t\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t1604024233000\\r\\n\\t\\t\\t1604024233000\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\tAlice\\r\\n\\t\\t\\r\\n\\t\\r\\n\\t200\\r\\n\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询报警联系组中的报警联系人列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeContactGroupList' => [
'summary' => '调用DescribeContactGroupList接口查询报警联系组列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示记录条数。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
'default' => '100',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
'default' => '1',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。说明 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'RequestId' => [
'description' => '本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。',
'type' => 'string',
'example' => '916EE694-03C2-47B6-85EE-5054E3C168D3',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '22',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'ContactGroups' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactGroup' => [
'description' => '报警联系人组列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人组。',
'type' => 'string',
'example' => '云账号报警联系人',
],
],
],
],
'ContactGroupList' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactGroup' => [
'description' => '报警联系人组列表。',
'type' => 'array',
'items' => [
'description' => '报警联系人组。',
'type' => 'object',
'properties' => [
'Describe' => [
'description' => '报警联系组的描述信息。',
'type' => 'string',
'example' => 'Devops-运维组',
],
'UpdateTime' => [
'description' => '更新时间。',
'type' => 'integer',
'format' => 'int64',
'example' => '2025-03-04T02:12:06Z',
],
'CreateTime' => [
'description' => '创建时间',
'type' => 'integer',
'format' => 'int64',
'example' => '2023-06-07T03:52:30Z',
],
'EnabledWeeklyReport' => [
'description' => '是否启用了周报功能。',
'type' => 'boolean',
'example' => 'false',
],
'Name' => [
'description' => '名称。',
'type' => 'string',
'example' => 'name',
],
'EnableSubscribed' => [
'description' => '是否开启周报订阅功能。取值:'."\n"
."\n"
.'- true:是。'."\n"
."\n"
.'- false:否。',
'type' => 'boolean',
'example' => 'false',
],
'Contacts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Contact' => [
'description' => '联系人列表。',
'type' => 'array',
'items' => [
'description' => '联系人。',
'type' => 'string',
'example' => '135xxxx8066',
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
200 => [
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'User not authorized to operate on the specified resource.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"RequestId\\": \\"916EE694-03C2-47B6-85EE-5054E3C168D3\\",\\n \\"Total\\": 22,\\n \\"Success\\": true,\\n \\"ContactGroups\\": {\\n \\"ContactGroup\\": [\\n \\"云账号报警联系人\\"\\n ]\\n },\\n \\"ContactGroupList\\": {\\n \\"ContactGroup\\": [\\n {\\n \\"Describe\\": \\"Devops-运维组\\",\\n \\"UpdateTime\\": 0,\\n \\"CreateTime\\": 0,\\n \\"EnabledWeeklyReport\\": false,\\n \\"Name\\": \\"name\\",\\n \\"EnableSubscribed\\": false,\\n \\"Contacts\\": {\\n \\"Contact\\": [\\n \\"135xxxx8066\\"\\n ]\\n }\\n }\\n ]\\n }\\n}","type":"json"}]',
'title' => '查询报警联系组列表',
],
'DescribeContactList' => [
'summary' => '调用DescribeContactList接口查询报警联系人列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '每页显示的记录条数。'."\n"
."\n"
.'默认值:100。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '10',
'default' => '100',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '当前页码。'."\n"
."\n"
.'默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'example' => '1',
'default' => '1',
],
],
[
'name' => 'ContactName',
'in' => 'query',
'schema' => [
'description' => '报警联系人姓名。',
'type' => 'string',
'required' => false,
'example' => 'Alice',
],
],
[
'name' => 'ChanelType',
'in' => 'query',
'schema' => [
'description' => '报警类型。取值:'."\n"
."\n"
.'- SMS:短信。'."\n"
."\n"
.'- AliIM:阿里旺旺。'."\n"
."\n"
.'- Mail:邮件。'."\n"
."\n"
.'- DingWebHook:钉钉机器人。'."\n"
."\n\n",
'type' => 'string',
'required' => false,
'example' => 'Mail',
],
],
[
'name' => 'ChanelValue',
'in' => 'query',
'schema' => [
'description' => '报警类型的值。'."\n"
."\n"
.'> 仅当`ChanelType`设置为`Mail`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => 'Alice@example.com',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '15',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'Contacts' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'Contact' => [
'description' => '报警联系方式。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'UpdateTime' => [
'description' => '报警更新时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552356159000',
],
'Name' => [
'description' => '报警联系人姓名。',
'type' => 'string',
'example' => 'Alice',
],
'CreateTime' => [
'description' => '报警创建时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '1552356159000',
],
'Lang' => [
'description' => '报警的语言类型。取值:'."\n"
.'- zh-cn:简体中文。'."\n"
.'- en:英文。',
'type' => 'string',
'example' => 'zh-cn',
],
'Desc' => [
'description' => '描述信息。',
'type' => 'string',
'example' => 'ECS联系人',
],
'ContactGroups' => [
'type' => 'object',
'itemNode' => true,
'properties' => [
'ContactGroup' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '报警联系人组列表。',
'type' => 'string',
'example' => '{ "ContactGroup": [ "ECS_Group", "Jim" ] }',
],
],
],
],
'Channels' => [
'description' => '报警通知方式。',
'type' => 'object',
'properties' => [
'Mail' => [
'description' => '邮件地址。',
'type' => 'string',
'example' => 'Alice@example.com',
],
'AliIM' => [
'description' => '旺旺名称。',
'type' => 'string',
'example' => 'Alice',
],
'DingWebHook' => [
'description' => '钉钉机器人地址。',
'type' => 'string',
'example' => 'https://oapi.dingtalk.com/robot/send?access_token=9bf44f8189597d07dfdd7a123455ffc112****',
],
'SMS' => [
'description' => '手机号码。',
'type' => 'string',
'example' => '1333333****',
],
],
],
'ChannelsState' => [
'description' => '报警通道的状态。'."\n"
."\n"
.'因为短信、电话号码和Email需要激活以后才能使用,所以当添加或修改报警通道时,如果处于未激活状态,则为PENDING;如果处于激活状态,则为OK。'."\n"
."\n"
.'因为Email需要激活以后才能使用,所以当添加或修改报警通道时,如果处于未激活状态,则为PENDING;如果处于激活状态,则为OK。'."\n"
."\n"
.'因为Email需要激活以后才能使用,所以当添加或修改报警通道时,如果处于未激活状态,则为PENDING;如果处于激活状态,则为OK。'."\n"
."\n",
'type' => 'object',
'properties' => [
'Mail' => [
'description' => 'Email的状态。取值:'."\n"
.'- PENDING:对应报警通道未激活,激活后才能使用。'."\n"
.'- OK:对应报警通道正常,可正常报警。',
'type' => 'string',
'example' => 'PENDING',
],
'AliIM' => [
'description' => '旺旺名称的状态正常。'."\n"
."\n"
.'目前取值只支持:OK。OK表示旺旺名状态正常,对应的报警通道正常,可正常报警。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => 'OK',
],
'DingWebHook' => [
'description' => '钉钉机器人的状态正常。'."\n"
."\n"
.'目前取值只支持:OK。OK表示钉钉机器人状态正常,对应的报警通道正常,可正常报警。',
'type' => 'string',
'example' => 'OK',
],
'SMS' => [
'description' => '短信的状态。取值:'."\n"
.'- PENDING:对应报警通道未激活,激活后才能使用。'."\n"
.'- OK:对应报警通道正常,可正常报警。'."\n"
."\n"
.'> 该参数仅适用于中国站。',
'type' => 'string',
'example' => 'OK',
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameter',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"06D5ECC2-B9BE-42A4-8FA3-1A610FB08B83\\",\\n \\"Total\\": 15,\\n \\"Success\\": true,\\n \\"Contacts\\": {\\n \\"Contact\\": [\\n {\\n \\"UpdateTime\\": 1552356159000,\\n \\"Name\\": \\"Alice\\",\\n \\"CreateTime\\": 1552356159000,\\n \\"Lang\\": \\"zh-cn\\",\\n \\"Desc\\": \\"ECS联系人\\",\\n \\"ContactGroups\\": {\\n \\"ContactGroup\\": [\\n \\"{ \\\\\\"ContactGroup\\\\\\": [ \\\\t\\\\\\"ECS_Group\\\\\\", \\\\\\"Jim\\\\\\" ] }\\"\\n ]\\n },\\n \\"Channels\\": {\\n \\"Mail\\": \\"Alice@example.com\\",\\n \\"AliIM\\": \\"Alice\\",\\n \\"DingWebHook\\": \\"https://oapi.dingtalk.com/robot/send?access_token=9bf44f8189597d07dfdd7a123455ffc112****\\",\\n \\"SMS\\": \\"1333333****\\"\\n },\\n \\"ChannelsState\\": {\\n \\"Mail\\": \\"PENDING\\",\\n \\"AliIM\\": \\"OK\\",\\n \\"DingWebHook\\": \\"OK\\",\\n \\"SMS\\": \\"OK\\"\\n }\\n }\\n ]\\n }\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t\\tA1267F27-942F-40EE-9254-57FE16E3C9AB\\r\\n\\t\\t\\r\\n\\t\\t\\t\\r\\n\\t\\t\\t\\tContact Desc\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tECS_Group\\r\\n\\t\\t\\t\\t\\tJim\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\tPENDING\\r\\n\\t\\t\\t\\t\\tOK\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t1583307692000\\r\\n\\t\\t\\t\\t1589441072000\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\t\\talice@example.com\\r\\n\\t\\t\\t\\t\\t155*******\\r\\n\\t\\t\\t\\t\\r\\n\\t\\t\\t\\tAlice\\r\\n\\t\\t\\t\\tzh-cn\\r\\n\\t\\t\\t\\r\\n\\t\\t\\r\\n\\t\\t25\\r\\n\\t\\t200\\r\\n\\t\\ttrue\\r\\n","errorExample":""}]',
'title' => '查询报警联系人列表',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutContact' => [
'summary' => '调用PutContact接口创建或修改报警联系人信息。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'deprecated' => false,
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'ContactName',
'in' => 'query',
'schema' => [
'description' => '报警联系人姓名。',
'type' => 'string',
'required' => true,
'example' => 'Alice',
'docRequired' => true,
],
],
[
'name' => 'Describe',
'in' => 'query',
'schema' => [
'description' => '报警联系人描述详情。',
'type' => 'string',
'required' => true,
'example' => 'ECS_Instance',
'docRequired' => true,
],
],
[
'name' => 'Channels.SMS',
'in' => 'query',
'schema' => [
'description' => '手机号码。手机号码会收到一个激活链接, 激活之后您才会被加入到联系人中。'."\n"
."\n"
.'手机号码、邮箱、钉钉机器人和旺旺最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。'."\n",
'type' => 'string',
'required' => false,
'example' => '1333333****',
],
],
[
'name' => 'Channels.Mail',
'in' => 'query',
'schema' => [
'description' => 'Email地址。Email会收到一个激活链接, 激活之后您才会被加入到联系人中。'."\n"
."\n"
.'手机号码、邮箱、钉钉机器人和旺旺最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。',
'type' => 'string',
'required' => false,
'example' => 'test@aliyun.com',
],
],
[
'name' => 'Channels.AliIM',
'in' => 'query',
'schema' => [
'description' => '旺旺联系人。'."\n"
."\n"
.'手机号码、邮箱、钉钉机器人和旺旺最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。',
'type' => 'string',
'required' => false,
'example' => 'Jim',
],
],
[
'name' => 'Channels.DingWebHook',
'in' => 'query',
'schema' => [
'description' => '钉钉机器人。'."\n"
."\n"
.'手机号码、邮箱、钉钉机器人和旺旺最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。'."\n"
.'邮箱和钉钉机器人最少添加一种联系方式。',
'type' => 'string',
'required' => false,
'example' => 'https://oapi.dingtalk.com/robot/send?access_token=7d49515e8ebf21106a80a9cc4bb3d247771305d52fb15d6201234565****',
],
],
[
'name' => 'Lang',
'in' => 'query',
'schema' => [
'description' => '报警的语言类型。取值:'."\n"
.'- zh-cn:简体中文。'."\n"
.'- en:英文。'."\n"
."\n"
.'> 如果不设置该参数,则自动按照账号归属地域自动识别。',
'type' => 'string',
'required' => false,
'example' => 'zh-cn',
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The Request is not authorization.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '181C406E-9DE4-484C-9C61-37AE9A1A12EE',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"The Request is not authorization.\\",\\n \\"RequestId\\": \\"181C406E-9DE4-484C-9C61-37AE9A1A12EE\\",\\n \\"Success\\": true\\n}","errorExample":""},{"type":"xml","example":"\\n 200\\n 181C406E-9DE4-484C-9C61-37AE9A1A12EE\\n true\\n","errorExample":""}]',
'title' => '创建或修改报警联系人信息',
'requestParamsDescription' => ' ',
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'PutContactGroup' => [
'summary' => '调用PutContactGroup接口创建或修改报警联系组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'ContactGroupName',
'in' => 'query',
'schema' => [
'description' => '报警联系组名称。',
'type' => 'string',
'required' => true,
'example' => '考勤系统组',
],
],
[
'name' => 'Describe',
'in' => 'query',
'schema' => [
'description' => '报警联系组描述信息',
'type' => 'string',
'required' => false,
'example' => '告警测试',
],
],
[
'name' => 'EnableSubscribed',
'in' => 'query',
'schema' => [
'description' => '是否开启订阅功能。取值:'."\n"
."\n"
.'- true:是。'."\n"
."\n"
.'- false:否。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'ContactNames',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '报警联系人的名称。',
'type' => 'array',
'items' => [
'description' => '报警联系人的名称。',
'type' => 'string',
'required' => false,
'example' => 'lucy',
],
'required' => false,
'maxItems' => 100,
],
],
],
'responses' => [
200 => [
'schema' => [
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'Illegal parameters.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'B4E30DB6-F069-5D0B-A589-2A89F7D62A57',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied',
],
],
[
[
'errorCode' => 'ContactGroup.NotExists',
'errorMessage' => 'ContactGroup not exists',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Illegal parameters.\\",\\n \\"RequestId\\": \\"B4E30DB6-F069-5D0B-A589-2A89F7D62A57\\",\\n \\"Success\\": true\\n}","type":"json"}]',
'title' => '创建或修改报警联系组',
],
'CreateHybridMonitorNamespace' => [
'summary' => '调用CreateHybridMonitorNamespace接口创建指标仓库。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'格式:由小写字母、数字和短划线(-)组成。',
'type' => 'string',
'required' => true,
'example' => 'aliyun',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '指标仓库描述。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '阿里云产品指标仓库。',
],
],
[
'name' => 'Spec',
'in' => 'query',
'schema' => [
'description' => '数据存储时长。取值:'."\n"
."\n"
.'- cms.s1.large:数据存储时长15天。'."\n"
.'- cms.s1.xlarge:数据存储时长32天。'."\n"
.'- cms.s1.2xlarge:数据存储时长63天。'."\n"
.'- cms.s1.3xlarge(默认值):数据存储时长93天。'."\n"
.'- cms.s1.6xlarge:数据存储时长185天。'."\n"
.'- cms.s1.12xlarge:数据存储时长376天。'."\n"
."\n"
.'不同存储时长规格的价格,请参见[监控大盘](~~223532~~)中的**价格表**。'."\n"
."\n",
'type' => 'string',
'required' => false,
'docRequired' => false,
'enumValueTitles' => [
'cms.s1.large' => 'cms.s1.large',
'cms.s1.2xlarge' => 'cms.s1.2xlarge',
'cms.s1.xlarge' => 'cms.s1.xlarge',
'cms.s1.6xlarge' => 'cms.s1.6xlarge',
'cms.s1.3xlarge' => 'cms.s1.3xlarge',
],
'example' => 'cms.s1.3xlarge',
'enum' => [],
],
],
[
'name' => 'NamespaceType',
'in' => 'query',
'schema' => [
'description' => '监控数据的存储方案。取值:'."\n"
."\n"
.'- aliyun_prometheus:监控数据存储在 Prometheus 服务中。'."\n"
."\n"
.'> 关于监控数据的存储方案的更多信息,请参见[企业云监控的监控数据存储方案说明](~~2594921~~)。',
'type' => 'string',
'required' => false,
'example' => 'aliyun_prometheus',
],
],
[
'name' => 'NamespaceRegion',
'in' => 'query',
'schema' => [
'description' => '监控数据存储的地域。',
'type' => 'string',
'required' => false,
'example' => 'cn-hangzhou',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '调用结果。',
'type' => 'string',
'example' => 'Success',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Namespace.Existed',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3843D23A-FB9E-5DC8-BCCC-458768B79296',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"Success\\",\\n \\"Message\\": \\"Namespace.Existed\\",\\n \\"RequestId\\": \\"3843D23A-FB9E-5DC8-BCCC-458768B79296\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t3843D23A-FB9E-5DC8-BCCC-458768B79296\\r\\n\\tSuccess\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '创建指标仓库',
'description' => '## 前提条件'."\n"
.'请确保您已开通企业云监控。具体操作,请参见[开通企业云监控](~~250773~~)。'."\n"
."\n"
.'## 使用说明'."\n"
.'本文将提供一个示例,创建指标仓库`aliyun`,其数据存储时长为`cms.s1.3xlarge`。返回结果显示创建指标仓库成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'ModifyHybridMonitorNamespace' => [
'summary' => '调用ModifyHybridMonitorNamespace接口修改指标仓库。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'格式:由大写字母、小写字母、数字和短划线(-)组成。'."\n"
."\n"
.'关于如何获取指标仓库名称,请参见[DescribeHybridMonitorNamespaceList](~~428880~~)。',
'type' => 'string',
'required' => true,
'example' => 'aliyun',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '指标仓库描述。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '阿里云产品指标仓库。',
],
],
[
'name' => 'Spec',
'in' => 'query',
'schema' => [
'description' => '数据存储时长。取值:'."\n"
."\n"
.'- cms.s1.large:数据存储时长15天。'."\n"
.'- cms.s1.xlarge:数据存储时长32天。'."\n"
.'- cms.s1.2xlarge:数据存储时长63天。'."\n"
.'- cms.s1.3xlarge:数据存储时长93天。'."\n"
.'- cms.s1.6xlarge:数据存储时长185天。'."\n"
.'- cms.s1.12xlarge:数据存储时长376天。'."\n"
."\n"
.'不同存储时长规格的价格,请参见[监控大盘](~~223532~~)中的**价格表**。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'enumValueTitles' => [
'cms.s1.12xlarge' => 'cms.s1.12xlarge',
'cms.s1.large' => 'cms.s1.large',
'cms.s1.2xlarge' => 'cms.s1.2xlarge',
'cms.s1.6xlarge' => 'cms.s1.6xlarge',
'cms.s1.3xlarge' => 'cms.s1.3xlarge',
],
'example' => 'cms.s1.2xlarge',
'enum' => [],
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '调用结果。',
'type' => 'string',
'example' => 'Success',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => '%s',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'E190AB2E-7BF9-59B7-9DDC-7CB1782C5ECD',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"Success\\",\\n \\"Message\\": \\"%s\\",\\n \\"RequestId\\": \\"E190AB2E-7BF9-59B7-9DDC-7CB1782C5ECD\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\tE190AB2E-7BF9-59B7-9DDC-7CB1782C5ECD\\r\\n\\tSuccess\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '修改指标仓库',
'description' => '本文将提供一个示例,将指标仓库`aliyun`中的数据存储时长修改为`cms.s1.2xlarge`。返回结果显示修改指标仓库成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DeleteHybridMonitorNamespace' => [
'summary' => '调用DeleteHybridMonitorNamespace接口删除指标仓库。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'readAndWrite',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'关于如何获取指标仓库名称,请参见[DescribeHybridMonitorNamespaceList](~~428880~~)。',
'type' => 'string',
'required' => true,
'example' => 'aliyun',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '调用结果。',
'type' => 'string',
'example' => 'Success',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Namespace.NotFound',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '3843D23A-FB9E-5DC8-BCCC-458768B79296',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"Success\\",\\n \\"Message\\": \\"Namespace.NotFound\\",\\n \\"RequestId\\": \\"3843D23A-FB9E-5DC8-BCCC-458768B79296\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t3843D23A-FB9E-5DC8-BCCC-458768B79296\\r\\n\\tSuccess\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '删除指标仓库',
'description' => '> 如果指标仓库中存在数据接入任务,则不允许删除。'."\n"
."\n"
.'本文将提供一个示例,删除指标仓库`aliyun`。返回结果显示删除指标仓库成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DescribeHybridMonitorNamespaceList' => [
'summary' => '查询指标仓库列表,及其接入数据详情。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '10',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '1',
],
],
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '搜索关键字。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'aliyun',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'格式:由大写字母、小写字母、数字和短划线(-)组成。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'aliyun-test',
],
],
[
'name' => 'ShowTaskStatistic',
'in' => 'query',
'schema' => [
'description' => '是否显示阿里云产品的数据接入任务的配置详情和非阿里云产品的数据接入任务数量。取值:'."\n"
."\n"
.'- true:显示。'."\n"
.'- false(默认值):不显示。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '1EC450A4-3221-5148-B77E-2827576CFE48',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Code' => [
'description' => '调用结果。',
'type' => 'string',
'example' => 'Success',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Specified parameter PageSize is not valid.',
],
'PageSize' => [
'description' => '分页时每页显示的数据行数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'DescribeHybridMonitorNamespace' => [
'description' => '指标仓库详情。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Description' => [
'description' => '指标仓库描述。',
'type' => 'string',
'example' => 'aliyun-test',
],
'CreateTime' => [
'description' => '创建指标仓库的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1652682744000',
],
'Namespace' => [
'description' => '指标仓库名称。',
'type' => 'string',
'example' => 'aliyun-test',
],
'IsDelete' => [
'description' => '指标仓库是否已删除。取值:'."\n"
."\n"
.'- 0:未删除。'."\n"
.'- 1:已删除。',
'type' => 'integer',
'format' => 'int32',
'example' => '0',
],
'Id' => [
'description' => '指标仓库ID。',
'type' => 'string',
'example' => '3****',
],
'ModifyTime' => [
'description' => '最后一次修改指标仓库的时间戳。',
'type' => 'string',
'example' => '1652682744000',
],
'Detail' => [
'description' => '数据存储时长的详情。',
'type' => 'object',
'properties' => [
'Spec' => [
'description' => '数据存储时长。取值:'."\n"
."\n"
.'- cms.s1.large:数据存储时长15天。'."\n"
.'- cms.s1.xlarge:数据存储时长32天。'."\n"
.'- cms.s1.2xlarge:数据存储时长63天。'."\n"
.'- cms.s1.3xlarge:数据存储时长93天。'."\n"
.'- cms.s1.6xlarge:数据存储时长185天。'."\n"
.'- cms.s1.12xlarge:数据存储时长376天。',
'type' => 'string',
'example' => 'cms.s1.3xlarge',
],
'NamespaceRegion' => [
'description' => '监控数据存储的地域。'."\n"
."\n"
.'> 当您创建指标仓库时,如果`NamespaceType`选择`m_prom_user`,则显示该参数。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'SLSProject' => [
'description' => '监控数据所在的日志项目。'."\n"
."\n"
.'> 当您创建指标仓库时,如果`NamespaceType`选择`m_prom_user`,则显示该参数。',
'type' => 'string',
'example' => 'cms-hybrid-120886317861****-cn-hangzhou-a83d',
],
'PrometheusInstanceId' => [
'description' => '监控数据所在的 Prometheus 实例。'."\n"
."\n"
.'> 当您创建指标仓库时,如果`NamespaceType`选择`aliyun_prometheus`,则显示该参数。',
'type' => 'string',
'example' => 'rw-57******************7f',
],
],
],
'NotAliyunTaskNumber' => [
'description' => '非阿里云产品的数据接入任务数量。'."\n"
."\n",
'type' => 'integer',
'format' => 'int64',
'example' => '0',
],
'AliyunProductMetricList' => [
'description' => '阿里云产品的数据接入任务的配置详情。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'UserId' => [
'description' => '创建指标仓库的账号。',
'type' => 'integer',
'format' => 'int64',
'example' => '120886317861****',
],
'NamespaceList' => [
'description' => '指标仓库列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Namespace' => [
'description' => '阿里云产品数据命名空间。',
'type' => 'string',
'example' => 'acs_ecs_dashboard',
],
'MetricList' => [
'description' => '阿里云产品的监控项列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Period' => [
'description' => '监控项的采集周期。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int64',
'example' => '60',
],
'List' => [
'description' => '监控项列表。',
'type' => 'array',
'items' => [
'description' => '监控项。',
'type' => 'string',
'example' => '["cpu_total"]',
],
],
],
],
],
],
],
],
'YAMLConfig' => [
'description' => '接入企业云监控的阿里云产品的配置文件。'."\n"
."\n"
.'- namespace:阿里云产品的命名空间。'."\n"
.'- metric_list:阿里云服务的监控项。'."\n"
.'- dimension:企业云监控支持查询的阿里云服务的资源。dimension为空,表示监控所有资源。',
'type' => 'string',
'example' => 'products:- namespace: acs_ecs_dashboard metric_info: - metric_list: - cpu_total dimension: \'\'',
],
],
],
],
'NamespaceType' => [
'description' => '监控数据的存储方案。取值:'."\n"
."\n"
.'- m_prom_user:监控数据存储在日志服务中。'."\n"
."\n"
.'- m_prom_pool:监控数据存储在云监控提供的存储空间中。'."\n"
."\n"
.'- aliyun_prometheus:监控数据存储在 Prometheus 服务中。',
'type' => 'string',
'example' => 'aliyun_prometheus',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"1EC450A4-3221-5148-B77E-2827576CFE48\\",\\n \\"Success\\": \\"true\\",\\n \\"Code\\": \\"Success\\",\\n \\"Message\\": \\"Specified parameter PageSize is not valid.\\",\\n \\"PageSize\\": 10,\\n \\"PageNumber\\": 1,\\n \\"Total\\": 1,\\n \\"DescribeHybridMonitorNamespace\\": [\\n {\\n \\"Description\\": \\"aliyun-test\\",\\n \\"CreateTime\\": \\"1652682744000\\",\\n \\"Namespace\\": \\"aliyun-test\\",\\n \\"IsDelete\\": 0,\\n \\"Id\\": \\"3****\\",\\n \\"ModifyTime\\": \\"1652682744000\\",\\n \\"Detail\\": {\\n \\"Spec\\": \\"cms.s1.3xlarge\\",\\n \\"NamespaceRegion\\": \\"cn-hangzhou\\",\\n \\"SLSProject\\": \\"cms-hybrid-120886317861****-cn-hangzhou-a83d\\",\\n \\"PrometheusInstanceId\\": \\"rw-57******************7f\\"\\n },\\n \\"NotAliyunTaskNumber\\": 0,\\n \\"AliyunProductMetricList\\": [\\n {\\n \\"UserId\\": 0,\\n \\"NamespaceList\\": [\\n {\\n \\"Namespace\\": \\"acs_ecs_dashboard\\",\\n \\"MetricList\\": [\\n {\\n \\"Period\\": 60,\\n \\"List\\": [\\n \\"[\\\\\\"cpu_total\\\\\\"]\\"\\n ]\\n }\\n ]\\n }\\n ],\\n \\"YAMLConfig\\": \\"products:- namespace: acs_ecs_dashboard metric_info: - metric_list: - cpu_total dimension: \'\'\\"\\n }\\n ],\\n \\"NamespaceType\\": \\"aliyun_prometheus\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t1EC450A4-3221-5148-B77E-2827576CFE48\\r\\n\\t10\\r\\n\\t1\\r\\n\\t1\\r\\n\\t\\r\\n\\t\\t1652682744000\\r\\n\\t\\t\\r\\n\\t\\t1652682744000\\r\\n\\t\\t0\\r\\n\\t\\t3****\\r\\n\\t\\taliyun-test\\r\\n\\t\\t\\r\\n\\t\\t\\tcms.s1.3xlarge\\r\\n\\t\\t\\r\\n\\t\\r\\n\\tSuccess\\r\\n\\ttrue\\r\\n\\t","errorExample":""}]',
'title' => '查询指标仓库列表',
'description' => '本文将提供一个示例,查询当前账号下的所有指标仓库。返回结果显示,当前账号下只有一个指标仓库`aliyun-test`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'CreateHybridMonitorTask' => [
'summary' => '调用CreateHybridMonitorTask接口创建阿里云产品的数据接入任务或SLS日志的监控项。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'paid',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'关于如何获取指标仓库名称,请参见[DescribeHybridMonitorNamespaceList](~~428880~~)。',
'type' => 'string',
'required' => true,
'docRequired' => false,
'example' => 'aliyun',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '监控任务描述。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '阿里云产品数据接入任务。',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '监控任务名称。'."\n"
."\n"
.'- 当`TaskType`为`aliyun_fc`时,输入阿里云产品的数据接入任务名称。'."\n"
.'- 当`TaskType`为`aliyun_sls`时,输入SLS日志的监控项名称。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'aliyun_task',
],
],
[
'name' => 'TaskType',
'in' => 'query',
'schema' => [
'description' => '监控任务类型。取值:'."\n"
."\n"
.'- aliyun_fc:阿里云产品的数据接入任务。'."\n"
.'- aliyun_sls:SLS日志的监控项。',
'type' => 'string',
'required' => true,
'docRequired' => true,
'enumValueTitles' => [
'aliyun_fc' => 'aliyun_fc',
'aliyun_sls' => 'aliyun_sls',
],
'example' => 'aliyun_fc',
],
],
[
'name' => 'CollectTargetType',
'in' => 'query',
'schema' => [
'description' => '监控数据的采集目标类型。'."\n"
.'- 当`TaskType`为`aliyun_fc`时,输入`aliyun_fc`。'."\n"
.'- 当`TaskType`为`aliyun_sls`时,输入SLS日志的Logstore组名称。',
'type' => 'string',
'required' => true,
'example' => 'aliyun_fc',
],
],
[
'name' => 'CollectInterval',
'in' => 'query',
'schema' => [
'description' => '监控项的采集周期。取值:'."\n"
."\n"
.'- 15'."\n"
.'- 60(默认值)'."\n"
."\n"
.'单位:秒。'."\n"
."\n"
.'> 仅当`TaskType`为`aliyun_sls`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'enumValueTitles' => [
15 => '15',
60 => '60',
],
'example' => '60',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。'."\n"
."\n"
.'> 仅当`TaskType`为`aliyun_sls`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '3607****',
],
],
[
'name' => 'YARMConfig',
'in' => 'query',
'schema' => [
'description' => '接入企业云监控的阿里云产品的配置文件。'."\n"
."\n"
.'- namespace:阿里云产品的命名空间。关于如何查询阿里云产品的命名空间,请参见[DescribeMetricMetaList](~~98846~~)。'."\n"
.'- metric_list:阿里云服务的监控项。关于如何查询阿里云产品的监控项,请参见[DescribeMetricMetaList](~~98846~~)。'."\n"
."\n"
.'配置文件示例如下:'."\n"
."\n"
.'```'."\n"
.'products:'."\n"
.'- namespace: acs_ecs_dashboard'."\n"
.' metric_info:'."\n"
.' - metric_list:'."\n"
.' - cpu_total'."\n"
.' - cpu_idle'."\n"
.' - diskusage_utilization'."\n"
.' - CPUUtilization'."\n"
.' - DiskReadBPS'."\n"
.' - InternetOut'."\n"
.' - IntranetOut'."\n"
.' - cpu_system'."\n"
.'- namespace: acs_rds_dashboard'."\n"
.' metric_info:'."\n"
.' - metric_list:'."\n"
.' - MySQL_QPS'."\n"
.' - MySQL_TPS'."\n"
.'```'."\n"
.'> 当`TaskType`为`aliyun_fc`时,必须设置该参数。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'products:- namespace: acs_ecs_dashboard metric_info: - metric_list: - cpu_total',
],
],
[
'name' => 'TargetUserId',
'in' => 'query',
'schema' => [
'description' => '成员ID。'."\n"
."\n"
.'当您通过管理账号调用API时,可以选择将资源目录中的任意成员的阿里云产品接入企业云监控。通过资源目录实现企业跨账号统一监控目标阿里云产品。'."\n"
."\n"
.'> 仅当`TaskType`为`aliyun_fc`时,需要设置该参数。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '120886317861****',
],
],
[
'name' => 'AttachLabels',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '监控项的标签。'."\n"
."\n"
.'> 仅当`TaskType`为`aliyun_sls`时,需要设置该参数。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '监控项的标签值。',
'type' => 'string',
'required' => false,
'example' => 'testValue',
],
'Name' => [
'description' => '监控项的标签键。',
'type' => 'string',
'required' => false,
'example' => 'app_service',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 10,
],
],
[
'name' => 'TargetUserIdList',
'in' => 'query',
'schema' => [
'description' => '成员ID。多个成员ID之间用半角逗号(,)分隔。'."\n"
."\n"
.'> 仅当您通过管理账号调用本接口时,需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => '120886317861****',
],
],
[
'name' => 'SLSProcessConfig',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => 'SLS日志配置。'."\n"
."\n"
.'> 仅当`TaskType`为`aliyun_sls`时,需要设置该参数。',
'type' => 'object',
'properties' => [
'Filter' => [
'description' => 'SLS日志中参数的过滤条件。',
'type' => 'object',
'properties' => [
'Relation' => [
'description' => '多个参数过滤条件之间的关系。取值:'."\n"
."\n"
.'- and(默认值):满足所有过滤条件,才处理日志。'."\n"
.'- or:满足任意过滤条件,即可处理日志。',
'type' => 'string',
'required' => false,
'enumValueTitles' => [
'or' => 'or',
'and' => 'and',
],
'example' => 'and',
],
'Filters' => [
'description' => 'SLS日志中参数的过滤条件列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志中过滤的参数名称。',
'type' => 'string',
'required' => false,
'example' => 'code',
],
'Operator' => [
'description' => 'SLS日志中参数值的过滤方式。取值:'."\n"
.'- `contain`:包含。'."\n"
.'- `notContain`:不包含。'."\n"
.'- `>`:大于。'."\n"
.'- `<`:小于。'."\n"
.'- `=`:等于。'."\n"
.'- `!=`:不等于。'."\n"
.'- `>=`:大于等于。'."\n"
.'- `<=`:小于等于。',
'type' => 'string',
'required' => false,
'example' => '=',
'enum' => [
'>',
'>=',
'=',
'<=',
'<',
'!=',
'contain',
'notContain',
],
],
'Value' => [
'description' => 'SLS日志中参数的过滤值。',
'type' => 'string',
'required' => false,
'example' => '200',
],
],
'required' => false,
],
'required' => false,
],
],
'required' => false,
],
'Statistics' => [
'description' => 'SLS日志的统计方式。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志统计的参数名称。',
'type' => 'string',
'required' => false,
'example' => 'name',
],
'Function' => [
'description' => '在计算周期内根据选定的统计方法对日志数据进行聚合处理。取值:'."\n"
.'- count:计数。'."\n"
.'- sum:求和。'."\n"
.'- avg:平均值。'."\n"
.'- max:最大值。'."\n"
.'- min:最小值。'."\n"
.'- value:周期内采样。'."\n"
.'- countps:计算统计周期内指定字段求count后的每秒平均值。'."\n"
.'- sumps:计算统计周期内指定字段求sum后的每秒平均值。'."\n"
.'- distinct:去重后计算统计周期内指定字段出现的次数。'."\n"
.'- distribution:计算字段值在一个区间内的出现次数。'."\n"
.'- percentile:计算字段值的分布值,例如:P50。',
'type' => 'string',
'required' => false,
'example' => 'count',
],
'Alias' => [
'description' => 'SLS日志统计结果的别名。',
'type' => 'string',
'required' => false,
'example' => 'level_count',
'minLength' => 0,
'pattern' => '^[a-zA-Z_][a-zA-Z0-9_]{1,39}$',
],
'Parameter1' => [
'description' => 'SLS日志的统计值。'."\n"
."\n"
.'- 当`Function`为`distribution`时,表示统计区间的下限,例如:统计HttpCode的2XX数量,填写200。'."\n"
."\n"
.'- 当`Function`为`percentile`时,表示统计分布的百分位,例如:0.5表示P50。'."\n",
'type' => 'string',
'required' => false,
'example' => '200',
],
'Parameter2' => [
'description' => 'SLS日志的统计值。'."\n"
."\n"
.'> 仅当`Function`为`distribution`时,需要设置该参数。表示统计区间的上限,例如:统计HttpCode的2XX数量,填写299。'."\n",
'type' => 'string',
'required' => false,
'example' => '299',
],
],
'required' => false,
],
'required' => false,
],
'GroupBy' => [
'description' => '对数据进行空间维度聚合,相当于SQL中的Group By。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志统计的参数名称。',
'type' => 'string',
'required' => false,
'example' => 'code',
],
'Alias' => [
'description' => 'SLS日志统计结果的别名。',
'type' => 'string',
'required' => false,
'example' => 'ApiResult',
'pattern' => '^[a-zA-Z_][a-zA-Z0-9_]{1,39}$',
],
],
'required' => false,
],
'required' => false,
],
'Express' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Express' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果。',
'type' => 'string',
'required' => false,
'example' => 'success_count',
],
'Alias' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果的别名。',
'type' => 'string',
'required' => false,
'example' => 'SuccRate',
'pattern' => '^[a-zA-Z_][a-zA-Z0-9_]{1,39}$',
],
],
'required' => false,
],
'required' => false,
],
],
'required' => false,
],
],
[
'name' => 'CloudAccessId',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => '其他云厂商接入云监控的主账号ID列表。',
'type' => 'array',
'items' => [
'description' => '其他云厂商接入云监控的主账号ID。',
'type' => 'string',
'required' => false,
'example' => 'n5n9ik1b****',
],
'required' => false,
'maxItems' => 50,
'minItems' => 1,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'yamlConfigFail',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '28CEA2E0-3E90-51B2-A7E8-B1ED75534E49',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'TaskId' => [
'description' => '监控任务ID。',
'type' => 'integer',
'format' => 'int64',
'example' => '36****',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"yamlConfigFail\\",\\n \\"RequestId\\": \\"28CEA2E0-3E90-51B2-A7E8-B1ED75534E49\\",\\n \\"Success\\": \\"true\\",\\n \\"TaskId\\": 0\\n}","errorExample":""},{"type":"xml","example":"\\n\\t36****\\n\\t28CEA2E0-3E90-51B2-A7E8-B1ED75534E49\\n\\t200\\n\\ttrue\\n\\t","errorExample":""}]',
'title' => '创建监控任务',
'description' => '## 前提条件'."\n"
."\n"
.'- 请确保您已开通企业云监控。具体操作,请参见[开通企业云监控](~~250773~~)。'."\n"
."\n"
.'- 如果您需要创建SLS日志的监控项,请确保您已开通SLS日志服务,且已创建日志项目(Project)和日志库(Logstore)。具体操作,请参见[快速入门](~~54604~~)。'."\n"
."\n"
.'## 使用说明'."\n"
.'本文将提供一个示例,创建阿里云产品的数据接入任务`aliyun_task`,将云服务器ECS的监控项`cpu_total`接入指标仓库`aliyun`。返回结果显示,创建数据接入任务成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'ModifyHybridMonitorTask' => [
'summary' => '调用ModifyHybridMonitorTask接口修改SLS日志的监控项。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'update',
'riskType' => 'none',
'chargeType' => 'paid',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '监控任务ID。'."\n"
."\n"
.'关于如何获取监控任务ID,请参见[DescribeHybridMonitorTaskList](~~428624~~)。'."\n"
."\n",
'type' => 'string',
'required' => true,
'docRequired' => true,
'example' => '36****',
],
],
[
'name' => 'TaskName',
'in' => 'query',
'schema' => [
'description' => '监控任务名称。'."\n"
."\n"
.'关于如何获取监控任务ID,请参见[DescribeHybridMonitorTaskList](~~428624~~)。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'SLS_task',
],
],
[
'name' => 'Description',
'in' => 'query',
'schema' => [
'description' => '监控任务描述。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'SLS日志监控数据。',
],
],
[
'name' => 'CollectInterval',
'in' => 'query',
'schema' => [
'description' => '监控项的采集周期。取值:'."\n"
."\n"
.'- 15'."\n"
."\n"
.'- 60'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'required' => false,
'example' => '15',
],
],
[
'name' => 'AttachLabels',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => '监控项的标签。'."\n"
."\n",
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '监控项的标签值。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'testValue',
],
'Name' => [
'description' => '监控项的标签键。',
'type' => 'string',
'required' => false,
'example' => 'app_service',
],
],
'required' => false,
],
'required' => false,
'maxItems' => 10,
],
],
[
'name' => 'SLSProcessConfig',
'in' => 'query',
'style' => 'flat',
'schema' => [
'description' => 'SLS日志配置。'."\n"
."\n",
'type' => 'object',
'properties' => [
'Filter' => [
'description' => 'SLS日志中参数的过滤条件。'."\n"
."\n",
'type' => 'object',
'properties' => [
'Relation' => [
'description' => '多个参数过滤条件之间的关系。取值:'."\n"
."\n"
.'- and(默认值):满足所有过滤条件,才处理日志。'."\n"
.'- or:满足任意过滤条件,即可处理日志。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'and',
],
'Filters' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志中过滤的参数名称。'."\n"
."\n",
'type' => 'string',
'required' => false,
'example' => 'code',
],
'Operator' => [
'description' => 'SLS日志中参数值的过滤方式。取值:'."\n"
.'- `contain`:包含。'."\n"
.'- `notContain`:不包含。'."\n"
.'- `>`:大于。'."\n"
.'- `<`:小于。'."\n"
.'- `=`:等于。'."\n"
.'- `!=`:不等于。'."\n"
.'- `>=`:大于等于。'."\n"
.'- `<=`:小于等于。',
'type' => 'string',
'required' => false,
'example' => '=',
'enum' => [
'>',
'>=',
'=',
'<=',
'<',
'!=',
'contain',
'notContain',
],
],
'Value' => [
'description' => 'SLS日志中参数的过滤值。',
'type' => 'string',
'required' => false,
'example' => '200',
],
],
'required' => false,
],
'required' => false,
],
],
'required' => false,
],
'Statistics' => [
'description' => '无。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志统计的参数名称。',
'type' => 'string',
'required' => false,
'example' => 'name',
],
'Function' => [
'description' => '在计算周期内根据选定的统计方法对日志数据进行聚合处理。取值:'."\n"
.'- count:计数。'."\n"
.'- sum:求和。'."\n"
.'- avg:平均值。'."\n"
.'- max:最大值。'."\n"
.'- min:最小值。'."\n"
.'- value:周期内采样。'."\n"
.'- countps:计算统计周期内指定字段求count后的每秒平均值。'."\n"
.'- sumps:计算统计周期内指定字段求sum后的每秒平均值。'."\n"
.'- distinct:去重后计算统计周期内指定字段出现的次数。'."\n"
.'- distribution:计算字段值在一个区间内的出现次数。'."\n"
.'- percentile:计算字段值的分布值,例如:P50。',
'type' => 'string',
'required' => false,
'example' => 'count',
],
'Alias' => [
'description' => 'SLS日志统计结果的别名。',
'type' => 'string',
'required' => false,
'example' => 'level_count',
'minLength' => 0,
'pattern' => '^[a-zA-Z_][a-zA-Z0-9_]{1,39}$',
],
'Parameter1' => [
'description' => 'SLS日志的统计值。'."\n"
."\n"
.'- 当`Function`为`distribution`时,表示统计区间的下限,例如:统计HttpCode的2XX数量,填写200。'."\n"
."\n"
.'- 当`Function`为`percentile`时,表示统计分布的百分位,例如:0.5表示P50。'."\n",
'type' => 'string',
'required' => false,
'example' => '200',
],
'Parameter2' => [
'description' => 'SLS日志的统计值。'."\n"
."\n"
.'> 仅当`Function`为`distribution`时,需要设置该参数。表示统计区间的上限,例如:统计HttpCode的2XX数量,填写299。',
'type' => 'string',
'required' => false,
'example' => '299',
],
],
'required' => false,
],
'required' => false,
],
'GroupBy' => [
'description' => '对数据进行空间维度聚合,相当于SQL中的Group By。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志统计的参数名称。',
'type' => 'string',
'required' => false,
'example' => 'code',
],
'Alias' => [
'description' => 'SLS日志统计结果的别名。',
'type' => 'string',
'required' => false,
'example' => 'ApiResult',
'pattern' => '^[a-zA-Z_][a-zA-Z0-9_]{1,39}$',
],
],
'required' => false,
],
'required' => false,
],
'Express' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Express' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果。',
'type' => 'string',
'required' => false,
'example' => 'success_count',
],
'Alias' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果的别名。',
'type' => 'string',
'required' => false,
'example' => 'SuccRate',
'pattern' => '^[a-zA-Z_][a-zA-Z0-9_]{1,39}$',
],
],
'required' => false,
],
'required' => false,
],
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Invalid.SLSConfig',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '11145B76-566A-5D80-A8A3-FAD98D310079',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Invalid.SLSConfig\\",\\n \\"RequestId\\": \\"11145B76-566A-5D80-A8A3-FAD98D310079\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 11145B76-566A-5D80-A8A3-FAD98D310079\\n 200\\n true\\n","errorExample":""}]',
'title' => '修改监控任务',
'description' => '本文将提供一个示例,将SLS日志的监控任务`36****`的采集周期修改为`15`秒。返回结果显示,修改监控项成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DeleteHybridMonitorTask' => [
'summary' => '调用DeleteHybridMonitorTask接口删除阿里云产品的数据接入任务或SLS日志的监控项。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '监控任务ID。'."\n"
."\n"
.'关于如何获取监控任务ID,请参见[DescribeHybridMonitorTaskList](~~428624~~)。'."\n"
."\n"
.'> 当您删除SLS日志的监控项(即`TaskType`为`aliyun_sls`)时,必须设置该参数。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '36****',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'格式:由大写字母、小写字母、数字和短划线(-)组成。'."\n"
."\n"
.'> 当您删除阿里云产品的数据接入任务(即`TaskType`为`aliyun_fc`)时,必须设置该参数。',
'type' => 'string',
'required' => false,
'example' => 'aliyun',
],
],
[
'name' => 'TargetUserId',
'in' => 'query',
'schema' => [
'description' => '成员ID。'."\n"
."\n"
.'> 仅当您通过管理账号调用本接口删除成员的阿里云数据接入任务(即`TaskType`为`aliyun_fc`)时,需要设置该参数。',
'type' => 'string',
'required' => false,
'example' => '120886317861****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'null',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'D6B8103F-7BAD-5FEB-945F-71D991AB8834',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"null\\",\\n \\"RequestId\\": \\"D6B8103F-7BAD-5FEB-945F-71D991AB8834\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n D6B8103F-7BAD-5FEB-945F-71D991AB8834\\n 200\\n true\\n","errorExample":""}]',
'title' => '删除监控任务',
'description' => '本文将提供一个示例,删除监控任务`36****`。返回结果显示,删除监控任务成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DescribeHybridMonitorTaskList' => [
'summary' => '调用DescribeHybridMonitorTaskList接口查询数据接入任务列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '搜索关键字。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'task',
],
],
[
'name' => 'TaskId',
'in' => 'query',
'schema' => [
'description' => '监控任务ID。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '36****',
],
],
[
'name' => 'GroupId',
'in' => 'query',
'schema' => [
'description' => '应用分组ID。'."\n"
."\n"
.'关于如何获取应用分组ID,请参见[DescribeMonitorGroups](~~115032~~)。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '3607****',
],
],
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'关于如何获取指标仓库名称,请参见[DescribeHybridMonitorNamespaceList](~~428880~~)。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => 'aliyun',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:10。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '10',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'integer',
'format' => 'int32',
'required' => false,
'docRequired' => false,
'example' => '1',
],
],
[
'name' => 'IncludeAliyunTask',
'in' => 'query',
'schema' => [
'description' => '返回结果是否包含阿里云产品的数据接入任务。取值:'."\n"
."\n"
.'- true(默认值):包含。'."\n"
.'- false:不包含。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'TaskType',
'in' => 'query',
'schema' => [
'description' => '监控任务类型。取值:'."\n"
."\n"
.'- aliyun_fc:阿里云产品的数据接入任务。'."\n"
.'- aliyun_sls:SLS日志的监控项。',
'type' => 'string',
'required' => false,
'enumValueTitles' => [
'aliyun_sls' => 'aliyun_sls',
],
'example' => 'aliyun_fc',
],
],
[
'name' => 'TargetUserId',
'in' => 'query',
'schema' => [
'description' => '成员ID。'."\n"
."\n"
.'> 仅当您通过管理账号调用本接口删除成员的阿里云数据接入任务(即`TaskType`为`aliyun_fc`)时,需要设置该参数。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '120886317861****',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '11145B76-566A-5D80-A8A3-FAD98D310079',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '返回信息。'."\n"
."\n"
.'- 当操作成功时,返回`success`。'."\n"
.'- 当操作失败时,返回错误信息。',
'type' => 'string',
'example' => 'success',
],
'PageSize' => [
'description' => '分页时每页显示的数据行数。',
'type' => 'integer',
'format' => 'int32',
'example' => '10',
],
'PageNumber' => [
'description' => '页码。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'TaskList' => [
'description' => '监控任务列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'YARMConfig' => [
'description' => '接入企业云监控的阿里云产品的配置文件。'."\n"
."\n"
.'- namespace:阿里云产品的命名空间。'."\n"
.'- metric_list:阿里云服务的监控项。',
'type' => 'string',
'example' => 'products:- namespace: acs_ecs_dashboard metric_info: - metric_list: - cpu_total',
],
'CreateTime' => [
'description' => '创建监控任务的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1639382496000',
],
'TaskName' => [
'description' => '监控任务名称。',
'type' => 'string',
'example' => 'aliyun_task',
],
'Namespace' => [
'description' => '主机归属的指标仓库。',
'type' => 'string',
'example' => 'aliyun',
],
'UploadRegion' => [
'description' => '主机归属的地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'NetworkType' => [
'description' => '主机的网络类型。取值:'."\n"
."\n"
.'- `vpc`:专有网络。'."\n"
.'- `Internet`:公网。',
'type' => 'string',
'example' => 'vpc',
],
'CollectTimout' => [
'description' => '云监控插件采集主机监控数据的超时时间。取值:'."\n"
."\n"
.'- 0'."\n"
.'- 15'."\n"
.'- 30'."\n"
.'- 60'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '15',
],
'CollectTargetEndpoint' => [
'description' => '云监控插件采集主机监控数据的地址。',
'type' => 'string',
'example' => 'http://localhost',
],
'TaskType' => [
'description' => '监控任务类型。取值:'."\n"
."\n"
.'- aliyun_fc:阿里云产品的数据接入任务。'."\n"
.'- aliyun_sls:SLS日志的监控项。',
'type' => 'string',
'example' => 'aliyun_sls',
],
'MatchExpressRelation' => [
'description' => '监控任务的实例过滤条件。取值:'."\n"
."\n"
.'- or:或。'."\n"
.'- and:和。',
'type' => 'string',
'example' => 'or',
],
'Description' => [
'description' => '监控任务描述。',
'type' => 'string',
'example' => 'aliyun',
],
'GroupId' => [
'description' => '应用分组ID。',
'type' => 'string',
'example' => '3607****',
],
'CollectInterval' => [
'description' => '云监控插件采集主机监控数据的间隔时间。取值:'."\n"
."\n"
.'- 15'."\n"
.'- 30'."\n"
.'- 60'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int32',
'example' => '60',
],
'TargetUserId' => [
'description' => '成员ID。'."\n"
."\n"
.'> 仅当您通过管理账号调用本接口时,显示该参数。',
'type' => 'string',
'example' => '120886317861****',
],
'CollectTargetPath' => [
'description' => '云监控Agent采集的时候,采集的相对路径。',
'type' => 'string',
'example' => '/metrics',
],
'CollectTargetType' => [
'description' => '采集目标类型。包括:Spring、Tomcat、Nginx、Tengine、JVM、Redis和MySQL等。',
'type' => 'string',
'example' => 'nginx',
],
'TaskId' => [
'description' => '监控任务ID。',
'type' => 'string',
'example' => '36****',
],
'AttachLabels' => [
'description' => '监控任务的标签。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Name' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'key1',
],
'Value' => [
'description' => '标签值。',
'type' => 'string',
'example' => 'value1',
],
],
],
],
'MatchExpress' => [
'description' => '应用分组中实例的匹配条件。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Value' => [
'description' => '实例名称的值。',
'type' => 'string',
'example' => 'ECS_instance1',
],
'Name' => [
'description' => '实例名称。',
'type' => 'string',
'example' => 'name',
],
'Function' => [
'description' => '实例名称的匹配方法。取值:'."\n"
."\n"
.'- startWith:前缀。'."\n"
.'- endWith:后缀。'."\n"
.'- all:全部。'."\n"
.'- equals:等于。'."\n"
.'- contains:包含。'."\n"
.'- notContains:不包含。',
'type' => 'string',
'example' => 'all',
],
],
],
],
'Instances' => [
'description' => '分批采集监控数据的实例列表。',
'type' => 'array',
'items' => [
'description' => '实例ID。',
'type' => 'string',
'example' => 'i-hp368focau7dp0hw****',
],
],
'ExtraInfo' => [
'description' => '实例的附加信息。',
'type' => 'string',
'example' => 'test',
],
'LogFilePath' => [
'description' => '本地日志数据保存在云监控所在主机的指定路径。'."\n"
."\n"
.'- Windows:仅支持盘符开头,例如:`C:\\UserData\\log\\\\*.Log`(不支持通配路径)。'."\n"
.'- Linux:仅支持以“/”开头,例如:`/home/appdata/log/**/*.log`(`/**/`用于匹配appdata下的所有文件)。',
'type' => 'string',
'example' => 'C:\\UserData\\log\\*.Log',
],
'LogSplit' => [
'description' => '本地日志数据根据不同匹配模式的切分结果。'."\n"
."\n"
.'> 本地日志数据的匹配模式包括:完整正则模式、分隔符模式和JSON模式。',
'type' => 'string',
'example' => '{"type": "regex","regex": "\\\\d+\\\\.\\\\d+\\\\.\\\\d+\\\\.\\\\d+\\\\s+(\\\\d+)\\\\s+\\\\S+\\\\s+\\\\[\\\\d+/\\\\S+/\\\\d+:\\\\d+:\\\\d+:\\\\d+\\\\s+\\\\+\\\\d+\\\\]\\\\s+(\\\\S+)\\\\s+\\\\S+\\\\s+/\\\\S+/\\\\S+/\\\\S+\\\\s+(\\\\d+)","columns": [{"name": "field1"},{"name": "filed2","translate": {"default": "-","mappings": [{"from": "(\\\\w+)","to": "$1x","type": "regex"}]}},{"name": "filed3","translate": {"default": "-","mappings": [{"from": "NumberRange(100,300)","to": "true","type": "function"}]}}]}',
],
'LogProcess' => [
'description' => '本地日志监控计算方式。',
'type' => 'string',
'example' => '[{"metric": "metric1","filters": [{"column": "filed2","type": "include","values": ["222222"]}],"groupBys": [{"column": "filed3","name": "filed3"}],"calculates": [{"column": "field1","name": "avg","type": "avg"}]},{"metric": "metric2","filters": [{"column": "field1","type": "include","values": ["11111"]}],"groupBys": [{"column": "filed2","name": "filed2"}],"calculates": [{"column": "field1","name": "avg","type": "avg"}]}]',
],
'LogSample' => [
'description' => '本地日志数据的示例。',
'type' => 'string',
'example' => '{"logContent":"100.116.134.26 1119 - [13/Aug/2019:16:55:46 +0800] POST metrichub-cn-hongkong.aliyun.com /agent/metrics/putLines 200 0 \\"-\\" \\"127.0.0.1:7001\\" \\"Go-http-client/1.1\\" \\"-\\" \\"-\\" \\"0a98a21a15656865460656276e\\"","addData":{"field1":["1119","1119"],"filed2":["POSTx","POST"],"filed3":["true","200"]}}',
],
'SLSProcess' => [
'description' => 'SLS日志数据的配置信息。',
'type' => 'string',
'example' => '{"express": [],"filter": {"filters": [{"key": "task_type","operator": "=","value": "1"}]},"groupby": [{"alias": "isp","key": "isp","sqlKey": "t.`isp`","valueKey": "isp"}],"interval": 60,"labels": [{"name": "__cms_app__","type": 0,"value": "sitemonitor"}],"statistics": [{"alias": "http_dns_time_avg","function": "avg","key": "http_dns_time"}]}',
],
'SLSProcessConfig' => [
'description' => 'SLS日志配置。'."\n"
."\n"
.'> 仅当`TaskType`为`aliyun_sls`时,显示该参数。',
'type' => 'object',
'properties' => [
'Filter' => [
'description' => 'SLS日志中参数的过滤条件。',
'type' => 'object',
'properties' => [
'Relation' => [
'description' => '多个参数过滤条件之间的关系。取值:'."\n"
."\n"
.'- and(默认值):满足所有过滤条件,才处理日志。'."\n"
.'- or:满足任意过滤条件,即可处理日志。',
'type' => 'string',
'example' => 'and',
],
'Filters' => [
'description' => 'SLS日志中参数的过滤条件。',
'type' => 'array',
'items' => [
'description' => 'SLS日志中参数的过滤条件。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志中过滤的参数名称。',
'type' => 'string',
'example' => 'host',
],
'Operator' => [
'description' => 'SLS日志中参数值的过滤方式。取值:'."\n"
.'- `contain`:包含。'."\n"
.'- `notContain`:不包含。'."\n"
.'- `>`:大于。'."\n"
.'- `<`:小于。'."\n"
.'- `=`:等于。'."\n"
.'- `!=`:不等于。'."\n"
.'- `>=`:大于等于。'."\n"
.'- `<=`:小于等于。',
'type' => 'string',
'example' => '=',
],
'Value' => [
'description' => 'SLS日志中参数的过滤值。',
'type' => 'string',
'example' => '200',
],
],
],
],
],
],
'Statistics' => [
'description' => 'SLS日志的统计方式。',
'type' => 'array',
'items' => [
'description' => 'SLS日志的统计方式。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志统计的参数名称。',
'type' => 'string',
'example' => 'name',
],
'Function' => [
'description' => '在计算周期内根据选定的统计方法对日志数据进行聚合处理。取值:'."\n"
.'- count:计数。'."\n"
.'- sum:求和。'."\n"
.'- avg:平均值。'."\n"
.'- max:最大值。'."\n"
.'- min:最小值。'."\n"
.'- value:周期内采样。'."\n"
.'- countps:计算统计周期内指定字段求count后的每秒平均值。'."\n"
.'- sumps:计算统计周期内指定字段求sum后的每秒平均值。'."\n"
.'- distinct:去重后计算统计周期内指定字段出现的次数。'."\n"
.'- distribution:计算字段值在一个区间内的出现次数。'."\n"
.'- percentile:计算字段值的分布值,例如:P50。',
'type' => 'string',
'example' => 'count',
],
'Alias' => [
'description' => 'SLS日志统计结果的别名。',
'type' => 'string',
'example' => 'level_count',
],
'Parameter1' => [
'description' => 'SLS日志的统计值。'."\n"
."\n"
.'- 当`Function`为`distribution`时,表示统计区间的下限,例如:统计HttpCode的2XX数量,填写200。'."\n"
."\n"
.'- 当`Function`为`percentile`时,表示统计分布的百分位,例如:0.5表示P50。'."\n",
'type' => 'string',
'example' => '200',
],
'Parameter2' => [
'description' => 'SLS日志的统计值。'."\n"
."\n"
.'> 仅当`Function`为`distribution`时,需要设置该参数。表示统计区间的上限,例如:统计HttpCode的2XX数量,填写299。',
'type' => 'string',
'example' => '299',
],
],
],
],
'GroupBy' => [
'description' => '对数据进行空间维度聚合,相当于SQL中的Group By。',
'type' => 'array',
'items' => [
'description' => '对数据进行空间维度聚合,相当于SQL中的Group By。',
'type' => 'object',
'properties' => [
'SLSKeyName' => [
'description' => 'SLS日志统计的参数名称。',
'type' => 'string',
'example' => 'code',
],
'Alias' => [
'description' => 'SLS日志统计结果的别名。',
'type' => 'string',
'example' => 'ApiResult',
],
],
],
],
'Express' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果。',
'type' => 'array',
'items' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果。',
'type' => 'object',
'properties' => [
'Express' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果。',
'type' => 'string',
'example' => 'success_count',
],
'Alias' => [
'description' => 'SLS日志统计结果的扩展字段的四则运算结果的别名。',
'type' => 'string',
'example' => 'SuccRate',
],
],
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"RequestId\\": \\"11145B76-566A-5D80-A8A3-FAD98D310079\\",\\n \\"Success\\": \\"true\\",\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"success\\",\\n \\"PageSize\\": 10,\\n \\"PageNumber\\": 1,\\n \\"Total\\": 1,\\n \\"TaskList\\": [\\n {\\n \\"YARMConfig\\": \\"products:- namespace: acs_ecs_dashboard metric_info: - metric_list: - cpu_total\\",\\n \\"CreateTime\\": \\"1639382496000\\",\\n \\"TaskName\\": \\"aliyun_task\\",\\n \\"Namespace\\": \\"aliyun\\",\\n \\"UploadRegion\\": \\"cn-hangzhou\\",\\n \\"NetworkType\\": \\"vpc\\",\\n \\"CollectTimout\\": 15,\\n \\"CollectTargetEndpoint\\": \\"http://localhost\\",\\n \\"TaskType\\": \\"aliyun_sls\\",\\n \\"MatchExpressRelation\\": \\"or\\",\\n \\"Description\\": \\"aliyun\\",\\n \\"GroupId\\": \\"3607****\\",\\n \\"CollectInterval\\": 60,\\n \\"TargetUserId\\": \\"120886317861****\\",\\n \\"CollectTargetPath\\": \\"/metrics\\",\\n \\"CollectTargetType\\": \\"nginx\\",\\n \\"TaskId\\": \\"36****\\",\\n \\"AttachLabels\\": [\\n {\\n \\"Name\\": \\"key1\\",\\n \\"Value\\": \\"value1\\"\\n }\\n ],\\n \\"MatchExpress\\": [\\n {\\n \\"Value\\": \\"ECS_instance1\\",\\n \\"Name\\": \\"name\\",\\n \\"Function\\": \\"all\\"\\n }\\n ],\\n \\"Instances\\": [\\n \\"i-hp368focau7dp0hw****\\"\\n ],\\n \\"ExtraInfo\\": \\"test\\",\\n \\"LogFilePath\\": \\"C:\\\\\\\\UserData\\\\\\\\log\\\\\\\\*.Log\\",\\n \\"LogSplit\\": \\"{\\\\\\"type\\\\\\": \\\\\\"regex\\\\\\",\\\\\\"regex\\\\\\": \\\\\\"\\\\\\\\\\\\\\\\d+\\\\\\\\\\\\\\\\.\\\\\\\\\\\\\\\\d+\\\\\\\\\\\\\\\\.\\\\\\\\\\\\\\\\d+\\\\\\\\\\\\\\\\.\\\\\\\\\\\\\\\\d+\\\\\\\\\\\\\\\\s+(\\\\\\\\\\\\\\\\d+)\\\\\\\\\\\\\\\\s+\\\\\\\\\\\\\\\\S+\\\\\\\\\\\\\\\\s+\\\\\\\\\\\\\\\\[\\\\\\\\\\\\\\\\d+/\\\\\\\\\\\\\\\\S+/\\\\\\\\\\\\\\\\d+:\\\\\\\\\\\\\\\\d+:\\\\\\\\\\\\\\\\d+:\\\\\\\\\\\\\\\\d+\\\\\\\\\\\\\\\\s+\\\\\\\\\\\\\\\\+\\\\\\\\\\\\\\\\d+\\\\\\\\\\\\\\\\]\\\\\\\\\\\\\\\\s+(\\\\\\\\\\\\\\\\S+)\\\\\\\\\\\\\\\\s+\\\\\\\\\\\\\\\\S+\\\\\\\\\\\\\\\\s+/\\\\\\\\\\\\\\\\S+/\\\\\\\\\\\\\\\\S+/\\\\\\\\\\\\\\\\S+\\\\\\\\\\\\\\\\s+(\\\\\\\\\\\\\\\\d+)\\\\\\",\\\\\\"columns\\\\\\": [{\\\\\\"name\\\\\\": \\\\\\"field1\\\\\\"},{\\\\\\"name\\\\\\": \\\\\\"filed2\\\\\\",\\\\\\"translate\\\\\\": {\\\\\\"default\\\\\\": \\\\\\"-\\\\\\",\\\\\\"mappings\\\\\\": [{\\\\\\"from\\\\\\": \\\\\\"(\\\\\\\\\\\\\\\\w+)\\\\\\",\\\\\\"to\\\\\\": \\\\\\"$1x\\\\\\",\\\\\\"type\\\\\\": \\\\\\"regex\\\\\\"}]}},{\\\\\\"name\\\\\\": \\\\\\"filed3\\\\\\",\\\\\\"translate\\\\\\": {\\\\\\"default\\\\\\": \\\\\\"-\\\\\\",\\\\\\"mappings\\\\\\": [{\\\\\\"from\\\\\\": \\\\\\"NumberRange(100,300)\\\\\\",\\\\\\"to\\\\\\": \\\\\\"true\\\\\\",\\\\\\"type\\\\\\": \\\\\\"function\\\\\\"}]}}]}\\",\\n \\"LogProcess\\": \\"[{\\\\\\"metric\\\\\\": \\\\\\"metric1\\\\\\",\\\\\\"filters\\\\\\": [{\\\\\\"column\\\\\\": \\\\\\"filed2\\\\\\",\\\\\\"type\\\\\\": \\\\\\"include\\\\\\",\\\\\\"values\\\\\\": [\\\\\\"222222\\\\\\"]}],\\\\\\"groupBys\\\\\\": [{\\\\\\"column\\\\\\": \\\\\\"filed3\\\\\\",\\\\\\"name\\\\\\": \\\\\\"filed3\\\\\\"}],\\\\\\"calculates\\\\\\": [{\\\\\\"column\\\\\\": \\\\\\"field1\\\\\\",\\\\\\"name\\\\\\": \\\\\\"avg\\\\\\",\\\\\\"type\\\\\\": \\\\\\"avg\\\\\\"}]},{\\\\\\"metric\\\\\\": \\\\\\"metric2\\\\\\",\\\\\\"filters\\\\\\": [{\\\\\\"column\\\\\\": \\\\\\"field1\\\\\\",\\\\\\"type\\\\\\": \\\\\\"include\\\\\\",\\\\\\"values\\\\\\": [\\\\\\"11111\\\\\\"]}],\\\\\\"groupBys\\\\\\": [{\\\\\\"column\\\\\\": \\\\\\"filed2\\\\\\",\\\\\\"name\\\\\\": \\\\\\"filed2\\\\\\"}],\\\\\\"calculates\\\\\\": [{\\\\\\"column\\\\\\": \\\\\\"field1\\\\\\",\\\\\\"name\\\\\\": \\\\\\"avg\\\\\\",\\\\\\"type\\\\\\": \\\\\\"avg\\\\\\"}]}]\\",\\n \\"LogSample\\": \\"{\\\\\\"logContent\\\\\\":\\\\\\"100.116.134.26 1119 - [13/Aug/2019:16:55:46 +0800] POST metrichub-cn-hongkong.aliyun.com /agent/metrics/putLines 200 0 \\\\\\\\\\\\\\"-\\\\\\\\\\\\\\" \\\\\\\\\\\\\\"127.0.0.1:7001\\\\\\\\\\\\\\" \\\\\\\\\\\\\\"Go-http-client/1.1\\\\\\\\\\\\\\" \\\\\\\\\\\\\\"-\\\\\\\\\\\\\\" \\\\\\\\\\\\\\"-\\\\\\\\\\\\\\" \\\\\\\\\\\\\\"0a98a21a15656865460656276e\\\\\\\\\\\\\\"\\\\\\",\\\\\\"addData\\\\\\":{\\\\\\"field1\\\\\\":[\\\\\\"1119\\\\\\",\\\\\\"1119\\\\\\"],\\\\\\"filed2\\\\\\":[\\\\\\"POSTx\\\\\\",\\\\\\"POST\\\\\\"],\\\\\\"filed3\\\\\\":[\\\\\\"true\\\\\\",\\\\\\"200\\\\\\"]}}\\",\\n \\"SLSProcess\\": \\"{\\\\\\"express\\\\\\": [],\\\\\\"filter\\\\\\": {\\\\\\"filters\\\\\\": [{\\\\\\"key\\\\\\": \\\\\\"task_type\\\\\\",\\\\\\"operator\\\\\\": \\\\\\"=\\\\\\",\\\\\\"value\\\\\\": \\\\\\"1\\\\\\"}]},\\\\\\"groupby\\\\\\": [{\\\\\\"alias\\\\\\": \\\\\\"isp\\\\\\",\\\\\\"key\\\\\\": \\\\\\"isp\\\\\\",\\\\\\"sqlKey\\\\\\": \\\\\\"t.`isp`\\\\\\",\\\\\\"valueKey\\\\\\": \\\\\\"isp\\\\\\"}],\\\\\\"interval\\\\\\": 60,\\\\\\"labels\\\\\\": [{\\\\\\"name\\\\\\": \\\\\\"__cms_app__\\\\\\",\\\\\\"type\\\\\\": 0,\\\\\\"value\\\\\\": \\\\\\"sitemonitor\\\\\\"}],\\\\\\"statistics\\\\\\": [{\\\\\\"alias\\\\\\": \\\\\\"http_dns_time_avg\\\\\\",\\\\\\"function\\\\\\": \\\\\\"avg\\\\\\",\\\\\\"key\\\\\\": \\\\\\"http_dns_time\\\\\\"}]}\\",\\n \\"SLSProcessConfig\\": {\\n \\"Filter\\": {\\n \\"Relation\\": \\"and\\",\\n \\"Filters\\": [\\n {\\n \\"SLSKeyName\\": \\"host\\",\\n \\"Operator\\": \\"=\\",\\n \\"Value\\": \\"200\\"\\n }\\n ]\\n },\\n \\"Statistics\\": [\\n {\\n \\"SLSKeyName\\": \\"name\\",\\n \\"Function\\": \\"count\\",\\n \\"Alias\\": \\"level_count\\",\\n \\"Parameter1\\": \\"200\\",\\n \\"Parameter2\\": \\"299\\"\\n }\\n ],\\n \\"GroupBy\\": [\\n {\\n \\"SLSKeyName\\": \\"code\\",\\n \\"Alias\\": \\"ApiResult\\"\\n }\\n ],\\n \\"Express\\": [\\n {\\n \\"Express\\": \\"success_count\\",\\n \\"Alias\\": \\"SuccRate\\"\\n }\\n ]\\n }\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n\\t11145B76-566A-5D80-A8A3-FAD98D310079\\n\\t10\\n\\t1\\n\\t1\\n\\t\\n\\t\\t15\\n\\t\\t0\\n\\t\\t\\n\\t\\t36****\\n\\t\\t1639382496000\\n\\t\\t\\n\\t\\t\\n\\t\\taliyun\\n\\t\\t0\\n\\t\\t\\n\\t\\t{\\\\\\"express\\\\\\":[],\\\\\\"filter\\\\\\":{\\\\\\"filters\\\\\\":[]},\\\\\\"groupby\\\\\\":[],\\\\\\"interval\\\\\\":60,\\\\\\"labels\\\\\\":[],\\\\\\"statistics\\\\\\":[{\\\\\\"alias\\\\\\":\\\\\\"referer_count\\\\\\",\\\\\\"function\\\\\\":\\\\\\"count\\\\\\",\\\\\\"key\\\\\\":\\\\\\"referer\\\\\\"}]}\\n\\t\\t\\n\\t\\taliyun_task\\n\\t\\tunknown\\n\\t\\tvpc\\n\\t\\taliyun_sls\\n\\t\\t\\n\\t\\t\\n\\t\\n\\t200\\n\\ttrue\\n\\t","errorExample":""}]',
'title' => '查询数据接入任务列表',
'description' => '本文将提供一个示例,查询当前账号下的所有数据接入任务。返回结果显示,当前账号下只有一个数据接入任务`aliyun_task`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'PutHybridMonitorMetricData' => [
'summary' => '调用PutHybridMonitorMetricData接口将指定监控数据上报至企业云监控的指定指标仓库中。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'paid',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'关于如何获取指标仓库名称,请参见[DescribeHybridMonitorNamespaceList](~~428880~~)。',
'type' => 'string',
'required' => true,
'example' => 'default-aliyun',
],
],
[
'name' => 'MetricList',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'title' => '上报的监控数据',
'description' => '监控数据列表。'."\n"
."\n"
.'N的取值范围:1~100。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Name' => [
'title' => '指标名,只能是英文字母、数字、下划线',
'description' => '监控指标名称。'."\n"
."\n"
.'N的取值范围:1~100。'."\n"
."\n"
.'格式:由大写字母、小写字母、数字和下划线(_)组成。开头必须为大写字母或小写字母。',
'type' => 'string',
'required' => true,
'example' => 'CPU_Usage',
'maxLength' => 128,
'minLength' => 1,
'pattern' => '^[a-zA-Z_][a-zA-Z0-9_]*$',
],
'Labels' => [
'title' => '标签,Key只能是英文字母、数字、下划线',
'description' => '监控指标的标签列表。'."\n"
."\n"
.'N的取值范围:1~100。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Key' => [
'title' => '只能是英文字母、数字、下划线',
'description' => '监控指标的标签键。'."\n"
."\n"
.'N的取值范围:1~100。'."\n"
."\n"
.'格式:由大写字母、小写字母、数字和下划线(_)组成。开头必须为大写字母、小写字母或下划线。'."\n"
."\n"
.'> Key和Value必须同时设置。',
'type' => 'string',
'required' => false,
'example' => 'IP',
],
'Value' => [
'description' => '监控指标的标签值。'."\n"
."\n"
.'N的取值范围:1~100。'."\n"
."\n"
.'> Key和Value必须同时设置。',
'type' => 'string',
'required' => false,
'example' => '192.168.XX.XX',
],
],
'required' => false,
],
'required' => false,
'example' => 'app、ip、hostName等标识信息',
'maxItems' => 20,
],
'Value' => [
'title' => '监控值,浮点或整型',
'description' => '监控指标的取值。'."\n"
."\n"
.'N的取值范围:1~100。'."\n"
."\n"
.'格式:整数或浮点数。',
'type' => 'string',
'required' => true,
'example' => '90',
'pattern' => '^[0-9\\.]*$',
],
'TS' => [
'title' => '时间戳,unix毫秒数,如果不传会使用服务器时间',
'description' => '监控数据上报的时间戳。'."\n"
."\n"
.'N的取值范围:1~100。'."\n"
."\n"
.'单位:毫秒。默认值为当前时间。',
'type' => 'integer',
'format' => 'int64',
'required' => false,
'example' => '1640776119473',
],
],
'required' => true,
],
'required' => true,
'maxItems' => 100,
'minItems' => 1,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'title' => '返回code',
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'RequestId' => [
'title' => '请求的requestId',
'description' => '请求ID。',
'type' => 'string',
'example' => '5DB1CBCA-D14A-55FA-814F-B4DBD9735F68',
],
'ErrorDetail' => [
'title' => '不合法的指标信息',
'description' => '错误参数的详情。'."\n"
."\n"
.'如果您设置的请求参数不符合要求,则会显示错误参数的详情。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Index' => [
'title' => '错误数据在上报列表中的序号,从0开始',
'description' => '错误信息在数组中的位置。',
'type' => 'integer',
'format' => 'int64',
'example' => '0',
],
'ErrorMessage' => [
'title' => '错误信息',
'description' => '错误参数的提示信息。',
'type' => 'string',
'example' => 'label name :123 not match [a-zA-Z_][a-zA-Z0-9_]*',
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"RequestId\\": \\"5DB1CBCA-D14A-55FA-814F-B4DBD9735F68\\",\\n \\"ErrorDetail\\": [\\n {\\n \\"Index\\": 0,\\n \\"ErrorMessage\\": \\"label name :123 not match [a-zA-Z_][a-zA-Z0-9_]*\\"\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\r\\n\\t5DB1CBCA-D14A-55FA-814F-B4DBD9735F68\\r\\n\\t200\\r\\n\\t","errorExample":""}]',
'title' => '上报监控数据至指标仓库',
'description' => '## 前提条件'."\n"
.'请确保您已开通企业云监控。具体操作,请参见[开通企业云监控](~~250773~~)。'."\n"
."\n"
.'## 使用限制'."\n"
.'单次上报监控数据小于等于1 MB。'."\n"
."\n"
.'## 使用说明'."\n"
.'本文将提供一个示例,将监控指标`CPU_Usage`的监控数据上报至企业云监控的指标仓库`default-aliyun`中。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。'."\n"
."\n",
'responseParamsDescription' => ' ',
'extraInfo' => ' ',
],
'DescribeHybridMonitorDataList' => [
'summary' => '调用DescribeHybridMonitorDataList接口查询指定指标仓库中的监控数据。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'query',
'schema' => [
'description' => '指标仓库名称。'."\n"
."\n"
.'关于如何获取指标仓库名称,请参见[DescribeHybridMonitorNamespaceList](~~428880~~)。',
'type' => 'string',
'required' => true,
'docRequired' => false,
'example' => 'default-aliyun',
],
],
[
'name' => 'PromSQL',
'in' => 'query',
'schema' => [
'description' => '监控指标。'."\n"
."\n"
.'> 支持PromQL查询语句。',
'type' => 'string',
'required' => true,
'docRequired' => false,
'example' => 'AliyunEcs_cpu_total',
],
],
[
'name' => 'Start',
'in' => 'query',
'schema' => [
'description' => '开始时间戳。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => false,
'example' => '1653804865',
],
],
[
'name' => 'End',
'in' => 'query',
'schema' => [
'description' => '结束时间戳。'."\n"
."\n"
.'单位:秒。',
'type' => 'integer',
'format' => 'int64',
'required' => true,
'docRequired' => false,
'example' => '1653805225',
],
],
[
'name' => 'Period',
'in' => 'query',
'schema' => [
'description' => '监控数据的统计周期。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'required' => false,
'docRequired' => false,
'example' => '60',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'end timestamp must not be before start time.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => 'C240412F-3F5F-50E2-ACEC-DE808EF9C4BE',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
'TimeSeries' => [
'description' => '监控指标的时间线列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'MetricName' => [
'description' => '监控指标名称。',
'type' => 'string',
'example' => 'AliyunEcs_cpu_total',
],
'Labels' => [
'description' => '时间维度的标签。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'K' => [
'description' => '标签键。',
'type' => 'string',
'example' => 'instanceId',
],
'V' => [
'description' => '标签值。',
'type' => 'string',
'example' => 'i-rj99xc6cptkk64ml****',
],
],
],
],
'Values' => [
'description' => '时间点的值。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'V' => [
'description' => '监控指标的值。',
'type' => 'string',
'example' => '0.13',
],
'Ts' => [
'description' => '监控指标值对应的时间戳。'."\n"
."\n"
.'单位:秒。',
'type' => 'string',
'example' => '1653804865',
],
],
],
],
],
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'BadRequest',
'errorMessage' => 'Bad request.',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => 'Resources already exist.',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"end timestamp must not be before start time.\\",\\n \\"RequestId\\": \\"C240412F-3F5F-50E2-ACEC-DE808EF9C4BE\\",\\n \\"Success\\": \\"true\\",\\n \\"TimeSeries\\": [\\n {\\n \\"MetricName\\": \\"AliyunEcs_cpu_total\\",\\n \\"Labels\\": [\\n {\\n \\"K\\": \\"instanceId\\",\\n \\"V\\": \\"i-rj99xc6cptkk64ml****\\"\\n }\\n ],\\n \\"Values\\": [\\n {\\n \\"V\\": \\"0.13\\",\\n \\"Ts\\": \\"1653804865\\"\\n }\\n ]\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n\\t\\n\\t\\tAliyunEcs_cpu_total\\n\\t\\t\\n\\t\\t\\t0.13\\n\\t\\t\\t1653804865\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t0.13\\n\\t\\t\\t1653804925\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t0.13\\n\\t\\t\\t1653804985\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t0.17\\n\\t\\t\\t1653805045\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t0.23\\n\\t\\t\\t1653805105\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t0.2\\n\\t\\t\\t1653805165\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t0.13\\n\\t\\t\\t1653805225\\n\\t\\t\\n\\t\\t\\n\\t\\t\\trg-acfmw3ty5y7****\\n\\t\\t\\trmgroup_id\\n\\t\\t\\n\\t\\t\\n\\t\\t\\tESS\\n\\t\\t\\ttag_ess\\n\\t\\t\\n\\t\\t\\n\\t\\t\\thostname1\\n\\t\\t\\thostname\\n\\t\\t\\n\\t\\t\\n\\t\\t\\ti-rj99xc6cptkk64ml****\\n\\t\\t\\tinstanceId\\n\\t\\t\\n\\t\\t\\n\\t\\t\\tcn-hangzhou\\n\\t\\t\\tregionId\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t192.168.XX.XX\\n\\t\\t\\tipgroup\\n\\t\\t\\n\\t\\t\\n\\t\\t\\t120886317861****\\n\\t\\t\\tuserId\\n\\t\\t\\n\\t\\n\\tC240412F-3F5F-50E2-ACEC-DE808EF9C4BE\\n\\t200\\n\\ttrue\\n\\t","errorExample":""}]',
'title' => '查询指定指标仓库中的监控数据',
'description' => '## 前提条件'."\n"
.'请确保您已开通企业云监控。具体操作,请参见[开通企业云监控](~~250773~~)。'."\n"
."\n"
.'## 使用限制'."\n"
.'单次最多返回监控数据1.5 MB。如果返回数据过大,则查询失败,请您重新设置查询条件。'."\n"
."\n"
.'## 使用说明'."\n"
.'本文将提供一个示例,查询指标仓库`default-aliyun`中监控指标`AliyunEcs_cpu_total`在指定时间`1653804865`(2022-05-29 14:14:25)至`1653805225`(2022-05-29 14:20:25)内的监控数据。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'CreateHybridMonitorSLSGroup' => [
'summary' => '创建企业云监控sls分组',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'SLSGroupName',
'in' => 'query',
'schema' => [
'description' => 'Logstore组名称。'."\n"
."\n"
.'长度为2~32个字符,由大写字母、小写字母、数字和下划线(_)组成。开头必须为大写字母或小写字母。',
'type' => 'string',
'required' => true,
'example' => 'Logstore_test',
],
],
[
'name' => 'SLSGroupDescription',
'in' => 'query',
'schema' => [
'description' => 'Logstore组描述。',
'type' => 'string',
'required' => false,
'example' => '阿里云产品归属的Logstore组。',
],
],
[
'name' => 'SLSGroupConfig',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => 'Logstore组的配置信息。'."\n"
."\n"
.'N的取值范围:1~25。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSRegion' => [
'description' => '地域。'."\n"
."\n"
.'N的取值范围:1~25。',
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
'SLSProject' => [
'description' => '日志项目。'."\n"
."\n"
.'N的取值范围:1~25。',
'type' => 'string',
'required' => true,
'example' => 'aliyun-project',
],
'SLSLogstore' => [
'description' => '日志库。'."\n"
."\n"
.'N的取值范围:1~25。',
'type' => 'string',
'required' => true,
'example' => 'Logstore-ECS',
],
'SLSUserId' => [
'description' => '成员ID。'."\n"
."\n"
.'N的取值范围:1~25。'."\n"
."\n"
.'当您通过管理账号调用API时,可以选择将资源目录中的任意成员的阿里云产品接入企业云监控。通过资源目录实现企业跨账号统一监控目标阿里云产品。'."\n"
."\n"
.'> 如果目标成员初次使用云监控,则需要确保该成员已授权云监控服务关联角色(AliyunServiceRoleForCloudMonitor)。更多信息,请参见[云监控服务关联角色](~~170423~~)。',
'type' => 'string',
'required' => false,
'example' => '120886317861****',
],
],
'required' => true,
],
'required' => true,
'maxItems' => 30,
'minItems' => 1,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'Duplicate.SLSGroup',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '66683237-7126-50F8-BBF8-D67ACC919A17',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'ParameterInvalid',
'errorMessage' => 'The parameter is missing or invalid. %s',
],
],
403 => [
[
'errorCode' => 'InvalidAuthorization',
'errorMessage' => 'Permission denied.',
],
],
[
[
'errorCode' => 'ResourceNotFound',
'errorMessage' => 'The specified resource is not found.',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"Duplicate.SLSGroup\\",\\n \\"RequestId\\": \\"66683237-7126-50F8-BBF8-D67ACC919A17\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 66683237-7126-50F8-BBF8-D67ACC919A17\\n 200\\n true\\n","errorExample":""}]',
'title' => '为SLS日志的监控项创建Logstore组',
'description' => '### 前提条件'."\n"
.'请确保您已开通SLS日志服务,且已创建日志项目(Project)和日志库(Logstore)。具体操作,请参见[快速入门](~~54604~~)。'."\n"
."\n"
.'### 使用说明'."\n"
.'本文将提供一个示例,创建一个Logstore组`Logstore_test`,其中地域为`cn-hangzhou`、日志项目为`aliyun-project`,日志库为`Logstore-ECS`。返回结果显示,创建Logstore组成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'ModifyHybridMonitorSLSGroup' => [
'summary' => '调用ModifyHybridMonitorSLSGroup接口修改Logstore组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'create',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'SLSGroupName',
'in' => 'query',
'schema' => [
'description' => 'Logstore组名称。'."\n"
."\n"
.'关于如何获取Logstore组名称,请参见[DescribeHybridMonitorSLSGroup](~~429526~~)。'."\n"
."\n\n"
."\n\n",
'type' => 'string',
'required' => true,
'example' => 'Logstore_test',
],
],
[
'name' => 'SLSGroupDescription',
'in' => 'query',
'schema' => [
'description' => 'Logstore组描述。',
'type' => 'string',
'required' => false,
'example' => '阿里云产品归属的Logstore组。',
],
],
[
'name' => 'SLSGroupConfig',
'in' => 'query',
'style' => 'repeatList',
'schema' => [
'description' => 'Logstore组的配置信息。'."\n"
."\n"
.'N的取值范围:1~25。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSRegion' => [
'description' => '地域。'."\n"
."\n"
.'N的取值范围:1~25。'."\n"
."\n",
'type' => 'string',
'required' => true,
'example' => 'cn-hangzhou',
],
'SLSProject' => [
'description' => '日志项目。'."\n"
."\n"
.'N的取值范围:1~25。',
'type' => 'string',
'required' => true,
'example' => 'aliyun-project',
],
'SLSLogstore' => [
'description' => '日志库。'."\n"
."\n"
.'N的取值范围:1~25。',
'type' => 'string',
'required' => true,
'example' => 'Logstore-aliyun-all',
],
'SLSUserId' => [
'description' => '成员ID。'."\n"
."\n"
.'N的取值范围:1~25。'."\n"
."\n"
.'当您通过管理账号调用API时,可以选择将资源目录中的任意成员的阿里云产品接入企业云监控。通过资源目录实现企业跨账号统一监控目标阿里云产品。'."\n"
."\n"
.'> 如果目标成员初次使用云监控,则需要确保该成员已授权云监控服务关联角色(AliyunServiceRoleForCloudMonitor)。更多信息,请参见[云监控服务关联角色](~~170423~~)。',
'type' => 'string',
'required' => false,
'example' => '120886317861****',
],
],
'required' => true,
],
'required' => true,
'maxItems' => 30,
'minItems' => 1,
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'NotFound.SLSGroup',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '66683237-7126-50F8-BBF8-D67ACC919A17',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"NotFound.SLSGroup\\",\\n \\"RequestId\\": \\"66683237-7126-50F8-BBF8-D67ACC919A17\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 66683237-7126-50F8-BBF8-D67ACC919A17\\n 200\\n true\\n","errorExample":""}]',
'title' => '修改Logstore组',
'description' => '本文将提供一个示例,将Logstore组`Logstore_test`中地域`cn-hangzhou`下的日志项目`aliyun-project`中的日志库修改为`Logstore-aliyun-all`。返回结果显示,修改Logstore组成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DeleteHybridMonitorSLSGroup' => [
'summary' => '调用DeleteHybridMonitorSLSGroup接口删除Logstore组。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'write',
'systemTags' => [
'operationType' => 'delete',
'riskType' => 'none',
'chargeType' => 'free',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'SLSGroupName',
'in' => 'query',
'schema' => [
'description' => 'Logstore组名称。'."\n"
."\n"
.'关于如何获取Logstore组名称,请参见[DescribeHybridMonitorSLSGroup](~~429526~~)。',
'type' => 'string',
'required' => true,
'example' => 'Logstore_test',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'RESOURCE_NOT_FOUND',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '85198BFF-1DE6-556E-B6A4-C77C51C62B8D',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"RESOURCE_NOT_FOUND\\",\\n \\"RequestId\\": \\"85198BFF-1DE6-556E-B6A4-C77C51C62B8D\\",\\n \\"Success\\": \\"true\\"\\n}","errorExample":""},{"type":"xml","example":"\\n 85198BFF-1DE6-556E-B6A4-C77C51C62B8D\\n 200\\n true\\n","errorExample":""}]',
'title' => '删除Logstore组',
'description' => '本文将提供一个示例,删除Logstore组`Logstore_test`。返回结果显示,删除Logstore组成功。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DescribeHybridMonitorSLSGroup' => [
'summary' => '调用DescribeHybridMonitorSLSGroup接口查询Logstore组列表。',
'methods' => [
'post',
'get',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'systemTags' => [
'operationType' => 'get',
'riskType' => 'none',
'chargeType' => 'free',
],
'parameters' => [
[
'name' => 'Keyword',
'in' => 'query',
'schema' => [
'description' => '搜索关键字。',
'type' => 'string',
'required' => false,
'example' => 'Logstore',
],
],
[
'name' => 'PageSize',
'in' => 'query',
'schema' => [
'description' => '分页时每页显示的数据行数。'."\n"
."\n"
.'起始值:1。默认值:10。',
'type' => 'string',
'required' => false,
'example' => '10',
],
],
[
'name' => 'PageNumber',
'in' => 'query',
'schema' => [
'description' => '页码。'."\n"
."\n"
.'起始值:1。默认值:1。',
'type' => 'string',
'required' => false,
'example' => '1',
],
],
[
'name' => 'SLSGroupName',
'in' => 'query',
'schema' => [
'description' => 'Logstore组名称。',
'type' => 'string',
'required' => false,
'example' => 'Logstore_test',
],
],
],
'responses' => [
200 => [
'schema' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'string',
'example' => '200',
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'NotFound.SLSGroup',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '66683237-7126-50F8-BBF8-D67ACC919A17',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
.'- false:失败。',
'type' => 'string',
'example' => '无。',
],
'List' => [
'description' => 'Logstore组列表。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSGroupName' => [
'description' => 'Logstore组名称。',
'type' => 'string',
'format' => 'int64',
'example' => 'Logstore_test',
],
'SLSGroupDescription' => [
'description' => 'Logstore组描述。',
'type' => 'string',
'example' => '阿里云产品归属的Logstore组。',
],
'SLSGroupConfig' => [
'description' => 'Logstore组的配置信息。',
'type' => 'array',
'items' => [
'description' => '无。',
'type' => 'object',
'properties' => [
'SLSRegion' => [
'description' => '地域。',
'type' => 'string',
'example' => 'cn-hangzhou',
],
'SLSProject' => [
'description' => '日志项目。',
'type' => 'string',
'example' => 'aliyun-project',
],
'SLSLogstore' => [
'description' => '日志库。',
'type' => 'string',
'example' => 'Logstore-aliyun-all',
],
'SLSUserId' => [
'description' => '成员ID。'."\n"
."\n"
.'> 当您通过管理账号调用API时,显示该参数。'."\n",
'type' => 'string',
'example' => '120886317861****',
],
],
],
],
'CreateTime' => [
'description' => '创建Logstore组的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1652845630000',
],
'UpdateTime' => [
'description' => '修改Logstore组的时间戳。'."\n"
."\n"
.'单位:毫秒。',
'type' => 'string',
'example' => '1652845630000',
],
],
],
],
'PageSize' => [
'description' => '分页时每页显示的数据行数。',
'type' => 'integer',
'format' => 'int64',
'example' => '10',
],
'PageNumber' => [
'description' => '页面。',
'type' => 'integer',
'format' => 'int64',
'example' => '1',
],
'Total' => [
'description' => '总记录条数。',
'type' => 'integer',
'format' => 'int64',
'example' => '2',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
409 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
412 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
[
'errorCode' => 'InternalError',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Code\\": \\"200\\",\\n \\"Message\\": \\"NotFound.SLSGroup\\",\\n \\"RequestId\\": \\"66683237-7126-50F8-BBF8-D67ACC919A17\\",\\n \\"Success\\": \\"无。\\",\\n \\"List\\": [\\n {\\n \\"SLSGroupName\\": 0,\\n \\"SLSGroupDescription\\": \\"阿里云产品归属的Logstore组。\\",\\n \\"SLSGroupConfig\\": [\\n {\\n \\"SLSRegion\\": \\"cn-hangzhou\\",\\n \\"SLSProject\\": \\"aliyun-project\\",\\n \\"SLSLogstore\\": \\"Logstore-aliyun-all\\",\\n \\"SLSUserId\\": \\"120886317861****\\"\\n }\\n ],\\n \\"CreateTime\\": \\"1652845630000\\",\\n \\"UpdateTime\\": \\"1652845630000\\"\\n }\\n ],\\n \\"PageSize\\": 10,\\n \\"PageNumber\\": 1,\\n \\"Total\\": 2\\n}","errorExample":""},{"type":"xml","example":"\\n 66683237-7126-50F8-BBF8-D67ACC919A17\\n 10\\n 1\\n 2\\n \\n 1652845630000\\n Logstore_test\\n 1652845630000\\n \\n \\n aliyun-project\\n cn-hangzhou\\n Logstore-aliyun-all\\n \\n
\\n \\n 1649230049000\\n Logstore_aliyun\\n 1649230049000\\n \\n \\n aliyun-test\\n cn-qingdao\\n oss_log\\n \\n
\\n 200\\n true\\n","errorExample":""}]',
'title' => '查询Logstore组列表',
'description' => '本文将提供一个示例,查询当前账号下的所有Logstore组。返回结果显示,当前账号下有两个Logstore组,分别是`Logstore_test`和`Logstore_aliyun`。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'Cursor' => [
'summary' => '调用Cursor接口定义导出监控数据的范围,并返回用于初始调用BatchExport接口的Cursor值。',
'methods' => [
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'paid',
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'formData',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于如何获取云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'Metric',
'in' => 'formData',
'schema' => [
'description' => '云产品的监控项名称。'."\n"
."\n"
.'关于如何获取云产品的监控项名称,请参见[云产品监控项](~~163515~~)。',
'type' => 'string',
'required' => true,
'example' => 'cpu_idle',
],
],
[
'name' => 'Period',
'in' => 'formData',
'schema' => [
'description' => '监控项的时间间隔。'."\n"
."\n"
.'单位:秒。'."\n"
."\n"
.'> 监控项的时间间隔通常为60秒。特殊取值,请参见[云产品监控项](~~163515~~)中的参数`Period`。'."\n"
."\n",
'type' => 'integer',
'format' => 'int32',
'required' => true,
'example' => '60',
],
],
[
'name' => 'StartTime',
'in' => 'formData',
'schema' => [
'description' => '开始时间戳。'."\n"
."\n"
.'支持Format格式(YYYY-MM-DDThh:mm:ssZ),例如:2023-01-01T00:00:00Z,表示GMT时间2023年01月01日零时零分零秒。'."\n"
."\n"
.'> 云监控不同时间粒度的监控数据TTL不同,请具体参考`Period`输入参数对应的数据TTL,设置合理的时间间隔。',
'type' => 'string',
'required' => true,
'example' => '1641627000000',
],
],
[
'name' => 'EndTime',
'in' => 'formData',
'schema' => [
'description' => '结束时间戳。'."\n"
."\n"
.'单位:毫秒。'."\n"
."\n"
.'> - Unix时间戳:从1970年01月01日开始所经过的毫秒数。支持Format格式(YYYY-MM-DDThh:mm:ssZ),例如:2023-01-01T00:00:00Z,表示GMT时间2023年01月01日零时零分零秒。'."\n"
.'- 不设置结束时间,表示结束时间无限大,使用实时导出的场景,可不设置该参数。'."\n"
.'- 云监控不同时间粒度的监控数据TTL不同,具体请参见`Period`输入参数对应的数据TTL,设置合理的时间间隔。',
'type' => 'string',
'required' => false,
'example' => '1641645000000',
],
],
[
'name' => 'Matchers',
'in' => 'formData',
'style' => 'json',
'schema' => [
'description' => '监控项的维度信息。',
'type' => 'array',
'items' => [
'description' => '监控项的维度信息。',
'required' => false,
'$ref' => '#/components/schemas/Matcher',
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'CursorPopResponse',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'Cursor' => [
'description' => 'Cursor在[BatchExport](~~2329847~~)接口中作为输入参数进行数据导出。'."\n"
."\n",
'type' => 'string',
'example' => 'v2.5eyJiYXRjaGVzIjoxLCJidWNrZXRCeXRlcyI6IndBPT0iLCJidWNrZXRzIjo0LCJjdXJyZW50QnVja2V0IjotNjQsImN1cnJlbnRUYXJnZXRUaW1lU2xvdCI6MTY3ODc1MjAwMCwiZW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0RW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0U3RhcnRUaW1lIjoxNjc4NzgxODE5MDAwLCJleHByZXNzUmFuZ2UiOmZhbHNlLCJoYXNOZXh0Ijp0cnVlLCJpbmRleCI6MCwibGF0ZXN0TG9nVGltZSI6MCwibWF0Y2hlcnMiOnsiY2hhaW4iOlt7ImxhYmVsIjoidXNlcklkIiwib3BlcmF0b3IiOiJFUVVBTFMiLCJ2YWx1ZSI6IjEyNzA2NzY2Nzk1NDY3MDQifV0sImxvY2tlZCI6dHJ1ZX0sIm1ldHJpYyI6IlNwbGl0cndQcm94eU1heFJlc3BvbnNlU2l6ZSIsIm1ldHJpY1R5cGUiOiJNRVRSSUMiLCJuYW1lc3BhY2UiOiJhY3Nfa3ZzdG9yZV9leCIsIm5leHRQa0FkYXB0ZXIiOnsiZGltIjoiVjowXG5EOmB1c2VySWRgPTEyNzA2NzY2Nzk1NDY3MDQsYGluc3RhbmNlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLGBub2RlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLXByb3h5LTIsXG4iLCJtZXRhIjoiXG5WOjBcbk06YWNzX2t2c3RvcmVfZXgvU3BsaXRyd1Byb3h5TWF4UmVzcG9uc2VTaXplXG5XOjYwXG5COjRcbkk6LTFcblQ6MFxuQzpgQXZlcmFnZWAsYE1heGltdW1gLGBfX2NvdW50X19gLGBfX3RzX19gXG4iLCJyZCI6InN1YkFMU0RwWXY2K0t6aENQQUFBWkErNUFKMEpjbGErRGd2V0hFNWxDSHMvbGtqR2FXYTFJTkVwdFE9PSIsInRhZyI6IiJ9LCJvZmZzZXQiOjAsIm9mZnNldERpZ2l0Ijo0NTU0NTczNDQyMTc4NDIxMjIsInN0YXJ0VGltZSI6MTY3ODc4MTgxOTAwMCwic3RlcCI6LTEsInRhZ01hdGNoZXJzIjp7ImNoYWluIjpbXSwibG9ja2VkIjp0cnVlfSwidGFyZ2V0VGltZVNsb3RzIjpbMTY3ODY2NTYwMCwxNjc4NzUyMDAwXSwidXVpZCI6ImQwMmFhZmY1LWU3ZGQtNDUyYy0***********',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '915C2D7A-E6A4-17C3-8E13-4DBDD61E7919',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"Cursor\\": \\"v2.5eyJiYXRjaGVzIjoxLCJidWNrZXRCeXRlcyI6IndBPT0iLCJidWNrZXRzIjo0LCJjdXJyZW50QnVja2V0IjotNjQsImN1cnJlbnRUYXJnZXRUaW1lU2xvdCI6MTY3ODc1MjAwMCwiZW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0RW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0U3RhcnRUaW1lIjoxNjc4NzgxODE5MDAwLCJleHByZXNzUmFuZ2UiOmZhbHNlLCJoYXNOZXh0Ijp0cnVlLCJpbmRleCI6MCwibGF0ZXN0TG9nVGltZSI6MCwibWF0Y2hlcnMiOnsiY2hhaW4iOlt7ImxhYmVsIjoidXNlcklkIiwib3BlcmF0b3IiOiJFUVVBTFMiLCJ2YWx1ZSI6IjEyNzA2NzY2Nzk1NDY3MDQifV0sImxvY2tlZCI6dHJ1ZX0sIm1ldHJpYyI6IlNwbGl0cndQcm94eU1heFJlc3BvbnNlU2l6ZSIsIm1ldHJpY1R5cGUiOiJNRVRSSUMiLCJuYW1lc3BhY2UiOiJhY3Nfa3ZzdG9yZV9leCIsIm5leHRQa0FkYXB0ZXIiOnsiZGltIjoiVjowXG5EOmB1c2VySWRgPTEyNzA2NzY2Nzk1NDY3MDQsYGluc3RhbmNlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLGBub2RlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLXByb3h5LTIsXG4iLCJtZXRhIjoiXG5WOjBcbk06YWNzX2t2c3RvcmVfZXgvU3BsaXRyd1Byb3h5TWF4UmVzcG9uc2VTaXplXG5XOjYwXG5COjRcbkk6LTFcblQ6MFxuQzpgQXZlcmFnZWAsYE1heGltdW1gLGBfX2NvdW50X19gLGBfX3RzX19gXG4iLCJyZCI6InN1YkFMU0RwWXY2K0t6aENQQUFBWkErNUFKMEpjbGErRGd2V0hFNWxDSHMvbGtqR2FXYTFJTkVwdFE9PSIsInRhZyI6IiJ9LCJvZmZzZXQiOjAsIm9mZnNldERpZ2l0Ijo0NTU0NTczNDQyMTc4NDIxMjIsInN0YXJ0VGltZSI6MTY3ODc4MTgxOTAwMCwic3RlcCI6LTEsInRhZ01hdGNoZXJzIjp7ImNoYWluIjpbXSwibG9ja2VkIjp0cnVlfSwidGFyZ2V0VGltZVNsb3RzIjpbMTY3ODY2NTYwMCwxNjc4NzUyMDAwXSwidXVpZCI6ImQwMmFhZmY1LWU3ZGQtNDUyYy0***********\\",\\n \\"Code\\": 200,\\n \\"Success\\": true,\\n \\"RequestId\\": \\"915C2D7A-E6A4-17C3-8E13-4DBDD61E7919\\"\\n}","errorExample":""},{"type":"xml","example":"\\n\\t915C2D7A-E6A4-17C3-8E13-4DBDD61E7919\\n\\tsuccess\\n\\t\\n\\t\\teyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0MzIwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQ3NTY2MzYzMjY3NmI2ZjM5MzU2YjY4MzAzMTYyNzg3MTcwNjkzMTM3MjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2****\\n\\t\\n\\t200\\n\\ttrue\\n\\t","errorExample":""}]',
'title' => '定义导出监控数据的范围',
'description' => '### 前提条件'."\n"
.'请确保您已开通企业云监控。具体操作,请参见[开通企业云监控](~~250773~~)。'."\n"
."\n"
.'### 背景信息'."\n"
.'先调用本接口获取初始的Cursor,再调用[BatchExport](~~2329847~~)接口导出监控数据。'."\n"
.'### 使用说明'."\n"
.'本文将提供一个示例,定义云产品`acs_ecs_dashboard`的监控项`cpu_idle`在时间段`1641627000000`(2022-01-08 15:30:00)至`1641645000000`(2022-01-08 20:30:00)内每60秒的数据导出范围。返回结果显示`Cursor`信息。',
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'BatchExport' => [
'summary' => '调用BatchExport接口导出在Cursor接口中定义的监控数据。',
'methods' => [
'post',
],
'schemes' => [
'http',
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'list',
'riskType' => 'none',
'chargeType' => 'paid',
],
'parameters' => [
[
'name' => 'Namespace',
'in' => 'formData',
'schema' => [
'description' => '云产品的数据命名空间。'."\n"
."\n"
.'关于如何获取云产品的数据命名空间,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 本参数必须与Cursor接口中的请求参数`Namespace`相同。',
'type' => 'string',
'required' => true,
'example' => 'acs_ecs_dashboard',
],
],
[
'name' => 'Metric',
'in' => 'formData',
'schema' => [
'description' => '云产品的监控项名称。'."\n"
."\n"
.'关于如何获取云产品的监控项名称,请参见[云产品监控项](~~163515~~)。'."\n"
."\n"
.'> 本参数必须与Cursor接口中的请求参数`Metric`相同。',
'type' => 'string',
'required' => true,
'example' => 'cpu_idle',
],
],
[
'name' => 'Cursor',
'in' => 'formData',
'schema' => [
'description' => '循环调用本接口导出数据时,必须输入`Cursor`的值。`Cursor`值的获取方法如下:'."\n"
."\n"
.'- 当您初次调用本接口时,必须先调用Cursor接口,获取`Cursor`的值。更多信息,请参见[Cursor](~~2330730~~)。'."\n"
."\n"
.'- 当您再次调用本接口时,可以从上次调用本接口的返回数据中获取`Cursor`的值。'."\n",
'type' => 'string',
'required' => true,
'example' => 'eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0MzIwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQ3NTY2MzYzMjY3NmI2ZjM5MzU2YjY4MzAzMTYyNzg3MTcwNjkzMTM3MjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTQ3OTU4MjMsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDE5NTgyMywic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2****',
],
],
[
'name' => 'Length',
'in' => 'formData',
'schema' => [
'description' => '每次最多返回的数据条数。'."\n"
."\n"
.'取值范围:1~10000。',
'type' => 'integer',
'format' => 'int32',
'required' => true,
'example' => '1000',
],
],
[
'name' => 'Measurements',
'in' => 'formData',
'style' => 'json',
'schema' => [
'description' => '用于定制返回数据的测量值。默认返回全部测量值。'."\n"
."\n"
.'例如:云产品`acs_ecs_dashboard`的监控指标`cpu_idle`下有三个测量值的列,分别是`Average`、`Maximum`或`Minimum`,如果只需要返回`Average`和`Maximum`两列,则该参数设置为`["Average", "Maximum"]`数组即可。'."\n"
."\n"
.'关于如何获取云产品的监控指标的测量值,请参见[云产品监控项](~~163515~~)的`statistics`列。',
'type' => 'array',
'items' => [
'description' => '测量值列名。',
'type' => 'string',
'required' => false,
'example' => 'Maximum',
],
'required' => false,
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => '无。',
'type' => 'object',
'properties' => [
'Message' => [
'description' => '返回信息。',
'type' => 'string',
'example' => 'success',
],
'Code' => [
'description' => '状态码。'."\n"
."\n"
.'> 200表示成功。',
'type' => 'integer',
'format' => 'int32',
'example' => '200',
],
'Success' => [
'description' => '操作是否成功。取值:'."\n"
."\n"
.'- true:成功。'."\n"
."\n"
.'- false:失败。',
'type' => 'boolean',
'example' => 'true',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '251402CD-305C-1617-808E-D8C11FC8138D',
],
'Cursor' => [
'description' => '用于再次调用本接口。'."\n"
."\n"
.'> 如果返回结果为`null`,则说明监控数据导出完成。',
'type' => 'string',
'example' => 'v2.5eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0ODAwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQzMjdhNjU2MjY3N2E2NjZhNzczOTY2NmM3Mjc0NjM3MzY5Njg3NDcyMjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2MH0***',
],
'Length' => [
'description' => '本次调用数据返回的条数。',
'type' => 'integer',
'format' => 'int32',
'example' => '1000',
],
'Anchor' => [
'description' => '后端请求数据的时间戳。时间戳越大,表示导出数据越靠近当前时间。',
'type' => 'integer',
'format' => 'int64',
'example' => '1678781819000',
],
'HasNext' => [
'description' => '数据是否已完成导出。取值:'."\n"
."\n"
.'- true:部分数据未完成导出。'."\n"
.'- false:数据已完成导出。',
'type' => 'boolean',
'example' => 'true',
],
'DataResults' => [
'description' => '当前调用的返回数据。',
'type' => 'array',
'items' => [
'description' => '导出数据。具体如下:'."\n"
.'- Namespace:云产品的数据命名空间,例如:`acs_ecs_dashboard`。'."\n"
.'- Metric:云产品的监控项名称,例如:`cpu_idle`。'."\n"
.'- Timestamp:监控数据的时间戳(单位:毫秒),例如:1641454680000。'."\n"
.'- Period:监控数据的统计周期(单位:秒),例如:60。'."\n"
.'- Dimensions:用于标识监控对象(实例)的Dimension信息,例如:`[{"Label":"userId", "Value":""20654616023382****"}, {"Label":"InstanceId", "Value":""i-2ze2d6j5uhg20x4****"}]`。'."\n"
.'- Associated:监控对象(实例)的附加信息,例如:标签信息之类,key:value键值对形式的集合,例如:`{"group":"test****", "name":"Alice"}`。'."\n"
.'- Measurements:指标的测量值(默认多值模式),例如:`{"Average":60,"Maximum":85}`。'."\n"
.'- LogTime:监控数据的记录时间(单位:毫秒),对于非原始数据(聚合后的数据),`LogTime`为空(NULL)。',
'$ref' => '#/components/schemas/MetricStat',
],
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
403 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
[
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
500 => [
[
'errorCode' => 'InternalError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
503 => [
[
'errorCode' => '%s',
'errorMessage' => '%s',
],
],
],
'responseDemo' => '[{"type":"json","example":"{\\n \\"Message\\": \\"success\\",\\n \\"Code\\": 200,\\n \\"Success\\": true,\\n \\"RequestId\\": \\"251402CD-305C-1617-808E-D8C11FC8138D\\",\\n \\"Cursor\\": \\"v2.5eyJidWNrZXRzIjo0LCJjdXJzb3IiOiIxNjQxNDU0ODAwMDAwMWUxY2YxNWY0NTU0MTliZjllYTY4OWQ2ODI1OTU1Yzc1NmZjMDQ2OTMxMzczMzM2MzUzMTMxMzEzMzM0MzMzODM5MzEzMTMwMjQyYzY5MmQzMjdhNjU2MjY3N2E2NjZhNzczOTY2NmM3Mjc0NjM3MzY5Njg3NDcyMjQyYyIsImN1cnNvclZlcnNpb24iOiJxdWVyeSIsImVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydEVuZFRpbWUiOjE2NDE0NTUyMzYxMTIsImV4cG9ydFN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwiZXhwcmVzc1JhbmdlIjpmYWxzZSwiaGFzTmV4dCI6dHJ1ZSwiaW5wdXRNZXRyaWMiOiJDUFVVdGlsaXphdGlvbiIsImlucHV0TmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJsaW1pdCI6MTAwMCwibG9nVGltZU1vZGUiOnRydWUsIm1hdGNoZXJzIjp7ImNoYWluIjpbeyJsYWJlbCI6InVzZXJJZCIsIm9wZXJhdG9yIjoiRVFVQUxTIiwidmFsdWUiOiIxNzM2NTExMTM0Mzg5MTEwIn1dfSwibWV0cmljIjoiQ1BVVXRpbGl6YXRpb24iLCJtZXRyaWNUeXBlIjoiTUVUUklDIiwibmFtZXNwYWNlIjoiYWNzX2Vjc19kYXNoYm9hcmQiLCJuZXh0UGtBZGFwdGVyIjp7fSwib2Zmc2V0IjowLCJwYXJlbnRVaWQiOjEyNzA2NzY2Nzk1NDY3MDQsInN0YXJ0VGltZSI6MTY0MTQ1NDYzNjExMiwic3RlcCI6LTEsInRpbWVvdXQiOjEyMCwid2luZG93Ijo2MH0***\\",\\n \\"Length\\": 1000,\\n \\"Anchor\\": 1678781819000,\\n \\"HasNext\\": true,\\n \\"DataResults\\": [\\n {\\n \\"Namespace\\": \\"\\",\\n \\"Metric\\": \\"\\",\\n \\"Period\\": 0,\\n \\"Timestamp\\": 0,\\n \\"Dimensions\\": [\\n {\\n \\"Label\\": \\"\\",\\n \\"Value\\": \\"\\"\\n }\\n ],\\n \\"Associated\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"Measurements\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"LogTime\\": 0\\n }\\n ]\\n}","errorExample":""},{"type":"xml","example":"\\n \\n \\n \\n \\n 1270676***********\\n \\n \\n \\n r-rj9f9s*********\\n \\n \\n \\n r-rj9f9s19lsu*******\\n \\n \\n acs_kvstore\\n 1678781700000\\n SplitrwProxyMaxResponseSize\\n 60\\n \\n 0.583\\n 0.583\\n \\n \\n 733A3B5A-F082-1092-B429-1208168FC07F\\n 200\\n 10\\n success\\n v2.5eyJiYXRjaGVzIjoxLCJidWNrZXRCeXRlcyI6IndBPT0iLCJidWNrZXRzIjo0LCJjdXJyZW50QnVja2V0IjotNjQsImN1cnJlbnRUYXJnZXRUaW1lU2xvdCI6MTY3ODc1MjAwMCwiZW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0RW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0U3RhcnRUaW1lIjoxNjc4NzgxODE5MDAwLCJleHByZXNzUmFuZ2UiOmZhbHNlLCJoYXNOZXh0Ijp0cnVlLCJpbmRleCI6MCwibGF0ZXN0TG9nVGltZSI6MCwibWF0Y2hlcnMiOnsiY2hhaW4iOlt7ImxhYmVsIjoidXNlcklkIiwib3BlcmF0b3IiOiJFUVVBTFMiLCJ2YWx1ZSI6IjEyNzA2NzY2Nzk1NDY3MDQifV0sImxvY2tlZCI6dHJ1ZX0sIm1ldHJpYyI6IlNwbGl0cndQcm94eU1heFJlc3BvbnNlU2l6ZSIsIm1ldHJpY1R5cGUiOiJNRVRSSUMiLCJuYW1lc3BhY2UiOiJhY3Nfa3ZzdG9yZV9leCIsIm5leHRQa0FkYXB0ZXIiOnsiZGltIjoiVjowXG5EOmB1c2VySWRgPTEyNzA2NzY2Nzk1NDY3MDQsYGluc3RhbmNlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLGBub2RlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLXByb3h5LTIsXG4iLCJtZXRhIjoiXG5WOjBcbk06YWNzX2t2c3RvcmVfZXgvU3BsaXRyd1Byb3h5TWF4UmVzcG9uc2VTaXplXG5XOjYwXG5COjRcbkk6LTFcblQ6MFxuQzpgQXZlcmFnZWAsYE1heGltdW1gLGBfX2NvdW50X19gLGBfX3RzX19gXG4iLCJyZCI6InN1YkFMU0RwWXY2K0t6aENQQUFBWkErNUFKMEpjbGErRGd2V0hFNWxDSHMvbGtqR2FXYTFJTkVwdFE9PSIsInRhZyI6IiJ9LCJvZmZzZXQiOjAsIm9mZnNldERpZ2l0Ijo0NTU0NTczNDQyMTc4NDIxMjIsInN0YXJ0VGltZSI6MTY3ODc4MTgxOTAwMCwic3RlcCI6LTEsInRhZ01hdGNoZXJzIjp7ImNoYWluIjpbXSwibG9ja2VkIjp0cnVlfSwidGFyZ2V0VGltZVNsb3RzIjpbMTY3ODY2NTYwMCwxNjc4NzUyMDAwXSwidXVpZCI6ImQwMmFhZmY1LWU3ZGQtNDUyYy04ZGMwLTZlY2QxZGVhZGY***************\\n true\\n true\\n 1678781819000\\n","errorExample":""}]',
'title' => '导出在Cursor中定义的监控数据',
'description' => '### 前提条件'."\n"
.'请确保您已调用[Cursor](~~2330730~~)接口获取初始的`Cursor`。'."\n"
.'### 使用说明'."\n"
.'本文将提供一个示例,导出云产品`acs_ecs_dashboard`的监控项`cpu_idle`的某个初始`Cursor`的监控数据,且每次最多返回1000条数据。'."\n",
'requestParamsDescription' => '关于公共请求参数的详情,请参见[公共参数](~~199331~~)。',
],
'DescribeSyntheticProbeList' => [
'summary' => '调用DescribeSyntheticProbeList接口查询拨测节点列表。',
'path' => '',
'methods' => [
'get',
'post',
],
'schemes' => [
'https',
],
'security' => [
[
'AK' => [],
],
],
'operationType' => 'read',
'deprecated' => false,
'systemTags' => [
'operationType' => 'none',
'riskType' => 'none',
'chargeType' => 'free',
'autoTest' => true,
'tenantRelevance' => 'publicInformation',
],
'parameters' => [
[
'name' => 'Isp',
'in' => 'query',
'schema' => [
'description' => '运营商探测点的名称或ID。',
'type' => 'string',
'required' => false,
'example' => '联通',
],
],
[
'name' => 'City',
'in' => 'query',
'schema' => [
'description' => '运营商探测点所在城市的名称或ID。',
'type' => 'string',
'required' => false,
'example' => '北京市',
],
],
[
'name' => 'Ipv4',
'in' => 'query',
'schema' => [
'description' => '只展示ipv4节点。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'Ipv6',
'in' => 'query',
'schema' => [
'description' => '只展示ipv6节点。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'ViewAll',
'in' => 'query',
'schema' => [
'description' => '是否返回所有探测点。取值:'."\n"
."\n"
.'- false(默认值):返回用户可使用的探测点。'."\n"
.'- true:返回所有探测点。',
'type' => 'boolean',
'required' => false,
'example' => 'true',
],
],
[
'name' => 'MbProbe',
'in' => 'query',
'schema' => [
'description' => '只查询移动端探测点。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'LmProbe',
'in' => 'query',
'schema' => [
'description' => '只查询Lastmile网民家宽节点。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
[
'name' => 'IdcProbe',
'in' => 'query',
'schema' => [
'description' => '只查询IDC机房探测点。',
'type' => 'boolean',
'required' => false,
'example' => 'false',
],
],
],
'responses' => [
200 => [
'schema' => [
'title' => 'Schema of Response',
'description' => 'Schema of Response',
'type' => 'object',
'properties' => [
'Code' => [
'title' => 'Id of the request',
'description' => '状态码。',
'type' => 'string',
'example' => '200',
],
'IspCityList' => [
'description' => '探测点列表。',
'type' => 'array',
'items' => [
'description' => '探测点列表。',
'type' => 'object',
'properties' => [
'AreaCn' => [
'description' => '大区中文。',
'type' => 'string',
'example' => '华北',
],
'AreaEn' => [
'description' => '大区英文。',
'type' => 'string',
'example' => 'Huabei',
],
'City' => [
'description' => '城市ID。',
'type' => 'string',
'example' => '738',
],
'CityCn' => [
'description' => '城市中文。',
'type' => 'string',
'example' => '北京',
],
'CityEn' => [
'description' => '城市英文。',
'type' => 'string',
'example' => 'Beijing',
],
'Country' => [
'description' => '国家代码。',
'type' => 'string',
'example' => '629',
],
'CountryCn' => [
'description' => '国家中文。',
'type' => 'string',
'example' => '中国',
],
'CountryEn' => [
'description' => '国家(或地区)英文',
'type' => 'string',
'example' => 'China',
],
'IpPool' => [
'description' => '节点ip列表。',
'type' => 'array',
'items' => [
'description' => '节点ip。',
'type' => 'string',
'example' => '1.1.1.1',
],
],
'Isp' => [
'description' => '运营商ID。',
'type' => 'string',
'example' => '232',
],
'IspCn' => [
'description' => '运营商中文。',
'type' => 'string',
'example' => '联通',
],
'IspEn' => [
'description' => '运营商英文。',
'type' => 'string',
'example' => 'China-Unicom',
],
'LmProbeCount' => [
'description' => 'lastmile探测点数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'MbProbeCount' => [
'description' => '移动端探测点数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'Region' => [
'description' => '省份代码。',
'type' => 'string',
'example' => '264',
],
'RegionCn' => [
'description' => '省份中文。',
'type' => 'string',
'example' => '江西省',
],
'RegionEn' => [
'description' => '省份英文。',
'type' => 'string',
'example' => 'Jiangxi',
],
'IdcV4ProbeCount' => [
'description' => 'idc ipv4节点数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
'IdcV6ProbeCount' => [
'description' => 'idc ipv6节点数量。',
'type' => 'integer',
'format' => 'int32',
'example' => '1',
],
],
],
],
'Message' => [
'description' => '错误信息。',
'type' => 'string',
'example' => 'The specified resource is not found.',
],
'RequestId' => [
'description' => '请求ID。',
'type' => 'string',
'example' => '87170bc7-e28a-4c93-b9bf-90a1dbe84736',
],
'Success' => [
'description' => '操作是否成功。取值:true:成功。false:失败。',
'type' => 'string',
'example' => 'true',
],
],
],
],
],
'errorCodes' => [
400 => [
[
'errorCode' => 'InvalidParameterValue',
'errorMessage' => 'Illegal parameters.',
],
],
[
[
'errorCode' => 'AccessDeniedException',
'errorMessage' => 'You donot have sufficient access to perform this action.',
],
],
[
[
'errorCode' => 'LimitExceeded',
'errorMessage' => 'The quota for this customer had been reached.',
],
],
[
[
'errorCode' => 'Forbidden',
'errorMessage' => 'You are not authorized to operate the specified resource.',
],
],
406 => [
[
'errorCode' => 'ExceedingQuota',
'errorMessage' => 'Exceeding quota limits.',
],
],
429 => [
[
'errorCode' => 'ThrottlingException',
'errorMessage' => 'The request was denied due to request throttling.',
],
],
500 => [
[
'errorCode' => 'InternalUnknownError',
'errorMessage' => 'The request processing has failed due to some unknown error.',
],
],
],
'staticInfo' => [
'returnType' => 'synchronous',
],
'responseDemo' => '[{"errorExample":"","example":"{\\n \\"Code\\": \\"200\\",\\n \\"IspCityList\\": [\\n {\\n \\"AreaCn\\": \\"华北\\",\\n \\"AreaEn\\": \\"Huabei\\",\\n \\"City\\": \\"738\\",\\n \\"CityCn\\": \\"北京\\",\\n \\"CityEn\\": \\"Beijing\\",\\n \\"Country\\": \\"629\\",\\n \\"CountryCn\\": \\"中国\\",\\n \\"CountryEn\\": \\"China\\",\\n \\"IpPool\\": [\\n \\"1.1.1.1\\"\\n ],\\n \\"Isp\\": \\"232\\",\\n \\"IspCn\\": \\"联通\\",\\n \\"IspEn\\": \\"China-Unicom\\",\\n \\"LmProbeCount\\": 1,\\n \\"MbProbeCount\\": 1,\\n \\"Region\\": \\"264\\",\\n \\"RegionCn\\": \\"江西省\\",\\n \\"RegionEn\\": \\"Jiangxi\\",\\n \\"IdcV4ProbeCount\\": 1,\\n \\"IdcV6ProbeCount\\": 1\\n }\\n ],\\n \\"Message\\": \\"The specified resource is not found.\\",\\n \\"RequestId\\": \\"87170bc7-e28a-4c93-b9bf-90a1dbe84736\\",\\n \\"Success\\": \\"true\\"\\n}","type":"json"}]',
'title' => '查询拨测探测节点列表',
'description' => '本文将提供一个示例,查询运营商“联通”在“北京市”的探测点详情。',
],
],
'endpoints' => [
[
'regionId' => 'cn-qingdao',
'endpoint' => 'cms.cn-qingdao.aliyuncs.com',
],
[
'regionId' => 'cn-beijing',
'endpoint' => 'cms.cn-beijing.aliyuncs.com',
],
[
'regionId' => 'cn-zhangjiakou',
'endpoint' => 'cms.cn-zhangjiakou.aliyuncs.com',
],
[
'regionId' => 'cn-zhengzhou-jva',
'endpoint' => 'metrics.cn-zhengzhou-jva.aliyuncs.com',
],
[
'regionId' => 'cn-huhehaote',
'endpoint' => 'metrics.cn-huhehaote.aliyuncs.com',
],
[
'regionId' => 'cn-wulanchabu',
'endpoint' => 'metrics.cn-wulanchabu.aliyuncs.com',
],
[
'regionId' => 'cn-hangzhou',
'endpoint' => 'metrics.cn-hangzhou.aliyuncs.com',
],
[
'regionId' => 'cn-shanghai',
'endpoint' => 'metrics.cn-shanghai.aliyuncs.com',
],
[
'regionId' => 'cn-nanjing',
'endpoint' => 'metrics.cn-nanjing.aliyuncs.com',
],
[
'regionId' => 'cn-fuzhou',
'endpoint' => 'metrics.cn-fuzhou.aliyuncs.com',
],
[
'regionId' => 'cn-shenzhen',
'endpoint' => 'metrics.cn-shenzhen.aliyuncs.com',
],
[
'regionId' => 'cn-heyuan',
'endpoint' => 'metrics.cn-heyuan.aliyuncs.com',
],
[
'regionId' => 'cn-guangzhou',
'endpoint' => 'metrics.cn-guangzhou.aliyuncs.com',
],
[
'regionId' => 'cn-chengdu',
'endpoint' => 'metrics.cn-chengdu.aliyuncs.com',
],
[
'regionId' => 'cn-wuhan-lr',
'endpoint' => 'metrics.cn-wuhan-lr.aliyuncs.com',
],
[
'regionId' => 'cn-hongkong',
'endpoint' => 'metrics.cn-hongkong.aliyuncs.com',
],
[
'regionId' => 'ap-northeast-1',
'endpoint' => 'metrics.ap-northeast-1.aliyuncs.com',
],
[
'regionId' => 'ap-northeast-2',
'endpoint' => 'metrics.ap-northeast-2.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-1',
'endpoint' => 'metrics.ap-southeast-1.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-2',
'endpoint' => 'metrics.ap-southeast-2.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-3',
'endpoint' => 'metrics.ap-southeast-3.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-5',
'endpoint' => 'cms.ap-southeast-5.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-6',
'endpoint' => 'metrics.ap-southeast-6.aliyuncs.com',
],
[
'regionId' => 'ap-southeast-7',
'endpoint' => 'metrics.ap-southeast-7.aliyuncs.com',
],
[
'regionId' => 'cn-zhongwei',
'endpoint' => 'metrics.cn-zhongwei.aliyuncs.com',
],
[
'regionId' => 'us-east-1',
'endpoint' => 'metrics.us-east-1.aliyuncs.com',
],
[
'regionId' => 'us-west-1',
'endpoint' => 'metrics.us-west-1.aliyuncs.com',
],
[
'regionId' => 'eu-west-1',
'endpoint' => 'metrics.eu-west-1.aliyuncs.com',
],
[
'regionId' => 'eu-central-1',
'endpoint' => 'metrics.eu-central-1.aliyuncs.com',
],
[
'regionId' => 'na-south-1',
'endpoint' => 'metrics.na-south-1.aliyuncs.com',
],
[
'regionId' => 'us-southeast-1',
'endpoint' => 'metrics.us-southeast-1.aliyuncs.com',
],
[
'regionId' => 'ap-south-1',
'endpoint' => 'metrics.ap-south-1.aliyuncs.com',
],
[
'regionId' => 'me-east-1',
'endpoint' => 'metrics.me-east-1.aliyuncs.com',
],
[
'regionId' => 'me-central-1',
'endpoint' => 'metrics.me-central-1.aliyuncs.com',
],
[
'regionId' => 'cn-hangzhou-finance',
'endpoint' => 'cms.cn-hangzhou-finance.aliyuncs.com',
],
[
'regionId' => 'cn-shanghai-finance-1',
'endpoint' => 'metrics.cn-shanghai-finance-1.aliyuncs.com',
],
[
'regionId' => 'cn-shenzhen-finance-1',
'endpoint' => 'metrics.cn-shenzhen-finance-1.aliyuncs.com',
],
[
'regionId' => 'cn-beijing-finance-1',
'endpoint' => 'metrics.cn-beijing-finance-1.aliyuncs.com',
],
[
'regionId' => 'cn-heyuan-acdr-1',
'endpoint' => 'metrics.cn-heyuan-acdr-1.aliyuncs.com',
],
[
'regionId' => 'cn-north-2-gov-1',
'endpoint' => 'metrics.cn-north-2-gov-1.aliyuncs.com',
],
],
];