GetAggregateConfigDeliveryChannel - Cloud Config: Central de Documentação do Alibaba Cloud

Consulta as informações sobre um canal de entrega em um grupo de contas.

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

get

*AggregateDelivery

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DeliveryChannelId	string	Sim	O ID do canal de entrega. Para mais informações sobre como obter o ID de um canal de entrega, consulte ListAggregateConfigDeliveryChannels.	cdc-d9106457e0d900b1****
AggregatorId	string	Sim	O ID do grupo de contas. Para mais informações sobre como obter o ID do grupo de contas, consulte ListAggregators.	ca-a4e5626622af0079****

Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	N/A.
DeliveryChannel	object	As informações sobre um canal de entrega.
Status	integer	O status do canal de entrega. Valores válidos: 0: O canal de entrega está desativado. 1: O canal de entrega está ativado.	1
DeliveryChannelId	string	O ID do canal de entrega.	cdc-d9106457e0d900b1****
DeliveryChannelName	string	O nome do canal de entrega.	myDeliveryChannel
DeliveryChannelType	string	O tipo do canal de entrega. Valores válidos: OSS: Object Storage Service (OSS) MNS: Message Service (MNS) SLS: Log Service	OSS
DeliveryChannelTargetArn	string	O ARN do destino de entrega. Se o valor do parâmetro DeliveryChannelType for OSS, o valor deste parâmetro é o ARN do bucket OSS de destino. Se o valor do parâmetro DeliveryChannelType for MNS, o valor deste parâmetro é o ARN do tópico MNS de destino. Se o valor do parâmetro DeliveryChannelType for SLS, o valor deste parâmetro é o ARN do Logstore do Log Service de destino.	acs:oss:cn-shanghai:120886317861****:new-bucket
DeliveryChannelAssumeRoleArn	string	O ARN da role atribuída ao canal de entrega.	acs:ram::120886317861****:role/aliyunserviceroleforconfig
DeliveryChannelCondition	string	A regra anexada ao canal de entrega. Este parâmetro está disponível quando você entrega dados de todos os tipos ao MNS ou entrega snapshots ao Log Service. Se o valor do parâmetro DeliveryChannelType for MNS, observe as seguintes configurações do nível de risco mais baixo e dos tipos de recursos dos eventos aos quais você se inscreveu: O nível de risco mais baixo dos eventos aos quais você deseja se inscrever está no seguinte formato: `{"filterType":"RuleRiskLevel","value":"1","multiple":false}`. O campo `value` indica o nível de risco dos eventos aos quais você deseja se inscrever. Valores válidos: 1, 2 e 3. O valor 1 indica o nível de risco alto, o valor 2 indica o nível de risco médio e o valor 3 indica o nível de risco baixo. A configuração dos tipos de recursos dos eventos aos quais você deseja se inscrever está no seguinte formato: `{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}`. O campo `values` indica os tipos de recursos dos eventos aos quais você deseja se inscrever. O valor do campo é um array JSON. Exemplos: `[{"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}]` Se você definir o parâmetro DeliveryChannelType como SLS, a configuração dos tipos de recursos dos snapshots que você deseja entregar está no seguinte formato: `{"filterType":"ResourceType","values":["ACS::ACK::Cluster","ACS::ActionTrail::Trail","ACS::CBWP::CommonBandwidthPackage"],"multiple":true}`. O campo `values` especifica os tipos de recursos dos snapshots que você deseja entregar. O valor do campo é um array JSON. Exemplos: `[{"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	O ARN do bucket OSS para o qual os dados entregues são transferidos quando o tamanho dos dados excede o limite superior especificado do canal de entrega.	acs:oss:cn-shanghai:100931896542****:new-bucket
Description	string	A descrição do canal de entrega.	My OSS delivery.
CompliantSnapshot	boolean	Indica se o destino especificado recebe snapshots de conformidade agendados. O Cloud Config entrega snapshots de conformidade agendados às `04:00Z` e `16:00Z` para o Log Service todos os dias. O horário é exibido em UTC. Valores válidos: true: O destino especificado recebe snapshots de conformidade agendados. false: O destino especificado não recebe snapshots de conformidade agendados.	false
ConfigurationItemChangeNotification	boolean	Indica se o destino especificado recebe logs de alteração de recursos. Se o valor deste parâmetro for true, o Cloud Config entrega os logs de alteração de recursos ao OSS, Log Service ou MNS quando as configurações dos recursos são alteradas. Valores válidos: true: O destino especificado recebe logs de alteração de recursos. false: O destino especificado não recebe logs de alteração de recursos.	true
NonCompliantNotification	boolean	Indica se o destino especificado recebe eventos de não conformidade de recursos. Se o valor deste parâmetro for true, o Cloud Config entrega eventos de não conformidade de recursos ao Log Service ou MNS quando os recursos são avaliados como não conformes. Valores válidos: true: O destino especificado recebe eventos de não conformidade de recursos. false: O destino especificado não recebe eventos de não conformidade de recursos.	false
AggregatorId	string	O ID do grupo de contas.	ca-a4e5626622af0079****
AccountId	string	O ID do membro no grupo de contas.	120886317861****
DeliverySnapshotTime	string	O horário em que o Cloud Config entrega snapshots de recursos agendados todos os dias. Formato: `HH:mmZ`. Este horário é exibido em UTC.	09:10Z
ConfigurationSnapshot	boolean	Indica se o destino especificado recebe snapshots de recursos agendados. O Cloud Config entrega snapshots de recursos agendados às `04:00Z` e `16:00Z` para o OSS, MNS ou Log Service todos os dias. O horário é exibido em UTC. Valores válidos: true: O destino especificado recebe snapshots de recursos agendados. false: O destino especificado não recebe snapshots de recursos agendados.	false
RequestId	string	O ID da solicitação.	DC300244-FCE3-5061-8214-C27ECB668487

Exemplos

Resposta de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro
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 Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.