Todos os produtos
Search
Central de documentação

Cloud Config:UpdateAggregateConfigDeliveryChannel

Última atualização: Sep 02, 2026

Modifica um canal de entrega em um grupo de contas especificado.

Descrição da operação

Este tópico fornece um exemplo de como alterar o status do canal de entrega cdc-8e45ff4e06a3a8**** no grupo de contas ca-a4e5626622af0079**** para 0 (desativado). Após a desativação de um canal de entrega, o Cloud Config retém a configuração de entrega mais recente e interrompe a entrega de dados de recursos.

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

update

*AggregateDelivery

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

AggregatorId

string

Sim

O ID do grupo de contas que existe na conta atual. Você pode chamar ListAggregators para consultar o ID do grupo de contas. O DeliveryChannelId deve ser o ID de um canal de entrega existente no grupo de contas. Você pode chamar ListAggregateConfigDeliveryChannels para consultar o ID do canal de entrega.

ca-a4e5626622af0079****

DeliveryChannelId

string

Sim

O ID do canal de entrega.

Para obter informações sobre como obter o ID do canal de entrega, consulte ListAggregateConfigDeliveryChannels.

cdc-8e45ff4e06a3a8****

DeliveryChannelName

string

Não

O nome do canal de entrega.

testoss

DeliveryChannelTargetArn

string

Não

O Alibaba Cloud Resource Name (ARN) do destino 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 anexada ao canal de entrega. Este parâmetro suporta todas as entregas por meio do canal MNS e entregas de snapshots por meio do canal SLS.

  • Se você especificar o nível de risco mínimo e os tipos de recursos para eventos de assinatura MNS:

    • O nível de risco mínimo para eventos de assinatura é {"filterType":"RuleRiskLevel","value":"1","multiple":false}.

      value especifica o nível de risco que você deseja filtrar. 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 os quais você deseja assinar eventos. O valor é 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 snapshot 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 que você deseja entregar. O valor é 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 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 definir este parâmetro, o Cloud Config entregará apenas informações resumidas.

Nota

Apenas os canais de entrega SLS e MNS são suportados. O limite do canal de entrega para Simple Log Service (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

Garante a idempotência da solicitação. Gere um valor de parâmetro a partir do seu cliente para garantir que o valor seja único em 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 agendados snapshots de recursos. O Cloud Config entrega snapshots de recursos agendados para OSS e Simple Message Queue (anteriormente MNS) às 04:00Z e 16:00Z (UTC) todos os dias. Valores válidos:

  • true: Aceitar snapshots de recursos agendados.

  • false (padrão): Não aceitar snapshots de recursos agendados.

false

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ção de recursos. Quando uma configuração de recurso é alterada, o Cloud Config entrega o histórico de configuração de recursos para OSS, SLS ou Simple Message Queue (anteriormente MNS). Valores válidos:

  • true: Aceitar histórico de configuração de recursos.

  • false (padrão): Não aceitar histórico de configuração de recursos.

Nota

Os canais de entrega OSS, SLS e MNS são suportados.

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 do recurso para 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

Apenas os canais de entrega SLS e MNS são suportados.

false

Status

integer

Não

O status do canal de entrega. Valores válidos:

  • 0: Desativado. O Cloud Config retém a configuração de entrega mais recente e interrompe a entrega de dados de recursos.

  • 1 (padrão): Ativado.

0

DeliverySnapshotTime

string

Não

A hora em que o snapshot de recursos agendado começa a ser entregue todos os dias.

O formato é HH:mmZ (UTC).

Nota

Ao ativar a entrega de snapshots de recursos agendados, 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 por padrão todos os dias.

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

Descrição

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.