GetAggregateConfigDeliveryChannel - Cloud Config - Centro de documentación de Alibaba Cloud

Consulta la información sobre un canal de entrega en un grupo de cuentas.

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

get

*AggregateDelivery

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DeliveryChannelId	string	Sí	El ID del canal de entrega. Para obtener más información sobre cómo obtener el ID de un canal de entrega, consulte ListAggregateConfigDeliveryChannels.	cdc-d9106457e0d900b1****
AggregatorId	string	Sí	El ID del grupo de cuentas. Para obtener más información sobre cómo obtener el ID del grupo de cuentas, consulte ListAggregators.	ca-a4e5626622af0079****

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	N/A.
DeliveryChannel	object	La información sobre un canal de entrega.
Status	integer	El estado del canal de entrega. Valores válidos: 0: El canal de entrega está deshabilitado. 1: El canal de entrega está habilitado.	1
DeliveryChannelId	string	El ID del canal de entrega.	cdc-d9106457e0d900b1****
DeliveryChannelName	string	El nombre del canal de entrega.	myDeliveryChannel
DeliveryChannelType	string	El tipo de canal de entrega. Valores válidos: OSS: Object Storage Service (OSS) MNS: Message Service (MNS) SLS: Log Service	OSS
DeliveryChannelTargetArn	string	El ARN del destino de entrega. Si el valor del parámetro DeliveryChannelType es OSS, el valor de este parámetro es el ARN del bucket de OSS de destino. Si el valor del parámetro DeliveryChannelType es MNS, el valor de este parámetro es el ARN del tema de MNS de destino. Si el valor del parámetro DeliveryChannelType es SLS, el valor de este parámetro es el ARN del Logstore de Log Service de destino.	acs:oss:cn-shanghai:120886317861****:new-bucket
DeliveryChannelAssumeRoleArn	string	El ARN del rol asignado al canal de entrega.	acs:ram::120886317861****:role/aliyunserviceroleforconfig
DeliveryChannelCondition	string	La regla asociada al canal de entrega. Este parámetro está disponible cuando se entregan datos de todos los tipos a MNS o cuando se entregan instantáneas a Log Service. Si el valor del parámetro DeliveryChannelType es MNS, tenga en cuenta las siguientes configuraciones del nivel de riesgo mínimo y los tipos de recursos de los eventos a los que se suscribió: El nivel de riesgo mínimo de los eventos a los que desea suscribirse tiene el siguiente formato: `{"filterType":"RuleRiskLevel","value":"1","multiple":false}`. El campo `value` indica el nivel de riesgo de los eventos a los que desea suscribirse. Valores válidos: 1, 2 y 3. El valor 1 indica el nivel de riesgo alto, el valor 2 indica el nivel de riesgo medio y el valor 3 indica el nivel de riesgo bajo. La configuración de los tipos de recursos de los eventos a los que desea suscribirse tiene el siguiente formato: `{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}`. El campo `values` indica los tipos de recursos de los eventos a los que desea suscribirse. El valor del campo es una matriz JSON. Ejemplos: `[{"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 configura el parámetro DeliveryChannelType como SLS, la configuración de los tipos de recursos de las instantáneas que desea entregar tiene el siguiente formato: `{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}`. El campo `values` especifica los tipos de recursos de las instantáneas que desea entregar. El valor del campo es una matriz JSON. Ejemplos: `[{"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	El ARN del bucket de OSS al que se transfieren los datos entregados cuando el tamaño de los datos supera el límite superior especificado del canal de entrega.	acs:oss:cn-shanghai:100931896542****:new-bucket
Description	string	La descripción del canal de entrega.	My OSS delivery
CompliantSnapshot	boolean	Indica si el destino especificado recibe instantáneas de cumplimiento programadas. Cloud Config entrega instantáneas de cumplimiento programadas a las `04:00Z` y `16:00Z` a Log Service todos los días. La hora se muestra en UTC. Valores válidos: true: El destino especificado recibe instantáneas de cumplimiento programadas. false: El destino especificado no recibe instantáneas de cumplimiento programadas.	false
ConfigurationItemChangeNotification	boolean	Indica si el destino especificado recibe registros de cambios de recursos. Si el valor de este parámetro es true, Cloud Config entrega los registros de cambios de recursos a OSS, Log Service o MNS cuando cambian las configuraciones de los recursos. Valores válidos: true: El destino especificado recibe registros de cambios de recursos. false: El destino especificado no recibe registros de cambios de recursos.	true
NonCompliantNotification	boolean	Indica si el destino especificado recibe eventos de incumplimiento de recursos. Si el valor de este parámetro es true, Cloud Config entrega eventos de incumplimiento de recursos a Log Service o MNS cuando los recursos se evalúan como no conformes. Valores válidos: true: El destino especificado recibe eventos de incumplimiento de recursos. false: El destino especificado no recibe eventos de incumplimiento de recursos.	false
AggregatorId	string	El ID del grupo de cuentas.	ca-a4e5626622af0079****
AccountId	string	El ID del miembro en el grupo de cuentas.	120886317861****
DeliverySnapshotTime	string	La hora a la que Cloud Config entrega instantáneas de recursos programadas todos los días. Formato: `HH:mmZ`. Esta hora se muestra en UTC.	09:10Z
ConfigurationSnapshot	boolean	Indica si el destino especificado recibe instantáneas de recursos programadas. Cloud Config entrega instantáneas de recursos programadas a las `04:00Z` y `16:00Z` a OSS, MNS o Log Service todos los días. La hora se muestra en UTC. Valores válidos: true: El destino especificado recibe instantáneas de recursos programadas. false: El destino especificado no recibe instantáneas de recursos programadas.	false
RequestId	string	El ID de la solicitud.	DC300244-FCE3-5061-8214-C27ECB668487

Ejemplos

Respuesta exitosa

JSON Formato

{
  "DeliveryChannel": {
    "Status": 1,
    "DeliveryChannelId": "cdc-d9106457e0d900b1****",
    "DeliveryChannelName": "myDeliveryChannel",
    "DeliveryChannelType": "OSS",
    "DeliveryChannelTargetArn": "acs:oss:cn-shanghai:120886317861****:new-bucket",
    "DeliveryChannelAssumeRoleArn": "acs:ram::120886317861****:role/aliyunserviceroleforconfig",
    "DeliveryChannelCondition": "[{\"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": "acs:oss:cn-shanghai:100931896542****:new-bucket",
    "Description": "My OSS delivery.",
    "CompliantSnapshot": false,
    "ConfigurationItemChangeNotification": true,
    "NonCompliantNotification": false,
    "AggregatorId": "ca-a4e5626622af0079****",
    "AccountId": "120886317861****",
    "DeliverySnapshotTime": "09:10Z",
    "ConfigurationSnapshot": false
  },
  "RequestId": "DC300244-FCE3-5061-8214-C27ECB668487"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	DeliveryChannelNotExists	The delivery channel does not exist.
404	AccountNotExisted	Your account does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.

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.