GetAggregateResourceConfigurationTimeline - Cloud Config: Central de Documentação do Alibaba Cloud

Consulta o histórico de configuração de um recurso específico em um grupo de contas especificado. Após ativar o Cloud Config, o serviço registra todas as alterações de configuração e relacionamento dos seus recursos e as organiza em um histórico de configuração. Esse histórico é salvo por 10 anos por padrão.

Descrição da operação

O Cloud Config fornece um histórico de configuração para cada recurso dentro do escopo de monitoramento:

Para recursos que já existem quando você ativa o Cloud Config, o histórico de configuração começa quando o serviço é ativado.
Para recursos criados após a ativação do Cloud Config, o histórico de configuração começa quando os recursos são criados. O Cloud Config registra alterações de configuração de recursos a cada 10 minutos. Quando a configuração de um recurso é alterada, um nó aparece no histórico de configuração. Esse nó contém os detalhes da configuração do recurso, os detalhes da alteração e o evento de gerenciamento relacionado.

Este tópico fornece um exemplo de como consultar o histórico de configuração de um bucket OSS chamado new-bucket. O bucket está na região cn-hangzhou, pertence à conta de membro 100931896542**** e faz parte do grupo de contas ca-5885626622af0008****. O resultado retornado indica que uma alteração de configuração do recurso foi registrada no timestamp UNIX 1624961112000 (UTC+8: 2021-06-29 18:05:12).

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

config:GetAggregateResourceConfigurationTimeline

list

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceId	string	Sim	O ID do recurso. Para mais informações, consulte ListAggregateDiscoveredResources.	new-bucket
StartTime	integer	Não	O horário de início da consulta. Este é um timestamp UNIX em milissegundos. Por padrão, são consultados dados dos últimos 30 dias.	1623211156000
EndTime	integer	Não	O horário de término da consulta. Este é um timestamp UNIX em milissegundos. Por padrão, são consultados dados até o horário atual.	1625821156000
MaxResults	integer	Não	O número máximo de entradas a serem retornadas em cada página. Valores válidos: 1 a 100.	10
ResourceType	string	Sim	O tipo do recurso. Para mais informações, consulte ListAggregateDiscoveredResources.	ACS::OSS::Bucket
Region	string	Sim	O ID da região onde o recurso está localizado. Para mais informações, consulte ListAggregateDiscoveredResources.	cn-hangzhou
AggregatorId	string	Sim	O ID do grupo de contas. Para mais informações, consulte ListAggregators.	ca-5885626622af0008****
NextToken	string	Não	Se a saída estiver truncada, você pode usar o `NextToken` para iniciar a próxima consulta a partir do ponto de truncamento.	IWBjqMYSy0is7zSMGu16****
ResourceAccountId	integer	Não	O ID da conta Alibaba Cloud que possui o recurso no grupo de contas.	100931896542****

Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	ED9CD1B3-286C-4E05-A765-5E1E0B9BC2AB
ResourceConfigurationTimeline	object	O histórico de configuração do recurso.
NextToken	string	O token usado para iniciar a próxima consulta.	IWBjqMYSy0is7zSMGu16****
MaxResults	integer	O número máximo de entradas retornadas em cada página.	10
ConfigurationList	array<object>	Uma lista de alterações de configuração.
	object	N/A.
