Todos os produtos
Search
Central de documentação

:DescribeAccessPoints

Última atualização: Jul 05, 2026

Consulta os pontos de acesso de um circuito Express Connect em uma região específica.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim DescribeAccessPoints

Operação a ser executada. Defina o valor como DescribeAccessPoints.

RegionId String Sim cn-hangzhou

ID da região do ponto de acesso.

Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

PageNumber Integer Não 1

Número da página a retornar. Valor padrão: 1.

PageSize Integer Não 10

Quantidade de entradas por página. Valor máximo: 50. Valor padrão: 10.

AcceptLanguage String Não zh-CN

Idioma da resposta. Valores válidos:

  • zh-CN: Chinês
  • en-US (padrão): Inglês

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String 3E85D803-C7CF-4BCD-9CFE-6DBA1DFFA027

ID da solicitação.

PageNumber Integer 1

Número da página retornada. Valor padrão: 1.

PageSize Integer 10

Quantidade de entradas retornadas por página. Valor máximo: 50. Valor padrão: 10.

TotalCount Integer 5

Total de entradas retornadas.

AccessPointSet Array of AccessPointType

Informações do ponto de acesso.

AccessPointType
Status String recommended

Status do ponto de acesso. Valores válidos:

  • recommended: O ponto de acesso está pronto para uso.
  • hot: Há muitos circuitos Express Connect conectados ao ponto de acesso.
  • full: A quantidade de circuitos Express Connect conectados ao ponto de acesso atingiu o limite máximo.
  • disabled: O ponto de acesso está indisponível.
Type String VPC

Tipo de rede do circuito Express Connect. Valor padrão: VPC.

HostOperator String China Telecom

Provedor de serviços de Internet (ISP) do ponto de acesso. Valores válidos:

Description String Access point description

Descrição do ponto de acesso.

AttachedRegionNo String cn-hangzhou

ID da região do ponto de acesso.

Name String Hangzhou-Yuhang-C

Nome do ponto de acesso.

AccessPointId String ap-cn-hangzhou-****

ID do ponto de acesso.

Location String Hangzhou

Localização do ponto de acesso.

AccessPointFeatureModels Array of AccessPointFeatureModel

Modelo de recurso do ponto de acesso.

AccessPointFeatureModel
FeatureValue String true

Valor do recurso do ponto de acesso.

FeatureKey String AP_Support_VbrBandwidthLimit

Recurso do ponto de acesso.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DescribeAccessPoints
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&AcceptLanguage=zh-CN
&Common request parameters

Exemplos de respostas bem-sucedidas

Formato XML

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

<DescribeAccessPointsResponse>
    <RequestId>3E85D803-C7CF-4BCD-9CFE-6DBA1DFFA027</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <TotalCount>5</TotalCount>
    <AccessPointSet>
        <Status>recommended</Status>
        <Type>VPC</Type>
        <HostOperator>China Telecom</HostOperator>
        <Description>Access point description</Description>
        <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
        <Name>Hangzhou-Yuhang-C</Name>
        <AccessPointId>ap-cn-hangzhou-****</AccessPointId>
        <Location>Hangzhou</Location>
        <AccessPointFeatureModels>
            <FeatureValue>true</FeatureValue>
            <FeatureKey>AP_Support_VbrBandwidthLimit</FeatureKey>
        </AccessPointFeatureModels>
    </AccessPointSet>
</DescribeAccessPointsResponse>

Formato JSON

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

{
  "RequestId" : "3E85D803-C7CF-4BCD-9CFE-6DBA1DFFA027",
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 5,
  "AccessPointSet" : [ {
    "Status" : "recommended",
    "Type" : "VPC",
    "HostOperator" : "China Telecom",
    "Description" : "Access point description",
    "AttachedRegionNo" : "cn-hangzhou",
    "Name" : "Hangzhou-Yuhang-C",
    "AccessPointId" : "ap-cn-hangzhou-****",
    "Location" : "Hangzhou",
    "AccessPointFeatureModels" : [ {
      "FeatureValue" : "true",
      "FeatureKey" : "AP_Support_VbrBandwidthLimit"
    } ]
  } ]
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

404

InvalidRegionId.NotSupport

The RegionId provided does not support in our records.

Mensagem de erro retornada porque o ID da região especificado é inválido.

Para obter uma lista de códigos de erro, visite o API Error Center.