DescribeCdnDeliverList - CDN: Central de Documentação do Alibaba Cloud

Consulta as tarefas de rastreamento de relatórios e retorna todas as tarefas de rastreamento do usuário.

Descrição da operação

Nota

Limite de taxa por usuário: 3 chamadas por segundo.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cdn:DescribeCdnDeliverList

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DeliverId	integer	Não	O ID da tarefa de rastreamento a ser consultada. Se você não especificar este parâmetro, todas as tarefas de rastreamento serão retornadas por padrão.	3

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta.
RequestId	string	O ID da solicitação.	12345
Content	object	Os dados da lista de tarefas de rastreamento.	"data": [{"deliverId": 1,"status": "enable","createTime": "2020-10-14T11:19:26Z","crontab": "0 0 0 * * ?","frequency": "d","name": " domain name subscription","dmList": ["www.example.com"],"reports": [{"reportId": 1,"conditions": [{"op": "in","field": "prov","value": [" Heilongjiang"," Beijing"]}]},{"reportId": 2}],"deliver": {"email": {"subject": " topic","to": ["example@alibaba-inc.com","example@alibaba-inc.com"]}}}]}}
data	array<object>	O corpo do conteúdo de rastreamento.
	array<object>	O corpo do conteúdo de rastreamento.
createTime	string	A hora de criação.	2021-12-30T10:29:29Z
crontab	string	A configuração da tarefa agendada.	00 00 08 * * ?
deliver	object	O método de rastreamento.
email	object	O conteúdo de rastreamento por e-mail.
to	array	Os destinatários.
	string	O endereço de e-mail.	xx@xx.xx
deliverId	integer	O ID de rastreamento.	1
dmList	array	A lista de nomes de domínio.
	string	O nome de domínio.	a.b.c
frequency	string	A frequência de envio de rastreamento.	d
name	string	O nome do rastreamento.	xxxx
reports	array<object>	A lista de relatórios rastreados.
	object	O relatório.
reportId	integer	O ID do relatório.	1
status	string	O status do rastreamento.	enable
timeEndFormat	string	A hora de término efetivo do rastreamento.	-1d
timeFromFormat	string	A hora de início efetivo do rastreamento.	-1d

Descrição dos dados

Parâmetro	Tipo	Descrição
deliverId	Long	O ID da tarefa de rastreamento.
status	String	O status da tarefa de rastreamento. Valores válidos: enable: ativado. disable: desativado.
createTime	String	A hora de criação da tarefa de rastreamento.
crontab	String	O ciclo de execução da tarefa de rastreamento.
frequency	String	A frequência de execução. Valores válidos: h: hora. d: dia. M: mês.
name	String	O nome da tarefa de rastreamento.
dmList	String[]	A lista de filtros de nomes de domínio da tarefa de rastreamento.
reports	String[]	A lista de relatórios rastreados. Este parâmetro inclui os seguintes campos: reportId: o ID do relatório. conditions: as condições de filtro do relatório, que incluem a operação de filtro, o campo de filtro e o valor de filtro. Se nenhuma condição de filtro for especificada, este campo estará vazio. op: a operação de filtro. Apenas in é suportado. field: o campo de filtro. value: o valor de filtro.
deliver	String	O módulo de entrega, que inclui informações como o assunto do e-mail e os destinatários. email: entrega por e-mail. subject: o assunto do e-mail. to: a lista de endereços de e-mail dos destinatários. copy: a lista de endereços de e-mail em cópia.

Descrição dos relatórios

Parâmetro	Tipo	Descrição
deliverId	Long	O ID da tarefa de rastreamento.
status	String	O status da tarefa de rastreamento. Valores válidos: enable: ativado. disable: desativado.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "12345",
  "Content": {
    "data": [
      {
        "createTime": "2021-12-30T10:29:29Z",
        "crontab": "00 00 08 * * ?",
        "deliver": {
          "email": {
            "to": [
              "xx@xx.xx"
            ]
          }
        },
        "deliverId": 1,
        "dmList": [
          "a.b.c"
        ],
        "frequency": "d",
        "name": "xxxx",
        "reports": [
          {
            "reportId": 1
          }
        ],
        "status": "enable",
        "timeEndFormat": "-1d",
        "timeFromFormat": "-1d"
      }
    ]
  }
}

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	SubscriptionAlreadyExists	The subscription already exists.	O serviço personalizado já foi ativado.
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.