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

Cria um pacote de conformidade para a conta atual.

Descrição da operação

Um pacote de conformidade é uma coleção de regras. Ao criar um pacote de conformidade, você pode selecionar as regras padrão em um modelo de pacote de conformidade ou selecionar regras a partir de modelos de regras e listas de regras existentes. Após a criação de um pacote de conformidade, uma avaliação é executada nessas regras por padrão. As avaliações subsequentes são acionadas automaticamente com base no mecanismo de acionamento das regras, ou você pode executar avaliações manualmente.

Um modelo de pacote de conformidade é uma coleção de regras personalizadas pelo Cloud Config com base em cenários de conformidade.

Este tópico fornece um exemplo de criação de um pacote de conformidade usando o modelo de pacote de conformidade ClassifiedProtectionPreCheck (Classified Protection Precheck).

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

create

*CompliancePack.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CompliancePackTemplateId	string	Não	Especifica se deve ser realizado um dry run na solicitação. Valores válidos: true: realiza um dry run. O sistema verifica os parâmetros da solicitação e a lógica de negócios relacionada, mas não executa a operação real. Se o dry run for bem-sucedido, o código de erro DryRunOperation será retornado. Se o dry run falhar, o código de erro correspondente será retornado. false: executa a operação real. Este é o valor padrão.	false
CompliancePackName	string	Sim	O ID do modelo de pacote de conformidade. Para mais informações sobre como obter o ID de um modelo de pacote de conformidade, consulte ListCompliancePackTemplates.	ct-5f26ff4e06a300c4****
Description	string	Não	O nome do pacote de conformidade.	Classified Protection Precheck compliance package
RiskLevel	integer	Não	A descrição do pacote de conformidade. Valores válidos: 1 : 高风险 2 : 中风险 3 : 低风险	Classified Protection Precheck compliance package
ConfigRules	array<object>	Não	O nível de risco do pacote de conformidade. Valores válidos: 1: alto risco. 2: risco médio. Este é o valor padrão. 3: baixo risco.	2
	array<object>	Não
ConfigRuleId	string	Não	O ID da regra. Se você especificar este parâmetro, o Cloud Config adiciona a regra que possui o ID especificado ao pacote de conformidade. Você precisa especificar apenas ManagedRuleIdentifier ou ConfigRuleId. Se você especificar ambos os parâmetros, o Cloud Config adiciona uma regra com base no valor de ConfigRuleId. Você pode chamar a operação ListConfigRules para obter o ID da regra.	cr-e918626622af000f****
ConfigRuleName	string	Não	O nome da regra.	弹性IP实例带宽满足最低要求
ConfigRuleParameters	array<object>	Não	Os parâmetros de entrada da regra.
	object	Não
