Todos os produtos
Search
Central de documentação

Cloud Config:CreateConfigDeliveryChannel

Última atualização: Sep 02, 2026

Cria um canal de entrega para enviar 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

Limites

Você pode criar até 5 canais de entrega.

Descrição da operação

Este tópico fornece um exemplo de como criar um canal de entrega. O tipo de canal de entrega é OSS e o Alibaba Cloud Resource Name (ARN) do destino 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:CreateConfigDeliveryChannel

create

*Entrega.

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

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 ARN do destino de entrega. Valores válidos:

  • Se o tipo de canal de entrega for OSS, o formato é acs:oss:{RegionId}:{accountId}:{bucketName}. Exemplo: acs:oss:cn-shanghai:100931896542****:new-bucket.

  • Se o tipo de canal de entrega for MNS, o formato é acs:mns:{RegionId}:{accountId}:/topics/{topicName}. Exemplo: acs:mns:cn-shanghai:100931896542****:/topics/topic1.

  • Se o tipo de 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 anexada ao canal de entrega, usada para especificar as condições de filtro para o conteúdo inscrito.

  • Se você especificar o nível mínimo de risco e os tipos de recursos para inscrição em eventos de conformidade, os detalhes são os seguintes:

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

      value especifica o nível de risco que você deseja filtrar. Valores válidos: 1: alto risco. 2: médio risco. 3: baixo risco.

      multiple especifica se este grupo de campos de filtro suporta múltiplos valores. O nível de risco suporta apenas filtragem de valor único, o que significa que o campo multiple para entrega de conteúdo de eventos de conformidade só pode ser definido como false.

    • Os tipos de recursos para eventos inscritos 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 inscrever-se em 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}]

      multiple especifica se este grupo de campos de filtro suporta múltiplos valores. Tipos de recursos suportam filtragem de múltiplos valores. Quando vários tipos de recursos são selecionados, o campo multiple pode ser definido como true.

    • Você também pode especificar tanto o nível de risco quanto os tipos de recursos. Exemplo: [{"filterType":"RuleRiskLevel","value":"2","multiple":false},{"filterType":"ResourceType","values":["ACS::CDN::Domain","ACS::ActionTrail::Trail"],"multiple":true}]

  • Se você especificar os tipos de recursos para entrega de configuração de recursos, 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 do OSS para o qual os dados de entrega são transferidos quando os dados excedem o limite de tamanho 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

Este parâmetro aplica-se apenas aos canais de entrega SLS e MNS. O limite de tamanho para o canal de entrega SLS é 1 MB, e o limite de tamanho para o canal de entrega 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. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações.

O valor ClientToken pode conter 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 recebidos snapshots agendados de recursos. O Cloud Config entrega snapshots agendados de recursos ao OSS ou SLS às 04:00Z e 16:00Z (UTC) todos os dias. Valores válidos:

  • true: Recebe snapshots agendados de recursos.

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

Nota
  • Se o tipo de canal de entrega for OSS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos) e ConfigurationItemChangeNotification (histórico de configuração) deve ser definido.

Nota
  • Se o tipo de canal de entrega for SLS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos), ConfigurationItemChangeNotification (histórico de configuração), CompliantSnapshot (snapshots de conformidade) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido.

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 ao SLS. Valores válidos:

  • true: Recebe snapshots de conformidade.

  • false: Não recebe 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 ao OSS, SLS ou Simple Message Queue (anteriormente MNS). Valores válidos:

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

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

Nota
  • Se o tipo de canal de entrega for OSS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos) e ConfigurationItemChangeNotification (histórico de configuração) deve ser definido.

Nota
  • Se o tipo de canal de entrega for SLS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos), CompliantSnapshot (snapshots de conformidade), ConfigurationItemChangeNotification (histórico de configuração) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido.

Nota
  • Se o tipo de canal de entrega for MNS, pelo menos um dos parâmetros ConfigurationItemChangeNotification (histórico de configuração) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido.

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 ao SLS ou Simple Message Queue (anteriormente MNS). Valores válidos:

  • true: Aceita eventos de não conformidade de recursos.

  • false (padrão): Não aceita eventos de não conformidade de recursos.

Nota
  • Se o tipo de canal de entrega for SLS, pelo menos um dos parâmetros ConfigurationSnapshot (snapshots agendados de recursos), CompliantSnapshot (snapshots de conformidade), ConfigurationItemChangeNotification (histórico de configuração) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido.

Nota
  • Se o tipo de canal de entrega for MNS, pelo menos um dos parâmetros ConfigurationItemChangeNotification (histórico de configuração) e NonCompliantNotification (eventos de não conformidade de recursos) deve ser definido.

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

Se você ativar a entrega de snapshots agendados de recursos, poderá 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.