Todos los productos
Search
Centro de documentos

Cloud Config:UpdateAggregateConfigDeliveryChannel

Última actualización: Sep 02, 2026

Modifica un canal de entrega en un grupo de cuentas especificado.

Descripción de la operación

Este tema proporciona un ejemplo sobre cómo cambiar el estado del canal de entrega cdc-8e45ff4e06a3a8**** en el grupo de cuentas ca-a4e5626622af0079**** a 0 (deshabilitado). Después de deshabilitar un canal de entrega, Cloud Config conserva la configuración de entrega más reciente y deja de entregar datos de recursos.

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

update

*AggregateDelivery

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

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

AggregatorId

string

Sí

El ID del grupo de cuentas que existe en la cuenta actual. Puede llamar a ListAggregators para consultar el ID del grupo de cuentas. El DeliveryChannelId debe ser el ID de un canal de entrega que exista en el grupo de cuentas. Puede llamar a ListAggregateConfigDeliveryChannels para consultar el ID del canal de entrega.

ca-a4e5626622af0079****

DeliveryChannelId

string

Sí

El ID del canal de entrega.

Para obtener información sobre cómo obtener el ID del canal de entrega, consulte ListAggregateConfigDeliveryChannels.

cdc-8e45ff4e06a3a8****

DeliveryChannelName

string

No

El nombre del canal de entrega.

testoss

DeliveryChannelTargetArn

string

No

El nombre de recurso de Alibaba Cloud (ARN) del destino de entrega. Valores válidos:

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

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

  • Si el 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 adjunta al canal de entrega. Este parámetro admite todas las entregas a través del canal MNS y las entregas de instantáneas a través del canal SLS.

  • Si especifica el nivel de riesgo mínimo y los tipos de recursos para los eventos de suscripción de MNS:

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

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

    • Los tipos de recursos para los eventos de suscripción 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}]

  • Si especifica los tipos de recursos para la entrega de instantáneas de SLS, 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 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

Solo se admiten los canales de entrega SLS y MNS. El límite del canal de entrega para Simple Log Service (SLS) es de 1 MB, y el límite del canal de entrega para 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.

My OSS delivery

ClientToken

string

No

Garantiza la idempotencia de la solicitud. Genere un valor de parámetro desde su cliente para garantizar que el valor sea único en diferentes solicitudes.

ClientToken solo admite 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 programan instantáneas de recursos. Cloud Config entrega instantáneas de recursos programadas a OSS y Simple Message Queue (anteriormente MNS) a las 04:00Z y 16:00Z (UTC) todos los días. Valores válidos:

  • true: Aceptar instantáneas de recursos programadas.

  • false (predeterminado): No aceptar instantáneas de recursos programadas.

false

CompliantSnapshot

boolean

No

Especifica si se reciben instantáneas de cumplimiento. Cloud Config entrega información de cumplimiento y no cumplimiento de recursos a SLS. Valores válidos:

  • true: Recibir instantáneas de cumplimiento.

  • false: No recibir instantáneas de cumplimiento.

false

ConfigurationItemChangeNotification

boolean

No

Especifica si se acepta 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: Aceptar el historial de configuración de recursos.

  • false (predeterminado): No aceptar el historial de configuración de recursos.

Nota

Se admiten los canales de entrega OSS, SLS y MNS.

false

NonCompliantNotification

boolean

No

Especifica si se aceptan eventos de no cumplimiento de recursos. Cuando un recurso no cumple con las normas, Cloud Config entrega el evento de no cumplimiento del recurso a SLS o Simple Message Queue (anteriormente MNS). Valores válidos:

  • true: Aceptar eventos de no cumplimiento de recursos.

  • false (predeterminado): No aceptar eventos de no cumplimiento de recursos.

Nota

Solo se admiten los canales de entrega SLS y MNS.

false

Status

integer

No

El estado del canal de entrega. Valores válidos:

  • 0: Deshabilitado. Cloud Config conserva la configuración de entrega más reciente y deja de entregar datos de recursos.

  • 1 (predeterminado): Habilitado.

0

DeliverySnapshotTime

string

No

La hora a la que comienza a entregarse la instantánea de recursos programada cada día.

El formato es HH:mmZ (UTC).

Nota

Cuando habilita la entrega de instantáneas de recursos programadas, puede usar 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

Ninguno.

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.