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

Consulta a linha do tempo de conformidade de um recurso específico em um grupo de contas. Uma linha do tempo de conformidade é um conjunto de registros de avaliação de conformidade para um recurso. Cada registro inclui a hora e o conteúdo de uma avaliação.

Descrição da operação

No Cloud Config, cada recurso possui sua própria linha do tempo de conformidade, que é composta por registros de avaliação de conformidade. Um registro é gerado sempre que uma regra é acionada para avaliar o recurso. As regras podem ser acionadas por alterações de configuração, execuções periódicas ou execuções manuais.

Este tópico fornece um exemplo de como consultar a linha do tempo de conformidade do recurso new-bucket (um bucket do OSS). O recurso está na região cn-hangzhou e pertence à conta de membro 100931896542**** dentro do grupo de contas ca-5885626622af0008****. A resposta mostra que a linha do tempo de conformidade do recurso inclui registros com os carimbos de data e hora 1625200295276 (UTC+8: 2021-07-02 12:31:35) e 1625200228510 (UTC+8: 2021-07-02 12:30:28).

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:GetAggregateResourceComplianceTimeline

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceType	string	Sim	O tipo de recurso. Para mais informações sobre como obter o tipo de recurso, consulte ListAggregateDiscoveredResources.	ACS::OSS::Bucket
ResourceId	string	Sim	O ID do recurso. Para mais informações sobre como obter o ID do recurso, consulte ListAggregateDiscoveredResources.	new-bucket
StartTime	integer	Não	O carimbo de data e hora de início. Por padrão, os dados dos últimos 30 dias são consultados. Unidade: milissegundos.	1623211156000
EndTime	integer	Não	O carimbo de data e hora de término. Por padrão, os dados até o momento atual são consultados. Unidade: milissegundos.	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
AggregatorId	string	Sim	O ID do grupo de contas. Para mais informações sobre como obter o ID de um grupo de contas, consulte ListAggregators.	ca-5885626622af0008****
Region	string	Sim	O ID da região onde o recurso reside. Para mais informações sobre como obter o ID da região onde um recurso reside, consulte ListAggregateDiscoveredResources.	cn-hangzhou
NextToken	string	Não	Se a saída de uma solicitação for truncada, você poderá usar este token para consultar a próxima página de resultados.	5OVS5J4I1/UKTkHV5oNs****
ResourceAccountId	integer	Não	O ID da conta Alibaba Cloud à qual o recurso no grupo de contas pertence. Nota Defina o parâmetro ResourceAccountId ou ResourceOwnerId. Este parâmetro é recomendado.	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	Nenhum.
RequestId	string	O ID da solicitação.	8D53A78F-1EB8-4264-A554-72F07E34FAE6
ResourceComplianceTimeline	object	A linha do tempo de conformidade do recurso.
NextToken	string	O token usado para consultar a próxima página.	5OVS5J4I1/UKTkHV5oNs****
MaxResults	integer	O número máximo de entradas retornadas por página.	10
ComplianceList	array<object>	Uma lista de entradas da linha do tempo de conformidade.
	object	Nenhum.
Tags	string	The tags of the resource.	{\"\"hc\"\":[\"\"value2\"\"]}
AccountId	string	The ID of the Alibaba Cloud account to which the resource belongs.	100931896542****
AvailabilityZone	string	The zone where the resource resides.	cn-hangzhou-f
ResourceType	string	The resource type.	ACS::OSS::Bucket
ResourceCreateTime	integer	The timestamp when the resource was created. Unit: milliseconds.	1624961112000
Region	string	The ID of the region where the resource resides.	cn-hangzhou
Configuration	string	A list of rules associated with the resource and their compliance details.	{\"Compliance\":{\"complianceType\":\"COMPLIANT\",\"count\":1},\"ConfigRuleList\":[{\"accountId\":100931896542**,\"configRuleId\":\"cr-9524626622af003d\",\"configRuleArn\":\"acs:config::100931896542:rule/cr-9524626622af003d**\",\"configRuleName\":\"OSS存储空间ACL禁止公共读写\",\"complianceType\":\"COMPLIANT\",\"riskLevel\":1,\"annotation\":\"\",\"invokingEventMessageType\":\"ScheduledNotification\"}]}
CaptureTime	integer	The timestamp when the compliance evaluation was recorded. Unit: milliseconds.	1625200295276
ConfigurationDiff	string	The details of the resource change that triggered this evaluation.	{\"OSS存储空间ACL禁止公共读写\":[{\"accountId\":100931896542**,\"configRuleId\":\"cr-965f626622af003d\",\"configRuleArn\":\"acs:config::100931896542:rule/cr-965f626622af003d**\",\"configRuleName\":\"OSS存储空间ACL禁止公共读写\",\"complianceType\":\"COMPLIANT\",\"riskLevel\":1,\"annotation\":\"\",\"invokingEventMessageType\":\"ScheduledNotification\"},{}]}
ResourceId	string	The resource ID.	new-bucket
ResourceName	string	The resource name.	new-bucket
ResourceStatus	string	The status of the resource. The status of a resource is defined by the corresponding Alibaba Cloud service. This parameter can be empty. For example: If the resource type is ACS::ECS::Instance, this parameter can be Running or Stopped because an ECS instance is stateful. If the resource type is ACS::OSS::Bucket, this parameter is empty because an OSS bucket is stateless.	null

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "8D53A78F-1EB8-4264-A554-72F07E34FAE6",
  "ResourceComplianceTimeline": {
    "NextToken": "5OVS5J4I1/UKTkHV5oNs****",
    "MaxResults": 10,
    "ComplianceList": [
      {
        "Tags": "{\\\"\\\"hc\\\"\\\":[\\\"\\\"value2\\\"\\\"]}",
        "AccountId": "100931896542****",
        "AvailabilityZone": "cn-hangzhou-f",
        "ResourceType": "ACS::OSS::Bucket",
        "ResourceCreateTime": 1624961112000,
        "Region": "cn-hangzhou",
        "Configuration": "{\\\"Compliance\\\":{\\\"complianceType\\\":\\\"COMPLIANT\\\",\\\"count\\\":1},\\\"ConfigRuleList\\\":[{\\\"accountId\\\":100931896542****,\\\"configRuleId\\\":\\\"cr-9524626622af003d****\\\",\\\"configRuleArn\\\":\\\"acs:config::100931896542****:rule/cr-9524626622af003d****\\\",\\\"configRuleName\\\":\\\"OSS存储空间ACL禁止公共读写\\\",\\\"complianceType\\\":\\\"COMPLIANT\\\",\\\"riskLevel\\\":1,\\\"annotation\\\":\\\"\\\",\\\"invokingEventMessageType\\\":\\\"ScheduledNotification\\\"}]}",
        "CaptureTime": 1625200295276,
        "ConfigurationDiff": "{\\\"OSS存储空间ACL禁止公共读写\\\":[{\\\"accountId\\\":100931896542****,\\\"configRuleId\\\":\\\"cr-965f626622af003d****\\\",\\\"configRuleArn\\\":\\\"acs:config::100931896542****:rule/cr-965f626622af003d****\\\",\\\"configRuleName\\\":\\\"OSS存储空间ACL禁止公共读写\\\",\\\"complianceType\\\":\\\"COMPLIANT\\\",\\\"riskLevel\\\":1,\\\"annotation\\\":\\\"\\\",\\\"invokingEventMessageType\\\":\\\"ScheduledNotification\\\"},{}]}",
        "ResourceId": "new-bucket",
        "ResourceName": "new-bucket",
        "ResourceStatus": "null"
      }
    ]
  }
}

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.