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

Cria um canal de entrega para um grupo de contas especificado, a fim de entregar dados de recursos ao Simple Log Service (SLS), Object Storage Service (OSS) ou Simple Message Queue (anteriormente MNS) para armazenamento.

Descrição da operação

Informações básicas

Entrega de eventos para o SLS

Para entregar histórico de configurações, eventos de não conformidade e snapshots agendados de recursos para um Logstore no SLS, crie um projeto e um Logstore antes de consultar e analisar logs. Para exemplos de conteúdo de arquivos JSON, consulte Exemplos de histórico de configuração de recursos, Exemplos de eventos de não conformidade de recursos e Exemplos de snapshots agendados de recursos.
Entrega de eventos para o OSS

Para entregar snapshots agendados ou histórico de configurações de recursos para um endereço especificado no OSS, crie um bucket antes de visualizar ou baixar arquivos JSON. Para exemplos de conteúdo de arquivos JSON, consulte Exemplos de snapshots agendados de recursos e Exemplos de histórico de configuração de recursos.
Entrega de eventos para o Simple Message Queue (anteriormente MNS)

Para entregar histórico de configurações de recursos e eventos de não conformidade de recursos para um tópico especificado no Simple Message Queue (anteriormente MNS), crie um tópico antes de configurar o método e o conteúdo de push para o tópico. Para exemplos de conteúdo de arquivos JSON, consulte Exemplos de histórico de configuração de recursos e Exemplos de eventos de não conformidade de recursos.

Limites

Você pode criar até 5 canais de entrega em cada grupo de contas.

Descrição da operação

Este tópico fornece um exemplo de como criar um canal de entrega para o grupo de contas ca-a4e5626622af0079****. O tipo de canal de entrega é OSS e o ARN do destino do canal de entrega é acs:oss:cn-shanghai:100931896542****:new-bucket. A resposta mostra que o canal de entrega foi criado e o ID do canal de entrega é cdc-8e45ff4e06a3a8****.

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

create

