DescribeRunningLogRecords - ApsaraDB for MongoDB: Central de Documentação do Alibaba Cloud

Consulta os logs de execução de uma instância do MongoDB.

Descrição da operação

Esta API é para instâncias com os seguintes tipos de especificação: disco local de uso geral, disco local dedicado e disco em nuvem.
Esta API é limitada a 30 chamadas por minuto. Exceder esse limite aciona a limitação de taxa, portanto, evite chamadas de alta frequência. Para operações de alta frequência, use o Logstore. Para obter mais informações, consulte Gerenciar Logstore.

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

dds:DescribeRunningLogRecords

get

*dbinstance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBInstanceId	string	Sim	O ID da instância. Nota Se este parâmetro for definido como o ID de uma instância de cluster sharded, você também deverá especificar o parâmetro NodeId.	dds-bpxxxxxxxx
NodeId	string	Não	O ID de um nó mongos ou nó shard em uma instância de cluster sharded. Nota Este parâmetro está disponível apenas quando o parâmetro DBInstanceId é definido como o ID de uma instância de cluster sharded.	d-bpxxxxxxxx
StartTime	string	Sim	O início do intervalo de tempo a ser consultado. Especifique o horário no formato yyyy-MM-ddTHH:mmZ. O horário está em UTC.	2019-01-01T12:10Z
EndTime	string	Sim	O fim do intervalo de tempo a ser consultado. O horário de término deve ser posterior ao horário de início. Especifique o horário no formato yyyy-MM-ddTHH:mmZ. O horário está em UTC. Nota O horário de término pode ser até 24 horas posterior ao horário de início. Caso contrário, a chamada falhará.	2019-01-01T13:10Z
DBName	string	Não	O nome do banco de dados.	mongodbtest
RoleType	string	Não	A função do nó. Valores válidos: primary: O nó primário. secondary: Um nó secundário. Nota Se o parâmetro NodeId for definido como o ID de um nó mongos, o parâmetro RoleType só poderá ser definido como primary.	primary
PageSize	integer	Não	O número de entradas a serem retornadas em cada página. Valores válidos: 30 a 100.	30
PageNumber	integer	Não	O número da página a ser retornada. O valor deve ser um número inteiro maior que 0. Valor padrão: 1.	1
OrderType	string	Não	A ordem de classificação dos logs de execução a serem retornados. Valores válidos: asc: ordem crescente desc: ordem decrescente	asc
ResourceGroupId	string	Não	O ID do grupo de recursos.	sg-bpxxxxxxxxxxxxxxxxxx
RoleId	string	Não	O ID da função do nó. Você pode chamar a operação DescribeReplicaSetRole para consultar o ID da função.	651xxxxx
QueryKeywords	string	Não	As palavras-chave para a consulta. Você pode especificar até 10 palavras-chave. Separe várias palavras-chave com espaços.	test test2
LogicalOperator	string	Não	O operador lógico para a consulta baseada em palavras-chave. Valor padrão: and.	and

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalRecordCount	integer	O número total de registros.	2
PageRecordCount	integer	O número de registros por página.	30
RequestId	string	O ID da solicitação.	45D2B592-DEBA-4347-BBF3-47FF6C97DBBC
PageNumber	integer	O número da página.	1
Items	object
LogRecords	array<object>	Uma lista de registros de log de execução.
	object
ConnInfo	string	The connection information.	conn18xxxxxx
CreateTime	string	The time when the log entry was created, in yyyy-MM-ddTHH:mm:ssZ format (UTC).	2019-02-26T12:09:34Z
Category	string	The log category.	NETWORK
Content	string	The content of the log entry.	end connection 11.xxx.xxx.xx:3xxxx (0 connections now open)\n
Engine	string	O mecanismo do banco de dados.	MongoDB

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalRecordCount": 2,
  "PageRecordCount": 30,
  "RequestId": "45D2B592-DEBA-4347-BBF3-47FF6C97DBBC",
  "PageNumber": 1,
  "Items": {
    "LogRecords": [
      {
        "ConnInfo": "conn18xxxxxx",
        "CreateTime": "2019-02-26T12:09:34Z",
        "Category": "NETWORK",
        "Content": " end connection 11.xxx.xxx.xx:3xxxx (0 connections now open)\\n"
      }
    ]
  },
  "Engine": "MongoDB"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameterCombination	The end time must be greater than the start time	The start time must be earlier than the end time.
400	InvalidStartTime.Malformed	The Specified parameter StartTime is not valid.
400	InvalidEndTime.Malformed	The Specified parameter EndTime is not valid.
403	LogApiFrequencyExceeded	Exceeding the allowed frequency of log api.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.