Todos los productos
Search
Centro de documentos

Cloud Config:CreateConfigDeliveryChannel

Última actualización: Sep 02, 2026

Crea un canal de entrega para enviar datos de recursos a Simple Log Service (SLS), Object Storage Service (OSS) o Simple Message Queue (anteriormente MNS) para su almacenamiento.

Descripción de la operación

Información de contexto

Límites

Puede crear hasta 5 canales de entrega.

Descripción de la operación

Este tema proporciona un ejemplo de cómo crear un canal de entrega. El tipo de canal de entrega es OSS y el Nombre de Recurso de Alibaba Cloud (ARN) del destino de entrega es acs:oss:cn-shanghai:100931896542****:new-bucket. La respuesta muestra que se ha creado el canal de entrega y que el ID del canal de entrega es cdc-8e45ff4e06a3a8****.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

config:CreateConfigDeliveryChannel

create

*Entrega.

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

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

DeliveryChannelName

string

No

El nombre del canal de entrega.

Nota

Si no establece este parámetro, el valor está vacío de forma predeterminada.

testoss

DeliveryChannelType

string

Sí

El tipo de 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

Sí

El ARN del destino de entrega. Valores válidos:

  • Si el tipo de canal de entrega es OSS, el formato es acs:oss:{RegionId}:{accountId}:{bucketName}. Ejemplo: acs:oss:cn-shanghai:100931896542****:new-bucket.

  • Si el tipo de canal de entrega es MNS, el formato es acs:mns:{RegionId}:{accountId}:/topics/{topicName}. Ejemplo: acs:mns:cn-shanghai:100931896542****:/topics/topic1.

  • Si el tipo de canal de entrega es SLS, el formato es acs:log:{RegionId}:{accountId}:project/{projectName}/logstore/{logstoreName}. Ejemplo: acs:log:cn-shanghai:100931896542****:project/project1/logstore/logstore1.

acs:oss:cn-shanghai:100931896542****:new-bucket

DeliveryChannelCondition

string

No

