Cria uma tarefa de rastreamento de relatórios. Após a assinatura ser bem-sucedida, o sistema envia periodicamente as estatísticas do relatório para você por e-mail.
Descrição da operação
Limite de taxa por usuário: 3 chamadas por segundo.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
cdn:CreateCdnDeliverTask |
create |
*Domínio.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| Name |
string |
Sim |
O nome da tarefa de rastreamento. |
Domain subscription |
| Reports |
string |
Sim |
A lista de relatórios a serem assinados. O valor deve ter escape JSON. |
[{\"reportId\":1,\"conditions\":[{\"field\":\"prov\",\"op\":\"in\",\"value\":[\" Heilongjiang\",\" Beijing\"]}]}] |
| DomainName |
string |
Não |
A lista de nomes de domínio a serem assinados. Separe vários nomes de domínio com vírgulas (,). Você pode assinar no máximo 500 nomes de domínio. Para assinar mais de 500 nomes de domínio, abra um ticket. Nota
Se você não especificar este parâmetro, a tarefa de rastreamento de relatórios será aplicada a todos os nomes de domínio da conta por padrão. |
www.example1.com,www.example2.com |
| Deliver |
string |
Sim |
O método de entrega do relatório. Apenas a entrega por e-mail é suportada. O valor deve ter escape JSON. |
{"email":{"subject":" topic name","to":["username@example.com","username@example.org"]}} |
| Schedule |
string |
Sim |
Os parâmetros relacionados ao ciclo de assinatura. O valor deve ter escape JSON. |
{"schedName":"Periodic task name","description":"Description","crontab":"000**?","frequency":"d","status":"enable","effectiveFrom":"2020-09-17T00:00:00Z","effectiveEnd":"2020-11-17T00:00:00Z"} |
Descrição dos dados ReDatas
| Parâmetro | Tipo | Obrigatório | Descrição |
| reportId | String | Sim | O ID do relatório. |
| conditions | ConDatas[] | Não | As condições de filtro para o relatório. |
Descrição dos dados ConDatas
| Parâmetro | Tipo | Obrigatório | Descrição |
| field | String | Não | O campo de filtro. |
| op | String | Não | A operação de filtro. |
| value | String[] | Não | A matriz de valores de campo. |
Descrição dos dados de e-mail
| Parâmetro | Tipo | Obrigatório | Descrição |
| subject | String | Sim | O assunto da assinatura. |
| to | String[] | Sim | A matriz de endereços de e-mail dos destinatários. |
Descrição dos dados Deliver
| Parâmetro | Tipo | Obrigatório | Descrição |
| subject | String | Não | O assunto da assinatura. |
| to | String[] | Sim | A matriz de endereços de e-mail dos destinatários. |
Descrição dos dados Schedule
| Parâmetro | Tipo | Obrigatório | Descrição |
| schedName | String | Não | O nome da tarefa de rastreamento. |
| description | String | Não | A descrição da tarefa de rastreamento. |
| crontab | String | Sim | O ciclo de execução da tarefa de rastreamento. |
| frequency | String | Sim | A frequência de execução. Valores válidos: h: hora d: dia w: semana |
| status | String | Não | O status da tarefa de rastreamento. Valores válidos: enable: ativado disable: desativado |
| effectiveFrom | String | Não | A hora de início da tarefa de rastreamento. |
| effectiveEnd | String | Não | A hora de término da tarefa de rastreamento. |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| DeliverId |
string |
O ID da tarefa de rastreamento. |
1025 |
| RequestId |
string |
O ID da solicitação. |
04F0F334-1335-436C-A1D7-6C044FE73368 |
Exemplos
Resposta de sucesso
JSON formato
{
"DeliverId": "1025",
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid. | Ocorreu uma exceção ao excluir a região de transmissão ao vivo. |
| 400 | TimeParseFailed | Failed to parse the time parameter. | Falha ao analisar o parâmetro de tempo. |
| 400 | SubscriptionNotFound | The subscription is not found. | O serviço personalizado não foi ativado. |
| 400 | NameAlreadyExists | The name already exists. | O nome já existe. |
| 400 | DeliverExceedLimit | The maximum number of subscribed tasks is exceeded. | O número de tarefas de rastreamento atingiu o limite superior. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.