Todos os produtos
Search
Central de documentação

Virtual Private Cloud:GetVpcGatewayEndpointAttribute

Última atualização: Jul 07, 2026

Consulta os atributos de um gateway endpoint.

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

vpc:GetVpcGatewayEndpointAttribute

get

*GatewayEndpoint

acs:vpc:{#regionId}:{#accountId}:gatewayendpoint/{#GatewayEndpointId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

EndpointId

string

Sim

O ID do gateway endpoint.

vpce-bp1w1dmdqjpwul0v3****

RegionId

string

Sim

O ID da região do gateway endpoint.

Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

A1122D0F-7B3B-5445-BB19-17F27F97FE1C

EndpointId

string

O ID do gateway endpoint.

vpce-bp1w1dmdqjpwul0v3****

EndpointName

string

O nome do gateway endpoint.

test

EndpointDescription

string

A descrição do gateway endpoint.

test

ServiceName

string

O nome do serviço de endpoint.

com.aliyun.cn-hangzhou.oss

VpcId

string

O ID da virtual private cloud (VPC) à qual o gateway endpoint pertence.

vpc-bp1nh86rugg01zol0****

PolicyDocument

string

A política de acesso para o serviço em nuvem.

{"Version" : "1", "Statement" : [ { "Effect" : "Allow", "Resource" : [ "*" ], "Action" : [ "*" ], "Principal" : [ "*" ] } ] }

CreationTime

string

A hora em que o endpoint foi criado. A hora segue o padrão ISO 8601 no formato YYYY-MM-DDThh:mm:ssZ. A hora é exibida em UTC.

2021-08-27T01:58:37Z

EndpointStatus

string

O status do gateway endpoint. Valores válidos:

  • Creating

  • Created

  • Modifying

  • Associating

  • Dissociating

  • Deleting

Created

RouteTables

array

O ID da tabela de rotas associada ao gateway endpoint.

string

O ID da tabela de rotas associada ao gateway endpoint.

["vtb-bp1s6g17997knk6a3****", "vtb-bp12qsdjwm37kv679****"]

ResourceGroupId

string

O ID do grupo de recursos ao qual o gateway endpoint pertence.

rg-acfmxvfvazb4p****

Tags

array<object>

A lista de tags.

object

Key

string

A chave da tag N adicionada ao recurso.

FinanceDept

Value

string

O valor da tag N adicionada ao recurso.

FinanceJoshua

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "A1122D0F-7B3B-5445-BB19-17F27F97FE1C",
  "EndpointId": "vpce-bp1w1dmdqjpwul0v3****",
  "EndpointName": "test",
  "EndpointDescription": "test",
  "ServiceName": "com.aliyun.cn-hangzhou.oss",
  "VpcId": "vpc-bp1nh86rugg01zol0****",
  "PolicyDocument": "{\"Version\" : \"1\",   \"Statement\" : [ {     \"Effect\" : \"Allow\",     \"Resource\" : [ \"*\" ],     \"Action\" : [ \"*\" ],     \"Principal\" : [ \"*\" ]   } ] }",
  "CreationTime": "2021-08-27T01:58:37Z",
  "EndpointStatus": "Created",
  "RouteTables": [
    "[\"vtb-bp1s6g17997knk6a3****\", \"vtb-bp12qsdjwm37kv679****\"]"
  ],
  "ResourceGroupId": "rg-acfmxvfvazb4p****",
  "Tags": [
    {
      "Key": "FinanceDept",
      "Value": "FinanceJoshua"
    }
  ]
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ResourceNotFound.GatewayEndpoint The specified resource gateway endpoint is not found. The error message returned because the specified gateway endpoint does not exist.
400 InvalidVpcId.NotFound Specified value of VpcId is not found in our record.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.