ListIpamDiscoveredIpAddresses - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Lista os endereços IP usados por recursos descobertos em uma VPC ou vSwitch.

Descrição da operação

Combinações de consulta suportadas:

Apenas VpcId
Apenas VSwitchId
VpcId + VSwitchId
VpcId + CidrBlock
VSwitchId + CidrBlock
VpcId + VSwitchId + CidrBlock

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região onde a instância de descoberta de recursos está hospedada.	cn-hangzhou
IpamResourceDiscoveryId	string	Sim	O ID da instância de descoberta de recursos.	ipam-res-disco-jt5f2af2u6nk2z321****
VpcId	string	Não	O ID de uma VPC descoberta. Nota Você deve especificar pelo menos um de VpcId e VSwitchId.	vpc-bp1fjfnrg3av6zb9e****
VSwitchId	string	Não	O ID de um vSwitch descoberto. Nota Você deve especificar pelo menos um de VpcId e VSwitchId.	vsw-bp1bmwg5u07e1l3q0is4w
Cidr	string	Não	O bloco CIDR para pesquisar endereços IP usados em uma VPC ou vSwitch. Para consultar um endereço IP específico, use um comprimento de prefixo /32. Nota Apenas blocos CIDR IPv4 são suportados.	192.168.1.0/24
IpVersion	string	Não	A versão do protocolo IP. Valor válido: IPv4 Valores válidos: IPv4 :	IPv4
NextToken	string	Não	O token usado para recuperar a próxima página de resultados. Valores válidos: Não especifique este parâmetro na sua primeira solicitação. Se existir uma próxima página, defina este parâmetro com o valor de NextToken retornado na resposta anterior.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	Não	O número máximo de entradas a serem retornadas por página. Valores válidos: 1 a 200. Valor padrão: 100.	100

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O objeto de resposta.
IpamDiscoveredIpAddresses	array<object>	Detalhes dos endereços IP usados.
	object
VpcId	string	O ID da VPC.	vpc-bp1fjfnrg3av6zb9e****
VSwitchId	string	O ID do vSwitch.	vsw-bp1bmwg5u07e1l3q0is4w
IpVersion	string	A versão do IP. Valor válido: IPv4: Indica o protocolo IPv4.	IPv4
IpAddress	string	O endereço IP em uso.	192.168.10.40/32
ResourceId	string	O ID do recurso.	eni-bp1001jpjhzmgc5m****
ResourceRegionId	string	O ID da região na qual o recurso reside.	cn-shenzhen
ResourceServiceType	string	O serviço em nuvem ao qual o recurso pertence.	ENI
NextToken	string	O token de paginação. Use este token em uma solicitação subsequente para recuperar a próxima página de resultados. Valores válidos: Vazio: Todos os resultados foram retornados. Se NextToken tiver um valor, ele é o token para a próxima página de resultados.	FFmyTO70tTpLG6I3FmYAXGKPd****
TotalCount	integer	O número total de entradas que correspondem à consulta.	1000
MaxResults	integer	O número máximo de entradas a serem retornadas por página. Valores válidos: 1 a 200. Valor padrão: 100.	100
Count	integer	O número de entradas retornadas na página atual.	10
RequestId	string	O ID da solicitação.	9F8315CB-560E-5F1E-B069-6E44B440CAF8

Exemplos

Resposta de sucesso

JSON formato

{
  "IpamDiscoveredIpAddresses": [
    {
      "VpcId": "vpc-bp1fjfnrg3av6zb9e****",
      "VSwitchId": "vsw-bp1bmwg5u07e1l3q0is4w",
      "IpVersion": "IPv4",
      "IpAddress": "192.168.10.40/32",
      "ResourceId": "eni-bp1001jpjhzmgc5m****",
      "ResourceRegionId": "cn-shenzhen",
      "ResourceServiceType": "ENI"
    }
  ],
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount": 1000,
  "MaxResults": 100,
  "Count": 10,
  "RequestId": "9F8315CB-560E-5F1E-B069-6E44B440CAF8"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ResourceNotFound.IpamResourceDiscovery	The dependent instance of IPAM resource discovery is not found.	The dependent instance of IPAM resource discovery is not found.
400	MissingParam.IpamResourceDiscoveryId	The IpamResourceDiscoveryId must be input.	The IpamResourceDiscoveryId must be input.
400	Forbidden.IpResourceAccess	The IPAM resource discovery instance in the parameters is not allowed to access the IP address of resource %s.	The IPAM resource discovery instance in the parameters is not allowed to access the IP address of resource %s.
400	IllegalParamFormat.%s	The param of %s is illegal.	The param of %s is illegal.
400	ResourceNotFound.IpamDiscoveredResource	The queried %s is not found among IPAM discovered resources.	The queried %s is not found among IPAM discovered resources.
400	Mismatch.VpcIdAndVSwitchId	VpcId and VSwitchId do not match.	VpcId and VSwitchId do not match.
400	MissingParam.VpcIdAndVSwitchId	VpcId and VSwitchId cannot both be empty please provide at least one.	VpcId and VSwitchId cannot both be empty please provide at least one.
400	Mismatch.IpamResourceDiscoveryAndResource	The IPAM resource discovery %s and the queried %s do not match.	The IPAM resource discovery %s and the queried %s do not match.
400	ResourceNotFound.IpamDiscoveredResource.Vpc	The queried VPC %s is not found among IPAM discovered resources.	The queried VPC %s is not found among IPAM discovered resources.
400	ResourceNotFound.IpamDiscoveredResource.VSwitch	The queried VSwitch %s is not found among IPAM discovered resources.	The queried VSwitch %s is not found among IPAM discovered resources.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.