ParameterName	string	Não	O nome do parâmetro de entrada. Você deve especificar tanto ParameterName quanto ParameterValue ou nenhum deles. Se a regra gerenciada tiver um parâmetro de entrada, mas nenhum valor padrão for especificado, você deverá especificar este parâmetro. Você pode chamar a operação ListCompliancePackTemplates para obter os nomes dos parâmetros de entrada da regra gerenciada.	bandwidth
ParameterValue	string	Não	O valor do parâmetro de entrada. Você deve especificar tanto ParameterName quanto ParameterValue ou nenhum deles. Se a regra gerenciada tiver um parâmetro de entrada, mas nenhum valor padrão for especificado, você deverá especificar este parâmetro. Você pode chamar a operação ListCompliancePackTemplates para obter os valores dos parâmetros de entrada da regra gerenciada.	10
Description	string	Não	A descrição da regra.	弹性公网已绑定到ECS或者NAT实例，非闲置状态，视为“合规”。
ManagedRuleIdentifier	string	Não	O identificador da regra gerenciada. O Cloud Config cria automaticamente uma regra gerenciada com base no identificador especificado e adiciona a regra ao pacote de conformidade. Você precisa especificar apenas ManagedRuleIdentifier ou ConfigRuleId. Se você especificar ambos os parâmetros, o Cloud Config adiciona uma regra com base no valor de ConfigRuleId. Você pode chamar a operação ListCompliancePackTemplates para obter o identificador da regra gerenciada.	eip-bandwidth-limit
RiskLevel	integer	Não	O nível de risco dos recursos que não estão em conformidade com a regra. Valores válidos: 1: alto. 2: médio. 3: baixo.	1
TemplateContent	string	Não	A lista de regras no pacote de conformidade. Nota Você deve especificar este parâmetro ou TemplateContent.	{ "configRuleTemplates": [ { "configRuleName": "自定义条件规则示例", "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": "OSS存储空间Referer在指定的防盗链白名单中", "scope": { "complianceResourceTypes": [ "ACS::OSS::Bucket" ] }, "description": "OSS存储空间开启防盗链并且Referer在指定白名单中，视为“合规”。", "source": { "owner": "ALIYUN", "identifier": "oss-bucket-referer-limit", "sourceDetails": [ { "messageType": "ConfigurationItemChangeNotification" } ] }, "inputParameters": { "allowEmptyReferer": "true", "allowReferers": "http://www.aliyun.com" } } ] }
ClientToken	string	Não	As informações do modelo usadas para gerar o pacote de conformidade. Você pode visualizar o conteúdo do modelo a partir da API de detalhes do pacote de conformidade existente, ou consultar Escrever um modelo de pacote de conformidade parametrizado para escrever o modelo. Nota Você deve especificar este parâmetro ou ConfigRules.	{ "configRuleTemplates": [ { "configRuleName": "Custom condition rule example", "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": "The Referer of the OSS bucket is in the specified hotlink protection whitelist", "scope": { "complianceResourceTypes": [ "ACS::OSS::Bucket" ] }, "description": "Hotlink protection is enabled for the OSS bucket and the Referer is in the specified whitelist. In this case, the configuration is considered compliant.", "source": { "owner": "ALIYUN", "identifier": "oss-bucket-referer-limit", "sourceDetails": [ { "messageType": "ConfigurationItemChangeNotification" } ] }, "inputParameters": { "allowEmptyReferer": "true", "allowReferers": "http://www.aliyun.com" } } ] }
DefaultEnable	boolean	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja exclusivo entre diferentes solicitações. O ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento.	1594295238-f9361358-5843-4294-8d30-b5183fac****
RegionIdsScope	string	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: A regra não é ativada. Este é o valor padrão.	false
ExcludeRegionIdsScope	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
ExcludeResourceIdsScope	string	Não	O escopo de região excluído. Separe vários IDs de região com vírgulas (,).	cn-hangzhou
ResourceIdsScope	string	Não	O pacote de conformidade não entra em vigor para os IDs de recurso especificados, o que significa que nenhuma avaliação é executada nesses recursos. Separe vários IDs de recurso com vírgulas (,).	eip-8vbf3x310fn56ijfd****
ResourceGroupIdsScope	string	Não	O escopo de recursos onde o pacote de conformidade entra em vigor. Separe vários IDs de recurso com vírgulas (,).	eip-8vbf3x310fn56ijfd****
ExcludeResourceGroupIdsScope	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-aekzdibsjjc****
TagKeyScope	string	Não	O pacote de conformidade não entra em vigor para recursos nos IDs de grupo de recursos especificados. Separe vários IDs de grupo de recursos com vírgulas (,).	rg-bnczc6r7rml****
TagValueScope	string	Não	O pacote de conformidade entra em vigor apenas para recursos que estão vinculados à chave de tag especificada.	ECS
TagsScope	array<object>	Não	O pacote de conformidade entra em vigor apenas para recursos que estão vinculados ao par chave-valor de tag especificado. Nota TagValueScope deve ser usado junto com TagKeyScope.	test
	object	Não
TagKey	string	Não	Chave da tag.	key-1
TagValue	string	Não	Valor da tag.	value-1
ExcludeTagsScope	array<object>	Não	O escopo de tags.
	object	Não
TagKey	string	Não	A chave de tag do recurso.	key-1
TagValue	string	Não	O valor da tag.	value-1
Tag	array<object>	Não	O escopo de tags excluído.
	object	Não	O escopo de tags excluído.
Key	string	Não	As chaves das tags. As chaves das tags não podem ser uma string vazia. As chaves das tags podem ter até 64 caracteres de comprimento. As chaves das tags não podem começar com aliyun ou acs: e não podem conter http:// ou https://. Você pode especificar no máximo 20 chaves de tag em cada chamada.	key-1
Value	string	Não	Os valores das tags. Os valores das tags podem ser uma string vazia ou ter até 128 caracteres de comprimento. Os valores das tags não podem começar com aliyun ou acs: e não podem conter http:// ou https://. Cada par chave-valor deve ser exclusivo. Você pode especificar no máximo 20 valores de tag em cada chamada.	value-1

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
CompliancePackId	string	O ID do pacote de conformidade.	cp-a8a8626622af0082****
RequestId	string	O ID da solicitação.	6EC7AED1-172F-42AE-9C12-295BC2ADB751

Exemplos

Resposta de sucesso

JSON formato

{
  "CompliancePackId": "cp-a8a8626622af0082****",
  "RequestId": "6EC7AED1-172F-42AE-9C12-295BC2ADB751"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	CompliancePackExceedMaxCount	The maximum number of compliance pack is exceeded.
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.
400	Invalid.CompliancePackName.Empty	You must specify CompliancePackName.
400	Invalid.CompliancePackName.Value	The specified CompliancePackName is invalid.
400	Invalid.CompliancePackTemplateId.Value	The specified CompliancePackTemplateId does not exist.
400	CompliancePackExists	The compliance pack already exists.
400	DryRunOperation	Request validation has been passed with DryRun flag set.
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.