Queries the information about a delivery channel.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes GetConfigDeliveryChannel

The operation that you want to perform. Set the value to GetConfigDeliveryChannel.

DeliveryChannelId String Yes cdc-d9106457e0d900b1****

The ID of the delivery channel.

For more information about how to obtain the ID of the delivery channel, see DescribeDeliveryChannels.

For more information about common request parameters, see Common parameters.

Response parameters

Parameter Type Example Description
DeliveryChannel Object

The information about the delivery channel.

Status Integer 1

The status of the delivery channel. Valid values:

  • 0: The delivery channel is disabled.
  • 1: The delivery channel is enabled.
DeliveryChannelId String cdc-d9106457e0d900b1****

The ID of the delivery channel.

DeliveryChannelName String myDeliveryChannel

The name of the delivery channel.

DeliveryChannelType String OSS

The type of the delivery channel. Valid values:

  • OSS: Object Storage Service (OSS)
  • MNS: Message Service (MNS)
  • SLS: Log Service
DeliveryChannelTargetArn String acs:oss:cn-shanghai:120886317861****:new-bucket

The Alibaba Cloud Resource Name (ARN) of the delivery destination.

  • If the DeliveryChannelType parameter is set to OSS, the value of this parameter is the ARN of the destination OSS bucket.
  • If the DeliveryChannelType parameter is set to MNS, the value of this parameter is the ARN of the destination MNS topic.
  • If the DeliveryChannelType parameter is set to SLS, the value is the ARN of the destination Log Service Logstore.
DeliveryChannelAssumeRoleArn String acs:ram::120886317861****:role/aliyunserviceroleforconfig

The ARN of the role assumed by the delivery channel.

DeliveryChannelCondition String [{"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}]

The rule attached to the delivery channel. This parameter is available only for delivery channels of the MNS type.

This parameter indicates the lowest risk level for the events to subscribe to and the resource types for which you subscribe to events.

  • The setting of the lowest risk level for the events to subscribe to is in the following format: {"filterType":"RuleRiskLevel","value":"1","multiple":false}.

    The value field indicates the lowest risk level. Valid values: 1, 2, and 3, where 1 indicates the high risk level, 2 indicates the medium risk level, and 3 indicates the low risk level.

  • The setting of the resource types for which you subscribe to events is in the following format: {"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}.

    The values field indicates the resource types for which you subscribe to events. The value is a JSON array.

    Example: [{"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 acs:oss:cn-shanghai:100931896542****:new-bucket

The ARN of the OSS bucket to which the delivered data is transferred when the size of the data exceeds the specified upper limit of the delivery channel.

Description String My OSS delivery.

The description of the delivery channel.

ConfigurationSnapshot Boolean false

Indicates whether the scheduled resource snapshots are received by the OSS bucket. If you set this parameter to true, Cloud Config delivers the scheduled resource snapshots to the specified OSS bucket at 00:00:00 and 12:00:00 every day. Valid values:

  • true: The scheduled resource snapshots are received by the specified OSS bucket.
  • false: The scheduled resource snapshots are not received by the specified OSS bucket.
ConfigurationItemChangeNotification Boolean true

Indicates whether the resource change logs are received by the specified destination. If you set this parameter to true, Cloud Config delivers the resource change logs to OSS, Log Service, or MNS when the configurations of the resources change. Valid values:

  • true: The resource change logs are received by the specified destination.
  • false: The resource change logs are not received by the specified destination.
NonCompliantNotification Boolean false

Indicates whether the resource non-compliance events are received by the specified destination. If you set this parameter to true, Cloud Config delivers resource non-compliance events to Log Service or MNS when resources are evaluated as non-compliant. Valid values:

  • true: The resource non-compliance events are received by the specified destination.
  • false: The resource non-compliance events are not received by the specified destination.
AccountId Long 120886317861****

The ID of your Alibaba Cloud account.

RequestId String DC300244-FCE3-5061-8214-C27ECB668487

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=GetConfigDeliveryChannel
&DeliveryChannelId=cdc-d9106457e0d900b1****
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<GetConfigDeliveryChannelResponse>
    <DeliveryChannel>
        <Status>1</Status>
        <DeliveryChannelId>cdc-d9106457e0d900b1****</DeliveryChannelId>
        <DeliveryChannelName>myDeliveryChannel</DeliveryChannelName>
        <DeliveryChannelType>OSS</DeliveryChannelType>
        <DeliveryChannelTargetArn>acs:oss:cn-shanghai:120886317861****:new-bucket</DeliveryChannelTargetArn>
        <DeliveryChannelAssumeRoleArn>acs:ram::120886317861****:role/aliyunserviceroleforconfig</DeliveryChannelAssumeRoleArn>
        <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}]</DeliveryChannelCondition>
        <OversizedDataOSSTargetArn>acs:oss:cn-shanghai:100931896542****:new-bucket</OversizedDataOSSTargetArn>
        <Description>My OSS delivery.</Description>
        <ConfigurationSnapshot>false</ConfigurationSnapshot>
        <ConfigurationItemChangeNotification>true</ConfigurationItemChangeNotification>
        <NonCompliantNotification>false</NonCompliantNotification>
    </DeliveryChannel>
    <RequestId>DC300244-FCE3-5061-8214-C27ECB668487</RequestId>
</GetConfigDeliveryChannelResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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.",
    "ConfigurationSnapshot" : false,
    "ConfigurationItemChangeNotification" : true,
    "NonCompliantNotification" : false
  },
  "RequestId" : "DC300244-FCE3-5061-8214-C27ECB668487"
}

Error codes

HttpCode Error code Error message Description
400 DeliveryChannelNotExists The delivery channel does not exist. The error message returned because the specified delivery channel does not exist.
404 AccountNotExisted Your account does not exist. The error message returned because the account does not exist.
503 ServiceUnavailable The request has failed due to a temporary failure of the server. The error message returned because the service is unavailable.

For a list of error codes, visit the API Error Center.