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

Cria um pacote de conformidade para um grupo de contas especificado.

Descrição da operação

Um pacote de conformidade é uma coleção de regras. Ao criar um pacote de conformidade, você pode selecionar regras padrão de um modelo de pacote de conformidade ou selecionar regras de modelos de regras e listas de regras existentes.

Após a criação de um pacote de conformidade, as regras no pacote são avaliadas uma vez por padrão. As avaliações subsequentes são acionadas automaticamente com base no mecanismo de acionamento de cada regra. Você também pode acionar avaliações manualmente.

Um modelo de pacote de conformidade é uma coleção de regras que o Cloud Config personaliza para cenários de conformidade.

Este tópico fornece um exemplo de como criar um pacote de conformidade para o grupo de contas ca-f632626622af0079**** usando o modelo de pacote de conformidade ClassifiedProtectionPreCheck (pacote de conformidade de verificação prévia de proteção classificada nível 3).

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

create

*PacoteDeConformidadeAgregado.

acs:config:*:{#accountId}:aggregatecompliancepack/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CompliancePackTemplateId	string	Não	O ID do modelo de pacote de conformidade. Para obter informações sobre como obter o ID do modelo de pacote de conformidade, consulte ListCompliancePackTemplates.	ct-5f26ff4e06a300c4****
CompliancePackName	string	Sim	O nome do pacote de conformidade.	Pacote de conformidade de verificação prévia de proteção classificada nível 3
Description	string	Não	A descrição do pacote de conformidade.	Verifica a conformidade dos recursos no Alibaba Cloud com base em alguns requisitos de proteção classificada nível 3
RiskLevel	integer	Não	O nível de risco do pacote de conformidade. Valores válidos: 1: alto risco. 2 (padrão): médio risco. 3: baixo risco. Valores válidos: 1 : Alto risco. 2 : Médio risco. 3 : Baixo risco.	2
AggregatorId	string	Sim	O ID do grupo de contas. Para obter informações sobre como obter o ID do grupo de contas, consulte ListAggregators.	ca-f632626622af0079****
ConfigRules	array<object>	Não	A lista de regras no pacote de conformidade. Nota Você deve especificar este parâmetro ou `TemplateContent`.
	array<object>	Não	As informações da regra.
ManagedRuleIdentifier	string	Não	O identificador do modelo de regra. O Cloud Config cria automaticamente uma regra com base no identificador do modelo de regra e adiciona a regra ao pacote de conformidade atual. Você deve definir `ManagedRuleIdentifier` ou `ConfigRuleId`. Se ambos os parâmetros forem definidos, `ConfigRuleId` terá precedência.	eip-bandwidth-limit
ConfigRuleName	string	Não	O nome da regra.	A largura de banda de um EIP atende ao requisito mínimo
ConfigRuleParameters	array<object>	Não	As informações dos parâmetros da regra.
	object	Não	As informações dos parâmetros da regra.
ParameterName	string	Não	O nome do parâmetro da regra. Os parâmetros ParameterName e ParameterValue devem ser especificados juntos ou deixados vazios ao mesmo tempo. Se o modelo de regra tiver parâmetros sem valores padrão, você deverá especificar este parâmetro.	bandwidth
ParameterValue	string	Não	O valor do parâmetro da regra. Os parâmetros ParameterName e ParameterValue devem ser especificados juntos ou deixados vazios ao mesmo tempo. Se o modelo de regra tiver parâmetros sem valores padrão, você deverá especificar este parâmetro.	10
ConfigRuleId	string	Não	O ID da regra. O Cloud Config adiciona a regra existente ao pacote de conformidade atual. Você deve especificar `ManagedRuleIdentifier` ou `ConfigRuleId`. Se ambos os parâmetros forem especificados, `ConfigRuleId` terá precedência.	cr-e918626622af000f****
Description	string	Não	A descrição da regra.	Um elastic IP address (EIP) associado a uma instância ECS ou gateway NAT e que não esteja ocioso é considerado compatível
RiskLevel	integer	Não	O nível de risco da regra. Valores válidos: 1: alto risco. 2: médio risco. 3: baixo risco.	1
TemplateContent	string	Não	As informações do modelo usadas para gerar o pacote de conformidade. Você pode visualizar o conteúdo do modelo na API de detalhes de um pacote de conformidade existente ou consultar Escrever um modelo de pacote de conformidade baseado em configuração para compor o modelo. Nota Você deve especificar este parâmetro ou `TemplateContent`.	{ "configRuleTemplates": [ { "configRuleName": "Exemplo de regra de condição personalizada", "scope": { "complianceResourceTypes": [ "ACS::ECS::Instance" ] }, "description": "", "source": { "owner": "CUSTOM_CONFIGURATION", "identifier": "acs-config-configuration", "sourceDetails": [ { "messageType": "ScheduledNotification", "maximumExecutionFrequency": "Twelve_Hours" }, { "messageType": "ConfigurationItemChangeNotification" } ], "conditions": "{\"ComplianceConditions\":\"{\\\"operator\\\":\\\"and\\\",\\\"children\\\":[{\\\"operator\\\":\\\"GreaterOrEquals\\\",\\\"featurePath\\\":\\\"$.Cpu\\\",\\\"featureSource\\\":\\\"CONFIGURATION\\\",\\\"desired\\\":\\\"2\\\"}]}\"}" }, "inputParameters": {} }, { "configRuleName": "O Referer de um bucket OSS está na lista de permissões de proteção contra hotlink especificada", "scope": { "complianceResourceTypes": [ "ACS::OSS::Bucket" ] }, "description": "Um bucket OSS com proteção contra hotlink ativada e o Referer na lista de permissões especificada é considerado compatível.", "source": { "owner": "ALIYUN", "identifier": "oss-bucket-referer-limit", "sourceDetails": [ { "messageType": "ConfigurationItemChangeNotification" } ] }, "inputParameters": { "allowEmptyReferer": "true", "allowReferers": "http://www.aliyun.com" } } ] }
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O parâmetro ClientToken suporta apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.	1594295238-f9361358-5843-4294-8d30-b5183fac****
DefaultEnable	boolean	Não	Especifica se a regra suporta ativação rápida. Valores válidos: true: A regra é ativada quando o pacote de conformidade é ativado rapidamente. false (padrão): A regra não é ativada.	false
RegionIdsScope	string	Não	O pacote de conformidade entra em vigor apenas para recursos nos IDs de região especificados. Separe vários IDs de região com vírgulas (,).	cn-hangzhou
ExcludeRegionIdsScope	string	Não	O pacote de conformidade não entra em vigor para recursos nas regiões especificadas. Os recursos nessas regiões não são avaliados. Separe vários IDs de região com vírgulas (,).	cn-shanghai
ExcludeResourceIdsScope	string	Não	O pacote de conformidade não entra em vigor para os IDs de recurso especificados. Os recursos com esses IDs não são avaliados. Separe vários IDs de recurso com vírgulas (,).	eip-8vbf3x310fn56ijfd****
ResourceIdsScope	string	Não	A regra entra em vigor apenas para os IDs de recurso especificados. Separe vários IDs de recurso com vírgulas (,).	lb-5cmbowstbkss9ta03****
ResourceGroupIdsScope	string	Não	O pacote de conformidade entra em vigor apenas para recursos nos IDs de grupo de recursos especificados. Separe vários IDs de grupo de recursos com vírgulas (,).	rg-aekzc7r7rhx****
ExcludeResourceGroupIdsScope	string	Não	A regra não entra em vigor para recursos nos IDs de grupo de recursos especificados. Os recursos nesses grupos de recursos não são avaliados. Separe vários IDs de grupo de recursos com vírgulas (,).	rg-bnczc6r7rml****
TagKeyScope	string	Não	O pacote de conformidade entra em vigor apenas para recursos vinculados à chave de tag especificada.	ECS
TagValueScope	string	Não	O pacote de conformidade entra em vigor apenas para recursos vinculados ao par chave-valor de tag especificado. Nota TagValueScope deve ser usado junto com TagKeyScope.	test
TagsScope	array<object>	Não	As tags efetivas.
	object	Não
TagKey	string	Não	A chave da tag do recurso.	tagKey1
TagValue	string	Não	O valor da tag do recurso.	tagValue1
ExcludeTagsScope	array<object>	Não	As tags excluídas.
	object	Não	O escopo de tags excluídas.
TagKey	string	Não	A chave da tag do recurso.	4
TagValue	string	Não	O valor da tag do recurso.	user
Tag	array<object>	Não	As tags do recurso. Você pode adicionar até 20 tags.
	object	Não	As tags do recurso. Você pode adicionar até 20 tags.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag.	key-1
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag.	value-1

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
CompliancePackId	string	O ID do pacote de conformidade.	cp-fc56626622af00f9****
RequestId	string	O ID da solicitação.	CC0CE5EB-E51E-48EB-B4AB-9A9E131ECC0F

Exemplos

Resposta de sucesso

JSON formato

{
  "CompliancePackId": "cp-fc56626622af00f9****",
  "RequestId": "CC0CE5EB-E51E-48EB-B4AB-9A9E131ECC0F"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	CompliancePackExists	The compliance pack already exists.
400	Invalid.AggregatorId.Value	The specified AggregatorId is invalid.
400	CompliancePackExceedMaxCount	The maximum number of compliance pack is exceeded.
400	Invalid.CompliancePackName.Value	The specified CompliancePackName is invalid.
400	Invalid.CompliancePackTemplateId.Value	The specified CompliancePackTemplateId does not exist.
400	Invalid.ConfigRules.Empty	You must specify ConfigRules.
400	Invalid.ConfigRules.Value	The specified ConfigRules is invalid.
400	ConfigRuleExceedMaxRuleCount	The maximum number of config rules is exceeded.
403	AggregatorMemberNoPermission	The aggregator member is not authorized to perform the operation.
404	AccountNotExisted	Your account does not exist.
503	ServiceUnavailable	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.