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

Obtém a lista de recursos agregados entre regiões na conta atual.

Descrição da operação

Limites

O Cloud Config suporta apenas serviços e tipos de recursos específicos da Alibaba Cloud. Portanto, o inventário de recursos exibe apenas um subconjunto de recursos. Para obter mais informações sobre os serviços e tipos de recursos suportados pelo Cloud Config, consulte Tipos de recursos e relações de recursos suportados pelo Cloud Config.

Notas de uso

Este tópico fornece um exemplo para consultar a lista de recursos na conta atual. A resposta mostra que a lista de recursos contém um total de 8 recursos.

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

list

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ResourceId	string	Não	O ID do recurso.	eni-hp31cqoba96jagtz****
ResourceName	string	Não	O nome do recurso.	test-resource-name
ResourceDeleted	integer	Não	O status do recurso. Valores válidos: 0: Excluído. Se você excluiu um recurso no serviço de nuvem de destino, o recurso é exibido como Excluído nos recursos do Cloud Config. 1 (padrão): Retido. Se o seu recurso for gerenciado em um estado Normal, o recurso é exibido como Retido nos recursos do Cloud Config.	1
MaxResults	integer	Sim	O número máximo de entradas a serem retornadas para uma única solicitação. Valores válidos: 1 a 100.	10
ResourceTypes	string	Não	Os tipos de recurso. Separe vários tipos de recurso com vírgulas (,).	ACS::ECS::NetworkInterface
Regions	string	Não	Os IDs das regiões às quais os recursos pertencem. Separe vários IDs de região com vírgulas (,).	cn-hangzhou
NextToken	string	Não	O token de paginação. Quando os resultados retornados de uma solicitação são truncados, você pode usar o NextToken para iniciar outra solicitação e obter os resultados restantes.	IWBjqMYSy0is7zSMGu16****
StartUpdateTimestamp	integer	Não	A hora de início do intervalo de tempo para consulta de recursos. A hora é um carimbo de data/hora UTC padrão. Limites: O valor deve ser um carimbo de data/hora em milissegundos. O valor não pode ser maior que EndUpdateTimestamp, e o intervalo entre a hora de início e a hora de término não pode exceder 30 dias. StartUpdateTimestamp e EndUpdateTimestamp devem ser ambos especificados ou ambos deixados vazios.	1722441600000
EndUpdateTimestamp	integer	Não	A hora de término do intervalo de tempo para consulta de recursos. A hora é um carimbo de data/hora UTC padrão. Limites: O valor deve ser um carimbo de data/hora em milissegundos. O valor não pode ser menor que StartUpdateTimestamp, e o intervalo entre a hora de início e a hora de término não pode exceder 30 dias. StartUpdateTimestamp e EndUpdateTimestamp devem ser ambos especificados ou ambos deixados vazios.	1724947200000
ExcludeResourceTypes	string	Não	Os tipos de recurso a serem excluídos. Separe vários tipos de recurso com vírgulas (,). Se este parâmetro entrar em conflito com o parâmetro ResourceTypes, este parâmetro terá precedência.	ACS::ECS::Instance,ACS::ECS::NetworkInterface

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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Nenhum.
DiscoveredResourceProfiles	object	Os recursos.
DiscoveredResourceProfileList	array<object>	Os detalhes dos recursos.
	object	Nenhum.
AccountId	integer	O ID da conta da Alibaba Cloud do proprietário do recurso.	161259599160****
AvailabilityZone	string	A zona.	cn-hangzhou-h
Region	string	O ID da região.	cn-hangzhou
ResourceCreationTime	integer	O carimbo de data/hora de quando o recurso foi criado. Unidade: milissegundos.	1618675206000
ResourceDeleted	integer	O status do recurso. Valores válidos: 0: Excluído. 1: Retido.	1
ResourceId	string	O ID do recurso.	eni-hp31cqoba96jagtz****
ResourceName	string	O nome do recurso.	Cloud Firewall
ResourceStatus	string	O status do recurso. O status de um recurso depende da definição do serviço de nuvem ao qual o recurso pertence. Este parâmetro pode estar vazio. Exemplos: Se o tipo de recurso for ACS::ECS::Instance, este parâmetro será Running ou Stopped porque as instâncias ECS possuem status. Se o tipo de recurso for ACS::OSS::Bucket, este parâmetro estará vazio porque os buckets do OSS não possuem status.	InUse
ResourceType	string	O tipo de recurso.	ACS::ECS::NetworkInterface
Tags	string	As tags do recurso.	{\"key1\":[\"value2\"]}
UpdateTime	integer	O carimbo de data/hora da última atualização do recurso. Unidade: milissegundos.	1722441600000
Version	integer	A versão da alteração do recurso.	1
VpcId	string	O ID da VPC à qual o recurso pertence. Formato: vpc-t4nhheyvay74fp7n0hxxx. Se o recurso não pertencer a uma VPC, uma string vazia "" será retornada.	vpc-t4nhheyvay74fp7n0hxxx
VSwitchId	string	O ID do vSwitch ao qual o recurso pertence. Formato: vsw-t4n7pokxxxxxxxxxxxxxx. Se existirem vários valores, eles serão separados por vírgulas (,), como vsw-t4n7pokxxxxxxxxxxxxxx,vsw-t4n7pokxxxxxxxxxxxxxx. Se o recurso não pertencer a um vSwitch, uma string vazia "" será retornada.	vsw-t4n7pokxxxxxxxxxxxxxx
ResourceGroupId	string	O ID do grupo de recursos ao qual o recurso pertence. Exemplo: rg-acfmvoh45rhxxxx.	rg-acfmvoh45rhxxxx
MaxResults	integer	O número máximo de entradas por página.	10
NextToken	string	O token usado para consultar a próxima página.	IWBjqMYSy0is7zSMGu16****
TotalCount	integer	O número total de recursos.	8
RequestId	string	O ID da solicitação.	C7817373-78CB-4F9A-8AFA-E7A88E9D64A2

Exemplos

Resposta de sucesso

JSON formato

{
  "DiscoveredResourceProfiles": {
    "DiscoveredResourceProfileList": [
      {
        "AccountId": 0,
        "AvailabilityZone": "cn-hangzhou-h",
        "Region": "cn-hangzhou",
        "ResourceCreationTime": 1618675206000,
        "ResourceDeleted": 1,
        "ResourceId": "eni-hp31cqoba96jagtz****",
        "ResourceName": "Cloud Firewall",
        "ResourceStatus": "InUse",
        "ResourceType": "ACS::ECS::NetworkInterface",
        "Tags": "{\\\"key1\\\":[\\\"value2\\\"]}",
        "UpdateTime": 1722441600000,
        "Version": 1,
        "VpcId": "vpc-t4nhheyvay74fp7n0hxxx",
        "VSwitchId": "vsw-t4n7pokxxxxxxxxxxxxxx",
        "ResourceGroupId": "rg-acfmvoh45rhxxxx"
      }
    ],
    "MaxResults": 10,
    "NextToken": "IWBjqMYSy0is7zSMGu16****",
    "TotalCount": 8
  },
  "RequestId": "C7817373-78CB-4F9A-8AFA-E7A88E9D64A2"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	NoPermission	You are not authorized to perform this operation.
400	MemberNotBelongToMaster	The specified member does not belong to your organization.
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.