*EntregaAgregada.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
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-a4e5626622af0079****
DeliveryChannelName	string	Não	O nome do canal de entrega. Nota Se você não definir este parâmetro, o valor será vazio por padrão.	testoss
DeliveryChannelType	string	Sim	O tipo do canal de entrega. Valores válidos: OSS: Object Storage Service. MNS: Simple Message Queue (anteriormente MNS). SLS: Simple Log Service. Valores válidos: MNS : Simple Message Queue (anteriormente MNS) SLS : Simple Log Service (SLS) OSS : Object Storage Service (OSS)	OSS
DeliveryChannelTargetArn	string	Sim	O Alibaba Cloud Resource Name (ARN) do destino do canal de entrega. Valores válidos: Se o canal de entrega for OSS, o formato é `acs:oss:{RegionId}:{accountId}:{bucketName}`. Exemplo: `acs:oss:cn-shanghai:100931896542**:new-bucket`. Se o canal de entrega for MNS, o formato é `acs:mns:{RegionId}:{accountId}:/topics/{topicName}`. Exemplo: `acs:mns:cn-shanghai:100931896542:/topics/topic1`. Se o canal de entrega for SLS, o formato é `acs:log:{RegionId}:{accountId}:project/{projectName}/logstore/{logstoreName}`. Exemplo: `acs:log:cn-shanghai:100931896542**:project/project1/logstore/logstore1`.	acs:oss:cn-shanghai:100931896542****:new-bucket
DeliveryChannelCondition	string	Não	A regra adicional do canal de entrega. Este parâmetro suporta todas as entregas para o canal MNS e entregas de snapshots para o canal SLS. Se você especificar o nível mínimo de risco e os tipos de recursos para eventos de assinatura do MNS: O nível mínimo de risco para eventos de assinatura é `{"filterType":"RuleRiskLevel","value":"1","multiple":false}`. `value` especifica o nível de risco a ser filtrado. Valores válidos: 1 indica alto risco, 2 indica médio risco e 3 indica baixo risco. Os tipos de recursos para eventos de assinatura são `{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}`. `values` especifica os tipos de recursos para eventos de assinatura, que é uma matriz JSON de tipos de recursos. Exemplo: `[{"filterType":"ResourceType","values":["ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage","ACS::CDN::Domain","ACS::CEN::CenBandwidthPackage","ACS::CEN::CenInstance","ACS::CEN::Flowlog","ACS::DdosCoo::Instance"],"multiple":true}]` Se você especificar os tipos de recursos para entrega de snapshots do SLS, os tipos de recursos são `{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}`. `values` especifica os tipos de recursos a serem entregues, que é uma matriz JSON de tipos de recursos. Exemplo: `[{"filterType":"ResourceType","values":["ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage","ACS::CDN::Domain","ACS::CEN::CenBandwidthPackage","ACS::CEN::CenInstance","ACS::CEN::Flowlog","ACS::DdosCoo::Instance"],"multiple":true}]`	[{"filterType":"ResourceType","values":["ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage","ACS::CDN::Domain","ACS::CEN::CenBandwidthPackage","ACS::CEN::CenInstance","ACS::CEN::Flowlog","ACS::DdosCoo::Instance"],"multiple":true}]
OversizedDataOSSTargetArn	string	Não	O ARN do bucket do OSS para o qual os dados de entrega são transferidos quando os dados excedem o limite do canal de entrega. O formato é `acs:oss:{RegionId}:{accountId}:{bucketName}`. Se você não configurar este parâmetro, o Cloud Config entregará apenas informações resumidas. Nota Este parâmetro é suportado apenas para canais de entrega SLS e MNS. O limite do canal de entrega para SLS é 1 MB e o limite do canal de entrega para Simple Message Queue (anteriormente MNS) é 64 KB.	acs:oss:cn-shanghai:100931896542****:new-bucket
Description	string	Não	A descrição do canal de entrega.	Minha entrega OSS
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Gere um valor de parâmetro a partir do seu cliente para garantir que o valor seja único entre diferentes solicitações. ClientToken suporta apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	1594295238-f9361358-5843-4294-8d30-b5183fac****
ConfigurationSnapshot	boolean	Não	Especifica se devem ser aceitos snapshots agendados de recursos. O Cloud Config entrega snapshots agendados de recursos para o OSS e Simple Message Queue (anteriormente MNS) às `04:00Z` e `16:00Z` (UTC) todos os dias. Valores válidos: true: Aceitar snapshots agendados de recursos. false (padrão): Não aceitar snapshots agendados de recursos. Nota Se o canal de entrega for OSS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos) e ConfigurationItemChangeNotification (histórico de configurações) deve ser definido como true. Nota Se o canal de entrega for SLS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos), ConfigurationItemChangeNotification (histórico de configurações) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido como true.	true
CompliantSnapshot	boolean	Não	Especifica se devem ser recebidos snapshots de conformidade. O Cloud Config entrega informações de conformidade e não conformidade de recursos para o SLS. Valores válidos: true: Receber snapshots de conformidade. false: Não receber snapshots de conformidade.	false
ConfigurationItemChangeNotification	boolean	Não	Especifica se deve ser aceito o histórico de configurações de recursos. Quando uma configuração de recurso é alterada, o Cloud Config entrega o histórico de configurações de recursos para o OSS, SLS ou Simple Message Queue (anteriormente MNS). Valores válidos: true: Aceitar histórico de configurações de recursos. false (padrão): Não aceitar histórico de configurações de recursos. Nota Se o canal de entrega for OSS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos) e ConfigurationItemChangeNotification (histórico de configurações) deve ser definido como true. Nota Se o canal de entrega for SLS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos), ConfigurationItemChangeNotification (histórico de configurações) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido como true. Nota Se o canal de entrega for MNS, pelo menos um dos parâmetros ConfigurationItemChangeNotification (histórico de configurações) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido como true.	false
NonCompliantNotification	boolean	Não	Especifica se devem ser aceitos eventos de não conformidade de recursos. Quando um recurso está em não conformidade, o Cloud Config entrega o evento de não conformidade de recursos para o SLS ou Simple Message Queue (anteriormente MNS). Valores válidos: true: Aceitar eventos de não conformidade de recursos. false (padrão): Não aceitar eventos de não conformidade de recursos. Nota Se o canal de entrega for SLS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos), ConfigurationItemChangeNotification (histórico de configurações) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido como true. Nota Se o canal de entrega for MNS, pelo menos um dos parâmetros ConfigurationItemChangeNotification (histórico de configurações) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido como true.	false
DeliverySnapshotTime	string	Não	A hora em que a entrega diária de snapshots agendados de recursos começa. O formato é `HH:mmZ` (UTC). Nota Ao ativar a entrega de snapshots agendados de recursos, você pode usar este parâmetro para personalizar o horário de entrega. Se você não definir este parâmetro, a entrega começará às `04:00Z` e `16:00Z` todos os dias por padrão.	09:10Z

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.	A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG
DeliveryChannelId	string	O ID do canal de entrega.	cdc-8e45ff4e06a3a8****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG",
  "DeliveryChannelId": "cdc-8e45ff4e06a3a8****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	DeliveryChannelNotExists	The delivery channel does not exist.
400	Invalid.DeliveryChannelAssumeRoleArn.Format	The specified format of DeliveryChannelAssumeRoleArn is invalid.
400	Invalid.DeliveryChannelTargetArn.Format	The specified format of DeliveryChannelTargetArn is invalid.
400	Invalid.DeliveryChannelCondition.Format	The specified format of DeliveryChannelCondition is invalid.
400	MemberNotBelongToMaster	The specified member does not belong to your organization.
400	DeliveryChannelAccountNotSupport	Cross-account delivery that is not in the RD is not supported.
400	DeliveryChannelMnsUnreachable	The MNS topic is unreachable.
400	DeliveryChannelOssUnreachable	The OSS bucket is unreachable.
400	DeliveryChannelSlsUnreachable	SLS logstore is unreachable.
404	AccountNotExisted	Your account does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.