La regla adicional adjunta al canal de entrega, que se utiliza para especificar las condiciones de filtro del contenido suscrito.

  • Si especifica el nivel de riesgo mínimo y los tipos de recursos para suscribirse a eventos de cumplimiento, los detalles son los siguientes:

    • El nivel de riesgo mínimo para los eventos suscritos es {"filterType":"RuleRiskLevel","value":"1","multiple":false}.

      value especifica el nivel de riesgo que desea filtrar. Valores válidos: 1: riesgo alto. 2: riesgo medio. 3: riesgo bajo.

      multiple especifica si este grupo de campos de filtro admite múltiples valores. El nivel de riesgo solo admite el filtrado de un solo valor, lo que significa que el campo multiple para la entrega de contenido de eventos de cumplimiento solo puede establecerse en false.

    • Los tipos de recursos para los eventos suscritos son {"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}.

      values especifica los tipos de recursos para los cuales desea suscribirse a eventos. El valor es una matriz JSON de tipos de recursos. Ejemplo: [{"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 si este grupo de campos de filtro admite múltiples valores. Los tipos de recursos admiten el filtrado de múltiples valores. Cuando se seleccionan varios tipos de recursos, el campo multiple puede establecerse en true.

    • También puede especificar tanto el nivel de riesgo como los tipos de recursos. Ejemplo: [{"filterType":"RuleRiskLevel","value":"2","multiple":false},{"filterType":"ResourceType","values":["ACS::CDN::Domain","ACS::ActionTrail::Trail"],"multiple":true}]

  • Si especifica los tipos de recursos para la entrega de configuración de recursos, los tipos de recursos son {"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}.

    values especifica los tipos de recursos que desea entregar. El valor es una matriz JSON de tipos de recursos. Ejemplo: [{"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

No

El ARN del bucket de OSS al que se transfieren los datos de entrega cuando los datos superan el límite de tamaño del canal de entrega. El formato es acs:oss:{RegionId}:{accountId}:{bucketName}.

Si no establece este parámetro, Cloud Config entrega solo información resumida.

Nota

Este parámetro se aplica únicamente a los canales de entrega SLS y MNS. El límite de tamaño para el canal de entrega SLS es de 1 MB, y el límite de tamaño para el canal de entrega Simple Message Queue (anteriormente MNS) es de 64 KB.

acs:oss:cn-shanghai:100931896542****:new-bucket

Description

string

No

La descripción del canal de entrega.

Mi entrega a OSS

ClientToken

string

No

El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero asegúrese de que el token sea único entre diferentes solicitudes.

El valor de ClientToken solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.

1594295238-f9361358-5843-4294-8d30-b5183fac****

ConfigurationSnapshot

boolean

No

Especifica si se deben recibir instantáneas programadas de recursos. Cloud Config entrega instantáneas programadas de recursos a OSS o SLS a las 04:00Z y 16:00Z (UTC) todos los días. Valores válidos:

  • true: recibe instantáneas programadas de recursos.

  • false (predeterminado): no recibe instantáneas programadas de recursos.

Nota
  • Si el tipo de canal de entrega es OSS, debe establecerse al menos uno de los siguientes parámetros: ConfigurationSnapshot (instantáneas programadas de recursos) y ConfigurationItemChangeNotification (historial de configuración).

Nota
  • Si el tipo de canal de entrega es SLS, debe establecerse al menos uno de los siguientes parámetros: ConfigurationSnapshot (instantáneas programadas de recursos), ConfigurationItemChangeNotification (historial de configuración), CompliantSnapshot (instantáneas de cumplimiento) y NonCompliantNotification (eventos de incumplimiento de recursos).

true

CompliantSnapshot

boolean

No

Especifica si se deben recibir instantáneas de cumplimiento. Cloud Config entrega información de cumplimiento e incumplimiento de recursos a SLS. Valores válidos:

  • true: recibe instantáneas de cumplimiento.

  • false: no recibe instantáneas de cumplimiento.

false

ConfigurationItemChangeNotification

boolean

No

Especifica si se debe aceptar el historial de configuración de recursos. Cuando cambia la configuración de un recurso, Cloud Config entrega el historial de configuración del recurso a OSS, SLS o Simple Message Queue (anteriormente MNS). Valores válidos:

  • true: acepta el historial de configuración de recursos.

  • false (predeterminado): no acepta el historial de configuración de recursos.

Nota
  • Si el tipo de canal de entrega es OSS, debe establecerse al menos uno de los siguientes parámetros: ConfigurationSnapshot (instantáneas programadas de recursos) y ConfigurationItemChangeNotification (historial de configuración).

Nota
  • Si el tipo de canal de entrega es SLS, debe establecerse al menos uno de los siguientes parámetros: ConfigurationSnapshot (instantáneas programadas de recursos), CompliantSnapshot (instantáneas de cumplimiento), ConfigurationItemChangeNotification (historial de configuración) y NonCompliantNotification (eventos de incumplimiento de recursos).

Nota
  • Si el tipo de canal de entrega es MNS, debe establecerse al menos uno de los siguientes parámetros: ConfigurationItemChangeNotification (historial de configuración) y NonCompliantNotification (eventos de incumplimiento de recursos).

false

NonCompliantNotification

boolean

No

Especifica si se deben aceptar eventos de incumplimiento de recursos. Cuando un recurso incumple las normas, Cloud Config entrega el evento de incumplimiento del recurso a SLS o Simple Message Queue (anteriormente MNS). Valores válidos:

  • true: acepta eventos de incumplimiento de recursos.

  • false (predeterminado): no acepta eventos de incumplimiento de recursos.

Nota
  • Si el tipo de canal de entrega es SLS, debe establecerse al menos uno de los siguientes parámetros: ConfigurationSnapshot (instantáneas programadas de recursos), CompliantSnapshot (instantáneas de cumplimiento), ConfigurationItemChangeNotification (historial de configuración) y NonCompliantNotification (eventos de incumplimiento de recursos).

Nota
  • Si el tipo de canal de entrega es MNS, debe establecerse al menos uno de los siguientes parámetros: ConfigurationItemChangeNotification (historial de configuración) y NonCompliantNotification (eventos de incumplimiento de recursos).

false

DeliverySnapshotTime

string

No

La hora a la que comienza la entrega diaria de instantáneas programadas de recursos.

El formato es HH:mmZ (UTC).

Nota

Si habilita la entrega de instantáneas programadas de recursos, puede utilizar este parámetro para personalizar la hora de entrega. Si no establece este parámetro, la entrega comienza a las 04:00Z y 16:00Z de forma predeterminada todos los días.

09:10Z

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Ninguna.

RequestId

string

El ID de la solicitud.

A7A0FFF8-0B44-40C6-8BBF-3A185EFDERTHG

DeliveryChannelId

string

El ID del canal de entrega.

cdc-8e45ff4e06a3a8****

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.