Tags	string	The tags of the resource.	{\"\"hc\"\":[\"\"value2\"\"]}
AccountId	integer	The ID of the Alibaba Cloud account that owns the resource.	100931896542****
ResourceEventType	string	The type of the resource change event. Valid values: DISCOVERED: The resource is discovered by Cloud Config. DISCOVERED_REVISED: The resource is discovered by Cloud Config through a periodic remediation task. MODIFY: The resource is modified. MODIFY_REVISED: The resource is modified, as detected by a periodic remediation task. REMOVE: The resource is deleted. Nota To ensure data integrity, Cloud Config periodically runs remediation tasks to align data. This process may generate resource discovery events. These events occur infrequently. The time when a resource event is generated by a periodic remediation task is the discovery time of the task. This time is later than the actual time of the resource change.	DISCOVERED
AvailabilityZone	string	The zone.	cn-hangzhou-h
ResourceType	string	The resource type.	ACS::OSS::Bucket
ResourceCreateTime	string	The time when the resource was created. This is a UNIX timestamp in milliseconds.	1624961112000
Region	string	The ID of the region.	cn-hangzhou
CaptureTime	string	The time when the resource change snapshot was recorded. This is a UNIX timestamp in milliseconds.	1624961156000
ConfigurationDiff	string	The details of the resource changes that triggered the evaluation.	{\"AccessControlList\":[null,{\"Grant\":\"private\"}],\"ServerSideEncryptionRule\":[null,{\"SSEAlgorithm\":\"None\"}],\"CreationDate\":[null,\"2021-06-29T10:05:12.000Z\"],\"Owner\":[null,{\"DisplayName\":\"100931896542**\",\"ID\":\"100931896542**\"}],\"BucketPolicy\":[null,{\"LogPrefix\":\"\",\"LogBucket\":\"\"}],\"StorageClass\":[null,\"Standard\"],\"ExtranetEndpoint\":[null,\"oss-cn-hangzhou.aliyuncs.com\"],\"DataRedundancyType\":[null,\"LRS\"],\"AllowEmptyReferer\":[null,\"true\"],\"IntranetEndpoint\":[null,\"oss-cn-hangzhou-internal.aliyuncs.com\"],\"Name\":[null,\"new-bucket\"],\"Location\":[null,\"oss-cn-hangzhou\"]}
ResourceId	string	The ID of the resource.	new-bucket
ResourceName	string	The resource name.	new-bucket

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "ED9CD1B3-286C-4E05-A765-5E1E0B9BC2AB",
  "ResourceConfigurationTimeline": {
    "NextToken": "IWBjqMYSy0is7zSMGu16****",
    "MaxResults": 10,
    "ConfigurationList": [
      {
        "Tags": "{\\\"\\\"hc\\\"\\\":[\\\"\\\"value2\\\"\\\"]}",
        "AccountId": 0,
        "ResourceEventType": "DISCOVERED",
        "AvailabilityZone": "cn-hangzhou-h",
        "ResourceType": "ACS::OSS::Bucket",
        "ResourceCreateTime": "1624961112000",
        "Region": "cn-hangzhou",
        "CaptureTime": "1624961156000",
        "ConfigurationDiff": "{\\\"AccessControlList\\\":[null,{\\\"Grant\\\":\\\"private\\\"}],\\\"ServerSideEncryptionRule\\\":[null,{\\\"SSEAlgorithm\\\":\\\"None\\\"}],\\\"CreationDate\\\":[null,\\\"2021-06-29T10:05:12.000Z\\\"],\\\"Owner\\\":[null,{\\\"DisplayName\\\":\\\"100931896542****\\\",\\\"ID\\\":\\\"100931896542****\\\"}],\\\"BucketPolicy\\\":[null,{\\\"LogPrefix\\\":\\\"\\\",\\\"LogBucket\\\":\\\"\\\"}],\\\"StorageClass\\\":[null,\\\"Standard\\\"],\\\"ExtranetEndpoint\\\":[null,\\\"oss-cn-hangzhou.aliyuncs.com\\\"],\\\"DataRedundancyType\\\":[null,\\\"LRS\\\"],\\\"AllowEmptyReferer\\\":[null,\\\"true\\\"],\\\"IntranetEndpoint\\\":[null,\\\"oss-cn-hangzhou-internal.aliyuncs.com\\\"],\\\"Name\\\":[null,\\\"new-bucket\\\"],\\\"Location\\\":[null,\\\"oss-cn-hangzhou\\\"]}",
        "ResourceId": "new-bucket",
        "ResourceName": "new-bucket"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NoPermission	You are not authorized to perform this operation.	You are not authorized to perform this operation.
400	Invalid.AggregatorId.Value	The specified AggregatorId is invalid.	The specified aggregator ID does not exist or you are not authorized to use the aggregator.
400	Invalid.ResourceOwnerId.Value	The specified ResourceOwnerId is invalid.	The specified ResourceOwnerId is invalid.
404	AccountNotExisted	Your account does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	The request has failed due to a temporary failure of the server.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.