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

Consulta una lista de recursos agregados entre regiones en la cuenta actual de Alibaba Cloud.

Descripción de la operación

Límites

Cloud Config solo admite servicios y tipos de recursos específicos de Alibaba Cloud. La lista de recursos devuelta incluye únicamente estos recursos compatibles. Para obtener más información sobre los servicios y tipos de recursos admitidos, consulte Tipos de recursos y relaciones de recursos compatibles.

Notas de uso

Este tema proporciona un ejemplo de cómo consultar los recursos en su cuenta. La respuesta de ejemplo muestra que se devuelven ocho 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:ListDiscoveredResources

list

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ResourceId	string	No	El ID del recurso.	eni-hp31cqoba96jagtz****
ResourceName	string	No	El nombre del recurso.	test-resource-name
ResourceDeleted	integer	No	El estado del recurso. Valores válidos: 0: El recurso está eliminado. Si elimina un recurso en el servicio correspondiente de Alibaba Cloud, Cloud Config muestra el recurso como Eliminado. 1 (Predeterminado): El recurso está activo. Si un recurso se administra, Cloud Config muestra el recurso como Activo.	1
MaxResults	integer	Sí	El número máximo de entradas a devolver en cada página. Valores válidos: de 1 a 100.	10
ResourceTypes	string	No	El tipo de recurso. Separe varios tipos de recursos con comas (,).	ACS::ECS::NetworkInterface
Regions	string	No	El ID de la región donde reside el recurso. Separe varios ID de región con comas (,).	cn-hangzhou
NextToken	string	No	Un token de paginación. Si la respuesta se trunca, utilice este token en una solicitud posterior para recuperar la siguiente página de resultados.	IWBjqMYSy0is7zSMGu16****
StartUpdateTimestamp	integer	No	El inicio del intervalo de tiempo para consultar recursos, especificado como una marca de tiempo UNIX en milisegundos. Nota: El valor no puede ser posterior a EndUpdateTimestamp. El intervalo de tiempo entre StartUpdateTimestamp y EndUpdateTimestamp no puede exceder los 30 días. Especifique tanto StartUpdateTimestamp como EndUpdateTimestamp, o deje ambos en blanco.	1722441600000
EndUpdateTimestamp	integer	No	El fin del intervalo de tiempo para consultar recursos, especificado como una marca de tiempo UNIX en milisegundos. Nota: El valor no puede ser anterior a StartUpdateTimestamp. El intervalo de tiempo entre StartUpdateTimestamp y EndUpdateTimestamp no puede exceder los 30 días. Especifique tanto StartUpdateTimestamp como EndUpdateTimestamp, o deje ambos en blanco.	1724947200000
ExcludeResourceTypes	string	No	Los tipos de recursos a excluir. Separe varios tipos de recursos con comas (,). Este parámetro tiene prioridad sobre el parámetro ResourceTypes.	ACS::ECS::Instance,ACS::ECS::NetworkInterface

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	No se devuelven datos.
DiscoveredResourceProfiles	object	La lista de recursos.
DiscoveredResourceProfileList	array<object>	Los detalles de los recursos.
	object	Ninguna.
AccountId	integer	El ID de la cuenta de Alibaba Cloud a la que pertenece el recurso.	161259599160****
AvailabilityZone	string	La zona de disponibilidad del recurso.	cn-hangzhou-h
Region	string	El ID de la región.	cn-hangzhou
ResourceCreationTime	integer	La hora en que se creó el recurso. Es una marca de tiempo UNIX en milisegundos.	1618675206000
ResourceDeleted	integer	El estado del recurso. Valores válidos: 0: Eliminado. 1: Activo.	1
ResourceId	string	El ID del recurso.	eni-hp31cqoba96jagtz****
ResourceName	string	El nombre del recurso.	Cloud Firewall
ResourceStatus	string	El estado del recurso. El estado lo define el servicio correspondiente de Alibaba Cloud. Este parámetro puede estar vacío. Por ejemplo: Si el tipo de recurso es ACS::ECS::Instance, el recurso tiene estado. El valor puede ser Running o Stopped. Si el tipo de recurso es ACS::OSS::Bucket, el recurso no tiene estado. El valor está vacío.	InUse
ResourceType	string	El tipo de recurso.	ACS::ECS::NetworkInterface
Tags	string	Las etiquetas del recurso.	{\"key1\":[\"value2\"]}
UpdateTime	integer	La hora en que se actualizó por última vez el recurso. Es una marca de tiempo UNIX en milisegundos.	1722441600000
Version	integer	La versión del cambio del recurso.	1
VpcId	string	El ID de la nube privada virtual (VPC) a la que pertenece el recurso. Se devuelve una cadena vacía ("") si el recurso no pertenece a una VPC.	vpc-t4nhheyvay74fp7n0hxxx
VSwitchId	string	El ID del vSwitch al que pertenece el recurso. Los ID de vSwitch múltiples se separan con comas (,). Se devuelve una cadena vacía ("") si el recurso no pertenece a un vSwitch.	vsw-t4n7pokxxxxxxxxxxxxxx
ResourceGroupId	string	El ID del grupo de recursos al que pertenece el recurso. Ejemplo: rg-acfmvoh45rhxxxx.	rg-acfmvoh45rhxxxx
MaxResults	integer	El número máximo de entradas devueltas en cada página.	10
NextToken	string	El token de paginación que se utiliza en la siguiente solicitud para recuperar una nueva página de resultados.	IWBjqMYSy0is7zSMGu16****
TotalCount	integer	El número total de recursos.	8
RequestId	string	El ID de la solicitud.	C7817373-78CB-4F9A-8AFA-E7A88E9D64A2

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	NoPermission	You are not authorized to perform this operation.	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.	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.